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:
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 |
DeviceSettings#getGooglePlayProtectVerifyAppsState() gibt die aktuelle
GooglePlayProtectVerifyAppsState zurück.
|
| 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_OWNEDmanagementMode: UNMANAGEDmanagementAppPackageName: N/AworkProfileState:
|
N/A
|
| Arbeitsprofil auf privaten Geräten (BYOD) |
ownership:
PERSONALLY_OWNEDmanagementMode: UNMANAGEDmanagementAppPackageName: N/AworkProfileState:
|
ownership:
PERSONALLY_OWNEDmanagementMode: PROFILE_OWNERmanagementAppPackageName: Package name of the Profile Owner applicationworkProfileState:
|
| Arbeitsprofil auf unternehmenseigenem Gerät |
ownership:
COMPANY_OWNEDmanagementMode: UNMANAGEDmanagementAppPackageName: N/AworkProfileState:
|
ownership:
COMPANY_OWNEDmanagementMode: PROFILE_OWNERmanagementAppPackageName: Package name of the Profile Owner applicationworkProfileState:
|
| Vollständig verwaltetes Gerät |
N/A
|
ownership:
COMPANY_OWNEDmanagementMode: DEVICE_OWNERmanagementAppPackageName: Package name of the Device Owner applicationworkProfileState:
|