Microsoft Entra Verified ID-Netzwerk-API
Hinweis
Microsoft Entra Verified ID ist jetzt Teil der Microsoft Entra-Produktfamilie. Erfahren Sie mehr über die Microsoft Entra-Familie mit Lösungen für die Identitätsverwaltung, und beginnen Sie im einheitlichen Microsoft Entra Admin Center.
Mithilfe der Microsoft Entra Verified ID-Netzwerk-API können Sie im Microsoft Entra Verified ID-Netzwerk nach veröffentlichten Anmeldeinformationen suchen.
Hinweis
Die API ist für Entwickler vorgesehen, die mit RESTful-APIs vertraut sind.
Basis-URL
Die Microsoft Entra ID Verified-Netzwerk-API wird über HTTPS bereitgestellt. Alle in der Dokumentation referenzierten URLs verwenden die folgende Basis: https://verifiedid.did.msidentity.com
.
Authentifizierung
Die API ist durch 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 dann 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-Netzwerk verfügbar sind. Sie können anhand des Namens der verknüpften Domäne nach Ausstellern suchen. Der für den Parameter filter
angegebene Wert wird verwendet, um Aussteller zu ermitteln, die sich für Microsoft Entra Verified ID entschieden haben und über eine verifizierte verknüpfte Domäne verfügen. Derzeit können Sie nur nach linkeddomainurls
und mit dem Operator like
filtern. Die Zahl der Aussteller in der Antwort ist auf 15 begrenzt.
HTTP-Anforderung
GET /v1.0/verifiableCredentialsNetwork/authorities?filter=linkeddomainurls%20like%20Woodgrove
Anforderungsheader
Header | Wert |
---|---|
Authorization | Bearer (Token). Erforderlich |
Content-Type | Anwendung/json |
Anforderungsparameter
Parameter | value |
---|---|
filter | linkeddomainurls-Wert wie z. B. Woodgrove |
Antwortnachricht
HTTP/1.1 200 OK
Content-type: application/json
[
{
"id": "0459a193-1111-2222-3333-444455556666",
"tenantId": "55eafede-1111-2222-3333-444455556666",
"did": "did:web:bank.woodgrove.com...<SNIP>...",
"name": "WoodgroveBank",
"linkedDomainUrls": [
"https://bank.woodgrove.com/"
]
},
{
"id": "6e0e41cb-1111-2222-3333-444455556666",
"tenantId": "7f448f57-1111-2222-3333-444455556666",
"did": "did:web:woodgrove.com...<SNIP>...",
"name": "Woodgrove",
"linkedDomainUrls": [
"https://woodgrove.com/"
]
}
]
Suche nach veröffentlichten Anmeldeinformationstypen für einen Aussteller
Diese API dient der Suche nach veröffentlichten Berechtigungstypen für einen bestimmten Aussteller. Sie müssen die Aussteller tenantId
und issuerId
kennen. Die Antwortnachricht ist eine Sammlung der veröffentlichten Anmeldeinformationstypen und der zugehörigen Ansprüche. Die Zahl der Anmeldeinformationstypen in der Antwort ist auf 100 begrenzt.
HTTP-Anforderung
GET /v1.0/tenants/:tenantId/verifiableCredentialsNetwork/authorities/:issuerId/contracts/
Anforderungsheader
Header | Wert |
---|---|
Authorization | Bearer (Token). Erforderlich |
Content-Type | Anwendung/json |
Anforderungsparameter
Parameter | value |
---|---|
tenantId | Mandanten-ID, die bei der Suche nach dem Namen der verknüpften Domäne ermittelt wurde |
issuerId | Aussteller-ID, die bei der Suche nach dem Namen der verknüpften Domäne ermittelt wurde |
Antwortnachricht
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
Weitere Informationen finden Sie unter Microsoft Entra Verified ID-Netzwerk.