Atributy profilu uživatele

Platí pro: Tenanti pracovních sil – externí tenanti (další informace)

Atributy uživatele, které shromažďujete při registraci, se ukládají s profilem uživatele ve vašem adresáři. Můžete si vybrat z předdefinovaných atributů uživatele nebo vytvořit vlastní atributy uživatele.

• Předdefinované atributy uživatelů, jako jsou město, země/oblast, e-mailová adresa atd., jsou k dispozici v Microsoft Entra Externí ID. Můžete zvolit předdefinované atributy uživatele, které chcete shromažďovat při registraci.

• Pro všechny další informace, které chcete shromáždit, můžete vytvořit vlastní atributy uživatele. Na registrační stránku je možné přidat několik vlastních ovládacích prvků pro zadávání, které shromáždí atributy, včetně textových polí, přepínačů a zaškrtávacích políček. Následující příklad ukazuje, jak lze vlastní vstupní ovládací prvky použít ke shromažďování atributů pro číslo věrnosti, podmínky souhlasu s používáním podmínek použití a souhlas se zásadami ochrany osobních údajů.

  

Předdefinované atributy uživatele

Microsoft Entra Externí ID má předdefinované atributy uživatele, které můžete shromažďovat během registrace. Tyto atributy nakonfigurujete při vytváření toků uživatelů v Centru pro správu Microsoft Entra.

Tato tabulka shrnuje předdefinované atributy uživatele, které můžete shromažďovat během procesu registrace:

• Popisek v Centru pro správu Microsoft Entra je název atributu uživatele, který se zobrazí v Centru pro správu Microsoft Entra.
• Programovatelný název je název atributu uživatele, který se používá v uživatelském prostředku rozhraní Microsoft Graph API. Tento název použijete, pokud chcete tento atribut uživatele používat programově, například v nativním ověřování.
• Datový typ je datový typ atributu uživatele.

Popisek v Centru pro správu Microsoft Entra	Programovatelný název	Datový typ	Poznámky
Město	city	String	Maximální délka je 128 znaků.
Země/oblast	country	String	Maximální délka je 128 znaků.
Zobrazovaný název	displayName	String	Maximální délka je 256 znaků.
E-mailová adresa	pošta	String	Tato vlastnost nemůže obsahovat zvýrazňující znaky. V nativním ověřovacím rozhraní API se na tento atribut odkazuje jako na uživatelské jméno.
jméno	givenName	String	Maximální délka je 64 znaků.
Funkce	jobTitle	String	Maximální délka je 128 znaků.
PSČ	postalCode	String	Maximální délka je 40 znaků.
Stát/kraj	state	String	Maximální délka je 128 znaků.
Adresa	streetAddress	String	Maximální délka je 1024 znaků.
Příjmení	surname	String	Maximální délka je 64 znaků.

Vlastní atributy uživatele

Pokud vaše aplikace vyžaduje více informací než předdefinované atributy uživatelů, můžete přidat vlastní atributy. Tyto atributy označujeme jako vlastní atributy uživatele.

Pokud chcete definovat vlastní atribut uživatele, nejprve vytvoříte atribut na úrovni tenanta, aby ho bylo možné použít v libovolném toku uživatele v tenantovi. Potom přiřadíte atribut toku uživatele pro registraci a nakonfigurujete, jak se má zobrazit na registrační stránce.

Přečtěte si, jak vytvořit vlastní atributy uživatele. Článek o vytváření vlastních atributů uživatele.

Vlastní atributy uživatele – vstupní typy

Než použijete vlastní atributy uživatele, určete nejlepší způsob, jak shromáždit vstup uživatele pro každý vlastní atribut, který chcete shromáždit. Během registrace můžete shromažďovat informace od uživatelů pomocí následujících ovládacích prvků typu vstupu:

• Textové pole Řetězec
• Přepínače
• Vícenásobný výběr zaškrtávacích políček
• Číselné textové pole
• Zaškrtávací políčko s jedním zaškrtnutím

Informace o vhodných datových typech a typech uživatelských vstupů najdete v této tabulce:

Datový typ	Typ vstupu uživatele	Popis
String	TextBox	Pole pro zadání volného textu
String	RadioSingleSelect	Řada přepínačů s povoleným pouze jedním výběrem. Text pro jednotlivá přepínače může obsahovat hypertextové odkazy formátované v jazyce Markdown.
String	CheckboxMultiSelect	Řada jednoho nebo více zaškrtávacích políček s povoleným vícenásobným výběrem Text pro jednotlivá zaškrtávací políčka může obsahovat hypertextové odkazy formátované v jazyce Markdown.
Logická hodnota	CheckboxSingleSelect	Jedno logické zaškrtávací políčko s popiskem Popisek zaškrtávacího políčka může obsahovat hypertextové odkazy formátované v jazyce Markdown.
Int	NumericTextBox	Celočíselná položka volného tvaru

Zaškrtávací políčka a přepínače můžou obsahovat hypertextové odkazy na jiný obsah, například podmínky použití a zásady ochrany osobních údajů. Příklad na začátku tohoto článku ukazuje registrační stránku, která kombinuje předdefinované atributy a vlastní atributy. V tomto příkladu:

• Pole Zobrazovaný název je předdefinovaný atribut.
• Číslo věrnosti je vlastní atribut s volným vstupním polem, které přijímá číselné celé číslo. Tento formát můžete nakonfigurovat pomocí datového typu Int a typu vstupu uživatele NumericTextBox .
• Podmínky použití a vlastní atributy zásad ochrany osobních údajů jsou samostatné a jedno zaškrtávací políčka s popisky obsahujícími hypertextové odkazy. Jedno zaškrtávací políčko můžete nakonfigurovat pomocí logického datového typu, který je výchozím nastavením typu CheckboxSingleSelect uživatele. Pomocí jazyka Markdown můžete přidat hypertextové odkazy na popisek zaškrtávacího políčka.

Přečtěte si, jak nakonfigurovat vstupní typy atributů uživatelů v článku Konfigurace typů uživatelských vstupů.

Kde jsou uložené vlastní atributy uživatele

Vlastní atributy uživatele se také označují jako atributy rozšíření adresáře, protože rozšiřují informace o profilu uživatele uložené ve vašem adresáři. Všechny atributy rozšíření vašeho externího tenanta se ukládají do aplikace s názvem b2c-extensions-app. Když uživatel během registrace zadá hodnotu vlastního atributu, přidá se do objektu uživatele a dá se volat prostřednictvím rozhraní Microsoft Graph API pomocí konvence extension_{appId-without-hyphens}_{custom-attribute-name} vytváření názvů, kde:

• {appId-without-hyphens} je oříznutá verze ID klienta pro aplikaci b2c-extensions-app.
• {custom-attribute-name} je název, který jste přiřadili vlastnímu atributu.

Pokud je například ID klienta aplikace b2c-extensions-app2588a-bcdwh-tfeehj-jeeqw-ertc a název atributu:

• loyaltyNumber, pak vlastní atribut je pojmenován jakoextension_2588abcdwhtfeehjjeeqwertc_loyaltyNumber.
• Číslo věrnosti pak vlastní atribut je pojmenován jakoextension_2588abcdwhtfeehjjeeqwertc_loyaltyNumber. Mezeru odeberete a použijete camel case k oddělení slov.

V článku o aplikaci rozšíření zjistěte, jak najít ID aplikace pro b2c-extensions-app zaregistrovanou ve vašem externím tenantovi.

Rozhraní Microsoft Graph API

Atributy uživatele se v Microsoft Graphu označují jako atributy toku uživatele. Ke správě předdefinovaných i vlastních atributů toku uživatele použijte typ prostředku identityUserFlowAttribute a jeho přidružené metody.

Související obsah

• Přidejte atributy do tokenu ID vráceného do vaší aplikace.

• Přečtěte si další informace o vytváření toku uživatelů registrace a přihlašování pro zákazníky.

• Tvůrce atributů nativního ověřování SADY MSAL Android SDK