Microsoft Entra Ellenőrzött azonosító hálózati API
A Microsoft Entra Ellenőrzött azonosító Network API lehetővé teszi a közzétett hitelesítő adatok keresését a Microsoft Entra Ellenőrzött azonosító hálózatban.
Megjegyzés
Az API a RESTful API-kkal kényelmesen használható fejlesztőknek készült.
A Microsoft Entra ID Verified Network API HTTPS-en keresztül érhető el. A dokumentációban hivatkozott összes URL-cím alapja a következő: https://verifiedid.did.msidentity.com
.
Az API a Microsoft Entra-azonosítón keresztül védett, és OAuth2 tulajdonosi jogkivonatokat használ. Az alkalmazásregisztrációnak rendelkeznie kell az API-engedéllyel Verifiable Credentials Service Admin
, majd a hozzáférési jogkivonat beszerzésekor az alkalmazásnak hatókört 6a8b4b39-c021-437c-b060-5a14a3fd65f3/full_access
kell használnia.
Ez az API a Microsoft Entra Ellenőrzött azonosító hálózatban elérhető kiállítók keresésére szolgál. A kiállítókat a csatolt tartománynév alapján keresheti meg. A paraméterhez filter
megadott érték azon kiállítók megkeresésére szolgál, amelyek Microsoft Entra Ellenőrzött azonosító és ellenőrzött csatolt tartománnyal rendelkeznek. Jelenleg csak operátorral linkeddomainurls
és operátorral like
szűrhet. A válaszban legfeljebb 15 kiállító szerepel.
GET /v1.0/verifiableCredentialsNetwork/authorities?filter=linkeddomainurls%20like%20Woodgrove
Fejléc | Value |
---|---|
Authorization | Tulajdonos (jogkivonat). Szükséges |
Content-Type | application/json |
Paraméter | Érték |
---|---|
szűrő | linkeddomainurls, például Woodgrove |
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/"
]
}
]
Ezt az API-t egy adott kiállító közzétett hitelesítő adatainak keresésére használják. Ismernie kell a kibocsátókat tenantId
és issuerId
a . A visszatérési üzenet a közzétett hitelesítő adatok típusainak és a hozzájuk tartozó jogcímek gyűjteménye. A válasz legfeljebb 100 hitelesítőadat-típust fog megadni.
GET /v1.0/tenants/:tenantId/verifiableCredentialsNetwork/authorities/:issuerId/contracts/
Fejléc | Value |
---|---|
Authorization | Tulajdonos (jogkivonat). Szükséges |
Content-Type | application/json |
Paraméter | Érték |
---|---|
tenantId | Csatolt tartománynév alapján végzett keresésből beszerzett TenantId |
issuerId | Társított tartománynév alapján végzett keresésből beszerzett IssuerId |
HTTP/1.1 200 OK
Content-type: application/json
[
{
"name": "Verified employee 1",
"types": [
"VerifiedEmployee"
],
"claims": [
"displayName",
"givenName",
"jobTitle",
"preferredLanguage",
"surname",
"mail",
"revocationId",
"photo"
]
}
]
További információ a Microsoft Entra Ellenőrzött azonosító Hálózatról.