# Log in to the Cerby web app

{% hint style="info" %}
**Who can use this feature?**

* Workspace **Owners**, **Super Admins**, **Admins**, **Users**, **Guest Users**, and **Login-Only** users
  {% endhint %}

As a user with any workspace role, you can log in to the Cerby web app to access your workspace and manage your items.

The Cerby web app is the primary browser-based client for Cerby. From your workspace, you can streamline and protect your account logins, manage secrets, and collaborate with your team. For more information about how the web app works and the supported features, read the article [Explore the Cerby web app](https://help.cerby.com/getting-started/our-client-apps/explore-the-cerby-web-app).

The login process is different for workspaces integrated or federated with an identity provider (IdP) such as Okta or Entra ID, with social login or third-party authentication such as Google, and local workspaces:

* **IdP-based or federated workspaces:** All users, except Guest Users, authenticate via single sign-on (SSO) through their corporate login portal. Guest Users authenticate with login credentials managed by Cerby.
* **Social login or third-party authentication:** All users authenticate via single sign-on (SSO) through their external identity portal.
* **Local user workspaces:** All users authenticate with login credentials managed by Cerby.

***

## Prerequisites

The following are the requirements to log in to the Cerby web app:

* A web browser
* A Cerby workspace
* A Cerby user account with the workspace **Owner**, **Super Admin**, **Admin**, **User**, **Guest User**, or **Login-Only** role

***

## Log in to the Cerby web app

The login process is different depending on your workspace type:

* [IdP-based or federated workspaces](#idp-based-or-federated-workspaces)
* [Social login or third-party authentication](#social-login-or-third-party-authentication)
* [Local workspaces](#local-workspaces)

The following sections describe each process.

### IdP-based or federated workspaces

To log in to the Cerby web app in IdP-based or federated workspaces, complete the following steps:

1. Open the [Cerby login page](https://app.cerby.com/) with your browser. Based on previous logins or organization prefill, one of the following pages is displayed:
   * **Welcome to Cerby** page

     a. Click the **Log in** button. The **Let's find your workspace** page is displayed.

     b. Enter the name of your workspace.

     c. Click the **Next** button. An authentication waiting page is displayed on a new browser tab.
   * **Hi there!** page

     a. Click the **Log in** button of your workspace. An authentication waiting page is displayed on a new browser tab.

     **IMPORTANT:** If you have a **Guest User** role, proceed to the next step right away. After a few seconds, you will be redirected to the corporate login portal, and you must start from step 1.
2. Click the button of your authentication method based on your workspace role:
   * **Owner**, **Super Admin**, **Admin**, **User**, and **Login-Only**

     a. Click the **SSO Login** button. Your corporate login portal is displayed.
   * **Guest User**

     a. Click the **Log in as a guest user** button. The Cerby login portal is displayed.
3. Authenticate with your login credentials.
4. Provide your multi-factor authentication (MFA) verification code, if applicable. The Cerby web app dashboard is displayed.

Now you are done.

### Social login or third-party authentication

To log in to the Cerby web app in workspaces with social login or third-party authentication, complete the following steps:

1. Open the [Cerby login page](https://app.cerby.com/) with your browser. Based on previous logins or organization prefill, one of the following pages is displayed:
   * **Welcome to Cerby** page

     a. Click the **Log in** button. The **Let's find your workspace** page is displayed.

     b. Enter the name of your workspace.

     c. Click the **Next** button. The external identity portal is displayed on a new browser tab.
   * **Hi there!** page

     a. Click the **Log in** button of your workspace. The external identity portal is displayed.
2. Select an account to authenticate from the list of accounts with an active session.

   <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p><strong>NOTE:</strong> If you don't have active sessions, you must log in to the third-party authentication platform.</p></div>
3. Confirm the permissions and access to grant to Cerby on your account. The Cerby web app dashboard is displayed.

Now you are done.

### Local workspaces

To log in to the Cerby web app in local user workspaces, complete the following steps:

1. Open the [Cerby login page](https://app.cerby.com/) with your browser. Based on previous logins or organization prefill, one of the following pages is displayed:
   * **Welcome to Cerby** page

     a. Click the **Log in** button. The **Let's find your workspace** page is displayed.

     b. Enter the name of your workspace.

     c. Click the **Next** button. The Cerby login portal is displayed.
   * **Hi there!** page

     a. Click the **Log in** button of your workspace. The Cerby login portal is displayed.
2. Authenticate with your login credentials.
3. Provide your multi-factor authentication (MFA) verification code, if applicable. The Cerby web app dashboard is displayed.

Now you are done.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.cerby.com/cerby-web-app/access/log-in-to-the-cerby-web-app.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
