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

# Login Identities

> Create and manage login identities to test authenticated user flows

## Overview

Login Identities are reusable login profiles that let your tests start from an authenticated state. Decipher supports two types:

* **Credentials** — Stores a username and password. Decipher logs in automatically before each test run.
* **2FA / Magic Link** — For login flows that require human interaction (2FA codes, magic links, OTPs). You log in once in a live browser session, and Decipher saves the browser state.

## Credentials Identity

1. Go to [**Tests → Identities**](https://app.getdecipher.com/tests/identities) and click **Create Identity**
2. Select **Credentials**
3. Fill in **Name**, **Login URL**, **Username/Email**, **Password**, and optionally a **PIN**
4. Click **Create Identity**

That's it — Decipher will automatically log in with these credentials before each test run. No manual login session needed.

## 2FA / Magic Link Identity

1. Go to [**Tests → Identities**](https://app.getdecipher.com/tests/identities) and click **Create Identity**
2. Select **2FA / Magic Link**
3. Fill in **Name** and **Login URL**
4. Click **Create Identity**

After creating the identity, you need to run a login session to establish the browser state:

1. Click **Run Login** on the identity
2. Complete the login in the live browser session (enter credentials, approve 2FA, click magic link, etc.)
3. Click **End Session** when done

Decipher saves the browser state so future test runs can start from this authenticated session.

<Tip>
  Create separate identities for different user roles (admin, standard user, etc.) to test role-specific functionality.
</Tip>

## Using Identities in Tests

When creating a test, select an **Identity** from the dropdown. The test will use that identity's stored credentials or saved browser session to start in an authenticated state.

## Managing Identities

* **Edit** — Select an identity, click **Edit**, update fields, and **Save Changes**. If active test validations use this identity, you'll be prompted to restart them with the new credentials.
* **Delete** — Select an identity, click **Delete**, and confirm. This also removes all associated login attempts.

***

*Need help? [Contact our support team](mailto:team@getdecipher.com).*
