إعداد إشعارات النشر/الاشتراك

توفّر إشعارات Pub/Sub طريقة لتلقّي تنبيهات بشأن الأجهزة التي تم تسجيلها حديثًا وتقارير الأجهزة والأوامر التي تم إصدارها مؤخرًا.

لإعداد إشعارات Pub/Sub، عليك تفعيل Pub/Sub API وإنشاء موضوع. لتلقّي الرسائل المنشورة في موضوع معيّن، أنشئ اشتراكًا في ذلك الموضوع. يربط الاشتراك الموضوع بتطبيق مشترك يتلقّى الرسائل المنشورة في الموضوع ويعالجها. بعد إنشاء اشتراك، عليك منح تطبيق "سياسة أجهزة Android" الإذن بالنشر في موضوعك.

1. تفعيل واجهة برمجة التطبيقات Pub/Sub API لمشروعك

للحصول على تعليمات حول كيفية تفعيل Pub/Sub API، يُرجى الاطّلاع على دليل البدء السريع لوحدة التحكّم. تأكَّد من اختيار المشروع نفسه الذي تم تفعيل واجهة برمجة التطبيقات لإدارة Android له.

2. إنشاء موضوع

بعد تفعيل واجهة برمجة التطبيقات، عليك إنشاء موضوع يمكن لتطبيق Android Device Policy نشر الإشعارات عليه. هناك طريقتان لإنشاء موضوع:

أ. يدويًا في Google Cloud Console:
ب. باستخدام Pub/Sub API (راجِع طريقة create topic).

بعد إنشاء موضوع، دوِّن اسم الموضوع.

3- إنشاء اشتراك

يسجِّل الاشتراك بث الرسائل المنشورة حول موضوع معيّن. هناك طريقتان لإنشاء اشتراك:

أ. يدويًا في Google Cloud Console:
ب. باستخدام Pub/Sub API (راجِع طريقة إنشاء الاشتراك).

4. منح تطبيق Android Device Policy الإذن بالنشر في موضوعك

عليك منح android-cloud-policy@system.gserviceaccount.com إذنًا للقيام بالنشر في موضوعك. هناك طريقتان لمنح حقوق النشر:

أ. يدويًا في Google Cloud Console

  • أضِف android-cloud-policy@system.gserviceaccount.com كعضو في موضوعك.
  • انقر على اختيار دور > Pub/Sub > ناشر Pub/Sub.

ب- باستخدام Pub/Sub API (راجِع مقالة التحكّم في الوصول من خلال واجهة برمجة التطبيقات IAM API)

  • أضِف serviceAccount:android-cloud-policy@system.gserviceaccount.com إلى members.
  • اضبط role على roles/pubsub.publisher.

5- تحديث المؤسسة لتفعيل الإشعارات

تخطَّ هذه الخطوة إذا كان الإشعار الذي تريد توفيره هو ENTERPRISE_UPGRADE، الذي يكون متاحًا دائمًا.

لربط الإشعارات حول مؤسسة بالموضوع الذي أنشأته، اتصل بـ enterprises.patch وحدِّد المَعلمات التالية:

  • ‫pubsubTopic: اسم موضوع النشر/الاشتراك بالتنسيق التالي: projects/{project}/topics/{topic}.
  • enabledNotificationTypes: أدرِج جميع أنواع الإشعارات التي تريد تلقّيها. يمكنك الاختيار من بين ENROLLMENT وSTATUS_REPORT وCOMMAND.

6- استخدام Pub/Sub API لتلقّي الإشعارات

يمكن أن يستخدم الاشتراك آلية "الدفع" أو "السحب" لتسليم الرسائل. تتوفّر إرشادات وتوجيهات حول كيفية تلقّي الإشعارات من خلال كل من هذين الآليتين في دليل المشتركين في Pub/Sub.

تنسيق الرسالة

تأخذ الرسائل شكل PubsubMessage. يحتوي الحقل attributes في الرسالة على سمة بالمفتاح notificationType والقيمة التي تم ضبطها على نوع الإشعار الذي أدّى إلى إرسال الرسالة (مثل ENROLLMENT). يحتوي الحقل data في الرسالة على تمثيل JSON للمورد الذي تم تعديله، ويتم تشفيره كسلسلة UTF-8. في ما يلي الإشعارات وأنواع الموارد المقابلة لها:

  • تستخدِم إشعارات COMMAND نوع المورد العملية.
  • تستخدِم إشعارات USAGE_LOGS نوع المورد UsageLogEvent.
  • تستخدِم إشعارات ENROLLMENT وSTATUS_REPORT نوع المورد الجهاز.
  • تستخدم إشعارات ENTERPRISE_UPGRADE نوع المورد EnterpriseUpgradeEvent.

عند ضبط pubsubTopic على Enterprise، سيتم نشر رسالة أولية مع ضبط notificationType على test. يتم إرسال هذه الرسالة للتحقّق مما إذا كان تطبيق Android Device Policy يملك إذن النشر في الموضوع، ويجب تجاهلها.

مدة الاستجابة المتوقّعة

من المتوقّع إرسال أحداث الترقية إلى Enterprise على الفور.

يتم تجميع أحداث الجهاز المحلية التي تحدث بشكل متتابع سريع وإعداد تقارير عنها في رسالة Pub/Sub واحدة إلى خدمات إدارة الخدمات الجوّالة للمؤسسات (EMM).

نوع الحدث وقت الاستجابة المتوقّع بين الحدث على الجهاز وإشعار إدارة الخدمات الجوّالة للمؤسسات المرتبط به 1
حالات التطبيق ذات المفاتيح ذات الأولوية العالية فورية، بحد أقصى بلاغ واحد في الدقيقة
حالات التطبيق المرتبطة بمفتاح ذات الأولوية العادية خلال دقيقة واحدة
الأحداث المرتبطة بالتطبيقات أثناء التوفير، للتطبيقات التي تتضمّن حالات تثبيت حدّدها مشرفتكنولوجيا المعلومات2 خلال دقيقة واحدة بالإضافة إلى أحداث الإعداد الأخرى ذات الصلة
الأحداث ذات الصلة بالتطبيقات بعد التوفير للتطبيقات التي تتضمّن حالات تثبيت يحدّدها مشرفتكنولوجيا المعلومات خلال 5 دقائق
الأحداث المرتبطة بالتطبيقات أثناء عملية التوفير وبعدها، للتطبيقات التي تتضمّن حالات تثبيت حدّدها الموظف3 خلال 60 دقيقة
أحداث التطبيقات الأخرى على الجهاز خلال 60 دقيقة

  1. استهدافات أقصى الجهود استنادًا إلى الظروف الخاضعة للرقابة قد تختلف مدة الاستجابة الفعلية تبعًا لمجموعة متنوعة من عوامل الجهاز والبيئة. ↩

  2. InstallType من التطبيقات التي تم فرضها في السياسة: FORCE_INSTALLED BLOCKED وREQUIRED_FOR_SETUP وPREINSTALLED وKIOSK. ↩

  3. InstallType من التطبيقات المتاحة: AVAILABLE، INSTALL_TYPE_UNSPECIFIED. ↩