مشاركة عبر

نظرة عامة على أحداث الشركاء - Azure Event Grid

  • مقالة

تسمح أحداث شركاء Event Grid للعملاء بالاشتراك في الأحداث التي تنشأ في نظام مسجل باستخدام نفس الآلية التي سيستخدمونها لأي مصدر أحداث آخر على Azure، مثل خدمة Azure. تُعرف هذه الأنظمة المسجلة بالتكامل مع Event Grid باسم "الشركاء". كما تمكّن هذه الميزة العملاء من إرسال الأحداث إلى أنظمة الشركاء التي تدعم تلقي الأحداث وتوجيهها إلى حلول/نقاط النهاية الخاصة بالعميل في نظامهم الأساسي. عادةً ما يكون الشركاء عبارة عن موفري برامج كخدمة (SaaS) أو ERP، ولكن قد يكونون منصات مؤسسية ترغب في إتاحة أحداثها للفرق الداخلية. وهي تتكامل عن قصد مع Event Grid لتحقيق حالات استخدام العملاء الشاملة التي تنتهي على Azure (يشترك العملاء في الأحداث المرسلة من قِبل الشريك) أو تنتهي على نظام شريك (يشترك العملاء في أحداث Microsoft المرسلة بواسطة Azure Event Grid). يعتمد العملاء على Azure Event Grid لإرسال الأحداث المنشورة من قِبل شريك إلى الوجهات المدعومة مثل الإخطارات على الويب أو وظائف Azure أو Azure Event Hubs أو ناقل خدمة Azure، على سبيل المثال لا الحصر. يعتمد العملاء أيضا على Azure Event Grid لتوجيه الأحداث التي تنشأ في خدمات Microsoft، مثل Outlook أو Teams أو Microsoft Entra ID، بحيث يمكن لحلول العميل التفاعل معها. باستخدام أحداث الشركاء، يمكن للعملاء إنشاء حلول تعتمد على الأحداث عبر الأنظمة الأساسية وحدود الشبكة لتلقي الأحداث أو إرسالها بشكل موثوق به وآمن وعلى نطاق واسع.

إشعار

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

أحداث الشركاء: كيفية عملها

كشريك، يمكنك إنشاء موارد Event Grid التي تمكّنك من نشر الأحداث إلى Azure Event Grid بحيث يمكن للعملاء على Azure الاشتراك فيها. بالنسبة إلى معظم الشركاء، على سبيل المثال موفرو SaaS، إنها إمكانية التكامل الوحيدة التي سيستخدمونها.

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

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

  1. اتصل بفريق Event Grid للتواصل askgrid@microsoft.com مع اهتمامك بأن تصبح شريكاً. بمجرد الاتصال بنا، سنرشدك خلال عملية الإعداد ونساعد خدمتك في الحصول على بطاقة إدخال في معرض Azure Event Grid بحيث يمكن العثور على خدمتك على مدخل Microsoft Azure.

  2. إنشاء تسجيل شريك. هذا مورد عمومي وعادة ما تحتاج إلى إنشاء مرة واحدة.

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

  4. يأذن لك العميل بإنشاء موضوع شريك في اشتراك Azure الخاص بالعميل.

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

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

  7. يقوم العميل بتنشيط موضوع الشريك الذي قمت بإنشائه في اشتراك Azure ومجموعة الموارد الخاصة به.

  8. ابدأ في نشر الأحداث إلى مساحة اسم الشريك.

    إشعار

    يجب تسجيل موفر موارد Azure Event Grid في كل اشتراك Azure حيث تريد إنشاء موارد Event Grid. خلاف ذلك، ستفشل عمليات إنشاء الموارد.

لماذا ينبغي أن أستخدم "أحداث الشريك"؟

قد ترغب في استخدام ميزة أحداث الشريك إذا كان لديك واحد أو أكثر من المتطلبات التالية.

للشركاء كناشري الأحداث

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

للشركاء كمشترك

  • تريد أن تتفاعل خدمتك مع أحداث العملاء التي تنشأ في Microsoft Azure.
  • تريد أن يتفاعل عميلك مع أحداث خدمة Microsoft Azure باستخدام تطبيقاته المستضافة من قِبل النظام الأساسي الخاص بك. يمكنك استخدام قدرات توجيه الأحداث في النظام الأساسي لتقديم الأحداث إلى حل العميل المناسب.
  • تريد نموذجًا بسيطًا حيث يقوم عملاؤك فقط بتحديد اسم الخدمة كوجهة دون الحاجة إلى معرفتهم بالتفاصيل التقنية مثل نقاط نهاية النظام الأساسي الخاص بك.
  • يدعم النظام/النظام الأساسي مخطط Cloud Events 1.0.

الموارد التي يديرها الشركاء

بصفتك شريكًا، يمكنك إدارة الأنواع التالية من الموارد.

تسجيل الشريك

التسجيل يحتوي على معلومات عامة تتعلق بالشريك. التسجيل مطلوب عند إنشاء مساحة اسم شريك. بمعنى، يجب أن يكون لديك تسجيل شريك لإنشاء موارد Azure الضرورية للتكامل مع Azure Event Grid.

التسجيلات عمومية. أي أنها غير مرتبطة بمنطقة Azure معينة. يمكنك إنشاء تسجيل شريك واحد واستخدامه عند إنشاء مساحات أسماء الشريك.

القناة

القناة هي مورد متداخل لمساحة اسم الشريك. القناة لها غرضان رئيسيان:

  • إنه نوع المورد الذي يسمح لك بإنشاء موارد شريك على اشتراك Azure الخاص بالعميل. عند إنشاء قناة من النوع partner topic، يتم إنشاء موضوع شريك على اشتراك Azure الخاص بالعميل. موضوع الشريك هو مورد العميل الذي يتم توجيه الأحداث إليه عندما ينشر نظام شريك الأحداث.

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

  • إنه مورد يستخدم لتوجيه الأحداث. يتم استخدام قناة من نوع partner topic لتوجيه الأحداث إلى موضوع شريك العميل. وهو يدعم نوعين من أوضاع التوجيه.

    • توجيه اسم القناة. مع هذا النوع من التوجيه، تقوم بنشر الأحداث باستخدام عنوان http يسمى aeg-channel-name حيث تقدم اسم القناة التي يجب توجيه الأحداث إليها. نظرًا إلى أن القنوات هي تمثيل شريك لمواضيع الشريك، تظهر الأحداث الموجهة إلى القناة حول موضوع المشارك الخاص بالعميل. هذا النوع من التوجيه هو قدرة جديدة غير موجودة في event channels، والتي تدعم التوجيه المستند إلى المصدر فقط. يتيح توجيه اسم القناة حالات استخدام أكثر من التوجيه المستند إلى المصدر وهو وضع التوجيه الموصى به للاختيار. على سبيل المثال، مع توجيه اسم القناة يمكن للعميل طلب الأحداث التي تنشأ في مصادر أحداث مختلفة للهبوط على موضوع شريك واحد.
    • التوجيه المستند إلى المصدر. يعتمد نهج التوجيه هذا على قيمة source سمة السياق في الحدث. يتم تعيين المصادر إلى القنوات وعندما يأتي حدث مع مصدر، على سبيل المثال، للقيمة "A" يتم توجيه هذا الحدث إلى موضوع الشريك المرتبط بالقناة التي تحتوي على "A" في خاصية المصدر الخاصة به.

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

    هام

    يمكن إدارة أنواع الأحداث على القناة وبمجرد تحديث القيم، تنعكس التغييرات مباشرة على موضوع الشريك المقترن.

مساحة اسم الشريك

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

تحتوي مساحات أسماء الشركاء على قنوات أو قنوات أحداث. يتم تحديده بواسطة وضع توجيه موضوع شريك الخاصية في مساحة الاسم. إذا تم تعيينه إلى عنوان اسم القناة، فإن القنوات هي النوع الوحيد من الموارد التي يمكن إنشاؤها ضمن مساحة الاسم. إذا تم تعيين وضع توجيه موضوع الشريك إلى سمة المصدر في الحدث، يمكن أن تحتوي مساحة الاسم على قنوات الأحداث فقط. ضع في اعتبارك أن قرار تعيين الحق partner topic routing mode ليس قرارًا بين اختيار اسم القناة أو التوجيه المستند إلى المصدر. تدعم القنوات كليهما. إنه قرار بدلاً من ذلك بين استخدام النوع الجديد من مورد التوجيه، والقنوات، مقابل استخدام مورد قديم، وقنوات الحدث.

قناة الحدث

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

هام

يتم إهمال قنوات الأحداث. ومن ثم، ينصح باستخدام القنوات.

الشركاء تم التحقق منهم

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

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

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

إشعار

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

هام

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

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

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

كيف يمكنك أتمتة العملية لمعرفة متى يمكنك بدء نشر الأحداث لموضوع شريك معين؟

لديك خياران:

  • اقرأ (الاستقصاء) حالة القناة بشكل دوري للتحقق مما إذا كانت حالة التنشيط قد انتقلت من غير منشط إلى تم التنشيط. يمكن أن تكون هذه العملية مكثفة حسابيًا.
  • إنشاء اشتراك حدثلاشتراك Azure أو مجموعة الموارد التي تحتوي على القناة (القنوات) التي تريد مراقبتها. ستتلقى Microsoft.Resources.ResourceWriteSuccess الأحداث كلما تم تحديث قناة. ستحتاج بعد ذلك إلى قراءة حالة القناة باستخدام معرف Azure Resource Manager المتوفر في الحدث للتأكد من أن التحديث مرتبط بتغيير في حالة التنشيط إلى تم التنشيط.

المراجع

SDK

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