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

# Azure AD

This guide explains how to configure Azure Single Sign-On (SSO) so users can securely log in to ResolveAI.

You'll create a custom SAML 2.0 application, configure user and group attributes, and share your setup details with your Resolve contact.

<Info>
  This setup must be completed by an Azure AD Administrator.
</Info>

## 1. Create a Custom SAML App

* Go to your [Azure Portal](https://portal.azure.com/)
* Navigate to **Azure Services -> Enterprise applications**
* Click **+ New application**

<img src="https://mintcdn.com/resolveai-0e94a547/GuuijYwp3RfE7Xrj/images/external/aabfa2895010.png?fit=max&auto=format&n=GuuijYwp3RfE7Xrj&q=85&s=e0d4099fbe70d1c083c50f5d2e772f8c" width="70%" alt="" data-path="images/external/aabfa2895010.png" />

* Click **+ Create your own application**
* Name the app `ResolveAI`
* Select **Integrate any other application you don’t find in the gallery**
* Click **Create**
* [Download the ResolveAI logo](/images/resolveai-logo.png) and add it as the icon
* Click **Next** to continue

## 2. Configure Single Sign-On (SAML)

1. From the app's Overview page, click **Single sign-on**
2. Choose the **SAML** sign-on method

<img src="https://mintcdn.com/resolveai-0e94a547/GuuijYwp3RfE7Xrj/images/external/0c3b708f2953.png?fit=max&auto=format&n=GuuijYwp3RfE7Xrj&q=85&s=4d5aa81dd1a6720de4d7460938379e40" width="70%" alt="" data-path="images/external/0c3b708f2953.png" />

### Basic SAML Configuration

* **Identifier (Entity ID)**: `app0.resolve.ai`
* **Reply URL (ACS URL)**: `https://app0.resolve.ai/auth/saml/callback`
* **Relay State**: leave blank

Your configuration should look like this:

<img src="https://mintcdn.com/resolveai-0e94a547/GuuijYwp3RfE7Xrj/images/external/4fe6eaa2903b.png?fit=max&auto=format&n=GuuijYwp3RfE7Xrj&q=85&s=5a8fd59c8be76e166b8e1db51382383c" width="70%" alt="" data-path="images/external/4fe6eaa2903b.png" />

## 3. Configure Attributes & Claims

In the **User Attributes & Claims** section, configure the following:

* **nameidentifier**: `user.userprincipalname`

<img src="https://mintcdn.com/resolveai-0e94a547/GuuijYwp3RfE7Xrj/images/external/48569d291628.png?fit=max&auto=format&n=GuuijYwp3RfE7Xrj&q=85&s=703ccd993a9ad2db7f36983bbd5ac6a5" width="70%" alt="" data-path="images/external/48569d291628.png" />

* **email**: `user.userprincipalname` or `user.mail`

<img src="https://mintcdn.com/resolveai-0e94a547/GuuijYwp3RfE7Xrj/images/external/cf717d99092d.png?fit=max&auto=format&n=GuuijYwp3RfE7Xrj&q=85&s=02e5201260e50b156e01f69a8297f911" width="70%" alt="" data-path="images/external/cf717d99092d.png" />

* **firstName**: `user.givenname`

<img src="https://mintcdn.com/resolveai-0e94a547/GuuijYwp3RfE7Xrj/images/external/85263f777f6b.png?fit=max&auto=format&n=GuuijYwp3RfE7Xrj&q=85&s=6c00bf141e0847666d4c7ba16b835ef6" width="70%" alt="" data-path="images/external/85263f777f6b.png" />

* **lastName**: `user.surname`

<img src="https://mintcdn.com/resolveai-0e94a547/GuuijYwp3RfE7Xrj/images/external/bbed6d1645d8.png?fit=max&auto=format&n=GuuijYwp3RfE7Xrj&q=85&s=3d5972f088b09a473fd380f18805ae26" width="70%" alt="" data-path="images/external/bbed6d1645d8.png" />

(Optional) You can also include groups if you're using Azure AD groups for role-based access control.

After configuring your details, click **create SAML Certificate**.

<img src="https://mintcdn.com/resolveai-0e94a547/GuuijYwp3RfE7Xrj/images/external/e363e47d32c3.png?fit=max&auto=format&n=GuuijYwp3RfE7Xrj&q=85&s=faf3537cf417f8eb01a47ecdb03fcc43" width="70%" alt="" data-path="images/external/e363e47d32c3.png" />

## 4. Assign Users and Groups

Assign the app to users or groups who need access to Resolve. Only those assigned can authenticate.

To learn more: [Assign users and groups in Azure](https://learn.microsoft.com/en-us/azure/active-directory/manage-apps/assign-user-or-group-access-portal)

## **5. Contact ResolveAI**

After setup, copy the following to share with your Resolve contact:

* **Login URL**
* **Logout URL**
* **Azure AD Identifier**
* **Base64 Certificate**

<img src="https://mintcdn.com/resolveai-0e94a547/GuuijYwp3RfE7Xrj/images/external/715f4e33ffaf.png?fit=max&auto=format&n=GuuijYwp3RfE7Xrj&q=85&s=eb1b7c394255e174c1cd1c56a1d2832a" width="70%" alt="" data-path="images/external/715f4e33ffaf.png" />

<img src="https://mintcdn.com/resolveai-0e94a547/GuuijYwp3RfE7Xrj/images/external/f97aebd08729.png?fit=max&auto=format&n=GuuijYwp3RfE7Xrj&q=85&s=d13f15daf5a8f29dfc679bb740589497" width="70%" alt="" data-path="images/external/f97aebd08729.png" />

Once confirmed, users can log in at [app0.resolve.ai](https://app0.resolve.ai/).
