Kullanıcı profili öznitelikleri

Önemli

1 Mayıs 2025 tarihinden itibaren Azure AD B2C artık yeni müşteriler için satın alınamayacak. SSS bölümünden daha fazla bilgi edinebilirsiniz.

Azure Active Directory B2C (Azure AD B2C) dizin kullanıcı profiliniz, verilen ad, soyadı, şehir, posta kodu ve telefon numarası gibi bir dizi yerleşik öznitelikle birlikte gelir. Dış veri deposuna gerek kalmadan kullanıcı profilini kendi uygulama verilerinizle genişletebilirsiniz.

Microsoft Graph API,Azure ile kullanabileceğiniz özniteliklerin çoğunu destekler Bu makalede, Azure AD B2C'nin desteklediği kullanıcı profili öznitelikleri açıklanmaktadır. Ayrıca Microsoft Graph'ın desteklemediği öznitelikleri ve Azure AD B2C'nin kullanmaması gereken Microsoft Graph API özniteliklerini not eder.

Önemli

Hesap kimlik bilgileri, kamu kimlik numaraları, kart sahibi verileri, finansal hesap verileri, sağlık bilgileri veya hassas arka plan bilgileri gibi hassas kişisel verileri depolamak için yerleşik veya uzantı özniteliklerini kullanmamalısınız.

Dış sistemlerle de tümleştirebilirsiniz. Örneğin, kimlik doğrulaması için Azure AD B2C kullanabilir, ancak müşteri verilerinin yetkili kaynağı olarak dış müşteri ilişkileri yönetimine (CRM) veya müşteri bağlılığı veritabanına temsilci atayabilirsiniz. Daha fazla bilgi için bkz. uzak profil çözümü.

Microsoft Entra kullanıcı kaynak türü

Azure AD B2C dizin kullanıcı profili, aşağıdaki tabloda listelenen kullanıcı kaynak türü özniteliklerini destekler. Her öznitelik hakkında aşağıdaki bilgileri verir:

  • Azure AD B2C tarafından kullanılan öznitelik adı (ardından parantez içinde Microsoft Graph adı (farklıysa)
  • Öznitelik veri türü
  • Öznitelik açıklaması
  • Özniteliğin Azure portalında kullanılabilir olup olmadığı
  • Özniteliğin bir kullanıcı akışında kullanılıp kullanılamayacağı
  • Özniteliğin özel bir ilkede Microsoft Entra ID teknik profilinde ve hangi bölümde (<InputClaims>, <OutputClaims>, veya <PersistedClaims>) kullanılıp kullanılamayacağı
İsim Veri türü Açıklama Azure portalında kullanılabilir Kullanıcı akışlarında kullanılır Özel politikada kullanılır
hesap etkinleştirildi Boolean (Boole Mantığı) Kullanıcı hesabının etkinleştirilip etkinleştirilmediği veya devre dışı bırakılıp bırakılmadığı: hesap etkinse true , aksi takdirde false. Evet Hayı Kalıcı, Çıktı
yaş grubu Dize Kullanıcının yaş grubu. Olası değerler: null, Undefined, Küçük, Yetişkin, Yetişkin Değil. Evet Hayı Kalıcı, Çıktı
alternativeSecurityId (Kimlikler) Dize Dış kimlik sağlayıcısından tek bir kullanıcı kimliği. Hayı Hayı Giriş, Kalıcı, Çıkış
alternativeSecurityIds (Kimlikler) alternatif securityId koleksiyonu Dış kimlik sağlayıcılarından kullanıcı kimlikleri koleksiyonu. Hayı Hayı Kalıcı, Çıktı
şehir Dize Kullanıcının ikametgahı... Maksimum uzunluk 128. Evet Evet Kalıcı, Çıktı
Reşit Olmayan İçin Onay Verildi Dize Reşit olmayan bir çocuk için onayın sağlanıp sağlanmadığı. İzin verilen değerler: null, verildi, reddedildi veya notRequired. Evet Hayı Kalıcı, Çıktı
ülke Dize Kullanıcının ikamet ettiği ülke/bölge.. Örneğin: ABD veya Birleşik Krallık. Maksimum uzunluk 128. Evet Evet Kalıcı, Çıktı
oluşturulmaTarihiSaati Tarih ve Saat Kullanıcı nesnesinin oluşturulduğu tarih. Sadece okunur. Hayı Hayı Kalıcı, Çıktı
creationType Dize Kullanıcı hesabı bir Azure Active Directory B2C kiracısı için yerel hesap olarak oluşturulduysa, değer LocalAccount veya nameCoexistence olur. Sadece okunur. Hayı Hayı Kalıcı, Çıktı
doğumTarihi Tarih Doğum tarihi. Hayı Hayı Kalıcı, Çıktı
bölüm / departman Dize Kullanıcının çalıştığı bölümün adı. Maksimum uzunluk 64. Evet Hayı Kalıcı, Çıktı
ekran adı Dize Kullanıcının görünen adı. Maksimum uzunluk 256. Evet Evet Kalıcı, Çıktı
faksTelefonNumarası1 Dize Kullanıcının iş faks makinesinin telefon numarası. Evet Hayı Kalıcı, Çıktı
verilenAdi Dize Kullanıcının verilen adı (ilk ad). Maksimum uzunluk 64. Evet Evet Kalıcı, Çıktı
iş unvanı Dize Kullanıcının iş unvanı. Maksimum uzunluk 128. Evet Evet Kalıcı, Çıktı
değiştirilmezId Dize Genellikle şirket içi Active Directory'den geçirilen kullanıcılar için kullanılan bir tanımlayıcı. Hayı Hayı Kalıcı, Çıktı
yasal yaş grubu sınıflandırması Dize Yasal yaş grubu sınıflandırması. Salt okunur ve ageGroup ve consentProvidedForMinor özelliklerine göre hesaplanır. İzin verilen değerler: null, ebeveyn izni olmadan küçük, ebeveyn izni ile küçük, ebeveyn izni gerekmeyen küçük, yetişkin olmayan ve yetişkin. Evet Hayı Kalıcı, Çıktı
yasalÜlke1 Dize Yasal amaçlar için Ülke/Bölge. Hayı Hayı Kalıcı, Çıktı
posta takma adı Dize Kullanıcının posta diğer adı. Maksimum uzunluk 64. Hayı Hayı Kalıcı, Çıktı
mobil (cep telefonu) Dize Kullanıcının birincil cep telefonu numarası. Maksimum uzunluk 64. Evet Hayı Kalıcı, Çıktı
net Kimliği Dize Ağ Kimliği. Hayı Hayı Kalıcı, Çıktı
objectId (nesne kimliği) Dize Kullanıcı için benzersiz tanımlayıcı olan Küresel Benzersiz Tanımlayıcı (GUID). Örnek: 12345678-9abc-def0-1234-56789abcde. Salt okunur, değişmez. Yalnızca Okunur Evet Giriş, Kalıcı, Çıkış
diğer Postalar Dizgi koleksiyonu Kullanıcının diğer e-posta adreslerinin listesi. Örnek: [""bob@contoso.com, "Robert@fabrikam.com"]. Dikkat: Aksanlı karakterlere izin verilmez. Evet (Alternatif e-posta) Hayı Kalıcı, Çıktı
şifre Dize Kullanıcı oluşturma sırasında yerel hesabın parolası. Hayı Hayı Kalıcı
şifre politikaları Dize Parola ilkesi. Virgülle ayrılmış farklı ilke adından oluşan bir dizedir. Örneğin, "DisablePasswordExpiration, DisableStrongPassword". Hayı Hayı Kalıcı, Çıktı
Fiziksel Teslimat Ofis Adı (Ofis Konumu) Dize Kullanıcının iş yerindeki ofis konumu. Maksimum uzunluk 128. Evet Hayı Kalıcı, Çıktı
posta kodu Dize Kullanıcının posta adresinin posta kodu. Posta kodu kullanıcının ülkesine/bölgesine özgüdür. Amerika Birleşik Devletleri'nde bu öznitelik posta kodunu içerir. Maksimum uzunluk 40. Evet Hayı Kalıcı, Çıktı
tercih edilen dil Dize Kullanıcı için tercih edilen dil. Tercih edilen dil biçimi RFC 4646'ya dayanır. Ad, dille ilişkilendirilmiş ISO 639 iki harfli küçük harfli kültür kodunun ve ülke veya bölgeyle ilişkilendirilmiş ISO 3166 iki harfli büyük harfli alt kültür kodunun birleşimidir. Örneğin: en-USveya es-ES. Hayı Hayı Kalıcı, Çıktı
refreshTokenGeçerlilikTarihi (oturumlarGeçerlilikTarihi) Tarih ve Saat Bu süreden önce verilen tüm yenileme belirteçleri geçersizdir ve uygulamalar yeni erişim belirteci almak için geçersiz yenileme belirteci kullanırken hata alır. Bu durumda, uygulamanın yetkili uç noktaya istekte bulunarak yeni bir yenileme belirteci alması gerekir. Yalnızca okunabilir Hayı Hayı Çıktı
signInNames (Kimlikler) Dize Dizindeki herhangi bir türde yerel hesap kullanıcısının benzersiz oturum açma adı. Yerel hesap türünü belirtmeden oturum açma değerine sahip bir kullanıcıyı almak için bu özniteliği kullanın. Hayı Hayı Giriş
signInNames.userName (Kimlikler) Dize Dizindeki yerel hesap kullanıcısının benzersiz kullanıcı adı. Belirli bir oturum açma kullanıcı adına sahip bir kullanıcı oluşturmak veya almak için bu özniteliği kullanın. Patch işlemi sırasında yalnızca PersistedClaims içinde bu özniteliğin belirtilmesi diğer signInName türlerini kaldırır. Yeni bir signInName türü eklemek isterseniz, mevcut signInNames'i de kalıcı hale getirmek gerekir. NOT: Kullanıcı adı içinde vurgu karakterlerine izin verilmez. Hayı Hayı Giriş, Kalıcı, Çıkış
signInNames.phoneNumber (Kimlikler) Dize Dizindeki yerel hesap kullanıcısının benzersiz telefon numarası. Belirli bir oturum açma telefon numarasına sahip bir kullanıcı oluşturmak veya almak için bu özniteliği kullanın. Patch işlemi sırasında yalnızca PersistedClaims içinde bu özniteliğin belirtilmesi diğer signInName türlerini kaldırır. Yeni bir signInName türü eklemek isterseniz, mevcut signInNames'i de kalıcı hale getirmek gerekir. Hayı Hayı Giriş, Kalıcı, Çıkış
signInNames.emailAddress (Kimlikler) Dize Dizindeki yerel hesap kullanıcısının benzersiz e-posta adresi. Belirli bir oturum açma e-posta adresine sahip bir kullanıcı oluşturmak veya almak için bu özniteliği kullanın. Patch işlemi sırasında yalnızca PersistedClaims içinde bu özniteliğin belirtilmesi diğer signInName türlerini kaldırır. Yeni bir signInName türü eklemek isterseniz, mevcut signInNames'i de kalıcı hale getirmek gerekir. Hayı Hayı Giriş, Kalıcı, Çıkış
devlet Dize Kullanıcının adresindeki eyalet veya bölge. Maksimum uzunluk 128. Evet Evet Kalıcı, Çıktı
sokakAdresi Dize Kullanıcının iş yerinin sokak adresi. Maksimum uzunluk 1024. Evet Evet Kalıcı, Çıktı
strongAuthentication Alternatif Telefon Numarası1 Dize Kullanıcının çok faktörlü kimlik doğrulaması için kullanılan ikincil telefon numarası. Evet Hayı Kalıcı, Çıktı
güçlüKimlikDogrulamaEpostaAdresi1 Dize Kullanıcının SMTP adresi. Örnek: "bob@contoso.com" Bu öznitelik, kullanıcı e-posta adresini depolamak için kullanıcı adı ilkesiyle oturum açmak için kullanılır. Ardından parola sıfırlama akışında kullanılan e-posta adresi. Bu öznitelikte vurgu karakterlerine izin verilmez. Evet Hayı Kalıcı, Çıktı
güçlüKimlikDoğrulamaTelefonNumarası2 Dize Kullanıcının çok faktörlü kimlik doğrulaması için kullanılan birincil telefon numarası. Evet Hayı Kalıcı, Çıktı
soyadı Dize Kullanıcının soyadı (aile adı veya soyadı). Maksimum uzunluk 64. Evet Evet Kalıcı, Çıktı
telephoneNumber (işTelefonlarının ilk girişi) Dize Kullanıcının iş yerinin birincil telefon numarası. Evet Hayı Kalıcı, Çıktı
kullanıcı ana adı Dize Kullanıcının kullanıcı asıl adı (UPN). UPN, İnternet standardı RFC 822'yi temel alan kullanıcı için İnternet stili bir oturum açma adıdır. Etki alanı, kiracının doğrulanmış etki alanları koleksiyonunda bulunmalıdır. Bu özellik, bir hesap oluşturulduğunda gereklidir. Değişmez. Hayı Hayı Giriş, Kalıcı, Çıkış
kullanımKonumu Dize Ülkelerde/bölgelerdeki hizmetlerin kullanılabilirliğini denetlemek için yasal gereklilik nedeniyle lisans atanmış kullanıcılar için gereklidir. Null değeri atanamaz. İki harfli ülke/bölge kodu (ISO standardı 3166). Örnekler için ABD, JP ve GB. Evet Hayı Kalıcı, Çıktı
kullanıcı türü Dize Dizininizdeki kullanıcı türlerini sınıflandırmak için kullanılabilecek bir dize değeri. Değer Üye olmalıdır. Yalnızca okunabilir Yalnızca Okunur Hayı Kalıcı, Çıktı
kullanıcıDurumu (hariciKullanıcıDurumu)3 Dize Yalnızca Microsoft Entra B2B hesabı için ve davetin PendingAcceptance mı yoksa Kabul Edildi mi olduğunu gösterir. Hayı Hayı Kalıcı, Çıktı
kullanıcıDurumuDeğiştiğiTarih (hariciKullanıcıDurumuDeğişiklikZamanı)3 Tarih ve Saat UserState özelliğindeki en son değişikliğin zaman damgasını gösterir. Hayı Hayı Kalıcı, Çıktı

1 Microsoft Graph tarafından desteklenmiyor
2 Daha fazla bilgi için bkz. MFA telefon numarası özniteliği
3 Azure AD B2C ile kullanılmamalıdır

Gerekli öznitelikler

Azure AD B2C dizininde kullanıcı hesabı oluşturmak için aşağıdaki gerekli öznitelikleri sağlayın:

Görünen ad özniteliği

displayName, kullanıcı için Azure portalı kullanıcı yönetiminde ve Azure AD B2C'nin uygulamaya döndürdüğü erişim belirtecinde görüntülenecek addır. Bu özellik gereklidir.

Kimlikler özniteliği

Tüketici, iş ortağı veya vatandaş olabilecek bir müşteri hesabı şu kimlik türleriyle ilişkilendirilebilir:

  • Yerel kimlik - Kullanıcı adı ve parola Azure AD B2C dizininde yerel olarak depolanır. Bu kimlikleri genellikle "yerel hesaplar" olarak adlandırıyoruz.
  • Federasyon kimliği - Sosyal veya kurumsal hesaplar olarak da bilinen kullanıcının kimliği Facebook, Microsoft, ADFS veya Salesforce gibi bir federasyon kimlik sağlayıcısı tarafından yönetilir.

Müşteri hesabı olan bir kullanıcı birden çok kimlikle oturum açabilir. Örneğin, kullanıcı adı, e-posta, çalışan kimliği, kamu kimliği ve diğerleri. Tek bir hesabın hem yerel hem de sosyal olmak üzere aynı parolaya sahip birden çok kimliği olabilir.

Microsoft Graph API'sinde hem yerel hem de federasyon kimlikleri identities türünde olan kullanıcı özniteliğinde depolanır. Koleksiyon, identities kullanıcı hesabında oturum açmak için kullanılan bir kimlik kümesini temsil eder. Bu koleksiyon, kullanıcının ilişkili kimliklerinden herhangi biriyle kullanıcı hesabında oturum açmasını sağlar. identities özniteliği en fazla 10 objectIdentity nesnesi içerebilir. Her nesne aşağıdaki özellikleri içerir:

İsim Türü Açıklama
girişTürü String Dizininizdeki kullanıcı oturum açma türlerini belirtir. Yerel hesap için: emailAddress, emailAddress1, emailAddress2, emailAddress3, , userNameveya istediğiniz başka bir tür. Sosyal hesap olarak federatedayarlanmalıdır.
yayınlayan String Kimliği vereni belirtir. Yerel hesaplar için (signInTypefederated değilken), bu özellik yerel B2C kiracısının varsayılan etki alanı adıdır, örneğin contoso.onmicrosoft.com. Sosyal kimlik için (burada signInTypefederated), değer, verenin adıdır; örneğin facebook.com
İhraççıTarafındanAtananKimlik String Veren tarafından kullanıcıya atanan benzersiz tanımlayıcıyı belirtir. Kiracınız içinde, issuer ve issuerAssignedId birleşimi benzersiz olmalıdır. Yerel hesap için, signInType veya emailAddressolarak ayarlandığındauserName, kullanıcının oturum açma adını temsil eder.
signInType olarak ayarlandığında:
  • emailAddress(veya gibi emailAddressile başlaremailAddress1) issuerAssignedId geçerli bir e-posta adresi olmalıdır
  • userName(veya başka bir değer), issuerAssignedId bir e-posta adresinin geçerli bir yerel parçası olmalıdır
  • federated, issuerAssignedId federasyon hesabı benzersiz tanımlayıcısını temsil eder

Aşağıdaki JSON kod parçacığında Kimlikler özniteliği, oturum açma adıyla yerel bir hesap kimliği, oturum açma olarak bir e-posta adresi ve sosyal kimlik gösterilir.

"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"
  }
]

Federasyon kimlikleri için, kimlik sağlayıcısına bağlı olarak issuerAssignedId , uygulama veya geliştirme hesabı başına belirli bir kullanıcı için benzersiz bir değerdir. Azure AD B2C ilkesini sosyal hizmet sağlayıcısının veya aynı geliştirme hesabı içindeki başka bir uygulamanın atamış olduğu uygulama kimliğiyle yapılandırın.

Parola profil özelliği

Yerel kimlik için passwordProfile özniteliği gereklidir ve kullanıcının parolasını içerir. özniteliği, forceChangePasswordNextSignIn bir kullanıcının bir sonraki oturum açmada parolayı sıfırlaması gerekip gerekmediğini gösterir. Zorunlu parola sıfırlamayı işlemek için zorunlu parola sıfırlama akışını ayarlama yönergelerini kullanın.

Federasyon (sosyal) kimlik için passwordProfile özniteliği gerekli değildir.

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

Parola ilkesi özniteliği

Azure AD B2C parola ilkesi (yerel hesaplar için) Microsoft Entra Id güçlü parola gücü ilkesini temel alır. Azure AD B2C kaydolma veya oturum açma ve parola sıfırlama ilkeleri bu güçlü parola gücünü gerektirir ve parolaların süresi dolmaz.

Kullanıcı geçişi senaryolarında, geçirmek istediğiniz hesapların parola gücü Azure AD B2C tarafından zorlanan güçlü parola gücünden daha zayıfsa, güçlü parola gereksinimini devre dışı bırakabilirsiniz. Varsayılan parola ilkesini değiştirmek için özniteliğini passwordPolicies olarak DisableStrongPasswordayarlayın. Örneğin, oluşturulan kullanıcı isteğini aşağıdaki gibi değiştirebilirsiniz:

"passwordPolicies": "DisablePasswordExpiration, DisableStrongPassword"

MFA telefon numarası özniteliği

Çok faktörlü kimlik doğrulaması (MFA) için bir telefon kullanılırken, kullanıcı kimliğini doğrulamak için cep telefonu kullanılır. Program aracılığıyla yeni bir telefon numarası eklemek , telefon numarasını güncelleştirmek, almak veya silmek için MS Graph API telefon kimlik doğrulama yöntemini kullanın.

Azure AD B2C özel ilkelerinde telefon numarası talep türü aracılığıyla strongAuthenticationPhoneNumber kullanılabilir.

Uzantı öznitelikleri

Müşteriye yönelik her uygulama, bilgilerin toplanması için benzersiz gereksinimlere sahiptir. Azure AD B2C kiracınız, Verilen Ad, Soyadı ve Posta Kodu gibi özelliklerde depolanan yerleşik bir bilgi kümesiyle birlikte gelir. Azure AD B2C ile her müşteri hesabında depolanan özellikler kümesini genişletebilirsiniz. Daha fazla bilgi için bkz. Azure Active Directory B2C'de kullanıcı öznitelikleri ekleme ve kullanıcı girişini özelleştirme

Uzantı öznitelikleri, dizindeki kullanıcı nesnelerinin şemasını genişletir . Uzantı öznitelikleri, bir kullanıcı için veri içerse bile yalnızca bir uygulama nesnesine kaydedilebilir. Uzantı özniteliği, b2c-extensions-app adını taşıyan uygulamaya eklenmiştir. Azure AD B2C tarafından kullanıcı verilerini depolamak için kullanıldığından bu uygulamayı değiştirmeyin. Bu uygulamayı Microsoft Entra Uygulama kayıtları altında bulabilirsiniz. Azure AD B2Cb2c-extensions-app hakkında daha fazla bilgi edinin.

Uyarı

  • Herhangi bir kullanıcı hesabına en fazla 100 uzantı özniteliği yazabilirsiniz.
  • b2c-extensions-app uygulaması silinirse, bu uzantı öznitelikleri içerdikleri tüm verilerle birlikte tüm kullanıcılardan kaldırılır.
  • Bir uzantı özniteliği uygulama tarafından silinirse, tüm kullanıcı hesaplarından kaldırılır ve değerler silinir.

Microsoft Graph API'sindeki uzantı öznitelikleri kuralı extension_ApplicationClientID_AttributeNamekullanılarak adlandırılır ve burada:

Uzantı özniteliğinin adını oluşturmak için kullanılan Uygulama (istemci) kimliği kısa çizgi içermez. Örneğin:

"extension_831374b3bd5041bfaa54263ec9e050fc_loyaltyNumber": "212342"

Şema uzantısında öznitelik tanımlanırken aşağıdaki veri türleri desteklenir:

Türü Açıklamalar
Boolean (Boole Mantığı) Olası değerler: true veya false.
Tarih ve Saat ISO 8601 biçiminde belirtilmelidir. Değer UTC olarak depolanır.
Tamsayı 32 bit değer.
Dize En fazla 256 karakter.

İlgili içerik

Uzantı öznitelikleri hakkında daha fazla bilgi edinin:

  • Last updated on