API jaringan ID Terverifikasi Microsoft Entra

ID TERVERIFIKASI MICROSOFT ENTRA Network API memungkinkan Anda mencari kredensial yang diterbitkan di Jaringan ID Terverifikasi Microsoft Entra.

Catatan

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.

Autentikasi

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 jaringan ID Terverifikasi Microsoft Entra. Anda dapat mencari penerbit dengan nama domain tertaut mereka. Nilai yang disediakan untuk filter parameter akan digunakan untuk menemukan penerbit yang telah melakukan onboarding ke ID Terverifikasi Microsoft Entra dan memiliki domain tertaut terverifikasi. Saat ini Anda hanya dapat memfilter menurut linkeddomainurls dan dengan operator like. Akan ada maksimal 15 penerbit dalam respons.

Permintaan HTTP

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

Header permintaan

Header	Value
Authorization	Token pembawa (token). Wajib
Content-Type	application/json

Parameter permintaan

Parameter	value
filter	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 penerbit sertifikat

API ini digunakan untuk mencari jenis kredensial yang diterbitkan untuk penerbit sertifikat tertentu. Anda perlu mengetahui penerbit tenantId dan issuerId. Pesan pengembalian adalah kumpulan jenis kredensial yang diterbitkan dan klaim masing-masing. Akan ada maksimal 100 jenis kredensial dalam respons.

Permintaan HTTP

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

Header permintaan

Header	Value
Authorization	Token pembawa (token). Wajib
Content-Type	application/json

Parameter permintaan

Parameter	value
tenantId	TenantId diperoleh dari pencarian berdasarkan 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 jaringan ID Terverifikasi Microsoft Entra.