Microsoft Entra 已驗證的標識碼網路 API

Microsoft Entra 已驗證標識符網路 API 可讓您在 Microsoft Entra Verified ID Network中搜尋已發佈的認證。

基底 URL

Microsoft Entra ID 已驗證的網路 API 會透過 HTTPS 提供服務。 檔案中參考的所有網址都有下列基底：https://verifiedid.did.msidentity.com。

認證

API 會透過Microsoft Entra ID 來保護，並使用 OAuth2 持有人令牌。 應用程式註冊必須具有 Verifiable Credentials Service Admin 的 API 許可權，然後在取得存取令牌時，應用程式應該使用範圍 6a8b4b39-c021-437c-b060-5a14a3fd65f3/full_access。

搜尋簽發者

此 API 可用來搜尋 Microsoft Entra Verified ID Network 中可用的簽發者。 您可以依其 連結網域 名稱來搜尋簽發者。 為 filter 參數提供的值是用來尋找已上線至 Microsoft Entra 已驗證標識符且具有已驗證連結網域的簽發者。 目前，您只能依 linkeddomainurls 和運算子 like進行篩選。 回應中最多有15個簽發者。

HTTP 要求

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

要求標頭

要求參數

傳回訊息

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

依簽發者搜尋已發佈的認證類型

此 API 可用來搜尋特定簽發者的已發佈認證類型。 您必須知道簽發者 tenantId，並 issuerId。 傳回訊息是已發行認證類型的集合及其各自的宣告。 回應中最多有 100 種認證類型。

HTTP 要求

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

要求標頭

要求參數

傳回訊息

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

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

後續步驟

深入瞭解 Microsoft Entra Verified ID Network。