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

# Authentication

Epiq AI Admin permissions are required to enforce two-factor authentication across your organization account.

## Set up MFA

When you enable two-factor authentication, users are required to use 2FA to access projects.

Users will be prompted to set up MFA during login. A one-time password (OTP) will be sent to a user by email. Users can also get verified through an authentication app.

<Frame caption="Enable/Disable MFA in Admin Settings">
  <img src="https://mintcdn.com/epiqai/nS5UcVIcNVyp4Qxh/images/MFA.png?fit=max&auto=format&n=nS5UcVIcNVyp4Qxh&q=85&s=6dfb9229822f9f9e755320c735f2ec98" alt="" width="2042" height="632" data-path="images/MFA.png" />
</Frame>

Once MFA is enabled for a user, the user will see the following screen for MFA setup. Scan the QR code through the authentication app and enter the OTP token for verification.&#x20;

<Frame>
  <img src="https://mintcdn.com/epiqai/nS5UcVIcNVyp4Qxh/images/Screenshot-2024-11-17-at-11.40.41-PM.png?fit=max&auto=format&n=nS5UcVIcNVyp4Qxh&q=85&s=1c2770dc53983973e05bb21daee17bd3" alt="" width="375" data-path="images/Screenshot-2024-11-17-at-11.40.41-PM.png" />
</Frame>

After this initial verification, users can use either the authentication app or Email to get the MFA token in the subsequent logins.

## Set up Azure Active Directory SSO

Admins can set up Azure Active Directory single sign-on (SSO) on Aida.

1. Log in to the [Azure portal](https://portal.azure.com/).
2. Go to the **Enterprise Applications** page.
3. Click `+ New application`
4. Click `+ Create your own application`.

<Frame>
  <img src="https://mintcdn.com/epiqai/nS5UcVIcNVyp4Qxh/images/Azure-SSO.png?fit=max&auto=format&n=nS5UcVIcNVyp4Qxh&q=85&s=461da17e42424da56ec79035992c784f" alt="" width="2856" height="1106" data-path="images/Azure-SSO.png" />
</Frame>

5. Once the application is created, click on "1. Assign users and groups", then "+ Add user". Add yourself and the group you've created to the Aida app. Click "Assign".

<Frame>
  <img src="https://mintcdn.com/epiqai/nS5UcVIcNVyp4Qxh/images/Azure-SSO-2-1.png?fit=max&auto=format&n=nS5UcVIcNVyp4Qxh&q=85&s=bb2ec9bb3eee90156fa5d438be949fcc" alt="" width="2880" height="1480" data-path="images/Azure-SSO-2-1.png" />
</Frame>

6. Navigate back to **Overview**, click on "2. Set up single sign-on" and then select SAML as your single sign-on method.
7. For Section (1), labeled "Basic SAML Configuration", enter the following data in each line and save your changes.
   * Identifier (Entity ID): `https://aida.yourcompany.com`
   * Reply URL (Assertion Consumer Service URL): `https://aida.yourcompany.com/api/v1/saml/YOUR_ACCOUNT_ID/acs`
   * Sign on URL: `https://aida.yourcompany.com/api/v1/saml/YOUR_ACCOUNT_ID/login`
   * Relay State: `https://aida.yourcompany.com`
   * Logout URL: `https://aida.yourcompany.com/api/v1/saml/YOUR_ACCOUNT_ID/logout`
8. In Section (3), labeled "SAML Certificate", download the "Federation Metadata XML".
9. Navigate to your **Admin Settings > SSO** (or go to `https://aida.yourcompany.com/admin/sso/`).
10. Upload the App Federation Metadata XML from above under "Federation Metadata XML".

<Frame caption="Aida SSO settings">
  <img src="https://mintcdn.com/epiqai/nS5UcVIcNVyp4Qxh/images/Screenshot-2024-06-02-at-11.19.54-PM.png?fit=max&auto=format&n=nS5UcVIcNVyp4Qxh&q=85&s=aa68ae9ad2f6905a6ed7cf67f52267de" alt="" width="1698" height="1052" data-path="images/Screenshot-2024-06-02-at-11.19.54-PM.png" />
</Frame>

6. You can then log in Aida through the "Sign in with SSO" option.

## Set up Okta

Admins can set up Okta SAML application single sign-on (SSO) on Aida.

1. Log in to the [Okta Dashboard](https://developer.okta.com/).
2. Go to the **Applications** page.
3. Click `Create App Integration` and select `SAML 2.0`
4. Setup your own Application.
5. Enter the following data in each line and save your changes.
   * Single sign-on URL: `https://aida.yourcompany.com/api/v1/saml/YOUR_ACCOUNT_ID/acs`
   * Audience URI (SP Entity ID): `https://aida.yourcompany.com`
   * Relay State: Leave it empty
6. Add an Attribute Statement:&#x20;

* Name: /claims/name
* Name format: Unspecified
* Value: user.email

<Frame>
  <img src="https://mintcdn.com/epiqai/nS5UcVIcNVyp4Qxh/images/Screenshot-2024-11-20-at-3.13.14-PM.png?fit=max&auto=format&n=nS5UcVIcNVyp4Qxh&q=85&s=5c81f65782587889522843c25b808993" alt="" width="1464" height="1590" data-path="images/Screenshot-2024-11-20-at-3.13.14-PM.png" />
</Frame>

7. Export the metadata in XML and upload it to the SSO settings in AIDA under "Federation Metadata XML".
8. Support SSO through multiple domains

Add a second SSO URL in the section below

`https://<second_domain>/api/v1/saml/<account_id>/acs`

<Frame>
  <img src="https://mintcdn.com/epiqai/EvD16a-ShRZsx03D/images/Screenshot-2026-04-01-at-9.07.15-AM.png?fit=max&auto=format&n=EvD16a-ShRZsx03D&q=85&s=9a483cffd3761afb80f82868bedec085" alt="" width="1554" height="644" data-path="images/Screenshot-2026-04-01-at-9.07.15-AM.png" />
</Frame>
