API di rete microsoft Entra Verified ID

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

Nota

L'API è destinata agli sviluppatori che hanno familiarità con le API RESTful.

Base URL

L'API Microsoft Entra ID Verified 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. La registrazione dell'app deve avere l'autorizzazione API per Verifiable Credentials Service Admin e quindi, quando si acquisisce il token di accesso, l'app deve usare l'ambito 6a8b4b39-c021-437c-b060-5a14a3fd65f3/full_access.

Ricerca di autorità emittenti

Questa API viene usata 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

Intestazione	Valore
Autorizzazione	Connessione (token). Obbligatorio
Tipo di contenuto	application/json

Parametri della richiesta

Parametro	valore
filtro	linkeddomainurls come Woodgrove

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

Ricerca di 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 le autorità emittenti 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

Intestazione	Valore
Autorizzazione	Connessione (token). Obbligatorio
Tipo di contenuto	application/json

Parametri della richiesta

Parametro	valore
tenantId	TenantId ottenuto dalla ricerca in base al nome di dominio collegato
issuerId	IssuerId ottenuto dalla ricerca in base al nome di dominio collegato

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.