Skip to content

Commit

Permalink
Update sso-saml.mdx
Browse files Browse the repository at this point in the history
ran through prettier
  • Loading branch information
mkarnowski authored and russorat committed Nov 28, 2023
1 parent 3ab596c commit a25c4ae
Showing 1 changed file with 9 additions and 14 deletions.
23 changes: 9 additions & 14 deletions docs/integrations/microsoft/sso-saml.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand All @@ -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.

1 comment on commit a25c4ae

@vercel
Copy link

@vercel vercel bot commented on a25c4ae Nov 28, 2023

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Successfully deployed to the following URLs:

ngrok-docs – ./

ngrok-docs-ngrok-dev.vercel.app
ngrok-docs.vercel.app
ngrok-docs-git-main-ngrok-dev.vercel.app

Please sign in to comment.