Teilen über

Microsoft Entra Verified ID-Netzwerk-API

  • Artikel

Hinweis

Microsoft Entra Verified ID ist jetzt Teil der Microsoft Entra-Produktfamilie. Erfahren Sie mehr über die Microsoft Entra-Familie mit Lösungen für die Identitätsverwaltung, und beginnen Sie im einheitlichen Microsoft Entra Admin Center.

Mithilfe der Microsoft Entra Verified ID-Netzwerk-API können Sie im Microsoft Entra Verified ID-Netzwerk nach veröffentlichten Anmeldeinformationen suchen.

Hinweis

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

Basis-URL

Die Microsoft Entra ID Verified-Netzwerk-API wird über HTTPS bereitgestellt. Alle in der Dokumentation referenzierten URLs verwenden die folgende Basis: https://verifiedid.did.msidentity.com.

Authentifizierung

Die API ist durch 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 dann den Bereich 6a8b4b39-c021-437c-b060-5a14a3fd65f3/full_access verwenden.

Suchen nach Ausstellern

Diese API wird verwendet, um nach Ausstellern zu suchen, die im Microsoft Entra Verified ID-Netzwerk verfügbar sind. Sie können anhand des Namens der verknüpften Domäne nach Ausstellern suchen. Der für den Parameter filter angegebene Wert wird verwendet, um Aussteller zu ermitteln, die sich für Microsoft Entra Verified ID entschieden haben und über eine verifizierte verknüpfte Domäne verfügen. Derzeit können Sie nur nach linkeddomainurls und mit dem Operator like filtern. Die Zahl der Aussteller in der Antwort ist auf 15 begrenzt.

HTTP-Anforderung

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

Anforderungsheader

Header Wert
Authorization Bearer (Token). Erforderlich
Content-Type Anwendung/json

Anforderungsparameter

Parameter value
filter linkeddomainurls-Wert wie z. B. Woodgrove

Antwortnachricht

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

[
  {
    "id": "0459a193-1111-2222-3333-444455556666",
    "tenantId": "55eafede-1111-2222-3333-444455556666",
    "did": "did:web:bank.woodgrove.com...<SNIP>...",
    "name": "WoodgroveBank",
    "linkedDomainUrls": [
      "https://bank.woodgrove.com/"
    ]
  },
  {
    "id": "6e0e41cb-1111-2222-3333-444455556666",
    "tenantId": "7f448f57-1111-2222-3333-444455556666",
    "did": "did:web:woodgrove.com...<SNIP>...",
    "name": "Woodgrove",
    "linkedDomainUrls": [
      "https://woodgrove.com/"
    ]
  }
]

Suche nach veröffentlichten Anmeldeinformationstypen für einen Aussteller

Diese API dient der Suche nach veröffentlichten Berechtigungstypen für einen bestimmten Aussteller. Sie müssen die Aussteller tenantId und issuerId kennen. Die Antwortnachricht ist eine Sammlung der veröffentlichten Anmeldeinformationstypen und der zugehörigen Ansprüche. Die Zahl der Anmeldeinformationstypen in der Antwort ist auf 100 begrenzt.

HTTP-Anforderung

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

Anforderungsheader

Header Wert
Authorization Bearer (Token). Erforderlich
Content-Type Anwendung/json

Anforderungsparameter

Parameter value
tenantId Mandanten-ID, die bei der Suche nach dem Namen der verknüpften Domäne ermittelt wurde
issuerId Aussteller-ID, die bei der Suche nach dem Namen der verknüpften Domäne ermittelt wurde

Antwortnachricht

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

Weitere Informationen finden Sie unter Microsoft Entra Verified ID-Netzwerk.