Skip to main content

​
Overview

Login Identities allow you to create reusable login profiles for testing authenticated flows in your application. Each identity stores a login URL and securely maintains a persistent browser session, so you can run tests from an authenticated state without logging in each time.

​
Creating a Login Identity

To create a new login identity:
  1. Navigate to Tests → Identities in your Decipher dashboard
  2. Click the Create Identity button (+ icon)
  3. Fill in the required information:
    • Name (required) - A descriptive name for this identity (e.g., “Production Admin Account”)
    • Login URL (required) - The URL of your application’s login page (e.g., https://app.example.com/login)
    • Description (optional) - Additional notes about this identity
  4. Click Start Login Process
When you create an identity, Decipher opens a browser session where you’ll perform the login steps yourself.

​
Performing the Login

After clicking Start Login Process, you’ll:
  1. Complete the login - Enter your credentials and complete any authentication steps (2FA, CAPTCHA, social login, etc.) in the browser session
  2. Navigate as needed - After logging in, you can navigate through your application
  3. End the session - Click End Session when you’re done
Decipher securely stores the browser state to a persistent context, allowing future tests to use this logged-in state.
This approach works with any authentication method, including two-factor authentication, social logins (Google, GitHub, etc.), and CAPTCHA verification.

​
Managing Login Identities

​
Editing an Identity

To modify an existing identity:
  1. Select the identity from the list
  2. Click the Edit button
  3. Update the desired fields (Name, Login URL, Description)
  4. Click Save Changes

​
Deleting an Identity

To remove an identity:
  1. Select the identity from the list
  2. Click the Delete button
  3. Confirm the deletion

​
Using Identities in Tests

Once you’ve created a login identity, use it when creating tests:
  1. Navigate to Tests
  2. Click Create Test
  3. Select an Identity from the dropdown
  4. The test will use the securely stored browser context from that identity
This allows your tests to start from an authenticated state without manually logging in each time.
Create separate identities for different user roles (admin, standard user, premium user, etc.) to test role-specific functionality.
Need help with login identities? Contact our support team for assistance.