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

# Azure Active Directory Single Sign-On (SSO)

> Configure Azure Active Directory SSO for Manifest with step-by-step setup instructions for app registration and authentication.

## **Prerequisites**

Currently, Manifest only supports Single Sign-on (SSO) using Azure Active Directory. To get started you need the following items:

* An Azure account with an active subscription

* One of the following roles to the client Azure account: Global Administrator, Cloud Application Administrator, Application Administrator, or owner of the service principal.

* The following role to the Manifest application: System administrator

## **Adding the Manifest application to your Azure AD tenant**

1. Sign into the Azure portal 

2. In the Azure portal, search for and select **Azure Active Directory**.

3. ​Select **App registrations**

<img src="https://mintcdn.com/taqtile/McTkf_4O83inXzZ3/images/image-10-1024x513.png?fit=max&auto=format&n=McTkf_4O83inXzZ3&q=85&s=c720b62e632776da62519a586bf6485d" alt="Image 10" width="1024" height="513" data-path="images/image-10-1024x513.png" />

4. Select **“+ New Registration”**

5. Complete the App registration form:
   * Enter the desired user-facing display name, eg. “Manifest”

   * Choose the scope for application authentication (Most single tenant users will select the first option: Supported Account types – select “Accounts in this organizational directory only”)

   * Redirect URI is (optional) – leave blank

   * Select Register

<img src="https://mintcdn.com/taqtile/McTkf_4O83inXzZ3/images/image-9-1024x578.png?fit=max&auto=format&n=McTkf_4O83inXzZ3&q=85&s=a509f6fc2f9c93871a9a0c3dff6f6f0c" alt="Image 9" width="1024" height="578" data-path="images/image-9-1024x578.png" />

6. From the App registration screen, under “**Owned applications**” select the Manifest app you just created

7. Go to the **Authentication** tab

8. Select **+ Add a platform**

<img src="https://mintcdn.com/taqtile/J2z2RCHRXFb_W-Ov/images/AddPlatform-1024x739.png?fit=max&auto=format&n=J2z2RCHRXFb_W-Ov&q=85&s=2181237dd0bfa9cc6140823049908061" alt="Add Platform" width="1024" height="739" data-path="images/AddPlatform-1024x739.png" />

9. On the Configure platforms select Web

<img src="https://mintcdn.com/taqtile/z7ZwfGwVtZUiFpOT/images/ConfigurePlatforms-863x1024.png?fit=max&auto=format&n=z7ZwfGwVtZUiFpOT&q=85&s=6206ebf6039327fc6235f14d94136bb6" alt="Configure Platforms" width="863" height="1024" data-path="images/ConfigurePlatforms-863x1024.png" />

10. Enter the redirect URI of the application
    * *domain.com*/rest/dynamics/token

    * *domain.com*/rest/dynamics/auth\
      **IMPT**: insert your full Manifest domain URL in place of *domain.com* eg: [https://mysubdomain.taqmanifest.com/rest/dynamics/token​](https://mysubdomain.taqmanifest.com/rest/dynamics/token​)

<img src="https://mintcdn.com/taqtile/ugZN3LSXj-Ckj_f3/images/URIs-1024x895.png?fit=max&auto=format&n=ugZN3LSXj-Ckj_f3&q=85&s=12a7b7b93c054bd73b282e465f4ff0ae" alt="Uris" width="1024" height="895" data-path="images/URIs-1024x895.png" />

11. Go to the **Certificates & secrets** tab

12. Under **Client secrets**, select “**+ New client\*\*\*\*secret**” and add a client secret
    * Provide a description and expiration and a client secret will be automatically generated

    * **IMPT!** Copy the key once created and save this. You will need this to configure your AD in Manifest. Once you leave this screen you will not be able to access this secret value again.

<img src="https://mintcdn.com/taqtile/z7ZwfGwVtZUiFpOT/images/ClientSecretNew-1024x424.png?fit=max&auto=format&n=z7ZwfGwVtZUiFpOT&q=85&s=bb9092e7f8a9f9ef957174610c5033c2" alt="Client Secret New" width="1024" height="424" data-path="images/ClientSecretNew-1024x424.png" />

<img src="https://mintcdn.com/taqtile/McTkf_4O83inXzZ3/images/image-16-1024x227.png?fit=max&auto=format&n=McTkf_4O83inXzZ3&q=85&s=622bbb3115bcb80abf99101307de441d" alt="Image 16" width="1024" height="227" data-path="images/image-16-1024x227.png" />

11. Go to the **'API Permissions'** tab

12. Select **“+ Add a permission”**. The “Request API permissions” window will fly out.

13. Under Microsoft API’s, select **Microsoft Graph**. You will be prompted to indicate what type of permissions your application requires.

14. Select Delegated Permissions and search for and then check off the following permissions:
    * User.read

    * Sites.Manage.All

    * Sites.Read.All

    * User.Read

<img src="https://mintcdn.com/taqtile/McTkf_4O83inXzZ3/images/image-14-1022x1024.png?fit=max&auto=format&n=McTkf_4O83inXzZ3&q=85&s=2d397930ff19855d3d5165f2cd7d9b85" alt="Image 14" width="1022" height="1024" data-path="images/image-14-1022x1024.png" />

15. Before logging out, be sure to make note of the following information required to configure your Active Directory in Manifest:
    * **Application (client) ID:** available under App registrations

    * **Client Secret**: created in step 10

    * **Directory (tenant) ID**: available on the Overview tab​

## **Configuring Manifest with your client Azure AD**

1. Sign into the **Manifest Client Portal**

2. Select “**Client Setting**s” and go to the **Active Directory Configurations** tab

3. Select **"+ OAUTH PROVIDER"**

4. Enter in the following information gathered in step 15 when adding the Manifest application to your Azure AD tenant:
   * Client ID​

   * Client Secret​

   * Tenant ID​

5. Select Update

<figure>
  <img src="https://mintcdn.com/taqtile/McTkf_4O83inXzZ3/images/image-15-1024x577.png?fit=max&auto=format&n=McTkf_4O83inXzZ3&q=85&s=2508a0dfea690ccff8ccb9425af907af" alt="Image 15" width="1024" height="577" data-path="images/image-15-1024x577.png" />

  <figcaption>
    Manifest Client Portal Active Directory Configuration
  </figcaption>
</figure>
