Microsoft Entra Verified ID 네트워크 API

Microsoft Entra Verified ID 네트워크 API를 사용하면 Microsoft Entra Verified ID 네트워크에서 게시된 자격 증명을 검색할 수 있습니다.

참고 항목

API는 RESTful API에 익숙한 개발자를 위한 것입니다.

기준 URL

Microsoft Entra ID Verified Network API는 HTTPS를 통해 제공됩니다. 설명서에서 참조되는 모든 URL은 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 네트워크에서 사용할 수 있는 발급자를 검색하는 데 사용됩니다. 연결된 도메인 이름으로 발급자를 검색할 수 있습니다. filter 매개 변수에 제공된 값은 Microsoft Entra Verified ID에 온보딩되고 확인되고 연결된 도메인이 있는 발급자를 찾는 데 사용됩니다. 현재는 linkeddomainurls 및 like 연산자로만 필터링할 수 있습니다. 응답에는 최대 15개의 발급자가 있습니다.

HTTP 요청

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

요청 헤더

헤더	값
Authorization	전달자(토큰). Required
콘텐츠 형식	application/json

요청 매개 변수

매개 변수	value
필터	Woodgrove와 같은 linkeddomainurls

반환 메시지

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/

요청 헤더

헤더	값
Authorization	전달자(토큰). Required
콘텐츠 형식	application/json

요청 매개 변수

매개 변수	value
tenantId	연결된 도메인 이름으로 검색에서 얻은 TenantId
issuerId	연결된 도메인 이름으로 검색에서 얻은 IssuerId

반환 메시지

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 네트워크에 대해 자세히 알아보세요.