You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/active-directory/verifiable-credentials/how-to-dnsbind.md
+8-11Lines changed: 8 additions & 11 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -33,9 +33,9 @@ A DID starts out as an identifier that isn't anchored to existing systems. A DID
33
33
34
34
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.
35
35
36
-
## When do we need to manage linked domains?
36
+
## When do you need to update the domain in your DID?
37
37
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.
39
39
40
40
## How do we link DIDs and domains?
41
41
@@ -78,7 +78,7 @@ After you have the well-known configuration file, you need to make the file avai
78
78
>[!IMPORTANT]
79
79
>Microsoft Authenticator does not honor redirects, the URL specified must be the final destination URL.
80
80
81
-
## User experience
81
+
## User experience in the wallet
82
82
83
83
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.
84
84
@@ -107,33 +107,30 @@ It is of high importance that you link your DID to a domain recognizable to the
107
107
108
108

109
109
110
-
## How do you change a linked domain?
110
+
## How do you update the linked domain on your DID?
111
111
112
112
1. Navigate to the Verifiable Credentials | Getting Started page.
113
113
1. On the left side of the page select **Domain**.
114
114
1. In the Domain box, enter your new domain name.
115
-
1. Choose **Publish**.
115
+
1. Select **Publish**.
116
116
117
117
:::image type="content" source="media/how-to-dnsbind/publish-update-domain.png" alt-text="Choose the publish button so your changes become":::
118
118
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
+
119
121
>[!NOTE]
120
122
>If your changes are successful you will need to [verify](#verified-domain) your newly added domain.
121
123
122
124
123
125
:::image type="content" source="media/how-to-dnsbind/verification.png" alt-text="You need to verify your domain once that the publishing process completes":::
124
126
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
-
130
127
### Do I need to wait for my DID Doc to be updated to verify my newly added domains?
131
128
132
129
Yes. You need to wait until the config.json file gets updated before you publish it using your domain's hosting location.
133
130
134
131
### How do I know when the linked domain update has successfully completed?
135
132
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.
137
134
138
135
>[!IMPORTANT]
139
136
> No changes to your domain are possible while publishing is in progress.
0 commit comments