Attribut för användarprofil

Ditt Azure Active Directory B2C-användarprofil har en serie inbyggda attribut, till exempel förnamn, efternamn, ort, postnummer och telefonnummer. Du kan utöka användarprofilen med dina egna programdata utan att kräva ett externt datalager.

Microsoft Graph API stöder de flesta attribut som du kan använda med Azure Den här artikeln beskriver användarprofilattribut som Azure AD B2C stöder. Den noterar även de attribut som Microsoft Graph inte stöder och Microsoft Graph API-attribut som Azure AD B2C inte bör använda.

Du kan också integrera med externa system. Du kan till exempel använda Azure AD B2C för autentisering, men delegera till en extern kundrelationshantering (CRM) eller kundlojalitetsdatabas som auktoritativ källa för kunddata. Mer information finns i fjärrprofillösningen .

Microsoft Entra-användarresurstyp

Azure AD B2C-kataloganvändarprofilen stöder attributen för användarresurstypen som anges i tabellen nedan. Den ger följande information om varje attribut:

• Attributnamn som används av Azure AD B2C (följt av Microsoft Graph-namnet inom parenteser, om det är annorlunda)
• Attributdatatyp
• Attributbeskrivning
• Om attributet är tillgängligt i Azure-portalen
• Om attributet kan användas i ett användarflöde
• Om attributet kan användas i en anpassad policy Microsoft Entra ID teknisk profil och i vilket avsnitt (<InputClaims>, <OutputClaims> eller <PersistedClaims>)

¹ Stöds inte av Microsoft Graph
² Mer information finns i MFA-telefonnummerattribut
³ Bör inte användas med Azure AD B2C

Obligatoriska attribut

Om du vill skapa ett användarkonto i Azure AD B2C-katalogen anger du följande obligatoriska attribut:

• Visningsnamn

• Identiteter – med minst en entitet (ett lokalt eller ett federerat konto).

• Lösenordsprofil – Om du skapar ett lokalt konto anger du lösenordsprofilen.

Visningsnamnsattribut

displayName är namnet som ska visas i Azure-portalens användarhantering för användaren och i åtkomsttoken som Azure AD B2C returnerar till programmet. Denna egenskap är obligatorisk.

Identitetsattribut

Ett kundkonto, som kan vara en konsument, partner eller medborgare, kan associeras med dessa identitetstyper:

• Lokal identitet – Användarnamnet och lösenordet lagras lokalt i Azure AD B2C-katalogen. Vi kallar ofta dessa identiteter för "lokala konton".
• Federerad identitet – Även kallat sociala konton eller företagskonton hanteras användarens identitet av en federerad identitetsprovider som Facebook, Microsoft, ADFS eller Salesforce.

En användare med ett kundkonto kan logga in med flera identiteter. Till exempel användarnamn, e-post, medarbetar-ID, myndighets-ID och andra. Ett enda konto kan ha flera identiteter, både lokala och sociala, med samma lösenord.

I Microsoft Graph API lagras både lokala och federerade identiteter i användarattributet identities , som är av typen objectIdentity. Samlingen identities representerar en uppsättning identiteter som används för att logga in på ett användarkonto. Med den här samlingen kan användaren logga in på användarkontot med någon av sina associerade identiteter. Identitetsattributet kan innehålla upp till 10 objektIdentitetsobjekt . Varje objekt innehåller följande egenskaper:

Följande JSON-kodfragment visar attributet Identiteter , med en lokal kontoidentitet med ett inloggningsnamn, en e-postadress som inloggning och med en social identitet.

"identities": [
  {
    "signInType": "userName",
    "issuer": "contoso.onmicrosoft.com",
    "issuerAssignedId": "johnsmith"
  },
  {
    "signInType": "emailAddress",
    "issuer": "contoso.onmicrosoft.com",
    "issuerAssignedId": "jsmith@yahoo.com"
  },
  {
    "signInType": "federated",
    "issuer": "facebook.com",
    "issuerAssignedId": "5eecb0cd"
  }
]

För federerade identiteter, beroende på identitetsprovidern, är issuerAssignedId ett unikt värde för en viss användare per program eller utvecklingskonto. Konfigurera Azure AD B2C-principen med samma program-ID som den sociala providern eller ett annat program inom samma utvecklingskonto tilldelar.

Lösenordsprofilinställning

För en lokal identitet krävs attributet passwordProfile och innehåller användarens lösenord. Attributet forceChangePasswordNextSignIn anger om en användare måste återställa lösenordet vid nästa inloggning. Om du vill hantera en tvingad lösenordsåterställning använder du anvisningarna i konfigurerat flöde för tvingad lösenordsåterställning.

För en federerad (social) identitet krävs inte attributet passwordProfile .

"passwordProfile" : {
    "password": "password-value",
    "forceChangePasswordNextSignIn": false
  }

Lösenordsprincipattribut

Azure AD B2C-lösenordsprincipen (för lokala konton) baseras på principen för stark lösenordsstyrka i Microsoft Entra-ID. Policyerna för registrering eller inloggning och återställning av lösenord i Azure AD B2C kräver den här starka lösenordsstyrkan och gör inte lösenord inaktuella.

Om de konton som du vill migrera i användarmigreringsscenarier har svagare lösenordsstyrka än den starka lösenordsstyrka som tillämpas av Azure AD B2C kan du inaktivera det starka lösenordskravet. Om du vill ändra standardprincipen för lösenord anger du attributet passwordPolicies till DisableStrongPassword. Du kan till exempel ändra den skapade användarbegäran på följande sätt:

"passwordPolicies": "DisablePasswordExpiration, DisableStrongPassword"

MFA-telefonnummerattribut

När du använder en telefon för multifaktorautentisering (MFA) används mobiltelefonen för att verifiera användaridentiteten. Om du vill lägga till ett nytt telefonnummer programmatiskt, uppdatera, hämta eller ta bort telefonnumret använder du ms Graph API-autentiseringsmetoden för telefon.

I Azure AD B2C anpassade principer är telefonnumret tillgängligt via strongAuthenticationPhoneNumber anspråkstyp.

Tilläggsattribut

Alla kundinriktade program har unika krav för att informationen ska samlas in. Din Azure AD B2C-klientorganisation har en inbyggd uppsättning information som lagras i egenskaper, till exempel förnamn, efternamn och postnummer. Med Azure AD B2C kan du utöka uppsättningen egenskaper som lagras i varje kundkonto. Mer information finns i Lägga till användarattribut och anpassa användarindata i Azure Active Directory B2C

Tilläggsattribut utökar schemat för användarobjekten i katalogen. Tilläggsattributen kan bara registreras på ett programobjekt, även om de kan innehålla data för en användare. Tilläggsattributet är kopplat till programmet med namnet b2c-extensions-app. Ändra inte det här programmet eftersom det används av Azure AD B2C för lagring av användardata. Du hittar det här programmet under Microsoft Entra-appregistreringar. Läs mer om Azure AD B2Cb2c-extensions-app.

Tilläggsattribut i Microsoft Graph-API:et namnges med hjälp av konventionen extension_ApplicationClientID_AttributeName, där:

• ApplicationClientID är applikationens (klienten) IDb2c-extensions-app. Lär dig hur du hittar tilläggsappen.
• AttributeName är namnet på tilläggsattributet.

Program-ID(klient)-ID:t när det används för att skapa namnet på tilläggsattributet innehåller inte bindestreck. Till exempel:

"extension_831374b3bd5041bfaa54263ec9e050fc_loyaltyNumber": "212342"

Följande datatyper stöds när du definierar ett attribut i ett schematillägg:

Relaterat innehåll

Läs mer om tilläggsattribut:

• Schematillägg
• Definiera anpassade attribut