Skip to content

Commit 4f28fe3

Browse files
authored
Merge pull request #189636 from barclayn/vc-tenant-update
replacing images
2 parents 06abf0f + 61a2e98 commit 4f28fe3

File tree

4 files changed

+23
-7
lines changed

4 files changed

+23
-7
lines changed
Loading
Loading

articles/active-directory/verifiable-credentials/verifiable-credentials-configure-tenant.md

Lines changed: 23 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ author: barclayn
77
manager: karenhoran
88
ms.author: barclayn
99
ms.topic: tutorial
10-
ms.date: 10/08/2021
10+
ms.date: 02/24/2022
1111
# Customer intent: As an enterprise, we want to enable customers to manage information about themselves by using verifiable credentials.
1212

1313
---
@@ -31,7 +31,7 @@ The following diagram illustrates the Azure AD Verifiable Credentials architectu
3131

3232
![Diagram that illustrates the Azure AD Verifiable Credentials architecture.](media/verifiable-credentials-configure-tenant/verifiable-credentials-architecture.png)
3333

34-
See a [video walkthrough](https://www.youtube.com/watch?v=8jqjHjQo-3c) of setting up the Azure AD Verifiable Credential service, including all prerequisites, like Azure AD and an Azure subscription.
34+
See a [video walkthrough](https://www.youtube.com/watch?v=8jqjHjQo-3c) going over the setup of the Azure AD Verifiable Credential service.
3535

3636
## Prerequisites
3737

@@ -82,6 +82,8 @@ After you create your key vault, Verifiable Credentials generates a set of keys
8282
8383
A Key Vault [access policy](../../key-vault/general/assign-access-policy.md) defines whether a specified security principal can perform operations on Key Vault secrets and keys. Set access policies in your key vault for both the administrator account of the Azure AD Verifiable Credentials service, and for the Request Service API principal that you created.
8484
85+
### Set access policies for the Verifiable Credentials Admin user
86+
8587
1. In the [Azure portal](https://portal.azure.com/), go to the key vault you use for this tutorial.
8688
8789
1. Under **Settings**, select **Access policies**.
@@ -94,20 +96,34 @@ A Key Vault [access policy](../../key-vault/general/assign-access-policy.md) def
9496
9597
1. To save the changes, select **Save**.
9698
99+
### Set access policies for the Verifiable Credentials Issuer and Request services
100+
97101
1. Select **+ Add Access Policy** to add permission to the service principal of the **Verifiable Credential Request Service**.
98102
99103
1. In **Add access policy**:
100104
101105
1. For **Key permissions**, select **Get** and **Sign**.
102106
103-
1. For **Secret permissions**, select **Get**.
104-
105107
1. For **Select principal**, select **Verifiable Credential Request Service**.
106108
107109
1. Select **Add**.
108110
109-
![Screenshot that demonstrates how to add an access policy for the Verifiable Credential Request Service.](media/verifiable-credentials-configure-tenant/set-key-vault-service-principal-access-policy.png)
111+
:::image type="content" source="media/verifiable-credentials-configure-tenant/request-service-key-vault-access-policy.png" alt-text="Screenshot that demonstrates how to add an access policy for the Verifiable Credential Issuer Service." :::
112+
113+
The access policies for the Verifiable Credentials Issuer service should be added automatically. If the **Verifiable Credential Issuer Service** doesn't appear in the list of access policies, take the following steps to manually add access policies to the service.
114+
115+
1. Select **+ Add Access Policy** to add permission to the service principal of the **Verifiable Credential Issuer Service**.
116+
117+
1. In **Add access policy**:
118+
119+
1. For **Key permissions**, select **Get** and **Sign**.
120+
121+
1. For **Select principal**, select **Verifiable Credential Issuer Service**.
122+
123+
1. Select **Add**.
110124
125+
:::image type="content" source="media/verifiable-credentials-configure-tenant/issuer-service-key-vault-access-policy.png" alt-text="Screenshot that demonstrates how to add an access policy for the Verifiable Credential Request Service." :::
126+
111127
1. Select **Save** to save the new policy you created.
112128
113129
## Register an application in Azure AD
@@ -166,7 +182,7 @@ To set up Azure AD Verifiable Credentials, follow these steps:
166182
167183
1. **Organization name**: Enter a name to reference your business within Verifiable Credentials. Your customers don't see this name.
168184
169-
1. **Domain**: Enter a domain that's added to a service endpoint in your decentralized identity (DID) document. The domain is what binds your DID to something tangible that the user might know about your business. Microsoft Authenticator and other digital wallets use this information to validate that your DID is linked to your domain. If the wallet can verify the DID, it displays a verified symbol. If the wallet can't verify the DID, it informs the user that the credential was issued by an organization it couldn't validate.
185+
1. **Domain**: Enter a domain that's added to a service endpoint in your decentralized identity (DID) document. The domain is what binds your DID to something tangible that the user might know about your business. Microsoft Authenticator and other digital wallets use this information to validate that your DID is linked to your domain. If the wallet can verify the DID, it displays a verified symbol. If the wallet can't verify the DID, it informs the user that the credential was issued by an organization it couldn't validate.
170186
171187
>[!IMPORTANT]
172188
> The domain can't be a redirect. Otherwise, the DID and domain can't be linked. Make sure to use HTTPS for the domain. For example: `https://contoso.com`.
@@ -180,4 +196,4 @@ To set up Azure AD Verifiable Credentials, follow these steps:
180196
## Next steps
181197
182198
- [Learn how to issue Azure AD Verifiable Credentials from a web application](verifiable-credentials-configure-issuer.md).
183-
- [Learn how to verify Azure AD Verifiable Credentials](verifiable-credentials-configure-verifier.md).
199+
- [Learn how to verify Azure AD Verifiable Credentials](verifiable-credentials-configure-verifier.md).

0 commit comments

Comments
 (0)