Aracılığıyla paylaş

Kullanıcı profili öznitelikleri

  • Makale

Şunlar için geçerlidir: Gri X simgesine sahip beyaz daire. İş gücü kiracılarıBeyaz onay işareti simgesi olan yeşil daire.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.

    Kullanım koşulları ve gizlilik ilkesi onay kutularını içeren bir kaydolma sayfasının ekran görüntüsü.

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 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-app2588a-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