בעזרת ההתראות ב-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 קיבלה הרשאת פרסום לנושא, ויש להתעלם ממנה.