BuildingBlocks

  • مقالة

ملاحظة

في Azure Active Directory B2C، تم تصميم النُهج المخصصة بشكل أساسي لمعالجة السيناريوهات المعقدة. بالنسبة إلى معظم السيناريوهات، نوصي باستخدام تدفقات المستخدم المضمنة. إذا لم تقم بذلك، تعرف على حزمة بادئ النهج المخصصة في البدء باستخدام النهج المخصصة في Active Directory B2C.

تمت إضافة عنصرBuilding Blocksداخل عنصرTrust Framework Policy.

<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="mytenant.onmicrosoft.com"
  PolicyId="B2C_1A_TrustFrameworkBase"
  PublicPolicyUri="http://mytenant.onmicrosoft.com/B2C_1A_TrustFrameworkBase">

  <BuildingBlocks>
    <ClaimsSchema>
      ...
    </ClaimsSchema>
    <Predicates>
    ...
    </Predicates>
    <PredicateValidations>
    ...
    </PredicateValidations>
    <ClaimsTransformations>
      ...
    </ClaimsTransformations>
    <ContentDefinitions>
      ...
    </ContentDefinitions>
    <Localization>
      ...
    </Localization>
    <DisplayControls>
      ...
    </DisplayControls>
 </BuildingBlocks>

يحتوي عنصرBuildingBlocksعلى العناصر التالية التي يجب تحديدها بالترتيب المحدد:

  • يحدد عنصرClaimsSchemaأنواع المطالبات التي يمكن الرجوع إليها كجزء من النهج. مخطط المطالبات يقصد به المكان الذي تعلن فيه أنواع مطالباتك. نوع المطالبة مشابه لمتغير في العديد من لغات البرمجة. يمكنك استخدام نوع المطالبة لجمع البيانات من مستخدم التطبيق الخاص بك، أو تلقي مطالبات من موفري الهوية الاجتماعية، أو إرسال واستقبال البيانات من واجهة برمجة تطبيقات REST مخصصة، أو تخزين أي بيانات داخلية مستخدمة بواسطة نهجك المخصصة.

  • تمكّنك عناصر PredicateValidationReference من إجراء عمليات التحقق من الصحة لضمان إدخال البيانات التي تم تكوينها بشكل صحيح فقط في المطالبة.

  • يحتويClaimsTransformationsعلى قائمة بتحولات المطالبات التي يمكن استخدامها في النهج الخاص بك. تحويل المطالبات يحول مطالبة واحدة إلى أخرى. في تحويل المطالبات، تقوم بتحديد أسلوب التحويل، مثل:

    • تغيير حالة مطالبة سلسلة إلى الحالة المحددة. على سبيل المثال، تغيير سلسلة من الأحرف الصغيرة إلى الأحرف الكبيرة.
    • مقارنة مطالبتين وإعادة مطالبة مع الصواب للإشارة إلى أن المطالبات متطابقة، وإلا فهي خاطئة.
    • إنشاء مطالبة بسلسلة من المعلمة المتوفرة في النهج.
    • إنشاء سلسلة عشوائية باستخدام مُنشئ الأرقام العشوائية.
    • تنسيق مطالبة وفقًا لسلسلة التنسيق المتوفرة. يستخدم التحويل أسلوبString.Format C#‎.

  • InputValidation - يسمح لك هذا العنصر بإجراء تجميعات منطقية مشابهة لـووأو.

  • ContentDefinitions - تحتوي على عناوين URL لنماذج HTML5 لاستخدامها في رحلة المستخدم الخاصة بك. في النهج المخصص، يحدد تعريف المحتوى URI لصفحة HTML5 المستخدم لخطوة محددة في رحلة المستخدم. على سبيل المثال، صفحات تسجيل الدخول أو التسجيل أو إعادة تعيين كلمة المرور أو الخطأ. يمكنك تعديل الشكل والأسلوب عن طريق تجاوز LoadUri لملف HTML5. أو يمكنك إنشاء تعريفات محتوى جديدة وفقًا لاحتياجاتك. قد يحتوي هذا العنصر على مرجع موارد مترجم باستخدام معرّف الترجمة.

  • تسمح لكالترجمةبدعم لغات متعددة. يسمح لك دعم الترجمة في النهج بإعداد قائمة باللغات المدعومة في النهج واختيار لغة افتراضية. يتم أيضًا دعم سلاسل ومجموعات خاصة بلغة معينة.

  • DisplayControls - يحدد عناصر التحكم التي سيتم عرضها على صفحة. تحتوي عناصر التحكم في العرض على وظائف خاصة وتتفاعل مع ملفات التعريف الفنية للتحقق من صحة النهاية.