Kullanıcı profili öznitelikleri

Şunlar için geçerlidir: İş gücü kiracıları Dış kiracılar (daha fazla bilgi edinin)

Kaydolma sırasında topladığınız kullanıcı öznitelikleri, dizininizde kullanıcının profiliyle birlikte depolanır. Yerleşik kullanıcı öznitelikleri arasından seçim yapabilir veya özel kullanıcı öznitelikleri oluşturabilirsiniz.

• Şehir, ülke/bölge, e-posta adresi gibi yerleşik kullanıcı öznitelikleri Microsoft Entra Dış Kimlik'de kullanılabilir. Kaydolma sırasında toplamak istediğiniz yerleşik kullanıcı özniteliklerini seçebilirsiniz.

• Toplamak istediğiniz ek bilgiler için özel kullanıcı öznitelikleri oluşturabilirsiniz. Metin kutuları, radyo düğmeleri ve onay kutuları gibi öznitelikleri toplamak için kaydolma sayfasına çeşitli özel giriş denetimleri eklenebilir. Aşağıdaki örnek, özel giriş denetimlerinin bağlılık programı numarası özniteliklerini, kullanım koşulları için kullanım koşulları onayını ve gizlilik ilkesi onayını toplamak için nasıl kullanılabileceğini gösterir.

  

Yerleşik kullanıcı öznitelikleri

Microsoft Entra Dış Kimlik, kaydolma sırasında toplayabileceğiniz yerleşik kullanıcı özniteliklerine sahiptir. Microsoft Entra yönetim merkezinde kullanıcı akışları oluştururken bu öznitelikleri yapılandırabilirsiniz.

Bu tabloda, kayıt akışı sırasında toplayabileceğiniz yerleşik kullanıcı öznitelikleri özetlenir:

• Microsoft Entra yönetim merkezindeki etiket, Microsoft Entra yönetim merkezinde göründüğü gibi kullanıcı özniteliğinin adıdır.
• Programlanabilir ad, Microsoft Graph API'sinin kullanıcı kaynağında kullanılan kullanıcı özniteliğinin adıdır. Bu kullanıcı özniteliğini yerel kimlik doğrulamasında olduğu gibi program aracılığıyla kullanmak istediğinizde bu adı kullanırsınız.
• Veri türü , kullanıcı özniteliğinin veri türüdür.

Microsoft Entra yönetim merkezinde etiket	Programlanabilir ad	Veri türü	Açıklamalar
Şehir	şehir	String	Uzunluk üst sınırı 128 karakterdir.
Ülke/Bölge	ülke	String	Uzunluk üst sınırı 128 karakterdir.
Görünen Ad	displayName	String	Uzunluk üst sınırı 256 karakterdir.
E-posta Adresi	e-posta	String	Bu özellik vurgu karakterleri içeremez. Yerel kimlik doğrulama API'sinde bu özniteliğe kullanıcı adı olarak başvurulur.
Verilen Ad	givenName	String	Uzunluk üst sınırı 64 karakterdir.
İş unvanı	jobTitle	String	Uzunluk üst sınırı 128 karakterdir.
Posta Kodu	postalCode	String	Uzunluk üst sınırı 40 karakterdir.
Eyalet/İl	semt	String	Uzunluk üst sınırı 128 karakterdir.
Adres	streetAddress	String	Uzunluk üst sınırı 1024 karakterdir.
Soyadı	surname	String	Uzunluk üst sınırı 64 karakterdir.

Özel kullanıcı öznitelikleri

Uygulamanız yerleşik kullanıcı özniteliklerinin sağladığından daha fazla bilgi gerektiriyorsa, kendi özniteliklerinizi ekleyebilirsiniz. Bu öznitelikleri özel kullanıcı öznitelikleri olarak adlandırıyoruz.

Özel kullanıcı özniteliği tanımlamak için önce kiracı düzeyinde özniteliği oluşturursunuz, böylece kiracıdaki herhangi bir kullanıcı akışında kullanılabilir. Ardından, özniteliğini kaydolma kullanıcı akışınıza atar ve kayıt sayfasında nasıl görünmesini istediğinizi yapılandırabilirsiniz.

Özel kullanıcı öznitelikleri oluşturmayı öğrenin Özel kullanıcı öznitelikleri oluşturma makalesi.

Özel kullanıcı öznitelikleri giriş türleri

Özel kullanıcı özniteliklerini kullanmadan önce, toplamak istediğiniz her özel öznitelik için kullanıcı girişi toplamanın en iyi yolunu belirleyin. Kayıt sırasında aşağıdaki giriş türü denetimlerini kullanarak kullanıcılarınızdan bilgi toplayabilirsiniz:

• Dize metin kutusu
• Radyo düğmeleri
• Çoklu seçim onay kutuları
• Sayısal metin kutusu
• Tek seçim onay kutusu

Uygun veri türlerini ve kullanıcı giriş türlerini bulmak için bu tabloya bakın:

Veri türü	Kullanıcı giriş türü	Açıklama
String	TextBox	Serbest biçimli metin giriş alanı.
String	RadioSingleSelect	Yalnızca bir seçime izin verilen radyo düğmeleri serisi. Tek tek radyo düğmeleri için Metin , Markdown dilinde biçimlendirilmiş köprüler içerebilir.
String	Onay KutusuMultiSelect	Birden çok seçime izin verilen bir veya daha fazla onay kutusu serisi. Tek tek onay kutuları için Metin , Markdown dilinde biçimlendirilmiş köprüler içerebilir.
Boolean	Onay KutusuSingleSelect	Etiketli tek boole onay kutusu. Onay kutusunun Etiketi , Markdown dilinde biçimlendirilmiş köprüler içerebilir.
Int	NumericTextBox	Serbest biçimli tamsayı girdisi.

Onay kutuları ve radyo düğmeleri, kullanım koşulları ve gizlilik ilkeleri gibi diğer içeriğe köprüler içerebilir. Bu makalenin başındaki örnekte, yerleşik öznitelikleri ve özel öznitelikleri birleştiren bir kaydolma sayfası gösterilmektedir. Örnekte:

• Görünen Ad alanı yerleşik bir özniteliktir.
• Bağlılık Programı Numarası, sayısal tamsayı kabul eden serbest biçimli giriş alanına sahip özel bir özniteliktir. Int veri türünü ve NumericTextBox kullanıcı giriş türünü kullanarak bu biçimi yapılandırabilirsiniz.
• Kullanım koşulları ve gizlilik ilkesi özel öznitelikleri, köprü içeren etiketler içeren ayrı, tek seçimli onay kutularıdır. Varsayılan olarak CheckboxSingleSelect kullanıcı giriş türü olan Boole veri türünü kullanarak tek bir onay kutusu yapılandırabilirsiniz. Onay kutusu etiketine köprü eklemek için Markdown dilini kullanın.

Kullanıcı giriş türlerini yapılandırma makalesinde kullanıcı öznitelikleri giriş türlerini yapılandırmayı öğrenin.

Özel kullanıcı özniteliklerinin depolandığı yer

Özel kullanıcı öznitelikleri, dizininizde depolanan kullanıcı profili bilgilerini genişleten dizin uzantısı öznitelikleri olarak da bilinir. Dış kiracınızın tüm uzantı öznitelikleri b2c-extensions-app adlı bir uygulamada depolanır. Bir kullanıcı kayıt sırasında özel öznitelik için bir değer girdikten sonra, kullanıcı nesnesine eklenir ve adlandırma kuralı extension_{appId-without-hyphens}_{custom-attribute-name} kullanılarak Microsoft Graph API'sinde çağrılabilir:

• {appId-without-hyphens}, b2c-extensions-app için istemci kimliğinin kaldırılmış sürümüdür.
• {custom-attribute-name} , özel özniteliğe atadığınız addır.

Örneğin, b2c-extensions-app 2588a-bcdwh-tfeehj-jeeqw-ertc istemci kimliği ve öznitelik adı:

• loyaltyNumber, ardından özel özniteliği olarakextension_2588abcdwhtfeehjjeeqwertc_loyaltyNumber adlandırılır.
• Bağlılık Programı Numarası daha sonra özel öznitelik olarakextension_2588abcdwhtfeehjjeeqwertc_loyaltyNumber adlandırılır. Alanı kaldırır ve sözcükleri ayırmak için deve büyük/küçük harf kullanırsınız.

Dış kiracınızda kayıtlı b2c-extensions-app için uygulama kimliğini bulmayı öğrenmek için Uzantılar uygulamasının uygulama kimliğini bulma makalesini kullanın.

Microsoft Graph API'leri

Kullanıcı öznitelikleri, Microsoft Graph'ta kullanıcı akışı öznitelikleri olarak adlandırılır. Hem yerleşik hem de özel kullanıcı akışı özniteliklerini yönetmek için identityUserFlowAttribute kaynak türünü ve ilişkili yöntemlerini kullanın.

İlgili içerik

• Uygulamanıza döndürülen kimlik belirtecine öznitelikler ekleyin.

• Müşteriler için kaydolma ve oturum açma kullanıcı akışı oluşturma hakkında daha fazla bilgi edinin.

• Yerel kimlik doğrulaması MSAL Android SDK öznitelik oluşturucusu.