Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Namespace: microsoft.graph
Wichtig
Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.
Achtung
Diese Identitätsanbieter-API ist veraltet und wird nach März 2023 keine Daten mehr zurückgeben. Bitte verwenden Sie die neue Identitätsanbieter-API.
Repräsentiert OpenID Connect-Identitätsanbieter in einem Azure Active Directory B2C-Mandanten.
Das Konfigurieren eines OpenID Connect-Anbieters in einem B2C-Mandanten ermöglicht es Benutzern, sich mit ihrem benutzerdefinierten Identitätsanbieter in einer Anwendung zu registrieren und anzumelden.
Erbt von identityProvider.
Methoden
Keine.
Eine Liste der API-Vorgänge zum Verwalten des Open ID Connect-Anbieters finden Sie unter identityProvider.
Eigenschaften
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| clientId | Zeichenfolge | Der Client-Bezeichner für die Anwendung, der beim Registrieren der Anwendung beim Identitätsanbieter erhalten wird. Geerbt von identityProvider. Dies ist eine erforderliche Eigenschaft. |
| clientSecret | String | Der geheime Clientschlüssel für die Anwendung, der beim Registrieren der Anwendung beim Identitätsanbieter abgerufen wird. Der clientSecret ist von responseType abhängig. Wenn responseType ist code, ist ein Geheimnis für den Austausch von Authentifizierungscodes erforderlich. Wenn responseType das Geheimnis ist id_token , ist es nicht erforderlich, da kein Codeaustausch stattfindet, wird es id_token direkt von der Autorisierungsantwort zurückgegeben. Dieser verfügt nur über Schreibzugriff. Ein Lesevorgang gibt "****" zurück. Geerbt von identityProvider. |
| id | String | Die ID des Identitätsanbieters. Es handelt sich um eine erforderliche Eigenschaft und ist nach der Erstellung schreibgeschützt. |
| name | Zeichenfolge | Der Anzeigename des Identitätsanbieters. Es handelt sich um eine erforderliche Eigenschaft und ist nach der Erstellung schreibgeschützt. |
| type | Zeichenfolge | Der Typ des Identitätsanbieters. Muss OpenIDConnect sein. Es handelt sich um eine erforderliche Eigenschaft und ist nach der Erstellung schreibgeschützt. |
| claimsMapping | claimsMapping | Nachdem der OIDC-Anbieter ein ID-Token an Microsoft Entra ID zurückgesendet hat, muss Microsoft Entra ID in der Lage sein, die Ansprüche aus dem empfangenen Token den Ansprüchen zuzuordnen, die Microsoft Entra ID erkennt und verwendet. Dieser komplexe Typ erfasst diese Zuordnung. Es ist eine erforderliche Eigenschaft. |
| domainHint | Zeichenfolge | Der Domänenhinweis kann verwendet werden, um direkt zur Anmeldeseite des angegebenen Identitätsanbieters zu springen, anstatt den Benutzer aus der Liste der verfügbaren Identitätsanbieter auswählen zu lassen. |
| metadataUrl | Zeichenfolge | Die URL für das Metadatendokument des OpenID Connect-Identitätsanbieters. Jeder OpenID Connect-Identitätsanbieter beschreibt ein Metadatendokument, das die meisten Informationen enthält, die für die Anmeldung erforderlich sind. Dazu gehören Informationen wie die zu verwendenden URLs und der Speicherort der öffentlichen Signaturschlüssel des Diensts. Das OpenID Connect-Metadatendokument befindet sich immer an einem Endpunkt, der in einer bekannten/openid-Konfiguration endet. Für den OpenID Connect-Identitätsanbieter, den Sie hinzufügen möchten, müssen Sie die Metadaten-URL angeben. Es handelt sich um eine erforderliche Eigenschaft und ist nach der Erstellung schreibgeschützt. |
| responseMode | openIdConnectResponseMode | Der Antwortmodus definiert die Methode, die verwendet werden soll, um die Daten vom benutzerdefinierten Identitätsanbieter an Azure AD B2C zurückzusenden. Die folgenden Antwortmodi können verwendet werden: form_post, query.
query Antwortmodus bedeutet, dass der Code oder das Token als Abfrageparameter zurückgegeben wird.
form_post Für die beste Sicherheit wird der Antwortmodus empfohlen. Die Antwort wird über die HTTP POST-Methode übertragen, wobei der Code oder das Token im Text im Format application/x-www-form-urlencoded codiert wird. Es ist eine erforderliche Eigenschaft. |
| responseType | openIdConnectResponseTypes | Der Antworttyp beschreibt, welche Art von Informationen beim ersten Aufruf an die authorization_endpoint des benutzerdefinierten Identitätsanbieters zurückgesendet werden. Die folgenden Antworttypen können verwendet werden: code , id_token , token. Es ist eine erforderliche Eigenschaft. |
| Bereich | Zeichenfolge | Der Bereich definiert die Informationen und Berechtigungen, die Sie von Ihrem benutzerdefinierten Identitätsanbieter erfassen möchten. OpenID Connect-Anforderungen müssen den OpenID-Bereichswert enthalten, um das ID-Token vom Identitätsanbieter zu erhalten. Ohne das ID-Token können sich Benutzer nicht mit dem benutzerdefinierten Identitätsanbieter bei Azure AD B2C anmelden. Andere Bereiche können durch Leerzeichen getrennt angefügt werden. Weitere Informationen zu den Anwendungsbereichsbeschränkungen finden Sie RFC6749 Abschnitt 3.3. Es ist eine erforderliche Eigenschaft. |
openIdConnectResponseTypes-Werte
| Member | Beschreibung |
|---|---|
| code | Gemäß dem Autorisierungscodeflow wird ein Code an Azure AD B2C zurückgegeben. Azure AD B2C ruft dann die token_endpoint auf, um den Code gegen das Token einzutauschen. |
| id_token | Ein ID-Token wird vom benutzerdefinierten Identitätsanbieter an Azure AD B2C zurückgegeben. |
| token | Ein Zugriffstoken wird vom benutzerdefinierten Identitätsanbieter an Azure AD B2C zurückgegeben. Wird derzeit von Azure AD B2C nicht unterstützt. |
Beziehungen
Keine.
JSON-Darstellung
Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.
{
"id": "String",
"name": "String",
"type": "String",
"clientId": "String",
"clientSecret": "String",
"claimsMapping": {
"@odata.type": "#microsoft.graph.claimsMapping",
"userId": "String",
"givenName": "String",
"surname": "String",
"email": "String",
"displayName": "String"
},
"domainHint": "String",
"metadataUrl": "String",
"responseMode": "String",
"responseType": "String",
"scope": "String"
}