Skip to content

Commit 32c3cf8

Browse files
authored
Rewording
Final pass before publishing. Reworded it a bit
1 parent 393a4f9 commit 32c3cf8

File tree

1 file changed

+8
-11
lines changed

1 file changed

+8
-11
lines changed

articles/active-directory/verifiable-credentials/how-to-dnsbind.md

Lines changed: 8 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -33,9 +33,9 @@ A DID starts out as an identifier that isn't anchored to existing systems. A DID
3333

3434
Linking a DID to a domain solves the initial trust problem by allowing any entity to cryptographically verify the relationship between a DID and a Domain.
3535

36-
## When do we need to manage linked domains?
36+
## When do you need to update the domain in your DID?
3737

38-
Any situation that requires the domain associated with your company to change, like a company merger or a company rename, may mean that you need to manage your linked domain. Before, In either one of these situations would have required for you to opt out and back in. You no longer need to [opt out](how-to-opt-out.md) to make changes to your domain information. You can make changes to your domain through the Azure AD Portal. After you publish your changes, those changes are published to the ION network.
38+
In the event where the domain associated with your company changes, you would also need to change the domain in your DID document that is also published in the ION network. You can update the domain in your DID directly from the Azure AD Verifiable Credential portal.
3939

4040
## How do we link DIDs and domains?
4141

@@ -78,7 +78,7 @@ After you have the well-known configuration file, you need to make the file avai
7878
>[!IMPORTANT]
7979
>Microsoft Authenticator does not honor redirects, the URL specified must be the final destination URL.
8080

81-
## User experience
81+
## User experience in the wallet
8282

8383
When a user is going through an issuance flow or presenting a verifiable credential, they should know something about organization and its DID. Microsoft Authenticator, validates a DID's relationship with the domain in the DID document and presents users with two different experiences depending on the outcome.
8484

@@ -107,33 +107,30 @@ It is of high importance that you link your DID to a domain recognizable to the
107107

108108
![unverified domain warning in the add credential screen](media/how-to-dnsbind/add-credential-not-verified-authenticated.png)
109109

110-
## How do you change a linked domain?
110+
## How do you update the linked domain on your DID?
111111

112112
1. Navigate to the Verifiable Credentials | Getting Started page.
113113
1. On the left side of the page select **Domain**.
114114
1. In the Domain box, enter your new domain name.
115-
1. Choose **Publish**.
115+
1. Select **Publish**.
116116

117117
:::image type="content" source="media/how-to-dnsbind/publish-update-domain.png" alt-text="Choose the publish button so your changes become":::
118118

119+
It might take up to two hours for your DID document to be updated in the [ION network](https://identity.foundation/ion) with the new domain information. No other changes to the domain are possible before the changes are published.
120+
119121
>[!NOTE]
120122
>If your changes are successful you will need to [verify](#verified-domain) your newly added domain.
121123

122124

123125
:::image type="content" source="media/how-to-dnsbind/verification.png" alt-text="You need to verify your domain once that the publishing process completes":::
124126

125-
126-
>[!IMPORTANT]
127-
> No changes to the domain are possible before the changes are confirmed as published and live in the [ION network](https://identity.foundation/ion/).
128-
129-
130127
### Do I need to wait for my DID Doc to be updated to verify my newly added domains?
131128

132129
Yes. You need to wait until the config.json file gets updated before you publish it using your domain's hosting location.
133130

134131
### How do I know when the linked domain update has successfully completed?
135132

136-
Today, we're unable to tel you exactly when your domain link change will complete. We know that the publishing process may take up to two hours.
133+
Once the domain changes are publised to ION, the domain section inside the Azure AD Verifiable Credentials service will display `Published` as the status and you should be able to make new changes to the domain.
137134

138135
>[!IMPORTANT]
139136
> No changes to your domain are possible while publishing is in progress.

0 commit comments

Comments
 (0)