Teilen über


Microsoft Entra Verified ID-Netzwerk-API

Mit der Microsoft Entra Verified ID Network-API können Sie im Microsoft Entra Verified ID Networknach veröffentlichten Anmeldeinformationen suchen.

Anmerkung

Die API ist für Entwickler vorgesehen, die mit RESTful-APIs vertraut sind.

Basis-URL

Die Microsoft Entra ID Verified Network API wird über HTTPS bereitgestellt. Alle URLs, auf die in der Dokumentation verwiesen wird, haben die folgende Basis: https://verifiedid.did.msidentity.com.

Authentifizierung

Die API ist über die Microsoft Entra-ID geschützt und verwendet OAuth2-Bearertoken. Die App-Registrierung muss über die API-Berechtigung für Verifiable Credentials Service Admin verfügen und beim Abrufen des Zugriffstokens sollte die App den Bereich 6a8b4b39-c021-437c-b060-5a14a3fd65f3/full_accessverwenden.

Suchen nach Ausstellern

Diese API wird verwendet, um nach Ausstellern zu suchen, die im Microsoft Entra Verified ID Network verfügbar sind. Sie können nach Ausstellern anhand ihrer verknüpften Domäne Namen suchen. Der für den Parameter filter angegebene Wert wird verwendet, um Aussteller zu finden, die in Microsoft Entra Verified ID integriert sind und über eine überprüfte verknüpfte Domäne verfügen. Derzeit können Sie nur nach linkeddomainurls und mit Operator-likefiltern. Es gibt maximal 15 Aussteller in der Antwort.

HTTP-Anforderung

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

Anforderungsheader

Kopfball Wert
Ermächtigung Bearer (Token). Erforderlich
Inhaltstyp application/json

Anforderungsparameter

Parameter Wert
Filter linkeddomainurls wie Woodgrove

Nachricht zurückgeben

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

Suchen nach veröffentlichten Anmeldeinformationstypen durch einen Aussteller

Diese API wird verwendet, um nach veröffentlichten Anmeldeinformationstypen für einen bestimmten Aussteller zu suchen. Sie müssen die Aussteller tenantId und issuerIdkennen. Die Rückgabenachricht ist eine Sammlung veröffentlichter Anmeldeinformationstypen und deren jeweiligen Ansprüche. Es gibt maximal 100 Anmeldeinformationstypen in der Antwort.

HTTP-Anforderung

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

Anforderungsheader

Kopfball Wert
Ermächtigung Bearer (Token). Erforderlich
Inhaltstyp application/json

Anforderungsparameter

Parameter Wert
tenantId TenantId, die von der Suche anhand des verknüpften Domänennamens abgerufen wurde
issuerId IssuerId, die von der Suche anhand des verknüpften Domänennamens abgerufen wurde

Nachricht zurückgeben

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

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

Nächste Schritte

Erfahren Sie mehr über Microsoft Entra Verified ID Network.