Microsoft Entra Doğrulanmış Kimlik ağ API'si

Genel bakış

Microsoft Entra Doğrulanmış Kimlik Ağ API'si, Microsoft Entra Doğrulanmış Kimlik Ağıyayımlanan kimlik bilgilerini aramanızı sağlar.

Not

API, RESTful API'leri kullanan geliştiricilere yöneliktir.

Temel URL

Microsoft Entra Doğrulanmış Kimlik Ağ API'si HTTPS üzerinden sunulur. Belgelerde başvuruda bulunılan tüm URL'ler şu temele sahiptir: https://verifiedid.did.msidentity.com.

Kimlik doğrulama

API, Microsoft Entra Kimliği ile korunur ve OAuth2 taşıyıcı belirteçlerini kullanır. Erişim belirtecini alırken uygulama kaydına API İzni Verifiable Credentials Service Admin verin ve kapsamı 6a8b4b39-c021-437c-b060-5a14a3fd65f3/full_access kullanın.

Verenleri arama

Microsoft Entra Doğrulanmış Kimlik Ağı'nda bulunan verenleri aramak için bu API'yi kullanın. Verenleri bağlı etki alanı adına göre arayabilirsiniz. filter parametresi için sağlanan değer, Microsoft Entra Doğrulanmış Kimliği'ne eklenen ve doğrulanmış bir bağlı etki alanına sahip olan verenleri bulmak için kullanılır. Şu anda yalnızca linkeddomainurls ve işleci likeile filtreleyebilirsiniz. Yanıtta en fazla 15 veren vardır.

HTTP isteği

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

İstek üst bilgileri

Üstbilgi	Değer
İzin	Taşıyıcı (belirteç). Gerekli
İçerik Türü	uygulama/json

İstek parametreleri

Parametre	Değer
filtre	Woodgrove gibi linkeddomainurls

dönüş iletisi

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

Veren tarafından yayımlanan kimlik bilgisi türlerini arama

Bu API, belirli bir veren için yayımlanan kimlik bilgisi türlerini aramak için kullanılır. Verenin ve tenantId'ini issuerId bilmeniz gerekir. Dönüş iletisi, yayımlanan kimlik bilgisi türlerinin ve bunların ilgili taleplerinin bir koleksiyonudur. Yanıtta en fazla 100 kimlik bilgisi türü vardır.

HTTP isteği

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

İstek üst bilgileri

Üstbilgi	Değer
İzin	Taşıyıcı (belirteç). Gerekli
İçerik Türü	uygulama/json

İstek parametreleri

Parametre	Değer
kiracıKimliği	Aramadan bağlantılı etki alanı adına göre alınan TenantId
issuerId	Bağlantılı etki alanı adına göre aramadan alınan IssuerId

dönüş iletisi

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

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

Sonraki adımlar

Microsoft Entra Doğrulanmış Kimlik Ağıhakkında daha fazla bilgi edinin.