Skip to content

Commit 8af9bbe

Browse files
Merge pull request #208245 from cljung/cljung-vc-post-ga-08
Update post GA per 18 Aug
2 parents 10eb127 + 7d926ad commit 8af9bbe

File tree

6 files changed

+28
-7
lines changed

6 files changed

+28
-7
lines changed

articles/active-directory/verifiable-credentials/admin-api.md

Lines changed: 11 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -827,13 +827,23 @@ The response contains the following properties
827827

828828
| Property | Type | Description |
829829
| -------- | -------- | -------- |
830-
|`attestations`| [idTokenAttestation](#idtokenattestation-type) or [idTokenHintAttestation](#idtokenhintattestation-type) and/or [verifiablePresentationAttestation](#verifiablepresentationattestation-type) and/or [selfIssuedAttestation](#selfissuedattestation-type) and/or [accessTokenAttestation](#accesstokenattestation-type) (array) | describing supported inputs for the rules |
830+
|`attestations`| [attestions](#attestations-type)| describing supported inputs for the rules |
831831
|`validityInterval` | number | this value shows the lifespan of the credential |
832832
|`vc`| vcType array | types for this contract |
833833
|`customStatusEndpoint`| [customStatusEndpoint] (#customstatusendpoint-type) (optional) | status endpoint to include in the verifiable credential for this contract |
834834

835835
If the property `customStatusEndpoint` property isn't specified then the `anonymous` status endpoint is used.
836836

837+
#### attestations type
838+
839+
| Property | Type | Description |
840+
| -------- | -------- | -------- |
841+
|`idTokens`| [idTokenAttestation](#idtokenattestation-type) (array) (optional) | describes id token inputs|
842+
|`idTokenHints`| [idTokenHintAttestation](#idtokenhintattestation-type) (array) (optional) | describes id token hint inputs |
843+
|`presentations`| [verifiablePresentationAttestation](#verifiablepresentationattestation-type) (array) (optional) | describes verifiable presentations inputs |
844+
|`selfIssued`| [selfIssuedAttestation](#selfissuedattestation-type) (array) (optional) | describes self issued inputs |
845+
|`accessTokens`| [accessTokenAttestation](#accesstokenattestation-type) (array) (optional) | describes access token inputs |
846+
837847
#### idTokenAttestation type
838848

839849
| Property | Type | Description |

articles/active-directory/verifiable-credentials/decentralized-identifier-overview.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -80,10 +80,10 @@ In order to be able to resolve DID documents, DIDs are typically recorded on an
8080
Enables real people to use decentralized identities and Verifiable Credentials. Authenticator creates DIDs, facilitates issuance and presentation requests for verifiable credentials and manages the backup of your DID's seed through an encrypted wallet file.
8181

8282
**4. Microsoft Resolver**.
83-
An API that connects to our ION node to look up and resolve DIDs using the ```did:ion``` method and return the DID Document Object (DDO). The DDO includes DPKI metadata associated with the DID such as public keys and service endpoints.
83+
An API that look up and resolve DIDs using the ```did:web``` or the ```did:ion``` methods and return the DID Document Object (DDO). The DDO includes DPKI metadata associated with the DID such as public keys and service endpoints.
8484

85-
**5. Azure Active Directory Verified Credentials Service**.
86-
An issuance and verification service in Azure and a REST API for [W3C Verifiable Credentials](https://www.w3.org/TR/vc-data-model/) that are signed with the ```did:ion``` method. They enable identity owners to generate, present, and verify claims. This forms the basis of trust between users of the systems.
85+
**5. Entra Verified ID Service**.
86+
An issuance and verification service in Azure and a REST API for [W3C Verifiable Credentials](https://www.w3.org/TR/vc-data-model/) that are signed with the ```did:web``` or the ```did:ion``` method. They enable identity owners to generate, present, and verify claims. This forms the basis of trust between users of the systems.
8787

8888
## A sample scenario
8989

articles/active-directory/verifiable-credentials/introduction-to-verifiable-credentials-architecture.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: Azure Active Directory architecture overview
2+
title: Microsoft Entra Verified ID architecture overview
33
description: Learn foundational information to plan and design your solution
44
documentationCenter: ''
55
author: barclayn

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

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -40,7 +40,7 @@ The following diagram illustrates the Microsoft Entra Verified ID architecture a
4040
- To clone the repository that hosts the sample app, install [GIT](https://git-scm.com/downloads).
4141
- [Visual Studio Code](https://code.visualstudio.com/Download), or similar code editor.
4242
- [.NET 5.0](https://dotnet.microsoft.com/download/dotnet/5.0).
43-
- Download [ngrok](https://ngrok.com/) and sign up for a free account.
43+
- Download [ngrok](https://ngrok.com/) and sign up for a free account. If you can't use `ngrok` in your organization, please read this [FAQ](verifiable-credentials-faq.md#i-can-not-use-ngrok-what-do-i-do).
4444
- A mobile device with Microsoft Authenticator:
4545
- Android version 6.2206.3973 or later installed.
4646
- iOS version 6.6.2 or later installed.

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

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -35,7 +35,7 @@ In this article, you learn how to:
3535
- If you want to clone the repository that hosts the sample app, install [Git](https://git-scm.com/downloads).
3636
- [Visual Studio Code](https://code.visualstudio.com/Download) or similar code editor.
3737
- [.NET 5.0](https://dotnet.microsoft.com/download/dotnet/5.0).
38-
- Download [ngrok](https://ngrok.com/) and sign up for a free account.
38+
- Download [ngrok](https://ngrok.com/) and sign up for a free account. If you can't use `ngrok` in your organization, please read this [FAQ](verifiable-credentials-faq.md#i-can-not-use-ngrok-what-do-i-do).
3939
- A mobile device with Microsoft Authenticator:
4040
- Android version 6.2206.3973 or later installed.
4141
- iOS version 6.6.2 or later installed.

articles/active-directory/verifiable-credentials/verifiable-credentials-faq.md

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -127,6 +127,17 @@ Yes, after reconfiguring your service, your tenant has a new DID use to issue an
127127

128128
No, at this point it isn't possible to keep your tenant's DID after you have opt-out of the service.
129129

130+
### I can not use ngrok, what do I do?
131+
132+
The tutorials for deploying and running the [samples](verifiable-credentials-configure-issuer.md#prerequisites) describes the use of the `ngrok` tool as an application proxy. This tool is sometimes blocked by IT admins from being used in corporate networks. An alternative is to deploy the sample to [Azure AppServices](../../app-service/overview.md) and run it in the cloud. The following links helps you deploy the respective sample to Azure AppServices. The Free pricing tier will be sufficient for hosting the sample. For each tutorial, you need to start by first creating the Azure AppService instance, then skip creating the app since you already have an app and then continue the tutorial with deploying it.
133+
134+
- Dotnet - [Publish to AppServices](../../app-service/quickstart-dotnetcore.md?tabs=net60&pivots=development-environment-vs#publish-your-web-app)
135+
- Node - [Deploy to AppServices](../../app-service/quickstart-nodejs.md?tabs=linux&pivots=development-environment-vscode#deploy-to-azure)
136+
- Java - [Deploy to AppServices](../../app-service/quickstart-java.md?tabs=javase&pivots=platform-linux-development-environment-maven#4---deploy-the-app). You need to add the maven plugin for Azure AppServices to the sample.
137+
- Python - [Deploy using VSCode](../../app-service/quickstart-python.md?tabs=flask%2Cwindows%2Cazure-cli%2Cvscode-deploy%2Cdeploy-instructions-azportal%2Cterminal-bash%2Cdeploy-instructions-zip-azcli#3---deploy-your-application-code-to-azure)
138+
139+
Regardless of which language of the sample you are using, they will pickup the Azure AppService hostname (https://something.azurewebsites.net/) and use it as the public endpoint. You don't need to configure something extra to make it work. If you make changes to the code or configuration, you need to redeploy the sample to Azure AppServices. Troubleshooting/debugging will not be as easy as running the sample on your local machine, where traces to the console window shows you errors, but you can achieve almost the same by using the [Log Stream](../../app-service/troubleshoot-diagnostic-logs.md#stream-logs).
140+
130141
## Next steps
131142

132143
- [Customize your verifiable credentials](credential-design.md)

0 commit comments

Comments
 (0)