Olvasás angol nyelven

Megosztás a következőn keresztül:


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.

Kiindulási URL-cím

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.

Authentication

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_accesskell használnia.

Kiállítók keresése

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 likeszűrhet. A válaszban legfeljebb 15 kiállító szerepel.

HTTP-kérelem

GET /v1.0/verifiableCredentialsNetwork/authorities?filter=linkeddomainurls%20like%20Woodgrove

Kérésfejlécek

Fejléc Value
Authorization Tulajdonos (jogkivonat). Szükséges
Content-Type application/json

Kérelemparaméterek

Paraméter Érték
szűrő linkeddomainurls, például Woodgrove

Üzenet visszaküldése

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/"
    ]
  }
]

Közzétett hitelesítőadat-típusok keresése kiállító szerint

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 issuerIda . 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.

HTTP-kérelem

GET /v1.0/tenants/:tenantId/verifiableCredentialsNetwork/authorities/:issuerId/contracts/

Kérésfejlécek

Fejléc Value
Authorization Tulajdonos (jogkivonat). Szükséges
Content-Type application/json

Kérelemparaméterek

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

Üzenet visszaküldése

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 lépések

További információ a Microsoft Entra Ellenőrzött azonosító Hálózatról.