Device Trust from Android Enterprise – Verfügbare Signale

Device Trust from Android Enterprise stellt eine Reihe von Signalen zum Gerätestatus auf Device bereit, auf die autorisierte Anwendungen zugreifen können, um einen Vertrauenswert für das Gerät zu berechnen. Dazu gehören Anwendungen auf der Zulassungsliste und Apps, denen die Rolle COMPANION_APP zugewiesen ist (siehe Anwendungsrollen verwalten und Richtlinienkonfiguration).

Jedes Signalfeld in Device und den verschachtelten Modellklassen enthält eine entsprechende get*Metadata()-Methode, die Metadata zurückgibt. Dadurch werden alle Metadata.DataIssue-Fehler gemeldet, die beim Abrufen des Signals auftreten (z. B. fehlende Manifestberechtigungen).

Informationen zum Einbinden des Android Management API SDK in Ihre Anwendung finden Sie im Integrationsleitfaden für Device Trust from Android Enterprise.

Signale
Version des Betriebssystems
Device#getSoftwareInfo() gibt ein SoftwareInfo-Objekt mit Details zur Betriebssystemversion zurück (ältere Betriebssystemversionen haben in der Regel mehr Sicherheitslücken):
Android Device Policy-Version
SoftwareInfo#getAndroidDevicePolicyVersionCode() und SoftwareInfo#getAndroidDevicePolicyVersionName() geben den Versionscode und den für den Nutzer sichtbaren Versionsnamen der Android Device Policy App auf dem Android-Gerät zurück.
Hat das Gerät ein ausstehendes Over-the-Air-Update?
SoftwareInfo#getSystemUpdateInfo() gibt einen SoftwareInfo.SystemUpdateInfo zurück, der angibt, ob ein ausstehendes Betriebssystem-Update für das Gerät verfügbar ist (ein Hinweis darauf, dass das Gerät für Angriffe anfällig ist):
Sicherheitspatch-Level des Geräts
SoftwareInfo#getDeviceSecurityPatchInfos() gibt eine Liste von SoftwareInfo.SecurityPatchInfo-Objekten zurück (mit getComponent() und getSecurityPatchLevel(), die eine Liste von SecurityPatchLevel-Objekten zurückgeben) für das aktuelle Sicherheitspatch-Level des Geräts über aktualisierbare SecurityPatchComponent-Typen:
Veröffentlichtes Sicherheitspatch-Level
SoftwareInfo#getPublishedSecurityPatchInfos() gibt eine Liste von SoftwareInfo.SecurityPatchInfo-Objekten zurück (mit getComponent() und getSecurityPatchLevel(), die eine Liste von SecurityPatchLevel-Objekten zurückgeben) für das aktuelle veröffentlichte Sicherheitspatch-Level für aktualisierbare SecurityPatchComponent-Typen:
App-Details
Device#getApplicationReports() gibt Details zu allen installierten Anwendungen an Erweiterungs-Apps und aufrufende Anwendungen mit der Rolle COMPANION_APP auf einem von der AMAPI verwalteten Gerät zurück (siehe Anwendungsrollen verwalten und Richtlinienkonfiguration; bei Aufruf innerhalb eines Arbeitsprofils sind die Berichte auf im Arbeitsprofil installierte Apps beschränkt). Für alle anderen Aufrufer (z. B. Anwendungen auf der Zulassungsliste) gibt Device#getApplicationReports() nur Details zu den folgenden kritischen Anwendungen zurück:
  • com.android.chrome
  • com.google.android.gms
  • com.google.android.apps.work.clouddpc
  • com.android.vending
  • Das aktuelle WebView-Paket des Geräts (z. B. com.google.android.webview)
Die Details werden als Liste von ApplicationReport-Objekten zurückgegeben, die Folgendes enthalten:
Informationen zur Gerätehardware
Device#getHardwareInfo() gibt ein HardwareInfo-Objekt zurück, das Folgendes verfügbar macht:
Komplexität der Displaysperre
Device#getDeviceSettings() bietet DeviceSettings#getScreenLockComplexity(), das einen DeviceSettings.ScreenLockComplexity-Wert zurückgibt, der angibt, wie komplex die Displaysperre des aktuellen Nutzers oder Profils ist.
Verwaltungsstatus (und Verwaltungs-App)
Die zurückgegebenen Informationen hängen vom Profil ab, in dem die Anwendung ausgeführt wird. Weitere Informationen finden Sie in der Tabelle der Verwaltungsstatus.
Laufwerksverschlüsselung
DeviceSettings#getEncryptionStatus() gibt einen DeviceSettings.EncryptionStatus-Wert zurück, der angibt, ob der Speicher des Geräts verschlüsselt ist.
Netzwerkstatus abrufen (Netzwerkstatus und WLAN-Status)
Device#getNetworkInfo() gibt ein NetworkInfo-Objekt zurück und NetworkInfo#getNetworkParams() gibt eine Liste von NetworkInfo.NetworkParams-Objekten mit Details zu allen aktiven Netzwerken auf dem Gerät zurück:
Google Play Protect VerifyApps
Ist DNS-over-TLS aktiviert?
NetworkParams#getPrivateDnsState() gibt einen PrivateDnsState-Wert zurück, der angibt, ob im Netzwerk ein privates DNS verwendet wird.
WebView-Paket
SoftwareInfo#getWebviewPackage() gibt den Namen des aktuellen WebView-Pakets zurück.
Menschenlesbarer Name des Verwaltungsanbieters
Auf über AMAPI verwalteten Geräten gibt Device#getManagementProviderInfo() ein ManagementProviderInfo-Objekt zurück, dessen Methode getBusinessName() den menschenlesbaren Unternehmensnamen des Verwaltungsanbieters liefert. Dieses Feld ist auf nicht verwalteten Geräten oder Geräten, die von einem benutzerdefinierten DPC verwaltet werden, nicht festgelegt.

Verwaltungsstatus

Die für die Verwaltungssignale zurückgegebenen Werte hängen von dem Profil ab, in dem Ihre Anwendung ausgeführt wird. Für den Zugriff auf Signale aus dem privaten Profil, auf einem nicht verwalteten Gerät oder auf einem Gerät, das von einem benutzerdefinierten DPC verwaltet wird, muss Ihre Anwendung auf der Zulassungsliste stehen. Auf einem über die AMAPI verwalteten, vollständig verwalteten Gerät oder in einem Arbeitsprofil können Apps, denen die Rolle COMPANION_APP zugewiesen ist, auch auf diese Signale zugreifen, ohne auf der Zulassungsliste zu stehen. Wenn sie in einem Arbeitsprofil aufgerufen werden, sind sie auf Signale aus dem Arbeitsprofil beschränkt.

Verwaltungsstatus Signale, wenn sie über das private Profil aufgerufen werden Signale, wenn sie über das Arbeitsprofil aufgerufen werden
Nicht verwaltetes Gerät ownership: PERSONALLY_OWNED
managementMode: UNMANAGED
managementAppPackageName: N/A
workProfileState:
N/A
Arbeitsprofil auf privaten Geräten (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:
Arbeitsprofil auf unternehmenseigenem Gerät ownership: COMPANY_OWNED
managementMode: UNMANAGED
managementAppPackageName:N/A
workProfileState:
ownership: COMPANY_OWNED
managementMode: PROFILE_OWNER
managementAppPackageName: Package name of the Profile Owner application
workProfileState:
Vollständig verwaltetes Gerät N/A ownership: COMPANY_OWNED
managementMode: DEVICE_OWNER
managementAppPackageName: Package name of the Device Owner application
workProfileState: