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 | 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-app 2588a-bcdwh-tfeehj-jeeqw-ertc a název atributu:
- loyaltyNumber, pak vlastní atribut je pojmenován jako
extension_2588abcdwhtfeehjjeeqwertc_loyaltyNumber. - Číslo věrnosti pak vlastní atribut je pojmenován jako
extension_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ř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