Übergeben des Zugriffstokens eines Identitätsanbieters an Ihre Anwendung in Azure Active Directory B2C

Artikel
11/17/2023

Vorbereitung: Wählen Sie mithilfe des Selektors Richtlinientyp auswählen den Typ der einzurichtenden Richtlinie aus. Azure Active Directory B2C bietet zwei Methoden zum Definieren der Benutzerinteraktion mit Ihren Anwendungen: vordefinierte Benutzerflows oder vollständig konfigurierbare benutzerdefinierte Richtlinien. Die Schritte, die in diesem Artikel erforderlich sind, unterscheiden sich für jede Methode.

Ein Benutzerflow in Azure Active Directory B2C (Azure AD B2C) ermöglicht es Benutzern Ihrer Anwendung, sich mit einem Identitätsanbieter zu registrieren oder anzumelden. Bei diesem Vorgang empfängt Azure AD B2C zunächst ein Zugriffstoken vom Identitätsanbieter. Azure AD B2C verwendet dieses Token, um Informationen zum Benutzer abzurufen. Sie aktivieren einen Anspruch in Ihrem Benutzerflow, um das Token an die Anwendungen zu übergeben, die Sie in Azure AD B2C registrieren.

Azure AD B2C unterstützt die Übergabe des Zugriffstokens für OAuth 2.0-Identitätsanbieter. Hierzu zählen unter anderem Facebook und Google. Für alle weiteren Identitätsanbieter wird ein leerer Anspruch zurückgegeben.

Azure AD B2C unterstützt die Übergabe des Zugriffstokens von OAuth 2.0- und OpenID Connect-Identitätsanbietern. Für alle weiteren Identitätsanbieter wird ein leerer Anspruch zurückgegeben. Weitere Einzelheiten finden Sie in der Livedemo zum Verbund mit Identitätsanbietern.

Das folgende Diagramm zeigt, wie ein Identitätsanbieter Token an Ihre App zurückgibt:

Identity provider pass through flow

Voraussetzungen

Erstellen Sie einen Benutzerflow, damit sich Benutzer bei Ihrer Anwendung registrieren und anmelden können.
Registrieren Sie eine Webanwendung.

Führen Sie die unter Erste Schritte mit benutzerdefinierten Richtlinien in Active Directory B2C beschriebenen Schritte aus.
Registrieren Sie eine Webanwendung.

Aktivieren des Anspruchs

Melden Sie sich beim Azure-Portal als globaler Administrator Ihres Azure AD B2C-Mandanten an.
Wenn Sie Zugriff auf mehrere Mandanten haben, wählen Sie das Symbol Einstellungen im Menü oben aus, um über das Menü Verzeichnisse + Abonnements zu Ihrem Azure AD B2C-Mandanten zu wechseln.
Klicken Sie links oben im Azure-Portal auf Alle Dienste, suchen Sie nach Azure AD B2C, und klicken Sie darauf.
Wählen Sie Benutzerflows (Richtlinien) und dann Ihren Benutzerflow aus. Beispiel: B2C_1_signupsignin1.
Wählen Sie Anwendungsansprüche aus.
Aktivieren Sie den Anspruch Zugriffstoken des Identitätsanbieters.
Klicken Sie auf Speichern, um den Benutzerflow zu speichern.

Testen des Benutzerflows

Wenn Sie Ihre Anwendungen in Azure AD B2C testen, kann es nützlich sein, das Azure AD B2C-Token an https://jwt.ms zurückzugeben, um die darin enthaltenen Ansprüche zu überprüfen.

Wählen Sie auf der Übersichtsseite des Benutzerflows die Option Benutzerflow ausführen aus.
Wählen Sie für Anwendung Ihre Anwendung aus, die Sie zuvor registriert haben. Um das Token im nachstehenden Beispiel anzuzeigen, muss als Antwort-URL der Wert https://jwt.ms angegeben werden.
Klicken Sie auf Benutzerflow ausführen, und melden Sie sich dann mit den Anmeldeinformationen für Ihr Konto an. Es sollte das Zugriffstoken des Identitätsanbieters im Anspruch idp_access_token angezeigt werden.

Sie sollten eine Ausgabe ähnlich wie im folgenden Beispiel sehen:

Hinzufügen der Anspruchselemente

Öffnen Sie Ihre Datei TrustframeworkExtensions.xml, und fügen Sie das folgende ClaimType-Element mit dem Bezeichner identityProviderAccessToken zum ClaimsSchema-Element hinzu:

<BuildingBlocks>
  <ClaimsSchema>
    <ClaimType Id="identityProviderAccessToken">
      <DisplayName>Identity Provider Access Token</DisplayName>
      <DataType>string</DataType>
      <AdminHelpText>Stores the access token of the identity provider.</AdminHelpText>
    </ClaimType>
    ...
  </ClaimsSchema>
</BuildingBlocks>

Fügen Sie für jeden OAuth 2.0-Anbieter, für den Sie ein Zugriffstoken benötigen, das OutputClaim-Element zum TechnicalProfile-Element hinzu. Das folgende Beispiel zeigt, wie das Element zum technischen Profil für Facebook hinzugefügt wurde:

<ClaimsProvider>
  <DisplayName>Facebook</DisplayName>
  <TechnicalProfiles>
    <TechnicalProfile Id="Facebook-OAUTH">
      <OutputClaims>
        <OutputClaim ClaimTypeReferenceId="identityProviderAccessToken" PartnerClaimType="{oauth2:access_token}" />
      </OutputClaims>
      ...
    </TechnicalProfile>
  </TechnicalProfiles>
</ClaimsProvider>

Speichern Sie die Datei TrustframeworkExtensions.xml.

Öffnen Sie Ihre Richtliniendatei der vertrauenden Seite, z.B. SignUpOrSignIn.xml, und fügen Sie das OutputClaim-Element zum TechnicalProfile-Element hinzu:

<RelyingParty>
  <DefaultUserJourney ReferenceId="SignUpOrSignIn" />
  <TechnicalProfile Id="PolicyProfile">
    <OutputClaims>
      <OutputClaim ClaimTypeReferenceId="identityProviderAccessToken" PartnerClaimType="idp_access_token"/>
    </OutputClaims>
    ...
  </TechnicalProfile>
</RelyingParty>

Speichern Sie die Richtliniendatei.

Testen Ihrer Richtlinie

Wenn Sie Ihre Anwendungen in Azure AD B2C testen, kann es nützlich sein, das Azure AD B2C-Token an https://jwt.ms zurückzugeben, um die darin enthaltenen Ansprüche zu überprüfen.

Hochladen der Dateien

Melden Sie sich beim Azure-Portal an.
Wenn Sie Zugriff auf mehrere Mandanten haben, wählen Sie das Symbol Einstellungen im Menü oben aus, um über das Menü Verzeichnisse + Abonnements zu Ihrem Azure AD B2C-Mandanten zu wechseln.
Wählen Sie links oben im Azure-Portal die Option Alle Dienste aus, suchen Sie nach Azure AD B2C, und wählen Sie dann diese Option aus.
Wählen Sie Framework für die Identitätsfunktion aus.
Klicken Sie auf der Seite „Benutzerdefinierte Richtlinien“ auf Richtlinie hochladen.
Aktivieren Sie Richtlinie überschreiben, sofern vorhanden, suchen Sie nach der Datei TrustframeworkExtensions.xml, und wählen Sie die Datei aus.
Klicken Sie auf Hochladen.
Wiederholen Sie die Schritte 5 bis 7 für die Datei der vertrauenden Seite, z.B. SignUpOrSignIn.xml.

Ausführen der Richtlinie

Öffnen Sie die Richtlinie, die Sie geändert haben. Beispiel: B2C_1A_signup_signin.
Wählen Sie für Anwendung Ihre Anwendung aus, die Sie zuvor registriert haben. Um das Token im nachstehenden Beispiel anzuzeigen, muss als Antwort-URL der Wert https://jwt.ms angegeben werden.
Wählen Sie Jetzt ausführen aus.

Sie sollten eine Ausgabe ähnlich wie im folgenden Beispiel sehen:

Übergeben des IDP-Aktualisierungstokens (optional)

Das vom Identitätsanbieter zurückgegebene Zugriffstoken ist für einen kurzen Zeitraum gültig. Einige Identitätsanbieter stellen auch ein Aktualisierungstoken zusammen mit dem Zugriffstoken aus. Ihre Clientanwendung kann dann dieses Aktualisierungstoken des Identitätsanbieters bei Bedarf gegen ein neues Zugriffstoken austauschen.

Die benutzerdefinierte Azure AD B2C-Richtlinie unterstützt derzeit nur die Übergabe des Aktualisierungstokens für OAuth 2.0-Identitätsanbieter, zu denen Facebook, Google und GitHub gehören.

Führen Sie die folgenden Schritte aus, um das Aktualisierungstoken des Identitätsanbieters zu übergeben:

Öffnen Sie Ihre Datei TrustframeworkExtensions.xml, und fügen Sie das folgende ClaimType-Element mit dem Bezeichner identityProviderRefreshToken zum ClaimsSchema-Element hinzu.
```
<ClaimType Id="identityProviderRefreshToken">
    <DisplayName>Identity provider refresh token</DisplayName>
    <DataType>string</DataType>
</ClaimType>
```

Fügen Sie für jeden OAuth 2.0-Identitätsanbieter, für den Sie ein Aktualisierungstoken benötigen, das OutputClaim-Element zum TechnicalProfile-Element hinzu. Das folgende Beispiel zeigt, wie das Element zum technischen Profil für Facebook hinzugefügt wurde:

<ClaimsProvider>
  <DisplayName>Facebook</DisplayName>
  <TechnicalProfiles>
    <TechnicalProfile Id="Facebook-OAUTH">
      <OutputClaims>
        <OutputClaim ClaimTypeReferenceId="identityProviderRefreshToken" PartnerClaimType="{oauth2:refresh_token}" />
      </OutputClaims>
      ...
    </TechnicalProfile>
  </TechnicalProfiles>
</ClaimsProvider>

Einige Identitätsanbieter erfordern, dass Sie Metadaten oder Bereiche in das technische Profil des Identitätsanbieters einschließen.
- Fügen Sie für den Google-Identitätsanbieter zwei Anspruchstypen access_type und prompt hinzu. Fügen Sie dann dem technischen Profil des Identitätsanbieters die folgenden Eingabeansprüche hinzu:
```
<InputClaims>
    <InputClaim ClaimTypeReferenceId="access_type" PartnerClaimType="access_type" DefaultValue="offline" AlwaysUseDefaultValue="true" />

    
    <InputClaim ClaimTypeReferenceId="prompt" PartnerClaimType="prompt" DefaultValue="consent" AlwaysUseDefaultValue="true" />
</InputClaims>
```
- Andere Identitätsanbieter haben möglicherweise unterschiedliche Methoden, um ein Aktualisierungstoken auszustellen. Befolgen Sie die Anweisungen für die Zielgruppe des Identitätsanbieters, und fügen Sie dem technischen Profil Ihres Identitätsanbieters die erforderlichen Elemente hinzu.
Speichern Sie die Änderungen, die Sie in Ihrer TrustframeworkExtensions.xml-Datei vorgenommen haben.