From a25c4ae8fa20a5c14d14b26b244221e65968c1ea Mon Sep 17 00:00:00 2001 From: Matthew Karnowski Date: Tue, 21 Nov 2023 12:49:58 +0100 Subject: [PATCH] Update sso-saml.mdx ran through prettier --- docs/integrations/microsoft/sso-saml.mdx | 23 +++++++++-------------- 1 file changed, 9 insertions(+), 14 deletions(-) diff --git a/docs/integrations/microsoft/sso-saml.mdx b/docs/integrations/microsoft/sso-saml.mdx index 98da1906a..9bd900b7f 100644 --- a/docs/integrations/microsoft/sso-saml.mdx +++ b/docs/integrations/microsoft/sso-saml.mdx @@ -48,17 +48,16 @@ To integrate ngrok with Entra ID SSO, you will need to: 1. Enter in temporary values for "Identifier" and "Reply URL" and modify the value of "Unique User Identifier" to equal "user.mail". 1. **Identifier (Entity ID)** : https://temporary 1. **Reply URL (Assertion Consumer Service URL)** : https://temporary - 1. **Unique User Identifier** : user.mail -:::tip Note -This value can differ based upon setup, it is required that this user property value is an email address -::: + 1. **Unique User Identifier** : user.mail + :::tip Note + This value can differ based upon setup, it is required that this user property value is an email address + ::: ![enter temporary values](img/entra-saml-temp.png) ### Download the IdP metadata -1. From within the **Single sign-on** section on the ngrok Dashboard app, click on the **Download** option for **Federation Metadata XML**. Download the metadata XML. - +1. From within the **Single sign-on** section on the ngrok Dashboard app, click on the **Download** option for **Federation Metadata XML**. Download the metadata XML. ### Grant access to users and groups @@ -76,22 +75,18 @@ To configure ngrok Dashboard SSO with Entra ID: 1. Go to the [ngrok Dashboard](https://dashboard.ngrok.com). 1. Click **Settings** > **Account** 1. Within the **Single Sign-On (SSO)** section, click **New Identity Provider** > **New SAML Provider** -![create IdP](img/entra-new-idp.png) + ![create IdP](img/entra-new-idp.png) 1. On the SAML Provider settings, provide a **Description** and click **Upload XML** 1. Select your metadata file saved from the steps above and **Save** 1. After you save, the SP Metadata will appear. Copy these values into the Entra ID ngrok Dashboard app **Single sign-on** settings where temporary values were placed above: ![Update Entra with SP values](img/entra-6.png) 1. Save the changes in Entra ID. - - ## Step 3: Test the integration {#test-sso} 1. Navigate to the Entra ID ngrok Dashboard app **Single sign-on** settings. 1. Scroll to the bottom of the settings and click **Test** > **Test sign in** 1. You should be redirected to the ngrok Dashboard. - 1. If the current user is not a member of the ngrok account and JIT is enabled, the user will be prompted to join. - ![SSO JIT Prompt](img/entra-7.png) - 1. If the current user is already a member, they will be successfully authenticated into the ngrok Dashboard. - - + 1. If the current user is not a member of the ngrok account and JIT is enabled, the user will be prompted to join. + ![SSO JIT Prompt](img/entra-7.png) + 1. If the current user is already a member, they will be successfully authenticated into the ngrok Dashboard.