Bagikan melalui


API jaringan ID Terverifikasi Microsoft Entra

API Jaringan ID Terverifikasi Microsoft Entra memungkinkan Anda mencari kredensial yang diterbitkan di Jaringan ID Terverifikasi Microsoft Entra.

Nota

API ini ditujukan untuk pengembang yang nyaman dengan API RESTful.

URL Dasar

MICROSOFT Entra ID Verified Network API disajikan melalui HTTPS. Semua URL yang dirujuk dalam dokumentasi memiliki basis berikut: https://verifiedid.did.msidentity.com.

Otentikasi

API dilindungi melalui ID Microsoft Entra dan menggunakan token pembawa OAuth2. Pendaftaran aplikasi harus memiliki Izin API untuk Verifiable Credentials Service Admin dan kemudian saat memperoleh token akses, aplikasi harus menggunakan cakupan 6a8b4b39-c021-437c-b060-5a14a3fd65f3/full_access.

Mencari penerbit

API ini digunakan untuk mencari penerbit yang tersedia di Microsoft Entra Verified ID Network. Anda dapat mencari penerbit dengan nama domain tertaut mereka. Nilai yang disediakan untuk parameter filter digunakan untuk menemukan penerbit yang melakukan onboarding ke ID Terverifikasi Microsoft Entra dan memiliki domain tertaut terverifikasi. Saat ini Anda hanya dapat memfilter menurut linkeddomainurls dan dengan operator like. Ada maksimal 15 penerbit dalam respons.

Permintaan HTTP

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

Header permintaan

Header Nilai
Otorisasi Pembawa (token). Diperlukan
Tipe Isi application/json

Parameter permintaan

Parameter nilai
saringan linkeddomainurls seperti Woodgrove

Mengembalikan pesan

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

Mencari jenis kredensial yang diterbitkan oleh pengeluar sertifikat

API ini digunakan untuk mencari jenis kredensial yang diterbitkan untuk pengeluar sertifikat tertentu. Anda perlu mengetahui tenantId dan issuerIdpenerbit . Pesan pengembalian adalah kumpulan jenis kredensial yang diterbitkan dan klaim masing-masing. Ada maksimum 100 jenis kredensial dalam respons.

Permintaan HTTP

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

Header permintaan

Header Nilai
Otorisasi Pembawa (token). Diperlukan
Tipe Isi application/json

Parameter permintaan

Parameter nilai
tenantId TenantId diperoleh dari pencarian dengan nama domain tertaut
issuerId IssuerId diperoleh dari pencarian dengan nama domain tertaut

Mengembalikan pesan

HTTP/1.1 200 OK
Content-type: application/json

[
  {
    "name": "Verified employee 1",
    "types": [
      "VerifiedEmployee"
    ],
    "claims": [
      "displayName",
      "givenName",
      "jobTitle",
      "preferredLanguage",
      "surname",
      "mail",
      "revocationId",
      "photo"
    ]
  }
]

Langkah berikutnya

Pelajari selengkapnya tentang Microsoft Entra Verified ID Network.