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_access
kapsam 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 like
ile 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 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ü | 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.