Skip to content

Commit

Permalink
Revise and simplify IdP Sync setup documentation (#131)
Browse files Browse the repository at this point in the history
  • Loading branch information
bcmmbaga authored Jan 17, 2024
1 parent c1aa673 commit 87e607b
Show file tree
Hide file tree
Showing 7 changed files with 6 additions and 44 deletions.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file modified public/docs-static/img/how-to-guides/azure-new-application.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file not shown.
50 changes: 6 additions & 44 deletions src/pages/how-to/idp-sync.mdx
Original file line number Diff line number Diff line change
@@ -1,3 +1,5 @@
export const title = 'IdP Sync'

## IdP sync

Welcome to our comprehensive guide on configuring Identity Provider (IdP) for users and groups synchronization. This document provides step-by-step instructions and best practices for setting up and managing your synchronization processes effectively.
Expand Down Expand Up @@ -81,48 +83,13 @@ Before you start creating and configuring an Azure AD application, ensure that y
- Click `App Registrations` in the left menu then click on the `+ New registration` button to create a new application.
- Fill in the form with the following values and click `Register`
- Name: `NetBird`
- Account Types: `Accounts in this organizational directory only (Default Directory only - Single tenant)`
- Redirect URI: select `Single-page application (SPA)` and URI as `https://app.netbird.io/silent-auth`

<p>
<img src="/docs-static/img/how-to-guides/azure-new-application.png" alt="azure-new-application"/>
</p>


#### Step 2. Platform configurations
- Click `Authentication` on the left side menu
- Under the `Single-page application` Section, add another URI `https://app.netbird.io/auth` and click `Save`

<p>
<img src="/docs-static/img/how-to-guides/azure-spa-uri-setup.png" alt="azure-spa-uri-setup" />
</p>


#### Step 3. Create a NetBird application scope
- Click `Expose an API` on the left menu
- In `Application ID URI` click `Add` and then `Save`
<p>
<img src="/docs-static/img/how-to-guides/azure-add-application-uri.png" alt="azure-add-application-uri" />
</p>

- Under `Scopes defined by this API` click `+ Add a Scope`
- Fill in the form with the following values and click `Add scope`
- Scope name: `api`
- State: `Enabled`

<p>
<img src="/docs-static/img/how-to-guides/azure-add-scope.png" alt="azure-add-scope" />
</p>

- Under `Authorized client Applications`, click on `+ add a client application` and enter the following:
- Fill in the form with the following values and click `Add application`
- Client ID: same as your Application ID URI minus the `api://`

<p>
<img src="/docs-static/img/how-to-guides/azure-authorize-application.png" alt="azure-authorize-application" />
</p>

#### Step 4. Add API permissions
#### Step 2. Add API permissions

- Click `API permissions` on the left menu
- Click `Add a permission`
Expand All @@ -133,18 +100,13 @@ Before you start creating and configuring an Azure AD application, ensure that y
<img src="/docs-static/img/how-to-guides/azure-openid-permissions.png" alt="azure-openid-permissions" />
</p>

- Click `Grant admin conset for Default Directory` and click `Yes`
- Click `Grant admin consent for Default Directory` and click `Yes`

<p>
<img src="/docs-static/img/how-to-guides/azure-grant-admin-conset.png" alt="azure-grant-admin-conset"/>
<img src="/docs-static/img/how-to-guides/azure-grant-admin-consent.png" alt="azure-grant-admin-consent"/>
</p>

#### Step 5. Update token version
- Click `Manifest` on left menu
- Search for `accessTokenAcceptedVersion` and change the value from `null` to `2`
- Click `Save`

#### Step 6. Generate client secret
#### Step 3. Generate client secret
- Click `Certificates & secrets` on left menu
- Click `New client secret`
- Fill in the form with the following values and click `Add`
Expand Down

0 comments on commit 87e607b

Please sign in to comment.