Definieren benutzerdefinierter Attribute in Azure Active Directory B2C

• 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.

Verwenden eines benutzerdefinierten Attributs in einem Benutzerflow

1. Wählen Sie in Ihrem Azure AD B2C-Mandanten die Option Benutzerflows aus.
2. Wählen Sie eine Richtlinie aus (z.B. „B2C_1_SignupSignin“), um sie zu öffnen.
3. Wählen Sie Benutzerattribute und dann das benutzerdefinierte Attribut aus (z.B. „ShoeSize“). Wählen Sie Speichern aus.
4. Wählen Sie Anwendungsansprüche und dann das benutzerdefinierte Attribut aus.
5. Wählen Sie Speichern aus.

Nachdem Sie einen neuen Benutzer mithilfe des Benutzerflows erstellt haben, können Sie das Feature Benutzerflow ausführen für den Benutzerflow verwenden, um die Kundenumgebung zu überprüfen. ShoeSize sollte jetzt in der Liste der Attribute, die während der Registrierung erfasst werden, sowie in dem Token angezeigt werden, das zurück an die Anwendung gesendet wird.

Abrufen der Anwendungs-ID der Erweiterungs-App

1. Melden Sie sich beim Azure-Portal an.
2. Wenn Sie Zugriff auf mehrere Mandanten haben, wählen Sie das Symbol Einstellungen im Menü oben, um über das Menü Verzeichnisse + Abonnements zu Ihrem Azure AD B2C Mandanten zu wechseln.
3. Wählen Sie im linken Menü die Option Azure AD B2C aus. Oder wählen Sie Alle Dienste aus, suchen Sie nach dem Eintrag Azure AD B2C, und wählen Sie ihn aus.
4. Wählen Sie App-Registrierungen und dann Alle Anwendungen aus.
5. Wählen Sie die Anwendung b2c-extensions-app. Do not modify. Used by AADB2C for storing user data. aus.
6. Kopieren Sie die Anwendungs-ID. Beispiel: 11111111-1111-1111-1111-111111111111.

Abrufen der Anwendungseigenschaften der Erweiterungs-App

1. Melden Sie sich beim Azure-Portal an.
2. Wenn Sie Zugriff auf mehrere Mandanten haben, wählen Sie das Symbol Einstellungen im Menü oben, um über das Menü Verzeichnisse + Abonnements zu Ihrem Azure AD B2C Mandanten zu wechseln.
3. Wählen Sie im linken Menü die Option Azure AD B2C aus. Oder wählen Sie Alle Dienste aus, suchen Sie nach dem Eintrag Azure AD B2C, und wählen Sie ihn aus.
4. Wählen Sie App-Registrierungen und dann Alle Anwendungen aus.
5. Wählen Sie die Anwendung b2c-extensions-app. Do not modify. Used by AADB2C for storing user data. (b2c-extensions-app. Nicht ändern. Wird von AADB2C zum Speichern von Benutzerdaten verwendet.) aus.
6. Kopieren Sie die folgenden Bezeichner in die Zwischenablage, und speichern Sie sie:
   • Anwendungs-ID. Beispiel: 11111111-1111-1111-1111-111111111111.
   • Objekt-ID Beispiel: 22222222-2222-2222-2222-222222222222.

Ändern der benutzerdefinierten Richtlinie

Um benutzerdefinierte Attribute in Ihrer Richtlinie zu aktivieren, geben Sie die Anwendungs-ID und Objekt-ID der Anwendung in den Metadaten des technischen Profils AAD-Common an. Das technische Profil AAD-Common* ist im technischen Basisprofil Microsoft Entra ID enthalten und bietet Unterstützung für die Benutzerverwaltung in Microsoft Entra. Andere technische Profile von Microsoft Entra ID enthalten AAD-Common, um die zugehörige Konfiguration zu verwenden. Überschreiben Sie das technische Profil AAD-Common in der Erweiterungsdatei.

1. Öffnen Sie die Erweiterungsdatei Ihrer Richtlinie. Beispiel: SocialAndLocalAccounts/TrustFrameworkExtensions.xml.

2. Wechseln Sie zum ClaimsProviders-Element. Fügen Sie dem ClaimsProviders-Element ein neues ClaimsProvider-Element hinzu.

3. Fügen Sie die zuvor erfasste Anwendungs-ID zwischen dem öffnenden und dem schließenden Element (<Item Key="ClientId"> und </Item>) ein.

4. Fügen Sie die zuvor erfasste Anwendungsobjekt-ID zwischen dem öffnenden und dem schließenden Element (<Item Key="ApplicationObjectId"> und </Item>) ein.

   <!-- 
   <ClaimsProviders> -->
     <ClaimsProvider>
       <DisplayName>Azure Active Directory</DisplayName>
       <TechnicalProfiles>
         <TechnicalProfile Id="AAD-Common">
           <Metadata>
             <!--Insert b2c-extensions-app application ID here, for example: 11111111-1111-1111-1111-111111111111-->  
             <Item Key="ClientId"></Item>
             <!--Insert b2c-extensions-app application ObjectId here, for example: 22222222-2222-2222-2222-222222222222-->
             <Item Key="ApplicationObjectId"></Item>
           </Metadata>
         </TechnicalProfile>
       </TechnicalProfiles> 
     </ClaimsProvider>
   <!-- 
   </ClaimsProviders> -->
   

Hochladen der benutzerdefinierten Richtlinie

1. Melden Sie sich beim Azure-Portal an.
2. Wenn Sie Zugriff auf mehrere Mandanten haben, wählen Sie das Symbol Einstellungen im Menü oben, um über das Menü Verzeichnisse + Abonnements zu Ihrem Azure AD B2C Mandanten zu wechseln.
3. Klicken Sie links oben im Azure-Portal auf Alle Dienste, suchen Sie nach App-Registrierungen, und wählen Sie dann diese Option aus.
4. Wählen Sie Framework für die Identitätsfunktion aus.
5. Wählen Sie Benutzerdefinierte Richtlinie hochladen aus, und laden Sie dann die geänderten Richtliniendateien des Typs „TrustFrameworkExtensions.xml“ hoch.

Erstellen eines benutzerdefinierten Attributs im Azure-Portal

Von integrierten und benutzerdefinierten Profilen werden dieselben Erweiterungsattribute genutzt. Beim Hinzufügen benutzerdefinierter Attribute auf der Portaloberfläche werden diese Attribute mithilfe von der in jedem B2C-Mandanten vorhandenen b2c-extensions-app registriert.

Sie können diese Attribute auf der Portalbenutzeroberfläche erstellen, bevor Sie sie in Ihren benutzerdefinierten Richtlinien einsetzen. Wenn Sie im Portal das Attribut loyaltyId erstellen, müssen Sie wie folgt darauf verweisen:

Das folgende Beispiel veranschaulicht die Verwendung benutzerdefinierter Attribute in einer benutzerdefinierten Azure AD B2C-Anspruchsdefinition für eine Richtlinie.

<BuildingBlocks>
  <ClaimsSchema>
    <ClaimType Id="extension_loyaltyId">
      <DisplayName>Loyalty Identification</DisplayName>
      <DataType>string</DataType>
      <UserHelpText>Your loyalty number from your membership card</UserHelpText>
      <UserInputType>TextBox</UserInputType>
    </ClaimType>
  </ClaimsSchema>
</BuildingBlocks>

Das folgende Beispiel veranschaulicht die Verwendung eines benutzerdefinierten Attributs in der benutzerdefinierten Azure AD B2C-Richtlinie in einem technischen Profil, einer Eingabe, einer Ausgabe und persistent gespeicherten Ansprüchen.

<InputClaims>
  <InputClaim ClaimTypeReferenceId="extension_loyaltyId"  />
</InputClaims>
<PersistedClaims>
  <PersistedClaim ClaimTypeReferenceId="extension_loyaltyId" />
</PersistedClaims>
<OutputClaims>
  <OutputClaim ClaimTypeReferenceId="extension_loyaltyId" />
</OutputClaims>

Führen Sie die folgenden Schritte aus, um ein benutzerdefiniertes Attribut aus einem Benutzerflow in Ihrem Mandaten zu entfernen:

1. Melden Sie sich beim Azure-Portal als globaler Administrator Ihres Azure AD B2C-Mandanten an.
2. Stellen Sie sicher, dass Sie das Verzeichnis verwenden, das Ihren Azure AD B2C-Mandanten enthält:
   1. Wählen Sie auf der Symbolleiste des Portals das Symbol Verzeichnisse und Abonnements aus.
   2. Suchen Sie auf der Seite Portaleinstellungen > Verzeichnisse und Abonnements Ihr Azure AD B2C-Verzeichnis in der Verzeichnisliste, und wählen Sie dann Wechseln aus.
3. Klicken Sie links oben im Azure-Portal auf Alle Dienste, suchen Sie nach Azure AD B2C, und klicken Sie darauf.
4. Wählen Sie Benutzerattribute und dann das zu löschende Benutzerattribut aus.
5. Wählen Sie Löschen und dann Ja aus, um den Löschvorgang zu bestätigen.

Verwenden Sie die Microsoft Graph-API, um die benutzerdefinierten Attribute zu verwalten.