openIdConnectIdentityProvider Ressourcentyp

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.

Stellt OpenID Connect-Identitätsanbieter in einem Azure Active Directory (Azure AD) B2C-Mandanten dar.

Durch Konfigurieren eines OpenID Connect-Anbieters in einem Azure AD B2C-Mandanten können sich Benutzer mit ihrem benutzerdefinierten Identitätsanbieter bei jeder Anwendung registrieren und anmelden.

Erbt von identityProviderBase.

Methoden

Keine.

Eine Liste der API-Vorgänge zum Verwalten von OpenID Connect-Identitätsanbietern in Azure AD B2C finden Sie unter dem Ressourcentyp identityProviderBase.

Eigenschaften

Eigenschaft Typ Beschreibung
clientId Zeichenfolge Der Client-Bezeichner für die Anwendung, der beim Registrieren der Anwendung beim Identitätsanbieter erhalten wird. Erforderlich.
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 ist id_token, ist das Geheimnis nicht erforderlich, da kein Codeaustausch stattfindet. Die id_token wird direkt von der Autorisierungsantwort zurückgegeben.
Dieser verfügt nur über Schreibzugriff. Ein Lesevorgang gibt **** zurück.
id Zeichenfolge Der Bezeichner des Identitätsanbieters. Erforderlich. Geerbt von identityProviderBase. Schreibgeschützt.
displayName Zeichenfolge Der Anzeigename des Identitätsanbieters.
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. Erforderlich.
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 auf .well-known/openid-configurationendet. Geben Sie die Metadaten-URL für den OpenID Connect-Identitätsanbieter an, den Sie hinzufügen. Schreibgeschützt. Erforderlich.
responseMode openIdConnectResponseMode Der Antwortmodus definiert die Methode, die zum Zurücksenden von Daten vom benutzerdefinierten Identitätsanbieter an Azure AD B2C verwendet wird. Mögliche Werte: form_post, query. Erforderlich.
responseType openIdConnectResponseTypes Der Antworttyp beschreibt den Typ der Informationen, die beim ersten Aufruf an den authorization_endpoint des benutzerdefinierten Identitätsanbieters zurückgesendet werden. Mögliche Werte: code , id_token , token. Erforderlich.
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 angefügt werden, getrennt durch ein Leerzeichen. Weitere Informationen zu den Anwendungsbereichsbeschränkungen finden Sie RFC6749 Abschnitt 3.3. Erforderlich.

openIdConnectResponseMode-Werte

Member Beschreibung
form_post Dieser Antwortmodus wird empfohlen, um optimale Sicherheit zu gewährleisten. 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.
Abfrage Der Code oder das Token wird als Abfrageparameter zurückgegeben.
unknownFutureValue Ein Sentinel-Wert, um zukünftige Werte anzugeben.

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. (Dieser Wert wird derzeit von Azure AD B2C nicht unterstützt)

Beziehungen

Keine.

JSON-Darstellung

Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.

{
  "@odata.type": "#microsoft.graph.openIdConnectIdentityProvider",
  "id": "String (identifier)",
  "displayName": "String",
  "clientId": "String",
  "clientSecret": "String",
  "scope": "String",
  "metadataUrl": "String",
  "domainHint": "String",
  "responseType": "String",
  "responseMode": "String",
  "claimsMapping": {
    "@odata.type": "microsoft.graph.claimsMapping"
  }
}
  • Last updated on