> ## Documentation Index
> Fetch the complete documentation index at: https://docs-classic.cognigy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Access to Cognigy

[Updated in 2026.23](https://docs-classic.cognigy.com/release-notes/2026.23.md)

Access to Cognigy allows you to log in to and log out of Cognigy.

## Prerequisites

* You need to have a Cognigy account.

## Login

### Limit Active Login Sessions

By default, there is no limit to the number of sessions you can start in Cognigy across different browsers. However, you can set a limit for the on-premises installations. Set the `REFRESH_TOKEN_MAX_AMOUNT_PER_USER` variable in `values.yml` to the number of active sessions you want to allow. For example, if you want to allow only one active session, set `REFRESH_TOKEN_MAX_AMOUNT_PER_USER=1`.

### Log in to Cognigy

You can access Cognigy's login page through the following login URL:

```txt theme={null}
https://<frontend-url>/login
```

`frontend-url` depends on your installation:

* For on-premises installations, `frontend-url` is a domain you defined to run Cognigy.
* For SaaS installations, `frontend-url` is provided to you during deployment.

For example, `frontend-url` for Cognigy's trial environment is `trial.cognigy.ai`, and the login URL is `https://trial.cognigy.ai/login`.

Select your preferred login method:

> [tab] Log in directly to Cognigy
>
> 1. Go to the login page and enter your account credentials in the following fields:
>
>    * **Email** — the email you provided to your Cognigy admin to register your Cognigy account.
>    * **Password** — the password you received from your Cognigy admin. If you don't remember your password, you can [reset your password](#reset-password).
>
> 2. *(Optional)* If you want to stay logged in after you close your session, activate the **Remember me** option.
>
> 3. Click **Sign in**.

> [tab] Log in to Cognigy via NiCE CXone Mpower
>
> Depending on the Cognigy version, logging in via NiCE CXone Mpower works differently:
>
> > [accordion] Cognigy 2026.18.0 and later
> >
> > NiCE CXone users can access Cognigy via their NiCE CXone accounts if the [Tenant ID](https://docs-classic.cognigy.com/ai/administer/access/management-ui.md#create-an-organization) from NiCE CXone Mpower is linked to a Cognigy organization.
> >
> > Linking the Tenant ID activates [single sign-on (SSO)](#log-in-with-single-sign-on), so users don't need a separate Cognigy username or password. Each Tenant ID is tied to a single Cognigy organization. When users log in via SSO, they can access only the organization associated with that Tenant ID.
> >
> > With a linked Tenant ID, NiCE CXone users can access Cognigy under the **Automation** category in the app selector of the NiCE CXone Mpower interface.
> > This option is available only if the Cognigy application is activated in NiCE CXone Mpower.
> > For more information, refer to the [NiCE CXone Mpower](https://help.nicecxone.com/content/cognigyai/enablecognigyaiandssoaccess.htm#Virtual) documentation.
> >
> > In CXone-integrated installations, opening a Cognigy URL directly also signs you in via SSO automatically:
> >
> > * With no active Cognigy session, you are redirected to the CXone login page instead of the Cognigy password form.
> > * With an active CXone session, you are signed into Cognigy with no login page shown at all.
> >
> > You are then redirected back to the Cognigy page you originally requested.
>
> > [accordion] Cognigy 2026.17.0 and earlier
> >
> > NiCE CXone users can log in to Cognigy via their NiCE CXone accounts if the [Tenant ID](https://docs-classic.cognigy.com/ai/administer/access/management-ui.md#create-an-organization) from NiCE CXone Mpower is linked to a Cognigy organization.
> > Linking the Tenant ID enables [single sign-on (SSO)](#log-in-with-single-sign-on), so users don't need a separate Cognigy username or password. Each Tenant ID is tied to a single Cognigy organization. When users log in via SSO, they can access only the organization associated with that Tenant ID.
> >
> > Specifying a Tenant ID allows NiCE CXone users to log in to Cognigy under the **Automation** category in the app selector of the NiCE CXone Mpower interface.
> > This option is available only if the Cognigy application is activated in NiCE CXone Mpower.
> > For more information, refer to the [NiCE CXone Mpower](https://help.nicecxone.com/content/cognigyai/enablecognigyaiandssoaccess.htm#Virtual) documentation.

> [!NOTE]
>
> Your account is locked after 5 consecutive failed login attempts by default. Your admin can change this limit in the [password policy](https://docs-classic.cognigy.com/ai/administer/access/management-ui.md#change-password-policy). To unlock the account, see [Account Lockout](#account-lockout).

### Reset Password

1. Go to the login page and click **Forgot Password?**.
2. Enter your email in the **Email** field.
3. Click **Send link**.

You will receive an email with instructions to reset your password. You need to choose a password according to the [password policy](https://docs-classic.cognigy.com/ai/administer/access/management-ui.md#change-password-policy) your admin set up.

### Account Lockout

Your account is locked after 5 consecutive failed login attempts by default. Failed attempts more than 24 hours apart don't count as consecutive, and a successful login resets the count. Administrators can change this limit or set it to `0` to turn off the lockout in the [password policy](https://docs-classic.cognigy.com/ai/administer/access/management-ui.md#change-password-policy).

When your account is locked, the login page still shows `invalid email or password`, even if you enter the correct password.

Locks and unlocks are recorded in the audit log as `lockUser` and `unlockUser`.

The lockout doesn't apply to:

* The last active administrator of an organization.
* Users who sign in only with SSO.

When your account is locked, you receive one email with the subject `Your Cognigy account is locked` and a link to reset your password. Further failed attempts don't send more emails.

To unlock an account, use one of the following options:

* Use the link in the email to set a new password.
* Use **Forgot Password?** on the login page, as described in [Reset Password](#reset-password).
* Ask an administrator to click **Reset failed login attempts** or use **Set password** in the user details in the Admin Center. For details, see [Access Control](https://docs-classic.cognigy.com/ai/administer/access/admin-center/access-control.md).

### Log in with Single Sign-on

In Cognigy, you can set up [single sign-on (SSO)](https://docs-classic.cognigy.com/ai/administer/installation/single-sign-on-saml2.md) and, if necessary, you can [enforce login with SSO](https://docs-classic.cognigy.com/ai/administer/installation/single-sign-on-saml2.md) for your users.

To log in with SSO, follow these steps:

> [tab] Log in with Optional SSO
>
> 1. Go to the login page and click **Login with SSO**.
> 2. Enter your email in the **Email** field.
> 3. Click **Login with SSO**.
> 4. Click **Sign in with SSO**.

> [tab] Log in with Enforced SSO
>
> 1. Go to the login page and click **Login with SSO**.
> 2. Enter your email in the **Email** field.
> 3. Click **Sign in with SSO**.

### Multiple Organizations

In Cognigy, you can be part of more than one [organization](https://docs-classic.cognigy.com/ai/administer/access/management-ui.md#manage-organizations). Each organization has a different login URL. For each organization, the login URL follows this pattern:

```txt theme={null}
https://<frontend-url>/login?organisationId=<organization-id>
```

The `organization-id` parameter is a unique identifier with 24 characters that identifies an organization in Cognigy.

> [!WARNING]
>
> If you are part of more than one organization, you need to include `organisationId` in the login URL. Otherwise, the login fails.

#### Email Notification for Failed Login

[Updated in 4.27.0](https://docs-classic.cognigy.com/release-notes/earlier-versions/cognigy-ai-pre-4.30.md)

If your login fails because you didn't include `organisationId` in the login URL, you receive an email with login links for each organization you belong to.

The login links in the email redirect you to the Cognigy login page with the `organisationId` parameter of the respective organization in the URL.

## Logout

### Log out of Cognigy

To log out of Cognigy, you have two options:

* In the upper-right corner of the **Main** page, select **User Menu > Logout**.
* In the bottom-left corner of the Project page, click **User Menu > Logout**.

### Automatic Logout

The **Automatic logout** feature allows you to set an inactivity period for users in your organization. If a user remains inactive longer than this period, they are automatically logged out.

By default, the inactivity period is 15 minutes. However, you can set a limit for on-premises installations. Set the following variables in `values.yml`:

* `FEATURE_ENABLE_AUTO_LOGOUT_ON_INACTIVITY=true`.
* `AUTO_LOGOUT_IDLE_TIME_IN_MIN` to the inactivity period you want in minutes.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.