Device Trust from Android Enterprise – אותות זמינים

התכונה Device Trust מ-Android Enterprise מספקת קבוצה של אותות לגבי מצב המכשיר ב-Device, שאפליקציות מורשות יכולות לגשת אליהם כדי לחשב את ציון המהימנות של המכשיר. האפליקציות המורשות כוללות אפליקציות ברשימת ההיתרים ואפליקציות שהוקצה להן התפקיד COMPANION_APP (ראו ניהול תפקידי אפליקציות והגדרת מדיניות).

כל שדה של אות ב-Device ובמחלקות המודל המקוננות שלו כולל שיטת get*Metadata() תואמת שמחזירה את Metadata, שמדווחת על כל Metadata.DataIssue שנתקלים בו במהלך אחזור האות (למשל, הרשאות מניפסט חסרות).

במאמר Device Trust מ-Android Enterprise – מדריך לשילוב מוסבר איך לשלב את Android Management API SDK באפליקציה.

אותות
גרסת ה-OS
Device#getSoftwareInfo() מחזירה אובייקט SoftwareInfo שמכיל פרטים על גרסת מערכת ההפעלה (בדרך כלל בגרסאות ישנות יותר של מערכת ההפעלה יש יותר נקודות חולשה):
גרסת Android Device Policy
SoftwareInfo#getAndroidDevicePolicyVersionCode() ו- SoftwareInfo#getAndroidDevicePolicyVersionName() מחזירים את קוד הגרסה ואת שם הגרסה שגלויה למשתמש של אפליקציית Android Device Policy במכשיר.
האם יש במכשיר עדכון OTA בהמתנה
SoftwareInfo#getSystemUpdateInfo() מחזיר SoftwareInfo.SystemUpdateInfo שמציין אם יש עדכון של מערכת ההפעלה בהמתנה למכשיר (פרוקסי שבודק אם המכשיר פגיע לניצול לרעה):
רמת תיקוני האבטחה במכשיר
SoftwareInfo#getDeviceSecurityPatchInfos() מחזירה רשימה של אובייקטים מסוג SoftwareInfo.SecurityPatchInfo (כאשר getComponent() ו- getSecurityPatchLevel() מחזירים רשימה של אובייקטים מסוג SecurityPatchLevel) לרמת תיקוני האבטחה הנוכחית של המכשיר בסוגי SecurityPatchComponent שניתן לעדכן:
רמת תיקוני האבטחה שפורסמה
‫SoftwareInfo#getPublishedSecurityPatchInfos() מחזירה רשימה של אובייקטים מסוג SoftwareInfo.SecurityPatchInfo (כאשר getComponent() ו-getSecurityPatchLevel() מחזירים רשימה של אובייקטים מסוג SecurityPatchLevel) עבור רמת תיקוני האבטחה הנוכחית שפורסמה, בכל סוגי ה-SecurityPatchComponent שניתן לעדכן:
פרטים קריטיים של האפליקציה
Device#getApplicationReports() מחזירה פרטים על כל האפליקציות המותקנות לאפליקציות הרחבה ולאפליקציות קוראות עם התפקיד COMPANION_APP במכשיר שמנוהל על ידי AMAPI (ראו ניהול תפקידי אפליקציות והגדרת מדיניות; כשמתבצעת קריאה בתוך פרופיל עבודה, הדוחות מוגבלים לאפליקציות שמותקנות בפרופיל העבודה). לכל שאר המתקשרים (כמו אפליקציות ברשימת ההיתרים), הפונקציה Device#getApplicationReports() מחזירה פרטים רק על האפליקציות הקריטיות הבאות:
  • com.android.chrome
  • com.google.android.gms
  • com.google.android.apps.work.clouddpc
  • com.android.vending
  • חבילת WebView הנוכחית של המכשיר (למשל, com.google.android.webview)
הפרטים מוחזרים כרשימה של אובייקטים מסוג ApplicationReport שחושפים את:
  • getPackageName()
  • getVersionName() וגם getLongVersionCode()
  • getSigningKeyCertSha256Fingerprints()
  • getApplicationSource() (ערך ApplicationSource) וגם getInstallerPackageName()
  • getLastUpdateTime()
מידע על החומרה של המכשיר
‫Device#getHardwareInfo() מחזירה אובייקט מסוג HardwareInfo שחושף את:
רמת המורכבות של נעילת המסך
Device#getDeviceSettings() מספק את DeviceSettings#getScreenLockComplexity(), ומחזיר ערך DeviceSettings.ScreenLockComplexity שמציין את רמת המורכבות של נעילת המסך של המשתמש או הפרופיל הנוכחיים.
מצב הניהול (והאפליקציה המנהלת)
המידע שמוחזר תלוי בפרופיל שבו האפליקציה פועלת. לפרטים נוספים, עיינו בטבלת מצבי הניהול.
הצפנת דיסק
DeviceSettings#getEncryptionStatus() מחזירה ערך DeviceSettings.EncryptionStatus שמציין אם האחסון של המכשיר מוצפן.
גישה למצב הרשת (מצב הרשת ומצב ה-Wi-Fi)
Device#getNetworkInfo() מחזירה אובייקט NetworkInfo, ו- NetworkInfo#getNetworkParams() מחזירה רשימה של אובייקטים NetworkInfo.NetworkParams עם פרטים על כל הרשתות הפעילות במכשיר:
‫VerifyApps של Google Play Protect
האם DNS over TLS מופעל
NetworkParams#getPrivateDnsState() מחזירה ערך PrivateDnsState שמציין אם נעשה שימוש בשרת DNS פרטי ברשת.
חבילת WebView
SoftwareInfo#getWebviewPackage() מחזירה את השם של חבילת WebView הנוכחית.
שם העסק של ספק הניהול, קריא לאנשים
במכשירים שמנוהלים באמצעות AMAPI, הפונקציה Device#getManagementProviderInfo() מחזירה אובייקט ManagementProviderInfo שה-method שלו getBusinessName() מספקת את השם העסקי הקריא לאנשים של ספק הניהול. השדה הזה לא מוגדר במכשירים לא מנוהלים או במכשירים שמנוהלים על ידי DPC בהתאמה אישית.

מצב הניהול

הערכים שמוחזרים לאותות הניהול תלויים בפרופיל שבו האפליקציה פועלת. כדי לגשת לאותות מתוך הפרופיל האישי, במכשיר לא מנוהל או במכשיר שמנוהל על ידי DPC בהתאמה אישית, האפליקציה צריכה להיות ברשימת ההיתרים. במכשיר מנוהל לחלוטין שמנוהל על ידי AMAPI או מתוך פרופיל עבודה, אפליקציות שהוקצה להן התפקיד COMPANION_APP יכולות גם לגשת לאותות האלה בלי להיות ברשימת ההיתרים (מוגבל לאותות מפרופיל העבודה כשמתבצעת קריאה בתוך פרופיל עבודה).

מצב הניהול אותות כשמתקשרים מהפרופיל האישי אותות כשמתבצעת קריאה מתוך פרופיל העבודה
מכשיר לא מנוהל ownership: PERSONALLY_OWNED
managementMode: UNMANAGED
managementAppPackageName: N/A
workProfileState:
N/A
פרופיל עבודה במכשיר בבעלות אישית (BYOD) ownership: PERSONALLY_OWNED
managementMode: UNMANAGED
managementAppPackageName: N/A
workProfileState:
ownership: PERSONALLY_OWNED
managementMode: PROFILE_OWNER
managementAppPackageName: Package name of the Profile Owner application
workProfileState:
פרופיל עבודה במכשיר בבעלות החברה ownership: COMPANY_OWNED
managementMode: UNMANAGED
managementAppPackageName:N/A
workProfileState:
ownership: COMPANY_OWNED
managementMode: PROFILE_OWNER
managementAppPackageName: Package name of the Profile Owner application
workProfileState:
מכשיר בניהול מלא N/A ownership: COMPANY_OWNED
managementMode: DEVICE_OWNER
managementAppPackageName: Package name of the Device Owner application
workProfileState: