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

# Authentication Console Guide: Sign-Ins, Sessions and Settings

> Every page of the Authentication section in the Didit Business Console: metrics, users, sign-ins and sessions, and each sign-in and security setting.

The **Authentication** section of the Didit Business Console is where you configure how people sign in to your application and watch what happens when they do.
Open it from **Authentication** in the products list; its sidebar groups the pages as below.

| Group | Pages |
| - | - |
| Authentication | [Overview](#overview), [Users](#users), [Sign-ins](#sign-ins-and-sessions) |
| Sign-in | [Sign-in methods](#sign-in-methods), [Verified identity](#verified-identity), [Organizations](#organizations) |
| Protection | [Bot protection](#bot-protection), [Security and sessions](#security-and-sessions), [Agent access](#agent-access) |
| Build | [Branding and emails](#branding-and-emails), [Import users](#import-users), [Developers](#developers) |

Settings belong to the application you have selected at the top of the console, and live and sandbox applications have separate settings and people.
Reading the section needs the `authentication` permission at **read**, and changing it needs **write**: see [roles and permissions](https://docs.didit.me/console/roles-permissions.md).
When your plan does not include a feature, its page shows a plan note; a Sandbox application includes every plan's features, so you can try them first.

## Overview

The home page of the section summarizes the last 30 days in one sentence, and answers questions about your sign-ins in **Ask Didit**.

| Metric | What it counts |
| - | - |
| **Monthly active users** | People who signed in during the last 30 days, compared with the 30 days before. |
| **Sign-ins** | Sign-ins in the last 30 days, and the average per active user. |
| **Success rate** | The share of sign-in attempts that succeeded, with the most common reason for failure. |
| **Passkey adoption** | The share of sign-ins made with a passkey. |

**Needs your attention** lists what your team should act on, such as accounts locked after repeated wrong passwords, with **Unlock** or **Keep locked**.
**See all analytics** opens the Authentication metrics in [Analytics](https://docs.didit.me/console/analytics.md).

![The Authentication overview in the Didit Business Console, with monthly active users, sign-ins, success rate and passkey adoption for the last 30 days](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-overview.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=211a7703b2c07f4fb0f993d4c5636f42)

Authentication > Overview in the Business Console.

## Users

**Users** is the same people list as the rest of the console, so each person's sign-ins sit next to their verifications and transactions.
The **Can sign in** and **Locked or blocked** views, and the **Sign-in** filter, narrow it to sign-in status, sign-in method or MFA.

On a person, your team can:

| Action | What it does |
| - | - |
| **Block** and **Unblock** | Stops or restores sign-in. Blocking also ends their sessions and agent access. You can email the person when the status changes. |
| **Unlock** | Clears a temporary lockout and the failed-attempt count. |
| **Revoke sessions** | Signs the person out everywhere, agents included. |
| **Reset MFA** | Removes every second factor, passkeys included, and ends their sessions. Owner or Admin only. |
| **Send sign-in link** | Emails the person a 15-minute, single-use link to your sign-in page. Owner or Admin only. |
| **Send password reset** | Emails the person a 30-minute password reset link. |

Select several people to apply an action to up to 100 at once.
The rules behind each action are in [admin identity actions](https://docs.didit.me/authentication/sign-in-methods.md#admin-identity-actions).

## Sign-ins and sessions

**Sign-ins** has two views.

**Sign-in attempts** lists every attempt with its state (success, failed, challenged or blocked), the person, the method, the device, the location, a risk level and the time.
Filter by state, method and risk.
Open an attempt to see its evidence, such as the device, the network and any VPN or lockout signal, with **Open person**, **See in Events** and **Block this IP**, which adds the address to your blocklist in [Lists](https://docs.didit.me/console/blocklist-users.md).

![The Sign-ins page in the Didit Business Console, listing sign-in attempts with their state, person, method, device, location, risk and time](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-sign-ins.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=3c79b4e120c911b732d738e52d1687c8)

Authentication > Sign-ins: every attempt, with filters for state, method and risk.

**Active sessions** lists the sessions that are signed in now, with the person, device, location, when each started, when it was last active and when it ends, under the rule "Sessions last X, or Y without activity" from your settings.
**Revoke** ends a session on that device at once.

![The Active sessions view in the Didit Business Console, listing signed-in sessions with device, location, start, last activity, end and a Revoke button](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-active-sessions.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=098f6be31804b0af7c680e569f341bfb)

Authentication > Sign-ins > Active sessions, with Revoke on each session.

**Open in Events** shows the same activity as events, with the [fraud views](https://docs.didit.me/authentication/events-and-webhooks.md#fraud-views) that combine sign-ins with the rest of each person's activity.

## Sign-in methods

Turn each method on or off and configure it.
Each one shows its share of your sign-ins.

| Group | Methods |
| - | - |
| Passwordless | **Passkeys**, **Email code**, **Magic link** |
| Password | **Email and password** |
| Social | Each social sign-in provider, with Didit's test credentials in Sandbox or your own app's client ID and secret |
| Phone and reusable identity | **Phone code**, with the phone verification workflow that sends it, and **Didit ID Wallet**, which is not available yet |

The **Hosted sign-in** card shows your hosted sign-in URL, and **Try your sign-in page** opens it.
See [sign-in methods](https://docs.didit.me/authentication/sign-in-methods.md) for how each method works.

![The Sign-in methods page in the Didit Business Console, with the hosted sign-in page card, the passwordless and password methods, and a live preview of the hosted page](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-sign-in-methods.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=4f71ad0125f22dd8184ad837854ec8db)

Authentication > Sign-in methods, with a live preview of the hosted page.

## Verified identity

Choose the check a person must pass before their account is created (none, liveness or full ID), the rules that ask for a check again before sensitive actions (a payout above an amount, a new bank account, an email or phone change, a new device and then a payout), and the verified claims your app receives in the token.
**Preview a step-up** shows what the person sees.
Each rule shows how many checks it asked for this month and how many passed.
See [verified identity](https://docs.didit.me/authentication/verified-identity.md).

![The Verified identity page in the Didit Business Console, with the sign-up verification levels and their prices, and the step-up rules before sensitive actions](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-verified-identity.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=98544caeedf5ffaf68484cace19f9b3f)

Authentication > Verified identity: the check at sign-up and the rules before sensitive actions.

## Organizations

Turn organizations on for your business customers and manage them: **New organization**, then on each organization its single sign-on and setup link, verified domains with auto-join, members, roles and invitations.
The key metrics count organizations, members, SSO connections and verified domains.
See [organizations](https://docs.didit.me/authentication/organizations.md).

![The Organizations page in the Didit Business Console, with key metrics and a list of organizations with their members, verified domains and single sign-on status](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-organizations.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=95f8ab54f499735fe3f8593c565c0daa)

Authentication > Organizations.

## Bot protection

**Only allow humans** is the switch for every protection.
Under it, each of the six protections (bot detection, credential stuffing, brute force lockout, disposable emails, VPN and data center networks, and impossible travel) is set to **Off**, **Log**, **Challenge** or **Block**, and shows how many attempts it matched this month.
**Attack mode** challenges every sign-up and sign-in for emergencies, and turns itself off.
The key metrics show what was blocked and challenged this month and the largest burst, and **See detections** opens the matching events.
See [bot protection](https://docs.didit.me/authentication/bot-protection.md).

![The Bot protection page in the Didit Business Console, with the Only allow humans switch, attack mode, key metrics and each protection with Off, Log, Challenge and Block modes](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-bot-protection.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=bb899d54d9e9e32172d83afbfa996375)

Authentication > Bot protection.

## Security and sessions

| Card | Settings |
| - | - |
| **Recommendations** | Suggested changes, such as requiring MFA for organization admins, marked **Done** when applied. |
| **Multi-factor authentication** | Who must use MFA: **Everyone**, **Organization admins** or **Optional**. People can use a passkey, an authenticator app or backup codes. |
| **Sessions** | **Session lifetime** (1, 7, 30 or 90 days), **Ends when idle for** (30 minutes, 2 hours, 1 day or 7 days), **Sign out other devices when the password changes**, and **Several devices at once**. |
| **Password** | **Minimum password length** (8, 10, 12 or 14). Common passwords are always refused, and the breached-password check is in **Bot protection**. |
| **Account protection** | **Who can sign up** (**Anyone**, **Invited people** or **Allowed domains**, with your list of allowed email domains), **Email subaddresses**, and your allowlist and blocklist from **Lists**, which apply at sign-in. |
| **Redirect URLs and allowed origins** | The exact addresses Didit may return people to, and the web origins that may call your sign-in origin. See [redirect URLs](https://docs.didit.me/authentication/overview.md#redirect-urls). |
| **Sign-in URL** | Where a sign-in starts in your app. The sign-in link your team sends from a person's record opens it. |

Each setting maps to a field in [application settings](https://docs.didit.me/authentication/overview.md#application-settings).

![The Security and sessions page in the Didit Business Console, with the MFA policy, session lifetime, idle timeout and password settings](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-security-and-sessions.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=ab3736c1463119747c89f6269ef31e05)

Authentication > Security and sessions.

## Agent access

Turn agent access on, and choose what agents can do, how long their sessions last, and how people approve them.
The page lists active agent sessions with **Revoke**, and counts approvals and revocations.
See [agent access](https://docs.didit.me/authentication/agent-access.md).

![The Agent access page in the Didit Business Console, with the agent settings, key metrics and the active agent sessions with a Revoke button](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-agent-access.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=7cc518e37e2ccafa5515eb22e6ef9b8d)

Authentication > Agent access.

## Branding and emails

See your brand from Customization, set the page texts and your terms and privacy links, add a custom sign-in domain, and preview the hosted page in light and dark.
The emails view lists your sign-in emails with a preview of each and **Send a test**, and the senders of your email and SMS messages.
See [branding and custom domain](https://docs.didit.me/authentication/branding-and-custom-domain.md).

![The Branding and emails page in the Didit Business Console for a sandbox application, with the brand from Customization, the page texts and a preview of the hosted page](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-branding.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=9653e0d5b5556cec809139cfa6eaf055)

Authentication > Branding and emails, with a preview of the hosted page.

## Import users

Bring people from another identity platform or your own database with a CSV or JSON file: run a dry run, check it, then import.
**Import history** lists every job with its status and results.
See [import users](https://docs.didit.me/authentication/migration.md).

## Developers

| Card | What it holds |
| - | - |
| **Keys** | The **Publishable key**, which is public and goes in your app, the **Secret key**, which never goes in client code, and the **Frontend API** address. |
| **Prompt for your AI coding agent** | A ready-made prompt with your application's key that adds Authentication to your codebase, and asks first whether you are moving users from another platform. |
| **SDKs** | Install and sign-in snippets for React, Next.js, iOS and Android. |
| **Events and webhooks** | The `auth.*` webhook types, and what your server receives. |

After you activate a custom domain, the publishable key changes: copy the new key from here into your app.
See the [quickstart](https://docs.didit.me/authentication/quickstart.md) and [events and webhooks](https://docs.didit.me/authentication/events-and-webhooks.md).


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