ClaimsTransformations

  • Makale

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.

ClaimsTransformations öğesi, özel bir ilkenin parçası olarak kullanıcı yolculuklarında kullanılabilecek talep dönüştürme işlevlerinin listesini içerir. Talep dönüştürmesi belirli bir talebi başka bir talebe dönüştürür. Talep dönüştürmesinde dönüştürme yöntemini belirtirsiniz; örneğin bir dize koleksiyonuna öğe ekler veya bir dizenin büyük/küçük harflerini değiştirirsiniz.

Kullanıcı yolculuklarında kullanılabilecek talep dönüştürme işlevlerinin listesini eklemek için, ilkenin BuildingBlocks bölümünde bir ClaimsTransformations XML öğesi bildirilmelidir.

<ClaimsTransformations>
  <ClaimsTransformation Id="<identifier>" TransformationMethod="<method>">
    ...
  </ClaimsTransformation>
</ClaimsTransformations>

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

Öznitelik Gerekli Açıklama
Id Yes Talep dönüştürmesini benzersiz olarak tanımlamak için kullanılan tanımlayıcı. Tanımlayıcıya ilkedeki diğer XML öğelerinden başvurulur.
DönüştürmeMethod Yes Talep dönüştürmede kullanılacak dönüştürme yöntemi. Her talep dönüştürmenin kendi değerleri vardır. Kullanılabilir değerlerin tam listesi için talep dönüştürme başvurusuna bakın.

ClaimsTransformation

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

<ClaimsTransformation Id="<identifier>" TransformationMethod="<method>">
  <InputClaims>
    ...
  </InputClaims>
  <InputParameters>
    ...
  </InputParameters>
  <OutputClaims>
    ...
  </OutputClaims>
</ClaimsTransformation>
Öğe Oluşum Description
InputClaims 0:1 Talep dönüştürmeye giriş olarak alınan talep türlerini belirten InputClaim öğelerinin listesi. Bu öğelerin her biri, ilkenin ClaimsSchema bölümünde önceden tanımlanmış bir ClaimType'a başvuru içerir.
Inputparameters 0:1 Talep dönüştürmeye giriş olarak sağlanan InputParameter öğelerinin listesi.
OutputClaims 0:1 ClaimsTransformation çağrıldıktan sonra oluşturulan talep türlerini belirten OutputClaim öğelerinin listesi. Bu öğelerin her biri, ClaimsSchema bölümünde önceden tanımlanmış bir ClaimType'a başvuru içerir.

InputClaims

InputClaims öğesi aşağıdaki öğeyi içerir:

Öğe Oluşum Description
InputClaim 1:n Beklenen giriş talep türü.

InputClaim

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

Öznitelik Gerekli Açıklama
ClaimTypeReferenceId Yes İlkenin ClaimsSchema bölümünde zaten tanımlanmış bir ClaimType başvurusu.
TransformationClaimType Yes Dönüştürme talep türüne başvurmak için bir tanımlayıcı. Her talep dönüştürmenin kendi değerleri vardır. Kullanılabilir değerlerin tam listesi için talep dönüştürme başvurusuna bakın.

Inputparameters

InputParameters öğesi aşağıdaki öğeyi içerir:

Öğe Oluşum Description
Inputparameter 1:n Beklenen giriş parametresi.

Inputparameter

Öznitelik Gerekli Açıklama
Id Yes Talep dönüştürme yönteminin parametresine başvuru olan tanımlayıcı. Her talep dönüştürme yönteminin kendi değerleri vardır. Kullanılabilir değerlerin tam listesi için talep dönüştürme tablosuna bakın.
DataType Yes Özel ilke XML şemasındaki DataType sabit listesi başına dize, Boole, Int veya DateTime gibi parametrenin veri türü. Bu tür, aritmetik işlemleri doğru bir şekilde gerçekleştirmek için kullanılır. Her talep dönüştürmenin kendi değerleri vardır. Kullanılabilir değerlerin tam listesi için talep dönüştürme başvurusuna bakın.
Değer Yes Dönüştürmeye ayrıntılı olarak geçirilen bir değer. Bazı değerler rastgeledir, bazıları talep dönüştürme yönteminden seçersiniz.

OutputClaims

OutputClaims öğesi aşağıdaki öğeyi içerir:

Öğe Oluşum Description
OutputClaim 0:n Beklenen çıkış talep türü.

OutputClaim

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

Öznitelik Gerekli Açıklama
ClaimTypeReferenceId Yes İlkenin ClaimsSchema bölümünde zaten tanımlanmış bir ClaimType başvurusu.
TransformationClaimType Yes Dönüştürme talep türüne başvurmak için bir tanımlayıcı. Her talep dönüştürmenin kendi değerleri vardır. Kullanılabilir değerlerin tam listesi için talep dönüştürme başvurusuna bakın.

Talep dönüştürmede kullanılan giriş ve çıkış talepleri ayrı olmalıdır. Aynı giriş talebi çıkış talebi olarak kullanılamaz.

Örnek

Örneğin, hizmet koşullarınızın son sürümünü kullanıcının kabul ettiğini depoleyebilirsiniz. Hizmet koşullarını güncelleştirdiğinizde, kullanıcıdan yeni sürümü kabul etmesini isteyebilirsiniz. Aşağıdaki örnekte HasTOSVersionChanged talep dönüştürmesi, TOSVersion talebi değerini LastTOSAcceptedVersion talebi değeriyle karşılaştırır ve ardından boolean TOSVersionChanged talebi döndürür.

<BuildingBlocks>
  <ClaimsSchema>
    <ClaimType Id="TOSVersionChanged">
      <DisplayName>Indicates if the TOS version accepted by the end user is equal to the current version</DisplayName>
      <DataType>boolean</DataType>
    </ClaimType>
    <ClaimType Id="TOSVersion">
      <DisplayName>TOS version</DisplayName>
      <DataType>string</DataType>
    </ClaimType>
    <ClaimType Id="LastTOSAcceptedVersion">
      <DisplayName>TOS version accepted by the end user</DisplayName>
      <DataType>string</DataType>
    </ClaimType>
  </ClaimsSchema>

  <ClaimsTransformations>
    <ClaimsTransformation Id="HasTOSVersionChanged" TransformationMethod="CompareClaims">
      <InputClaims>
        <InputClaim ClaimTypeReferenceId="TOSVersion" TransformationClaimType="inputClaim1" />
        <InputClaim ClaimTypeReferenceId="LastTOSAcceptedVersion" TransformationClaimType="inputClaim2" />
      </InputClaims>
      <InputParameters>
        <InputParameter Id="operator" DataType="string" Value="NOT EQUAL" />
      </InputParameters>
      <OutputClaims>
        <OutputClaim ClaimTypeReferenceId="TOSVersionChanged" TransformationClaimType="outputClaim" />
      </OutputClaims>
    </ClaimsTransformation>
  </ClaimsTransformations>
</BuildingBlocks>

Talep dönüştürmeleri başvurusu

Talep dönüştürme örnekleri için aşağıdaki başvuru sayfalarına bakın: