1
0
mirror of https://github.com/bitwarden/help synced 2025-12-16 08:13:28 +00:00

Update Azure directory connector documentation (#79)

Co-authored-by: BitwardenLuc <59910153+BitwardenLuc@users.noreply.github.com>
This commit is contained in:
Luc
2020-03-19 10:08:57 -07:00
committed by GitHub
parent 0bdea8cf76
commit 66f8a1b2d6
8 changed files with 11 additions and 14 deletions

View File

@@ -31,22 +31,19 @@ This article will cover how to connect the Bitwarden Directory Connector applica
1. Go to <https://portal.azure.com> 1. Go to <https://portal.azure.com>
2. Select the **Azure Active Directory** resource 2. Select the **Azure Active Directory** resource
3. Navigate to **App registrations** and select **New application registration** 3. Navigate to **App registrations** and select **New registration**
{% image directory-connector/azure/new-application.png %} {% image directory-connector/azure/new-application.png %}
4. **Name** your application "Bitwarden" 4. **Name** your application "Bitwarden"
5. Set the **Application type** to "Web app / API" 5. Click the **Create** button to create the application.
6. Set the **Sign-on URL** to any website value, such as "https://example.com". This URL is not used in this setup process so it can be anything.
7. Click the **Create** button to create the application.
{% image directory-connector/azure/create-application.png %} {% image directory-connector/azure/create-application.png %}
## Grant Application Permissions ## Grant Application Permissions
1. Select the **Bitwarden** application you created in the previous section. 1. Select the **Bitwarden** application you created in the previous section.
2. Navigate to **Settings** and select **Required Permissions**. 2. Select **API Permissions**.
3. Delete the existing **Windows Azure Active Directory** API permission set that is automatically created by default. It is not needed. 3. Select the **Add** button to create a new API permission set.
5. Select the **Add** button to create a new API permission set. 4. For step 1, **Select an API** for **Microsoft Graph**.
6. For step 1, **Select an API** for **Microsoft Graph**. 5. For step 2, **Select Permissions** for the following:
7. For step 2, **Select Permissions** for the following:
- Application Permissions: - Application Permissions:
- "Read all users' full profiles" - "Read all users' full profiles"
- "Read all groups" - "Read all groups"
@@ -54,15 +51,15 @@ This article will cover how to connect the Bitwarden Directory Connector applica
- "Read all groups" - "Read all groups"
- "Read all users' full profiles" - "Read all users' full profiles"
- "Read all users basic profiles" - "Read all users basic profiles"
8. Click the **Select** button and then **Done** to add the Microsoft Graph API permissions. 6. Click the **Select** button and then **Done** to add the Microsoft Graph API permissions.
{% image directory-connector/azure/graph-permissions.png %} {% image directory-connector/azure/graph-permissions.png %}
9. Click the **Grant Permissions** button to grant the permissions to the application. 7. Click the **Grant Permissions** button to grant the permissions to the application.
{% image directory-connector/azure/grant-permissions.png %} {% image directory-connector/azure/grant-permissions.png %}
## Create Application Secret Key ## Create Application Secret Key
1. Go back to the **Bitwarden** application that you created. 1. Go back to the **Bitwarden** application that you created.
2. Navigate to **Settings** and select **Keys**. 2. Select **Certificates & Keys**.
3. Add a new **Password** key by entering a **Name** and **Duration**. We recommend selecting "Never Expires" for the duration. 3. Add a new **Password** key by entering a **Name** and **Duration**. We recommend selecting "Never Expires" for the duration.
4. Click **Save** to create a new secret key. 4. Click **Save** to create a new secret key.
5. Copy the key's value to safe place. We will need to reference it later. 5. Copy the key's value to safe place. We will need to reference it later.
@@ -71,13 +68,13 @@ This article will cover how to connect the Bitwarden Directory Connector applica
## Get Your Application ID ## Get Your Application ID
1. Go back to the **Bitwarden** application that you created. 1. Go back to the **Bitwarden** application that you created.
2. Copy the **Application ID** to a safe place. We will need to reference it later. 2. Copy the **Application (client) ID** to a safe place. We will need to reference it later.
{% image directory-connector/azure/application-id.png %} {% image directory-connector/azure/application-id.png %}
## Get Your Tenant Hostname ## Get Your Tenant Hostname
1. Select the **Directory and Subscription** filter in the top right corner of the Azure Portal. 1. Select the **Directory and Subscription** filter in the top right corner of the Azure Portal.
2. Note the **hostname** value that appears under your directory (ex. company.onmicrosoft.com). This is your **Tenant** hostname. Copy the **Tenant** hostname to a safe place. We will need to reference it later. 2. Note the **Current directory** (ex. acmeinc.onmicrosoft.com). This is your **Tenant** hostname. Copy the **Tenant** hostname to a safe place. We will need to reference it later.
{% image directory-connector/azure/tenant.png %} {% image directory-connector/azure/tenant.png %}
## Configure Directory Connector ## Configure Directory Connector

Binary file not shown.

Before

Width:  |  Height:  |  Size: 28 KiB

After

Width:  |  Height:  |  Size: 106 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 35 KiB

After

Width:  |  Height:  |  Size: 69 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 9.9 KiB

After

Width:  |  Height:  |  Size: 112 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 61 KiB

After

Width:  |  Height:  |  Size: 118 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 15 KiB

After

Width:  |  Height:  |  Size: 94 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 47 KiB

After

Width:  |  Height:  |  Size: 99 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 20 KiB

After

Width:  |  Height:  |  Size: 26 KiB