# Azure AD SAML

If you have Azure AD configured, you can enable SSO on Akto. and you should be an Admin on Akto dashboard.

1. [Ensure that all pre-requisites are met](#pre-requisites)
2. [Create new Oauth application](#create-new-application)
3. [Assign users and groups to your Oauth application](#assign-users-and-groups)
4. [Set up SAML settings for Oauth application](#set-up-saml-settings)
5. [Test your integration](#import-azure-federation-metadata-into-akto-dashboard)

Follow these steps to configure SAML SSO using Azure Active Directory.

## Pre-requisites

To enable users to access Akto using Azure Active Directory Single Sign-On (SSO), the following prerequisites must be met:

1. One of the following roles on Azure AD: **Global Administrator, Privileged Role Administrator, Cloud Application Administrator, or Application Administrator**.
2. You should have **ADMIN** role in Akto dashboard.
3. **Assigned to the Application:** Users must be assigned to the 'Akto' application within the Azure AD.
4. **User Profile Attributes:** Users should have the following attributes defined on their profile on Azure AD:
   * First Name
   * Last Name
   * User Principal Name
   * Email

## Create new application.

1. Navigate to `Enterprise applications`.

<div align="center"><figure><img src="https://2916937215-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRc4KTKGprZI2sPWKoaLe%2Fuploads%2Fgit-blob-bbadd9eb095b51466b8ba1dadbf423045af7f466%2FAzure-saml-1.png?alt=media&#x26;token=86e32b29-3a36-4af7-94a7-e97b51f16ad8" alt="Navigate to enterprise application" height="300"><figcaption></figcaption></figure></div>

\\

2. Click on the `+ New application` button.

<div align="center"><figure><img src="https://2916937215-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRc4KTKGprZI2sPWKoaLe%2Fuploads%2Fgit-blob-3c73ac8d20ba875589f4e52ea9f4ee86216344bc%2FAzure-saml-2.png?alt=media&#x26;token=1a8da534-6e9c-4220-8b10-a1a4eeb7936c" alt="Create new application" height="300"><figcaption></figcaption></figure></div>

\
3\. Click on \`+Create your own Application\`.

<div align="center"><figure><img src="https://2916937215-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRc4KTKGprZI2sPWKoaLe%2Fuploads%2Fgit-blob-94e22c089e6d4f0662cc31c839a026090b2a4c0b%2FAzure-saml-3.png?alt=media&#x26;token=62d5702d-5e4b-4fbc-a7d1-bdd466f61ab8" alt="Create your own application" height="300"><figcaption></figcaption></figure></div>

\
4\. Mention \`Akto\` as the name of your app.

<div align="center"><figure><img src="https://2916937215-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRc4KTKGprZI2sPWKoaLe%2Fuploads%2Fgit-blob-2cdb2691e7f10fed6bfd8149f6a196ebaea78aca%2FAzure-saml-7.png?alt=media&#x26;token=a50e9efd-6cd3-4e60-9ea3-75f38e48c371" alt="Fill &#x27;Akto" height="300"><figcaption></figcaption></figure></div>

\
5\. Choose the \`Integrate any other application you don't find in the gallery (Non-gallery)\` option and then click on \`Create\`.

## Assign users and groups

<div align="center"><figure><img src="https://2916937215-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRc4KTKGprZI2sPWKoaLe%2Fuploads%2Fgit-blob-834566f920b5d275d98b50518db6ca69745e67d1%2FAzure-saml-8.png?alt=media&#x26;token=c233c0d8-d267-42fe-b521-c45de113d5bf" alt="Assign roles" height="300"><figcaption></figcaption></figure></div>

\\

## Set up SAML settings

In the Azure Active Directory admin center, select the 'Akto' Enterprise application. Set up single sign on for the 'Akto' application, selecting `SAML` as the sign-on method. Use the following SAML settings. Here `{ hostname }` is the value of your domain hostname where you are hosting the Akto application.

**NOTE:** `Sign on URL` must be in `https:` format and not `http` for configuring SAML.

1. Under `Set up single sign on`, click on `SAML`.

<div align="center"><figure><img src="https://2916937215-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRc4KTKGprZI2sPWKoaLe%2Fuploads%2Fgit-blob-6c3dc8679d2994ca36e15eaeb10544b832524758%2FAzure-saml-9.png?alt=media&#x26;token=5bb0eb4f-953a-4f51-9786-305a6b50dc6d" alt="Download certificate" height="300"><figcaption></figcaption></figure></div>

\
2\. \*\*Basic SAML Configuration\*\*

```
| Setting     | Value        |
| -------- | ----------------  |
| Identifier (Entity ID)     | { hostname } |
| Reply URL (Assertion Consumer Service URL)    | { hostname }/signup-azure-saml    |
| Relay State    | { Organization domain }       |
```

<div align="center"><figure><img src="https://2916937215-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRc4KTKGprZI2sPWKoaLe%2Fuploads%2Fgit-blob-d72d1a44182e42de7660d0611c35c62bd16c6624%2Fazure_sso_conf.png?alt=media" alt="SAML configs"><figcaption></figcaption></figure></div>

\\

## Import Azure Federation Metadata into Akto Dashboard

1. On the same page you configured SAML settings in the Azure Active Directory admin center, download the `Federation Metadata XML` file (listed under the SAML Signing Certificate).

\\

<div align="center"><figure><img src="https://2916937215-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRc4KTKGprZI2sPWKoaLe%2Fuploads%2Fgit-blob-b4f33853c68c44bc5acbd5fc281cd45003e574c3%2FAzure-saml-4.png?alt=media&#x26;token=acf2b63b-cbab-4598-bff4-b56e3f58f482" alt="Download certificate" height="300"><figcaption></figcaption></figure></div>

\\

2. Navigating in Akto dashboard.\
   **Settings => Integrations => Azure SSO SAML**
3. Click on `Configure`, and then upload the metadata xml file.

   <div align="center"><figure><img src="https://2916937215-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRc4KTKGprZI2sPWKoaLe%2Fuploads%2Fgit-blob-68c50003ddd991fea95a5de7290fe551191f78dc%2FAzure-saml-6.png?alt=media" alt="Upload file"><figcaption></figcaption></figure></div>

   \\
4. `Logout` to test the configuration by clicking "Sign in with Azure SSO".

## Get Support for your Akto setup

There are multiple ways to request support from Akto. We are 24X7 available on the following:

1. In-app `intercom` support. Message us with your query on intercom in Akto dashboard and someone will reply.
2. Join our [discord channel](https://www.akto.io/community) for community support.
3. Contact `help@akto.io` for email support.
4. Contact us [here](https://www.akto.io/contact-us).
