مشاركة عبر

كيفية تفويض حسابات المطور باستخدام خدمات مجال Microsoft Azure Active Directory B2C في Azure APIM

  • مقالة

ينطبق على: المطور | أساسي | الإصدار 2 الأساسي | قياسي | الإصدار 2 القياسي | بريميوم

تعتبر خدمات مجال Microsoft Azure Active Directory B2C حل إدارة الهوية السحابية لتطبيقات الويب والهاتف المحمول التي تواجه المستهلك. يمكنك استخدام هذا الحل لإدارة الوصول إلى مدخل مطور APIM الخاص بك.

في هذا البرنامج التعليمي، ستعرف كيفية التكوين المطلوب في مُنتج APIM للتكامل مع خدمات مجال Microsoft Azure Active Directory B2C.

للحصول على نظرة عامة حول خيارات تأمين مدخل المطور، راجع الوصول الآمن إلى مدخل مطور APIM.

هام

  • تم تحديث هذه المقالة بخطوات لتكوين تطبيق B2C Azure AD باستخدام مكتبة مصادقة Microsoft (MSAL).
  • إذا قمت مسبقا بتكوين تطبيق B2C Azure AD لتسجيل دخول المستخدم باستخدام مكتبة مصادقة Azure AD (ADAL)، نوصي بالترحيل إلى MSAL.

المتطلبات الأساسية

تكوين التسجيل ثم تسجيل الدخول لمخطط سير المستخدم

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

  1. في مدخل Microsoft Azure، امنح مستأجر خدمات مجال Microsoft Azure Active Directory B2C إمكانية الوصول.
  2. من الخيارنُهج، حددمخططات سير المستخدم>+ مخطط سير مستخدم جديد.
  3. في صفحةإنشاء تدفق مستخدم، حدد التسجيل ثم تسجيل دخول تدفق المستخدم. حدد الإصدار المستحسن ثم حدد إنشاء.
  4. في صفحة Create ، قم بتوفير المعلومات التالية:
    1. أدخل اسمًا فريدًا لمخطط سير المستخدم.
    2. من الخيارمُوفرو خدمات الهوية، حددالتسجيل عبر البريد الإلكتروني.
    3. في سمات المستخدم ومطالبات الرمز المميز، حدد السمات والمطالبات التالية المطلوبة لمدخل مطور APIM.

      • جمع السمات: الاسم المعطى، اللقب

      • إرجاع المطالبات: الاسم المعطى، اللقب، عناوين البريد الإلكتروني، معرف العنصر الخاص بالمستخدم

        لقطة شاشة للسمات والمطالبات في المدخل

  5. حدد إنشاء.

تكوين موفر خدمات الهوية لمدخل المطور

  1. في صفحة مدخل Microsoft Azureمنفصلة، ابحث عن مثيل APIM الخاص بك.

  2. من القائمةمدخل المطور، حدد الهويات>+ إضافة.

  3. من صفحةأضف موفّر خدمات الهويةحدد خدمات مجال Microsoft Azure Active Directory B2C. بعد التحديد، ستتمكن من إدخال المعلومات الضرورية الأخرى.

    • في القائمة المنسدلة مكتبة العميل ، حدد MSAL.
    • لإضافة إعدادات أخرى، راجع الخطوات لاحقا في المقالة.

  4. في نافذةأضف موفر خدمات الهوية، انسخ عنوان URL المُعاد توجيهه.

    لقطة شاشة لعنون URL لإعادة التوجيه في المدخل.

  5. العودة إلى علامة تبويب مستعرض الويب لمستأجر خدمات مجال Microsoft Azure Active Directory B2C في مدخل Microsoft Azure. حدد «تسجيلات التطبيق» >+ تسجيل جديد.

  6. عند فتح صفحةتسجيل طلب، أدخل معلومات التسجيل الخاصة بك ذات الصلة بالطلب.

    • في قسم الاسم، أدخل اسم طلب من اختيارك.
    • في قسم Supported account types ، حدد Accounts in any organizational directory (for authenticating users with user flows). للحصول على مزيد من المعلومات، راجع تسجيل طلب.
    • في إعادة توجيه URI ، حدد ويب ولصق عنوان URL المعاد توجيهه الذي حفظته من خطوة سابقة.
    • من القائمةأذونات، حددمنح موافقة المسؤول لفتح أذونات دخول ووصول عند عدم الاتصال بالإنترنت.
    • حدد Register لإنشاء التطبيق.

    لقطة شاشة لتسجيل تطبيق جديد في المدخل.

  7. من الصفحة «لمحة عامة»، احصل على معرّف التطبيق (الخاص بالعميل) ثم انسخ القيمة الموجودة إلى الحافظة.

    لقطة شاشة لصفحة نظرة عامة في المدخل.

  8. التبديل مرة أخرى إلى صفحة أضف موفّر خدمات الهوية APIM ثم الصق المعرّف في مربع النص معرّف العميل.

  9. أجري التبديل مرة أخرى إلى تسجيل تطبيق B2C. حدد «الشهادات الرقمية وأسرار العملاء»>+ أسرار عملاء جُدد. لقطة شاشة لإنشاء سر عميل في المدخل.

    • في الصفحة أضف سر عميل، أدخل وصفًا ثم حدد إضافة.
    • سجل القيمة في موقع آمن. لا تُعرض هذه القيمة السرية مجدداًبعد مغادرة هذه الصفحة مطلقاً.

  10. التبديل مرة أخرى إلى صفحة أضف موفّر خدمات الهوية في APIM ثم الصق المعرّف في مربع النص سر العميل.

  11. متابعة في صفحة إضافة موفر هوية:

    • من الاختيار تسجيل مستأجر ، حدد اسم المجال لمستأجر خدمات مجال Microsoft Azure Active Directory B2C.

    • يتيح لك الحقل «المرجع» التحكم في عنوان URL الخاص بتسجيل الدخول لاستخدام خدمات مجال Microsoft Azure Active Directory B2C. حدد القيمة إلى <your_b2c_tenant_name>.b2clogin.com.

    • حدد نهج التسجيل ونهج تسجيل الدخول باستخدام اسم تدفق المستخدم الذي أنشأته في خطوة سابقة.

    • توفيرتهج تحرير ملف التعريف ونهج إعادة تعيين كلمة المروربشكل اختياري.

      لقطة شاشة لتكوين موفر هوية Active Directory B2C في المدخل.

  12. بعد اختيار التكوين الذي ترغب في استخدامه، حدد «إضافة».

  13. أعد نشر مدخل المطور لتكوين Microsoft Azure Active Directory لتصبح سارية المفعول. في القائمة اليسرى، ضمن Developer portal، حدد Portal overview>Publish.

بعد حفظ التغييرات، سيتمكن المطورون من إنشاء حسابات جديدة، ثم تسجيل الدخول إلى مدخل المطور باستخدام خدمات مجال Microsoft Azure Active Directory B2C.

ترحيل إلى MSAL.js

إذا قمت مسبقا بتكوين تطبيق Azure AD B2C لتسجيل دخول المستخدم باستخدام ADAL، يمكنك استخدام المدخل لترحيل التطبيق إلى MSAL وتحديث موفر الهوية في APIM.

تحديث Azure AD تطبيق B2C لتوافق MSAL

للحصول على خطوات لتحديث تطبيق Azure AD B2C، راجع تبديل عناوين URL لإعادة التوجيه إلى نوع التطبيق أحادي الصفحة.

تكوين موفر الهوية

  1. في القائمة اليسرى لمثيل APIM الخاص بك، ضمن Developer portal، حدد Identities.
  2. حدد Azure Active Directory من القائمة.
  3. في القائمة المنسدلة مكتبة العميل ، حدد MSAL.
  4. حدد تحديث.
  5. إعادة نشر مدخل المطور الخاص بك.

مدخل المطوّر- أضف مصادقة حساب خدمات مجالMicrosoft Azure Active Directory B2C

هام

تحتاجلإعادة نشر مدخل المُطوّر عندما تُنشئ إعدادات تكوين خدمات مجال Microsoft Azure Active Directory B2C حتى تسري التعديلات التي أجريتها أو تحديثها.

في مدخل المطور، يكون تسجيل الدخول باستخدام خدمات مجال Microsoft Azure Active Directory B2C ممكنًا باستخدام زر تسجيل الدخول: لعنصر واجهة المستخدم OAuth. تم تضمين عنصر واجهة المستخدم بالفعل في صفحة تسجيل الدخول لمحتوى المدخل الافتراضي للمطوّر.

  1. لتسجيل الدخول باستخدام خدمات مجال Microsoft Azure Active Directory B2C، افتح نافذة مستعرض ويب جديدة ثم انتقل إلى مدخل المطور. حدد تسجيل الدخول.

  2. من الصفحة تسجيل الدخول، حدد «خدمات مجال Microsoft Azure Active Directory B2C».

    لقطة شاشة لتسجيل الدخول إلى مدخل المطور.

  3. تتم إعادة توجيهك إلى نهج التسجيل الذي أجريت تكوينه في القسم السابق. اختر التسجيل باستخدام عنوان بريدك الإلكتروني في مستأجر Active Directory B2C.

عند اكتمال التسجيل، تتم إعادة توجيهك مرة أخرى إلى مدخل المطور. لقد سجّلت الدخول الآن إلى مدخل المطور لمثيل منتج APIM الخاص بك.

اكتمال تسجيل الدخول لمدخل المطوّر

على الرغم من إنشاء حساب جديد تلقائيًّا كلما سجّل مستخدم جديد الدخول باستخدام Microsoft Azure Active Directory B2C، قد تفكر في إضافة نفس عنصر واجهة المستخدم إلى صفحة التسجيل.

نموذج التسجيل: تمثل أداة OAuth نموذج يستخدم للتسجيل باستخدام OAuth.

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