הגדרת התראות Pub/Sub

בעזרת ההתראות ב-Pub/Sub אפשר לקבל התראות לגבי מכשירים חדשים שנרשמו, דוחות על מכשירים ופקודות שהונפקו לאחרונה.

כדי להגדיר התראות ב-Pub/Sub, צריך להפעיל את Pub/Sub API וליצור נושא. כדי לקבל הודעות שמתפרסמות בנושא מסוים, צריך ליצור מינוי לנושא הזה. המינוי מחבר את הנושא לאפליקציה של מנוי, שמקבלת ומעבדת את ההודעות שפורסמו באותו נושא. לאחר יצירת המינוי, עליכם להעניק ל-Android Device Policy הרשאה לפרסם בנושא שלכם.

1. הפעלת Pub/Sub API לפרויקט

לקבלת הוראות להפעלת Pub/Sub API, קראו את המדריך למתחילים של המסוף. הקפידו לבחור את אותו הפרויקט שהופיע בו ממשק Android Management API.

2. יצירת נושא

לאחר הפעלת ה-API, עליכם ליצור נושא שבו אפליקציית Android Device Policy תוכל לפרסם התראות. יש שתי דרכים ליצור נושא:

a. ידנית במסוף Google Cloud Platform.
ב. באמצעות Pub/Sub API (כדאי לעיין במאמר יצירת topicmethod).

אחרי שיוצרים נושא, חשוב לזכור אותו.

3. יצירת מינוי

מינוי לוכד את זרם ההודעות שפורסמו בנושא נתון. יש שתי דרכים ליצור מינוי:

a. ידנית במסוף Google Cloud Platform.
ב. באמצעות Pub/Sub API (כדאי לעיין ביצירת שיטת מינוי).

4. הענק ל-Android Device Policy את הזכות לפרסם בנושא שלך

עליכם להעניק ל-android-cloud-policy@system.gserviceaccount.com הרשאה לפרסם את הנושא שלכם. יש שתי דרכים להענקת זכויות פרסום:

a. ידנית במסוף Google Cloud Platform.

  • צריך להוסיף את android-cloud-policy@system.gserviceaccount.com לחבר לנושא שלך.
  • לוחצים על Select a role (בחירת תפקיד) > Pub/Sub > Pub/Sub Publisher.

b. באמצעות Pub/Sub API (מידע נוסף זמין במאמר בקרת גישה דרך Google Cloud Pub/Sub IAM API)

  • הוספה של serviceAccount:android-cloud-policy@system.gserviceaccount.com אל members.
  • הגדרה של role לערך 'roles/pubsub.publisher'

5. צריך לעדכן את הארגון כדי לתמוך בהתראות

כדי לקשר התראות לגבי ארגון לנושא שיצרתם, צריך להתקשר למספר enterprises.patch ולציין את הפרמטרים הבאים:

  • pubsubTopic: השם של נושא ה-Pub/Sub בטופס projects/{project}/topics/{topic}.
  • enabledNotificationTypes: צריך לכלול את כל סוגי ההתראות שרוצים לקבל. אפשר לבחור מבין האפשרויות ENROLLMENT, STATUS_REPORT וCOMMAND.

6. שימוש ב-Pub/Sub API לקבלת התראות

מינוי יכול להשתמש במנגנון דחיפה או משיכה להעברת הודעות. במדריך למנויים של Pub/Sub תוכלו למצוא הנחיות והוראות לקבלת התראות בשתי המנגנונים האלה.

פורמט ההודעה

הן מופיעות בצורת PubsubMessage. השדה attributes בהודעה מכיל מאפיין עם מפתח notificationType וערך שמוגדר לסוג ההתראה שהפעיל את ההודעה (למשל ENROLLMENT). השדה data של ההודעה מכיל ייצוג JSON של המשאב שעודכן, מקודד כמחרוזת UTF-8. ההתראות וסוגי המשאבים התואמים שלהן:

  • ההתראות של COMMAND משתמשות בסוג המשאב Operation.
  • ההתראות USAGE_LOGS משתמשות בסוג המשאב UsageLogEvent.
  • ההתראות ENROLLMENT ו-STATUS_REPORT משתמשות בסוג המשאב מכשיר.

כשמגדירים את pubsubTopic בארגון, תפורסם הודעה ראשונית, כשהערך של notificationType הוא test. ההודעה הזו נשלחת כדי לוודא שהאפליקציה ל-Android Device Policy קיבלה הרשאת פרסום לנושא, ויש להתעלם ממנה.