Microsoft Entra Verified ID-Netzwerk-API
Mit der Microsoft Entra Verified ID Network-API können Sie im Microsoft Entra Verified ID Networknach veröffentlichten Anmeldeinformationen suchen.
Anmerkung
Die API ist für Entwickler vorgesehen, die mit RESTful-APIs vertraut sind.
Basis-URL
Die Microsoft Entra ID Verified Network API wird über HTTPS bereitgestellt. Alle URLs, auf die in der Dokumentation verwiesen wird, haben die folgende Basis: https://verifiedid.did.msidentity.com
.
Authentifizierung
Die API ist über die Microsoft Entra-ID geschützt und verwendet OAuth2-Bearertoken. Die App-Registrierung muss über die API-Berechtigung für Verifiable Credentials Service Admin
verfügen und beim Abrufen des Zugriffstokens sollte die App den Bereich 6a8b4b39-c021-437c-b060-5a14a3fd65f3/full_access
verwenden.
Suchen nach Ausstellern
Diese API wird verwendet, um nach Ausstellern zu suchen, die im Microsoft Entra Verified ID Network verfügbar sind. Sie können nach Ausstellern anhand ihrer verknüpften Domäne Namen suchen. Der für den Parameter filter
angegebene Wert wird verwendet, um Aussteller zu finden, die in Microsoft Entra Verified ID integriert sind und über eine überprüfte verknüpfte Domäne verfügen. Derzeit können Sie nur nach linkeddomainurls
und mit Operator-like
filtern. Es gibt maximal 15 Aussteller in der Antwort.
HTTP-Anforderung
GET /v1.0/verifiableCredentialsNetwork/authorities?filter=linkeddomainurls%20like%20Woodgrove
Anforderungsheader
Kopfball | Wert |
---|---|
Ermächtigung | Bearer (Token). Erforderlich |
Inhaltstyp | application/json |
Anforderungsparameter
Parameter | Wert |
---|---|
Filter | linkeddomainurls wie Woodgrove |
Nachricht zurückgeben
HTTP/1.1 200 OK
Content-type: application/json
[
{
"id": "00aa00aa-bb11-cc22-dd33-44ee44ee44ee",
"tenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
"did": "did:web:bank.woodgrove.com...<SNIP>...",
"name": "WoodgroveBank",
"linkedDomainUrls": [
"https://bank.woodgrove.com/"
]
},
{
"id": "00aa00aa-bb11-cc22-dd33-44ee44ee44ee",
"tenantId": "bbbbcccc-1111-dddd-2222-eeee3333ffff",
"did": "did:web:woodgrove.com...<SNIP>...",
"name": "Woodgrove",
"linkedDomainUrls": [
"https://woodgrove.com/"
]
}
]
Suchen nach veröffentlichten Anmeldeinformationstypen durch einen Aussteller
Diese API wird verwendet, um nach veröffentlichten Anmeldeinformationstypen für einen bestimmten Aussteller zu suchen. Sie müssen die Aussteller tenantId
und issuerId
kennen. Die Rückgabenachricht ist eine Sammlung veröffentlichter Anmeldeinformationstypen und deren jeweiligen Ansprüche. Es gibt maximal 100 Anmeldeinformationstypen in der Antwort.
HTTP-Anforderung
GET /v1.0/tenants/:tenantId/verifiableCredentialsNetwork/authorities/:issuerId/contracts/
Anforderungsheader
Kopfball | Wert |
---|---|
Ermächtigung | Bearer (Token). Erforderlich |
Inhaltstyp | application/json |
Anforderungsparameter
Parameter | Wert |
---|---|
tenantId | TenantId, die von der Suche anhand des verknüpften Domänennamens abgerufen wurde |
issuerId | IssuerId, die von der Suche anhand des verknüpften Domänennamens abgerufen wurde |
Nachricht zurückgeben
HTTP/1.1 200 OK
Content-type: application/json
[
{
"name": "Verified employee 1",
"types": [
"VerifiedEmployee"
],
"claims": [
"displayName",
"givenName",
"jobTitle",
"preferredLanguage",
"surname",
"mail",
"revocationId",
"photo"
]
}
]
Nächste Schritte
Erfahren Sie mehr über Microsoft Entra Verified ID Network.