مشاركة عبر

ادمج Azure Event Grid مع Auth0

  • مقالة

توضح هذه المقالة كيفية توصيل حسابات Auth0، وAzure عن طريق إنشاء موضوع شريك لشبكة الأحداث.

إشعار

راجع رموز نوع حدث Auth0 للحصول على قائمة كاملة بالأحداث التي يدعمها Auth0

أرسل الأحداث من Auth0 إلى Azure Event Grid

لإرسال أحداث Auth0 إلى Azure:

  1. قم بتسجيل موفر موارد Event Grid مع اشتراكك في Azure.
  2. تفويض الشريك لإنشاء موضوع شريك في مجموعة الموارد الخاصة بك.
  3. اطلب Auth0 لتمكين تدفق الأحداث إلى موضوع شريك عن طريق إعداد موضوع شريك Auth0 في لوحة معلومات Auth0.
  4. تنشيط موضوع الشريك حتى تبدأ الأحداث الخاصة بك في التدفق إلى موضوع الشريك الخاص بك.
  5. اشترك في الأحداث.

تسجيل موفر موارد شبكة الأحداث

ما لم تكن قد استخدمت Event Grid من قبل، فستحتاج إلى تسجيل مزود موارد Event Grid. إذا كنت قد استخدمت Event Grid من قبل، فانتقل إلى القسم التالي.

في مدخل Microsoft Azure، قم بالخطوات التالية:

  1. في القائمة اليسرى، حدد Subscriptions.

  2. حدد subscription الذي تريد استخدامه لـ Event Grid من قائمة الاشتراك.

  3. في صفحة Subscription، حدد Resource providers ضمن Settings في القائمة اليسرى.

  4. ابحث عن Microsoft.EventGrid، وتأكد من أن الحالة غير مسجلة.

  5. حدد Microsoft.EventGrid في قائمة الموفرين.

  6. حدد Register في شريط الأوامر.

    Image showing the registration of Microsoft.EventGrid provider with the Azure subscription.

  7. قم بالتحديث للتأكد من تغيير حالة Microsoft.EventGrid إلى Registered.

    Image showing the successful registration of Microsoft.EventGrid provider with the Azure subscription.

تفويض الشريك لإنشاء موضوع شريك

يجب أن تمنح موافقتك للشريك لإنشاء مواضيع الشريك في مجموعة الموارد التي تحددها. هذا الإذن له وقت انتهاء الصلاحية. إنه ساري المفعول للفترة الزمنية التي تحددها بين 1 إلى 365 يوماً.

هام

للحصول على موقف أمان أكبر، حدد الحد الأدنى لوقت انتهاء الصلاحية الذي يوفر للشريك وقتاً كافياً لتكوين أحداثك للتدفق إلى Event Grid ولتوفير موضوع الشريك الخاص بك. لن يتمكن شريكك من إنشاء موارد (موضوعات الشريك) في اشتراك Azure بعد وقت انتهاء صلاحية التخويل.

إشعار

بدأت Event Grid في فرض عمليات التحقق من التخويل لإنشاء مواضيع الشركاء حول 30 يونيو 2022.

  1. سجل الدخول إلى مدخل Azure.

  2. في شريط البحث في الجزء العلوي، أدخل تكوينات الشريك، وحدد Event Grid Partner Configurations ضمن الخدمات في النتائج.

  3. في صفحة Event Grid Partner Configurations، حدد الزر Create Event Grid partner configuration في الصفحة (أو) حدد Create + في شريط الأوامر.

    Screenshot showing the Event Grid Partner Configurations page with the list of partner configurations and the link to create a partner registration.

  4. في صفحة Create Partner Configuration، قم بالخطوات التالية:

    1. في قسم Project Details، حدد اشتراك Azure ومجموعة الموارد حيث تريد السماح للشريك بإنشاء موضوع شريك.

    2. في قسم Partner Authorizations، حدد وقت انتهاء الصلاحية الافتراضي لتخويلات الشركاء المحددة في هذه التكوين.

    3. لتوفير التخويل الخاص بك لشريك لإنشاء مواضيع الشريك في مجموعة الموارد المحددة، حدد ارتباط + تخويل الشريك.

      Screenshot showing the Create Partner Configuration page with the Partner Authorization link selected.

  5. في صفحة Add partner authorization to create resources، ترى قائمة verified partners. الشريك الذي تم التحقق منه هو الشريك الذي تم التحقق من صحة هويته بواسطة Microsoft. اتبع هذه الخطوات لتخويل Auth0 لإنشاء موضوع شريك.

    1. حدد الشريك الذي تم التحقق منه (Auth0 أو SAP أو Tribal Group أو Microsoft Graph API) من قائمة الشركاء الذين تم التحقق منهم.

    2. حدد authorization expiration time.

    3. حدد Add.

      Screenshot showing the page that allows you to grant a verified partner the authorization to create resources in your resource group.

      هام

      لن يتمكن شريكك من إنشاء موارد (موضوعات الشريك) في اشتراك Azure بعد وقت انتهاء صلاحية التخويل.

  6. مرة أخرى على صفحة Create Partner Configuration، تحقق من إضافة الشريك إلى قائمة تخويل الشريك بالجزء السفلي.

  7. حدد مراجعة + إنشاء عند أسفل الصفحة.

  8. في صفحة Review، راجع جميع الإعدادات، ثم حدد Create لإنشاء تسجيل الشريك.

قم بإعداد موضوع شريك Auth0

جزء من عملية التكامل هو إعداد Auth0 للاستخدام كمصدر حدث باستخدام لوحة معلومات Auth0.

  1. سجل الدخول إلى لوحة معلومات Auth0.
  2. انتقل إلى Monitoring>Streams.
  3. انقر فوق + Create Log Stream.
  4. حدد Azure Event Grid وأدخل اسماً فريداً لدفقك الجديد.
  5. في ، أدخل معرف اشتراك Azure الخاص بك.
  6. في Azure Region، حدد منطقة Azure التي توجد بها مجموعة الموارد.
  7. في Resource Group، أدخل اسم مجموعة الموارد.
  8. في ، حدد All أو تصفية لأنواع معينة من الأحداث.
  9. حدد الخيار Use a specific day and time to start the stream from إذا كنت تريد أن يبدأ البث في يوم ووقت محددين.
  10. انقر فوق حفظ.

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

Screenshot showing the partner topic in the list.

تنشيط موضوع شريك

  1. في شريط البحث في مدخل Microsoft Azure، ابحث عن وحدد Event Grid Partner Topics.

  2. في صفحة Event Grid Partner Topics، حدد موضوع الشريك في القائمة.

    Screenshot that shows selection a partner topic in the Event Grid Partner Topics page.

  3. راجع رسالة التنشيط، وحدد تنشيط على الصفحة أو على شريط الأوامر لتنشيط موضوع الشريك قبل وقت انتهاء الصلاحية المذكور على الصفحة.

    Screenshot showing the selection of the Activate button on the command bar or on the page.

  4. تأكد من تعيين حالة التنشيط على نشط ثم قم بإنشاء اشتراكات حدث لموضوع الشريك عن طريق تحديد + اشتراك حدث في شريط الأوامر.

    Screenshot showing the activation state of a partner topic as **Activated**.

الاشتراك في الأحداث

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

إنشاء معالج الحدث

لاختبار موضوع شريكك، ستحتاج إلى معالج حدث. انتقل إلى اشتراك Azure الخاص بك وقم بتدوير الخدمة التي يتم دعمها باعتبارها معالج حدث مثل وظيفة Azure. للحصول على مثال، راجع نموذج عارض Event Grid الذي يمكنك استخدامه كمعالج للأحداث عبر خطاطيف الويب.

اشترك في موضوع الشريك

الاشتراك في موضوع الشريك يخبر Event Grid أين تريد أن يتم تسليم أحداث شريكك.

  1. في مدخل Microsoft Azure، اكتب Event Grid Partner Topics في مربع البحث، وحدد Event Grid Partner Topics.

  2. في صفحة Event Grid Partner Topics، حدد موضوع الشريك في القائمة.

    Screenshot showing the selection of a partner topic on the Event Grid Partner Topics page.

  3. في صفحة Event Grid Partner Topic لموضوع الشريك، حدد + Event Subscription في شريط الأوامر.

    Screenshot showing the selection of Add Event Subscription button on the Event Grid Partner Topic page.

  4. في صفحة إنشاء اشتراك حدث، قم بتنفيذ الخطوات التالية:

    1. أدخل اسماً للاشتراك في الحدث.

    2. بالنسبة إلى تصفية أنواع الأحداث، حدد أنواع الأحداث التي سيتلقاها اشتراكك.

    3. بالنسبة إلى نوع نقطة النهاية، حدد خدمة Azure (Azure Function أو قوائم انتظار التخزين أو مراكز الأحداث أو قائمة انتظار ناقل الخدمة أو موضوع ناقل الخدمة أو الاتصال المختلطة وما إلى ذلك) أو إخطار على الويب.

    4. انقر على الرابط تحديد نقطة نهاية. في هذا المثال، دعنا نستخدم وجهة أو نقطة نهاية مراكز الأحداث.

      Screenshot showing the configuration of an endpoint for an event subscription.

    5. في صفحة Select Event Hub، حدد التكوينات لنقطة النهاية، ثم حدد Confirm Selection.

      Screenshot showing the configuration of an Event Hubs endpoint.

    6. الآن في صفحة Create Event Subscription، حدد Create.

      Screenshot showing the Create Event Subscription page with example configurations.

حاول استدعاء أي من إجراءات Auth0 التي تؤدي إلى نشر حدث لمشاهدة تدفق الأحداث.

تحقق من التكامل

للتحقق من أن التكامل يعمل كما هو متوقع:

  1. سجّل الدخول إلى لوحة معلومات Auth0.
  2. انتقل إلى Monitoring>Streams.
  3. انقر فوق Event Grid stream.
  4. بمجرد بدء البث، انقر فوق علامة التبويب Health. يجب أن يكون الدفق نشطاً وطالما أنك لا ترى أي أخطاء، فإن الدفق يعمل.

محاولات التسليم، وإعادة المحاولة

يتم تسليم أحداث Auth0 إلى Azure عبر آلية دفق. يتم إرسال كل حدث عند تشغيله في Auth0. إذا تعذر على Event Grid استقبال الحدث، فستعيد Auth0 المحاولة حتى ثلاث مرات لتسليم الحدث. خلاف ذلك، سوف تقوم Auth0 بتسجيل الفشل في التسليم في نظامها.

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