مشاركة عبر

التحولات العامة في المطالبات

  • مقالة

توفر هذه المقالة أمثلة على استخدام تحويلات المطالبات العامة للنهج المخصص لمتاجرة عمل-مستهلك في Microsoft Azure Active Directory (Azure AD B2C). لمزيد من المعلومات، راجع تحويلات المطالبات.

CopyClaim

انسخ قيمة مطالبة إلى مطالبة أخرى. ويجب أن تكون المطالبتان من نفس النوع. تحقق من العرض التوضيحي المباشر لتحول هذه المطالبات.

العنصر نوع مطالبة التحول نوع البيانات ملاحظات
InputClaim inputClaim سلسلة، int نوع المطالبة، الذي سيتم نسخه.
OutputClaim outputClaim سلسلة، int تم استدعاء المطالبة التي تُنتج بعد تحويل المطالبات هذا.

استخدم تحويل المطالبات هذا لنسخ قيمة من سلسلة أو مطالبة رقمية إلى مطالبة أخرى. المثال التالي نسخ قيمة المطالبة externalEmail إلى المطالبة البريد الإلكتروني.

<ClaimsTransformation Id="CopyEmailAddress" TransformationMethod="CopyClaim">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="externalEmail" TransformationClaimType="inputClaim"/>
  </InputClaims>
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="email" TransformationClaimType="outputClaim"/>
  </OutputClaims>
</ClaimsTransformation>

مثال على CopyClaim

  • مطالبات الإدخال:
    • inputClaim: bob@contoso.com
  • مطالبات الناتج:
    • outputClaim: bob@contoso.com

DoesClaimExist

التحقق من وجود مطالبة الإدخال، وتعيين مطالبة الناتج إلى true أو false وفقًا لذلك. تحقق من العرض التوضيحي المباشر لتحول هذه المطالبات.

العنصر نوع مطالبة التحول نوع البيانات ملاحظات
InputClaim inputClaim أي المطالبة بالمدخلات التي يجب التحقق من وجودها.
OutputClaim outputClaim منطقي تم استدعاء المطالبة التي تُنتج بعد تحويل المطالبات هذا.

مثال على DoesClaimExist

استخدم تحويل المطالبات هذا للتحقق مما إذا كانت المطالبة موجودة أو تحتوي على أي قيمة. قيمة الإرجاع هي منطقية تشير إلى ما إذا كانت المطالبة موجودة أم لا. على سبيل المثال يتحقق إذا كان عنوان البريد الإلكتروني موجودًا.

<ClaimsTransformation Id="CheckIfEmailPresent" TransformationMethod="DoesClaimExist">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="email" TransformationClaimType="inputClaim" />
  </InputClaims>
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="isEmailPresent" TransformationClaimType="outputClaim" />
  </OutputClaims>
</ClaimsTransformation>
  • مطالبات الإدخال:
    • inputClaim: someone@contoso.com
  • مطالبات الناتج:
    • outputClaim: صحيح

التجزئة

قم بتجزئة النص العادي المقدم باستخدام الملح والسر. خوارزمية التجزئة المستخدمة SHA-256. تحقق من العرض التوضيحي المباشر لتحول هذه المطالبات.

العنصر نوع مطالبة التحول نوع البيانات ملاحظات
InputClaim plaintext سلسلة المطالبة بإدخال أن تكون مشفرة
InputClaim ملح سلسلة معلمة الملح. يمكنك إنشاء قيمة عشوائية باستخدام CreateRandomString تحويل المطالبات.
InputParameter randomizerSecret سلسلة يشير إلى مفتاح نهجAzure AD B2C موجود. لإنشاء مفتاح نهج جديد: في مستأجر Azure AD B2C، ضمن "إدارة" ، حدد إطار عمل تجربة الهوية. حدد "مفاتيح النهج" لعرض المفاتيح المتوفرة في المستأجر. حدد ⁧⁩إضافة⁧⁩. بالنسبة لـOptions، حدد Manual. توفير اسم (قد تتم إضافة البادئة B2C_1A_ تلقائيا.). في مربع النص السري، أدخل أي سر تريد استخدامه، مثل 1234567890. لاستخدام المفتاح، حدد توقيع. حدد Create.
OutputClaim تجزئة سلسلة تم استدعاء المطالبة التي تُنتج بعد تحويل المطالبات هذا. المطالبة التي تم تكوينها في plaintextinputClaim.

مثال على Hash

يوضح المثال التالي كيفية تجزئة عنوان بريد إلكتروني. يُحسن تحويل المطالبات عنوان البريد الإلكتروني قبل تجزئة القيمة. لاستدعاء تحويل المطالبات هذا، عيّن قيمة للمطالبة mySalt.

<ClaimsTransformation Id="HashPasswordWithEmail" TransformationMethod="Hash">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="email" TransformationClaimType="plaintext" />
    <InputClaim ClaimTypeReferenceId="mySalt" TransformationClaimType="salt" />
  </InputClaims>
  <InputParameters>
    <InputParameter Id="randomizerSecret" DataType="string" Value="B2C_1A_AccountTransformSecret" />
  </InputParameters>
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="hashedEmail" TransformationClaimType="hash" />
  </OutputClaims>
</ClaimsTransformation>
  • مطالبات الإدخال:
    • plaintext: someone@contoso.com
    • ملح: 487624568
    • randomizerSecret: B2C_1A_AccountTransformSecret
  • مطالبات الناتج:
    • outputClaim: CdMNb/KTEfsWzh9MR1kQGRZCKjuxGMWhA5YQNihzV6U=

الخطوات التالية

  • يمكنك العثور على المزيد من أمثلة تحويل المطالبات في مستودع GitHub لمجتمع متاجرة عمل-مستهلك في Microsoft Azure Active Directory