Microsoft Entra Verified ID hálózati API

A Microsoft Entra Verified ID Network API lehetővé teszi a közzétett hitelesítő adatok keresését a Microsoft Entra Verified ID Network .

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

Hitelesítés

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 a Verifiable Credentials Service Admin API-engedélyével, majd a hozzáférési jogkivonat beszerzésekor az alkalmazásnak hatókört kell használnia 6a8b4b39-c021-437c-b060-5a14a3fd65f3/full_access.

Kiállítók keresése

Ez az API a Microsoft Entra Verified ID Networkben elérhető kiállítók keresésére szolgál. A kiállítókat a csatolt tartomány neve alapján keresheti meg. A filter paraméterhez megadott érték azon kiállítók megkeresésére szolgál, amelyek a Microsoft Entra Verified ID azonosítójára lettek előkészítve, és egy ellenőrzött csatolt tartománnyal rendelkeznek. Jelenleg csak linkeddomainurls és likeoperátorral szűrhet. A válaszban legfeljebb 15 kiállító szerepel.

HTTP-kérés

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

Kérelemfejlécek

Kérelemparaméterek

Ü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

Ez az API egy adott kiállító közzétett hitelesítőadat-típusainak keresésére szolgál. Ismernie kell a kiállítókat tenantId és issuerId. 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álaszban legfeljebb 100 hitelesítő adattípus szerepel.

HTTP-kérés

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

Kérelemfejlécek

Kérelemparaméterek

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

Következő lépések

További információ a Microsoft Entra verified ID Network .