Aracılığıyla paylaş


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

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 Id Doğrulanmış 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. Uygulama kaydının Verifiable Credentials Service Admin için API İznine sahip olması ve erişim belirtecini alırken uygulamanın 6a8b4b39-c021-437c-b060-5a14a3fd65f3/full_accesskapsam kullanması gerekir.

Verenleri arama

Bu API, Microsoft Entra Doğrulanmış Kimlik Ağı'nda bulunan verenleri aramak için kullanılır. 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ü application/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. verenlerin tenantId ve issuerIdbilmeniz 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ü application/json

İstek parametreleri

Parametre değer
tenantId 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.