API di rete microsoft Entra Verified ID

Informazioni generali

L'API Microsoft Entra Verified ID Network consente di cercare le credenziali pubblicate nella Microsoft Entra Verified ID Network.

URL di base

L'API Microsoft Entra Verified ID Network viene servita tramite HTTPS. Tutti gli URL a cui si fa riferimento nella documentazione hanno la base seguente: https://verifiedid.did.msidentity.com.

Autenticazione

L'API è protetta tramite Microsoft Entra ID e usa token di connessione OAuth2. Concedere all'app la registrazione dell'autorizzazione API per Verifiable Credentials Service Admin e usare l'ambito 6a8b4b39-c021-437c-b060-5a14a3fd65f3/full_access durante l'acquisizione del token di accesso.

Cercare autorità emittenti

Usare questa API per cercare le autorità emittenti disponibili nella rete ID verificato di Microsoft Entra. È possibile cercare le autorità emittenti nome di dominio collegato. Il valore fornito per il parametro filter viene usato per trovare le autorità emittenti di cui è stato eseguito l'onboarding nell'ID verificato di Microsoft Entra e avere un dominio collegato verificato. Attualmente è possibile filtrare solo in base linkeddomainurls e con l'operatore like. Nella risposta sono presenti al massimo 15 emittenti.

Richiesta HTTP

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

Intestazioni della richiesta

Parametri della richiesta

Messaggio restituito

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

Cercare i tipi di credenziali pubblicati da un'autorità emittente

Questa API viene usata per cercare i tipi di credenziali pubblicati per un'autorità emittente specifica. È necessario conoscere l'emittente tenantId e issuerId. Il messaggio restituito è una raccolta di tipi di credenziali pubblicati e le rispettive attestazioni. Nella risposta sono presenti al massimo 100 tipi di credenziali.

Richiesta HTTP

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

Intestazioni della richiesta

Parametri della richiesta

Messaggio restituito

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

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

Passaggi successivi

Altre informazioni su Microsoft Entra Verified ID Network.