> ## Documentation Index
> Fetch the complete documentation index at: https://macstadiuminc-add-bazel-rbe-integration-di574.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Enable SAML SSO with Microsoft Entra ID

> Set up SAML SSO for the MacStadium Portal with Microsoft Entra ID (Azure AD): create the enterprise app, configure SAML, and share metadata.

## About

<Note>SAML SSO is a paid offering. Contact your account team through the [Customer Portal](https://portal.macstadium.com) for more information.</Note>

<Warning>MacStadium does not support IdP-initiated logins. After SSO is configured, all users must log in at [portal.macstadium.com/sso](https://portal.macstadium.com/sso) using the ID provided by the MacStadium team.</Warning>

<Tip>You can also log in directly at [portal.macstadium.com](https://portal.macstadium.com/login).</Tip>

## Overview

SAML SSO with Microsoft Entra ID allows customers to:

* Enable users to be automatically signed in to MacStadium using their Entra ID accounts.
* Manage accounts in one central location: Microsoft Entra ID.

## Getting Started

1. Open **Entra ID admin**.
2. Navigate to **Enterprise applications**.\\
   <img src="https://mintcdn.com/macstadiuminc-add-bazel-rbe-integration-di574/s6YP2z0Sg2ywf40O/images/attachments/28263129254811.png?fit=max&auto=format&n=s6YP2z0Sg2ywf40O&q=85&s=2ce0a344bc0958cb1840e786ce45ce8d" alt="Azure Entra ID admin left sidebar with Enterprise applications option" width="2400" height="1600" data-path="images/attachments/28263129254811.png" />
3. Create a new application by clicking **New Application**.\\
   <img src="https://mintcdn.com/macstadiuminc-add-bazel-rbe-integration-di574/s6YP2z0Sg2ywf40O/images/attachments/28263097031963.png?fit=max&auto=format&n=s6YP2z0Sg2ywf40O&q=85&s=c9cae9b1cc9c3080a8c3e6c31ea117a1" alt="Azure Enterprise applications list with New Application button" width="2400" height="1600" data-path="images/attachments/28263097031963.png" />
4. Create an application by clicking **Create your own application**.\\
   <img src="https://mintcdn.com/macstadiuminc-add-bazel-rbe-integration-di574/s6YP2z0Sg2ywf40O/images/attachments/28263097033755.png?fit=max&auto=format&n=s6YP2z0Sg2ywf40O&q=85&s=3d3eb95363370b6639e3ea1fabfc602a" alt="Azure Browse gallery page with Create your own application button" width="2400" height="1600" data-path="images/attachments/28263097033755.png" />
   * Enter a name (for example **MacStadium-Portal**).
   * Select **Integrate any other application you don’t find in the gallery (Non-gallery).**\\
     <img src="https://mintcdn.com/macstadiuminc-add-bazel-rbe-integration-di574/s6YP2z0Sg2ywf40O/images/attachments/28263097036187.png?fit=max&auto=format&n=s6YP2z0Sg2ywf40O&q=85&s=c7b97981b2fe7efa747451a8c3471326" alt="Azure Create your own application form with name field and non-gallery option selected" width="2372" height="1581" data-path="images/attachments/28263097036187.png" />
5. Click **Single sign-on**.\\
   <img src="https://mintcdn.com/macstadiuminc-add-bazel-rbe-integration-di574/s6YP2z0Sg2ywf40O/images/attachments/28263129264411.png?fit=max&auto=format&n=s6YP2z0Sg2ywf40O&q=85&s=5673b6510f9fbedd25114c0c305b8c0e" alt="Azure enterprise app overview with Single sign-on option in sidebar" width="2372" height="1581" data-path="images/attachments/28263129264411.png" />
6. Select **SAML**.\\
   <img src="https://mintcdn.com/macstadiuminc-add-bazel-rbe-integration-di574/s6YP2z0Sg2ywf40O/images/attachments/28263129266459.png?fit=max&auto=format&n=s6YP2z0Sg2ywf40O&q=85&s=276e0fa2265fae44a6ed17b0a0fc8100" alt="Azure Single sign-on method selection with SAML option highlighted" width="2372" height="1581" data-path="images/attachments/28263129266459.png" />
7. Click **Edit** on the *Basic SAML settings.*\\
   <img src="https://mintcdn.com/macstadiuminc-add-bazel-rbe-integration-di574/s6YP2z0Sg2ywf40O/images/attachments/28263129267739.png?fit=max&auto=format&n=s6YP2z0Sg2ywf40O&q=85&s=4ef6e7e107d0479284ca2434127566a6" alt="Azure SAML-based Sign-on page showing Basic SAML Configuration section with Edit button" width="2372" height="1581" data-path="images/attachments/28263129267739.png" />
8. Configure the SAML settings:
   * **Identifier (Entity ID):** `urn:amazon:cognito:sp:us-east-1_pusi8jHs1`
   * **Reply URL (Assertion Consumer Service URL):** `https://idp.macstadium.com/saml2/idpresponse`
   * **Logout URL (Optional):** `https://idp.macstadium.com/saml2/logout`
   * Click **Save**
     <img src="https://mintcdn.com/macstadiuminc-add-bazel-rbe-integration-di574/s6YP2z0Sg2ywf40O/images/attachments/28263129269275.png?fit=max&auto=format&n=s6YP2z0Sg2ywf40O&q=85&s=d2937c30e495604466115858e43ab640" alt="Azure Basic SAML Configuration with Entity ID, Reply URL, and Logout URL fields completed" width="2372" height="1992" data-path="images/attachments/28263129269275.png" />
9. Edit **Attributes & Claims** for your SAML app. <Warning>The email field must be mapped to `user.mail` or login will fail.</Warning>\\
   <img src="https://mintcdn.com/macstadiuminc-add-bazel-rbe-integration-di574/9uOnQTt0h9NXKvKf/images/attachments/37939325807643.png?fit=max&auto=format&n=9uOnQTt0h9NXKvKf&q=85&s=8584087c26b6323e9e1c136595d7a78c" alt="Azure Attributes and Claims configuration with email mapped to user.mail" width="2834" height="2086" data-path="images/attachments/37939325807643.png" />

Once configured properly, section 2 of your SAML app should look like the below screenshot.\\

<img src="https://mintcdn.com/macstadiuminc-add-bazel-rbe-integration-di574/9uOnQTt0h9NXKvKf/images/attachments/37939280894619.png?fit=max&auto=format&n=9uOnQTt0h9NXKvKf&q=85&s=bb56d44dfc6e8217fcb362cfd72d0ab3" alt="Azure SAML app section 2 showing correctly configured Attributes and Claims" width="2948" height="1428" data-path="images/attachments/37939280894619.png" />

10. Once the attributes & claims are updated, please provide our support team with the app federation metadata URL. You can copy the federation metadata URL in section 3 of your SAML app, as shown in the below screenshot.\\
    <img src="https://mintcdn.com/macstadiuminc-add-bazel-rbe-integration-di574/9uOnQTt0h9NXKvKf/images/attachments/37939325810971.png?fit=max&auto=format&n=9uOnQTt0h9NXKvKf&q=85&s=8489d838308c866d6e8988147c220c37" alt="Azure SAML app section 3 showing App Federation Metadata URL to copy" width="1606" height="756" data-path="images/attachments/37939325810971.png" />
