Not
Bu sayfaya erişim yetkilendirme gerektiriyor. Oturum açmayı veya dizinleri değiştirmeyi deneyebilirsiniz.
Bu sayfaya erişim yetkilendirme gerektiriyor. Dizinleri değiştirmeyi deneyebilirsiniz.
Ö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.
Uyarı
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 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:
| Özellik | Gerekli | Açıklama |
|---|---|---|
| Kimlik | Evet | Talep dönüştürmeyi benzersiz olarak tanımlamak için kullanılan bir tanımlayıcı. Tanımlayıcıya ilkedeki diğer XML öğelerinden başvurulur. |
| DönüştürmeMethod | Evet | Talep dönüşümünde 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. |
Talep Dönüşümü
ClaimsTransformation öğesi aşağıdaki öğeleri içerir:
<ClaimsTransformation Id="<identifier>" TransformationMethod="<method>">
<InputClaims>
...
</InputClaims>
<InputParameters>
...
</InputParameters>
<OutputClaims>
...
</OutputClaims>
</ClaimsTransformation>
| Öğe | Oluşum | Açıklama |
|---|---|---|
| InputClaims (Girdi İddiaları) | 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 başvurusu içerir. |
| InputParameters (Giriş Parametreleri) | 0:1 | Talep dönüştürmeye giriş olarak sağlanan InputParameter öğelerinin listesi. |
| Çıktı İddiaları | 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 (Girdi İddiaları)
InputClaims öğesi aşağıdaki öğeyi içerir:
| Öğe | Oluşum | Açıklama |
|---|---|---|
| Giriş İddiası | 1:n | Beklenen giriş talep türü. |
Giriş İddiası
InputClaim öğesi aşağıdaki öznitelikleri içerir:
| Özellik | Gerekli | Açıklama |
|---|---|---|
| TalepTürüReferansId | Evet | İlkenin ClaimsSchema bölümünde zaten tanımlanmış bir ClaimType başvurusu. |
| TransformationClaimType | Evet | 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 (Giriş Parametreleri)
InputParameters öğesi aşağıdaki öğeyi içerir:
| Öğe | Oluşum | Açıklama |
|---|---|---|
| Girdi Parametresi | 1:n | Beklenen giriş parametresi. |
Girdi Parametresi
| Özellik | Gerekli | Açıklama |
|---|---|---|
| Kimlik | Evet | Talep dönüştürme yönteminin bir 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. |
| VeriTürü | Evet | Özel ilke XML şemasındaki DataType sabit listesi başına String, Boolean, 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 | Evet | Dönüştürmeye ayrıntılı olarak geçirilen bir değer. Bazı değerler rastgeledir, bazılarını talep dönüştürme yönteminden seçersiniz. |
Çıktı İddiaları
OutputClaims öğesi aşağıdaki öğeyi içerir:
| Öğe | Oluşum | Açıklama |
|---|---|---|
| Çıktı İddiası | 0:n | Beklenen çıkış talep türü. |
Çıktı İddiası
OutputClaim öğesi aşağıdaki öznitelikleri içerir:
| Özellik | Gerekli | Açıklama |
|---|---|---|
| TalepTürüReferansId | Evet | İlkenin ClaimsSchema bölümünde zaten tanımlanmış bir ClaimType başvurusu. |
| TransformationClaimType | Evet | 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ış taleplerinin ayrı olması gerekir. Aynı giriş talebi çıkış talebi olarak kullanılamaz.
Örnek
Örneğin, kullanıcı tarafından kabul edilen hizmet koşullarınızın son sürümünü 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: