TrustFrameworkPolicy

Not

Azure Active Directory B2C'de özel ilkeler öncelikli olarak karmaşık senaryoları ele almak için tasarlanmıştır. Çoğu senaryoda, yerleşik kullanıcı akışlarını kullanmanızı öneririz. Bunu yapmadıysanız, Active Directory B2C'de özel ilkeleri kullanmaya başlama bölümünde özel ilke başlangıç paketi hakkında bilgi edinin.

Özel ilke, hiyerarşik bir zincirde birbirine başvuran bir veya daha fazla XML biçimli dosya olarak temsil edilir. XML öğeleri, ilkenin talep şeması, talep dönüştürmeleri, içerik tanımları, talep sağlayıcıları, teknik profiller, kullanıcı yolculuğu ve düzenleme adımları gibi öğelerini tanımlar. Her ilke dosyası, bir ilke dosyasının en üst düzey TrustFrameworkPolicy öğesi içinde tanımlanır.

<TrustFrameworkPolicy
  xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance"
  xmlns:xsd="https://www.w3.org/2001/XMLSchema"
  xmlns="http://schemas.microsoft.com/online/cpim/schemas/2013/06"
  PolicySchemaVersion="0.3.0.0"
  TenantId="yourtenant.onmicrosoft.com"
  PolicyId="B2C_1A_TrustFrameworkBase"
  PublicPolicyUri="http://yourtenant.onmicrosoft.com/B2C_1A_TrustFrameworkBase">
  ...

TrustFrameworkPolicy öğesi aşağıdaki öznitelikleri içerir:

Öznitelik Zorunlu Açıklama
PolicySchemaVersion Yes İlkeyi yürütmek için kullanılacak şema sürümü. Değer şu şekilde olmalıdır: 0.3.0.0
TenantObjectId Hayır Azure Active Directory B2C (Azure AD B2C) kiracısının benzersiz nesne tanımlayıcısı.
TenantId Yes Bu ilkenin ait olduğu kiracının benzersiz tanımlayıcısı.
PolicyId Yes İlkenin benzersiz tanımlayıcısı. Bu tanımlayıcının öneki B2C_1A_
PublicPolicyUri Yes kiracı kimliği ile ilke kimliğinin birleşimi olan ilkenin URI'si.
DeploymentMode Hayır Olası değerler: Production, veya Development. Production varsayılan değerdir. İlkenizde hata ayıklamak için bu özelliği kullanın. Daha fazla bilgi için bkz . Günlükleri Toplama.
UserJourneyRecorderEndpoint Hayır Günlüğe kaydetme için kullanılan uç nokta. Öznitelik varsa değeri olarak ayarlanmalıdır urn:journeyrecorder:applicationinsights . Daha fazla bilgi için bkz . Günlükleri Toplama.

Aşağıdaki örnek, TrustFrameworkPolicy öğesinin nasıl belirtileceğini gösterir:

<TrustFrameworkPolicy
   xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance"
   xmlns:xsd="https://www.w3.org/2001/XMLSchema"
   xmlns="http://schemas.microsoft.com/online/cpim/schemas/2013/06"
   PolicySchemaVersion="0.3.0.0"
   TenantId="yourtenant.onmicrosoft.com"
   PolicyId="B2C_1A_TrustFrameworkBase"
   PublicPolicyUri="http://yourtenant.onmicrosoft.com/B2C_1A_TrustFrameworkBase">

TrustFrameworkPolicy öğesi aşağıdaki öğeleri içerir:

Öğe Oluşum Açıklama
BasePolicy 0:1 Temel ilkenin tanımlayıcısı.
BuildingBlocks 0:1 İlkenizin yapı taşları.
ClaimsProviders 0:1 Talep sağlayıcıları koleksiyonu.
UserJourneys 0:1 Kullanıcı yolculukları koleksiyonu.
SubJourneys 0:1 Alt yolculuklardan oluşan bir koleksiyon.
Bağlı Bölüm 0:1 Bağlı olan taraf ilkesinin tanımı.

Bir ilkeyi başka bir ilkeden devralmak için, ilke dosyasının TrustFrameworkPolicy öğesi altında bir BasePolicy öğesi bildirilmelidir. BasePolicy öğesi, bu ilkenin türetildiği temel ilkeye bir başvurudur.

Oluşumlar , bir üst öğenin sahip olabileceği veya içermesi gereken alt öğe sayısını ifade eder:

  • 0:1 , üst öğenin sıfır veya bir alt öğesi olduğu anlamına gelir.
  • 1:1 , üst öğenin bir alt öğesi olması gerektiği anlamına gelir.
  • 1:n , üst öğenin bir veya birden çok alt öğeye sahip olması gerektiği anlamına gelir.
  • 0:n , üst öğenin sıfır veya herhangi bir sayıda öğeye sahip olabileceği anlamına gelir.

BasePolicy öğesi aşağıdaki öğeleri içerir:

Öğe Oluşum Açıklama
TenantId 1:1 Azure AD B2C kiracınızın tanımlayıcısı.
PolicyId 1:1 Üst ilkenin tanımlayıcısı.

Aşağıdaki örnekte temel ilkenin nasıl belirtilmesi gösterilmektedir. Bu B2C_1A_TrustFrameworkExtensions ilkesi B2C_1A_TrustFrameworkBase ilkesinden türetilir.

<TrustFrameworkPolicy
   xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance"
   xmlns:xsd="https://www.w3.org/2001/XMLSchema"
   xmlns="http://schemas.microsoft.com/online/cpim/schemas/2013/06"
   PolicySchemaVersion="0.3.0.0"
   TenantId="yourtenant.onmicrosoft.com"
   PolicyId="B2C_1A_TrustFrameworkExtensions"
   PublicPolicyUri="http://yourtenant.onmicrosoft.com/B2C_1A_TrustFrameworkExtensions">

  <BasePolicy>
    <TenantId>yourtenant.onmicrosoft.com</TenantId>
    <PolicyId>B2C_1A_TrustFrameworkBase</PolicyId>
  </BasePolicy>
  ...
</TrustFrameworkPolicy>