Skip to content

Commit 818357e

Browse files
Merge pull request #220281 from whhender/freshness-review
Review
2 parents 3553fa6 + 10f692d commit 818357e

File tree

1 file changed

+40
-27
lines changed

1 file changed

+40
-27
lines changed

articles/purview/create-service-principal-azure.md

Lines changed: 40 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ ms.author: athenadsouza
66
ms.service: purview
77
ms.subservice: purview-data-catalog
88
ms.topic: how-to
9-
ms.date: 09/15/2021
9+
ms.date: 12/02/2022
1010
# Customer intent: As an Azure AD Global Administrator or other roles such as Application Administrator, I need to create a new service principal, in order to register an application in the Azure AD tenant.
1111
ms.custom: ignite-fall-2021
1212
---
@@ -18,49 +18,62 @@ You can create a new or use an existing service principal in your Azure Active D
1818
## App registration
1919

2020
1. Navigate to the [Azure portal](https://portal.azure.com).
21-
2. Select **Azure Active Directory** from the left-hand side menu.
22-
:::image type="content" source="media/create-service-principal-azure/create-service-principal-azure-aad.png" alt-text="Screenshot that shows the link to the Azure Active Directory":::
21+
1. Select **Azure Active Directory** from the left-hand side menu.
2322

24-
3. Select **App registrations** and **+ New registration**
25-
:::image type="content" source="media/create-service-principal-azure/create-service-principal-azure-new-reg.png" alt-text="Screenshot that shows the link to New registration":::
23+
:::image type="content" source="media/create-service-principal-azure/create-service-principal-azure-aad.png" alt-text="Screenshot that shows the link to the Azure Active Directory.":::
2624

27-
4. Enter a name for the **application** (the service principal name).
25+
1. Select **App registrations** and **+ New registration**
2826

29-
5. Select **Accounts in this organizational directory only**.
27+
:::image type="content" source="media/create-service-principal-azure/create-service-principal-azure-new-reg.png" alt-text="Screenshot that shows the link to New registration.":::
3028

31-
6. For **Redirect URI** select **Web** and enter any URL you want; it doesn't have to be real or work.
29+
1. Enter a name for the **application** (the service principal name).
3230

33-
7. Then select **Register**.
34-
:::image type="content" source="media/create-service-principal-azure/create-service-principal-azure-register.png" alt-text="Screenshot that shows the details for the new app registration":::
35-
:::image type="content" source="media/create-service-principal-azure/create-service-principal-azure-new-app.png" alt-text="Screenshot that shows the newly created application":::
31+
1. Select **Accounts in this organizational directory only**.
32+
33+
1. For **Redirect URI** select **Web** and enter any URL you want; it doesn't have to be real or work.
34+
35+
1. Then select **Register**.
36+
37+
:::image type="content" source="media/create-service-principal-azure/create-service-principal-azure-register.png" alt-text="Screenshot that shows the details for the new app registration.":::
38+
39+
:::image type="content" source="media/create-service-principal-azure/create-service-principal-azure-new-app.png" alt-text="Screenshot that shows the newly created application.":::
3640

3741
## Adding a secret to the client credentials
3842

3943
1. Select the app from the **App registrations**
40-
:::image type="content" source="media/create-service-principal-azure/create-service-principal-azure-app-select.png" alt-text="Screenshot that shows the app for registration":::
4144

42-
2. Click on the **Add a certificate or secret**
43-
:::image type="content" source="media/create-service-principal-azure/create-service-principal-azure-add-secret.png" alt-text="Screenshot that shows the app ":::
45+
:::image type="content" source="media/create-service-principal-azure/create-service-principal-azure-app-select.png" alt-text="Screenshot that shows the app for registration.":::
46+
47+
1. Select **Add a certificate or secret**
48+
49+
:::image type="content" source="media/create-service-principal-azure/create-service-principal-azure-add-secret.png" alt-text="Screenshot that shows the app.":::
4450

45-
3. Click on the **+ New client secret** under **Client secrets**
46-
:::image type="content" source="media/create-service-principal-azure/create-service-principal-azure-new-client-secret.png" alt-text="Screenshot that shows the client secret menu":::
51+
1. Select **+ New client secret** under **Client secrets**
4752

48-
4. Provide a **Description** and set the **Expires** for the secret
49-
:::image type="content" source="media/create-service-principal-azure/create-service-principal-azure-secret-desc.png" alt-text="Screenshot that shows the client secret details":::
50-
:::image type="content" source="media/create-service-principal-azure/create-service-principal-azure-client-secret.png" alt-text="Screenshot that shows the client secret":::
53+
:::image type="content" source="media/create-service-principal-azure/create-service-principal-azure-new-client-secret.png" alt-text="Screenshot that shows the client secret menu.":::
5154

52-
5. Copy the value of **Client credentials** from **Overview**
53-
:::image type="content" source="media/create-service-principal-azure/create-service-principal-azure-client-cred.png" alt-text="Screenshot that shows the app Overview":::
55+
1. Provide a **Description** and set the **Expires** for the secret
56+
57+
:::image type="content" source="media/create-service-principal-azure/create-service-principal-azure-secret-desc.png" alt-text="Screenshot that shows the client secret details.":::
58+
59+
:::image type="content" source="media/create-service-principal-azure/create-service-principal-azure-client-secret.png" alt-text="Screenshot that shows the client secret.":::
60+
61+
1. Copy the value of **Client credentials** from **Overview**
62+
63+
:::image type="content" source="media/create-service-principal-azure/create-service-principal-azure-client-cred.png" alt-text="Screenshot that shows the app Overview.":::
5464

5565
## Adding the secret to the key vault
5666

5767
1. Navigate to your **Key vault**
58-
:::image type="content" source="media/create-service-principal-azure/create-service-principal-azure-key-vault.png" alt-text="Screenshot that shows the Key vault":::
5968

60-
2. Select **Settings** --> **Secrets** --> **+ Generate/Import**
61-
:::image type="content" source="media/create-service-principal-azure/create-service-principal-azure-generate-secret.png" alt-text="Screenshot that options in the Key vault":::
69+
:::image type="content" source="media/create-service-principal-azure/create-service-principal-azure-key-vault.png" alt-text="Screenshot that shows the Key vault.":::
70+
71+
1. Select **Settings** --> **Secrets** --> **+ Generate/Import**
72+
73+
:::image type="content" source="media/create-service-principal-azure/create-service-principal-azure-generate-secret.png" alt-text="Screenshot that options in the Key vault.":::
6274

63-
3. Enter the **Name** of your choice and **Value** as the **Client secret** from your Service Principal
64-
:::image type="content" source="media/create-service-principal-azure/create-service-principal-azure-sp-secret.png" alt-text="Screenshot that shows the Key vault to create a secret":::
75+
1. Enter the **Name** of your choice and **Value** as the **Client secret** from your Service Principal
76+
77+
:::image type="content" source="media/create-service-principal-azure/create-service-principal-azure-sp-secret.png" alt-text="Screenshot that shows the Key vault to create a secret.":::
6578

66-
4. Select **Create** to complete
79+
1. Select **Create** to complete

0 commit comments

Comments
 (0)