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

# Microsoft SAML

> Set up a SAML application in Azure Portal for bLIS

This guide contains instructions for setting up a new SAML application in Azure Portal (Microsoft 365).

<Info>
  For questions or support, please reach out to [support@blis.app](mailto:support@blis.app).
</Info>

## Inputs

The following values will be provided by Gamma Peak:

* Entity ID
* Reply URL

## Outputs

After following the instructions below, you will provide the following values to Gamma Peak:

* Metadata URL
* Certificate (Base64)
* Login URL

***

# Instructions

## 1. Log in to Azure Portal

Log in to the [Azure Active Directory Admin dashboard](https://portal.azure.com/#view/Microsoft_AAD_IAM/ActiveDirectoryMenuBlade/~/Overview). Select **Enterprise applications** from the menu on the left.

<img src="https://mintcdn.com/gammapeak/CiqBgzBq_BDZIqoO/images/sso/ms-saml-1.png?fit=max&auto=format&n=CiqBgzBq_BDZIqoO&q=85&s=e314a35e667340d1a8eec297013c036f" alt="MS SAML Step 1" width="2526" height="1898" data-path="images/sso/ms-saml-1.png" />

## 2. Create a new enterprise application

Click **New application**, then click **Create your own application**.

<img src="https://mintcdn.com/gammapeak/CiqBgzBq_BDZIqoO/images/sso/ms-saml-2.png?fit=max&auto=format&n=CiqBgzBq_BDZIqoO&q=85&s=b8d63dd9c9be05eeeeda05f59ac5aba6" alt="MS SAML Step 2" width="2526" height="1898" data-path="images/sso/ms-saml-2.png" />

<img src="https://mintcdn.com/gammapeak/CiqBgzBq_BDZIqoO/images/sso/ms-saml-3.png?fit=max&auto=format&n=CiqBgzBq_BDZIqoO&q=85&s=9dd2ebe628ed0cdbb6b429bb669ca945" alt="MS SAML Step 3" width="2526" height="1898" data-path="images/sso/ms-saml-3.png" />

Enter a name for the application (e.g., `bLIS`) and click **Create**.

<img src="https://mintcdn.com/gammapeak/CiqBgzBq_BDZIqoO/images/sso/ms-saml-4.png?fit=max&auto=format&n=CiqBgzBq_BDZIqoO&q=85&s=6b16e51ff54f21e03342a4c5a9dbf670" alt="MS SAML Step 4" width="2526" height="1898" data-path="images/sso/ms-saml-4.png" />

## 3. Configure SAML

Once the application is created, click **Single sign-on** in the left menu, then click the **SAML** tile.

<img src="https://mintcdn.com/gammapeak/CiqBgzBq_BDZIqoO/images/sso/ms-saml-5.png?fit=max&auto=format&n=CiqBgzBq_BDZIqoO&q=85&s=9b3264dd66f4cdb2f85caabc0ed0b62a" alt="MS SAML Step 5" width="2526" height="1898" data-path="images/sso/ms-saml-5.png" />

<img src="https://mintcdn.com/gammapeak/CiqBgzBq_BDZIqoO/images/sso/ms-saml-6.png?fit=max&auto=format&n=CiqBgzBq_BDZIqoO&q=85&s=ff7c7865403774b69b9fb550c72429b8" alt="MS SAML Step 6" width="2526" height="1898" data-path="images/sso/ms-saml-6.png" />

Click the **Edit** button on the **Basic SAML Configuration** section.

<img src="https://mintcdn.com/gammapeak/CiqBgzBq_BDZIqoO/images/sso/ms-saml-7.png?fit=max&auto=format&n=CiqBgzBq_BDZIqoO&q=85&s=e9f72c4cb8714e695314d6e4c0284978" alt="MS SAML Step 7" width="2526" height="1898" data-path="images/sso/ms-saml-7.png" />

Enter the **Entity ID** and **Reply URL** values provided to you by Gamma Peak. If multiple Reply URLs were provided, add them all here. Click **Save**.

<img src="https://mintcdn.com/gammapeak/CiqBgzBq_BDZIqoO/images/sso/ms-saml-8.png?fit=max&auto=format&n=CiqBgzBq_BDZIqoO&q=85&s=1422eda53389106f6c95d9cd2faa8b95" alt="MS SAML Step 8" width="2526" height="1898" data-path="images/sso/ms-saml-8.png" />

## 4. Copy and save outputs

Scroll down on the SAML configuration page to locate the output values.

**Metadata URL** — In the **SAML Signing Certificate** section, locate the **App Federation Metadata Url**. Copy and save this value.

<img src="https://mintcdn.com/gammapeak/CiqBgzBq_BDZIqoO/images/sso/ms-saml-9.png?fit=max&auto=format&n=CiqBgzBq_BDZIqoO&q=85&s=a717f93c7e36ca234f87eb58de9dcc55" alt="MS SAML Step 9" width="2526" height="1898" data-path="images/sso/ms-saml-9.png" />

<Note>
  **Output:** Metadata URL
</Note>

**Certificate (Base64)** — In the **SAML Signing Certificate** section, click **Download** next to **Certificate (Base64)**. Save the downloaded `.cer` file.

<img src="https://mintcdn.com/gammapeak/CiqBgzBq_BDZIqoO/images/sso/ms-saml-10.png?fit=max&auto=format&n=CiqBgzBq_BDZIqoO&q=85&s=3db7ef8e2c88411f8f3e13fe187373ca" alt="MS SAML Step 10" width="2526" height="1898" data-path="images/sso/ms-saml-10.png" />

<Note>
  **Output:** Certificate (Base64) `.cer` file
</Note>

**Login URL** — In the **Set up bLIS** section, locate the **Login URL** field. Copy and save this value.

<img src="https://mintcdn.com/gammapeak/CiqBgzBq_BDZIqoO/images/sso/ms-saml-11.png?fit=max&auto=format&n=CiqBgzBq_BDZIqoO&q=85&s=e60ef27373e5354f0110976e9ded7b39" alt="MS SAML Step 11" width="2526" height="1898" data-path="images/sso/ms-saml-11.png" />

<Note>
  **Output:** Login URL
</Note>

## 5. Send output values

Configuration in Azure Portal is now complete. Send the following output values to [support@blis.app](mailto:support@blis.app):

* **Metadata URL**
* **Certificate (Base64)** — attach the downloaded `.cer` file
* **Login URL**

<Info>
  For questions or support, please reach out to [support@blis.app](mailto:support@blis.app).
</Info>