Thema
NinjaOne hat einige der in diesem Artikel beschriebenen grundlegenden API-Sätze in JSON-Darstellung implementiert. Wir arbeiten daran, in zukünftigen Versionen weitere APIs bereitzustellen.
Umgebung
- Android-OS
- NinjaOne MDM
Beschreibung
Um mehr über die Android Management API (AMAPI) zu erfahren, sehen Sie sich die Android-Entwicklerdokumentation an.
- Android-Anwendung-Endpunkt
- Delegierter Umfang
- Gewährte Berechtigungen
- Gerätekonnektivitätsverwaltung
- Verwalten des Schutzes vor Werksrücksetzung (FRP)
- Zugängliche Track-IDs
- Benutzerdefinierte Benachrichtigung
- Immer auf VPN-Paket
Android-Anwendung-Endpunkt:
{{server}}/ws/MDM/Anwendung/Android/{packageName}Der oben genannte Endpunkt wurde erstellt, um die unten aufgeführten Daten abzurufen.
- Zeigt eine Liste der Berechtigungen für diese Anwendung (packageName) an, einschließlich der Laufzeitberechtigungen.
- Zeigt die neueste Vorabversion und App-Transaktionen für jede App an, für die Zugang gewährt wurde.
- Gibt ein „appTracks“-Array mit Paketdaten zurück.
Delegierter Umfang:
Legen Sie die „DelegatedScope“-Felder in einer Android-Richtlinienanwendung fest. Diese gewähren den betroffenen Anwendungen zusätzliche Berechtigungen. Delegierte Gültigkeitsbereiche sind eine API mit Mehrfachauswahl, die es ermöglicht, einer Anwendung unter „Richtlinien/Anwendungen/App-Einstellungen“ einen oder mehrere delegierte Gültigkeitsbereiche für zusätzliche Funktionen auf dem Gerät zuzuweisen.
Scopes können auf mehrere Anwendungen angewendet werden, mit Ausnahme von SECURITY_LOGS, CERT_SELECTION und NETWORK_ACTIVITY_LOGS, die jeweils nur an eine App delegiert werden können.
| Enums | |
|---|---|
DELEGATED_SCOPE_UNSPECIFIED | Kein Delegationsumfang angegeben. |
CERT_INSTALL | Gewährt Zugriff auf die Installation und Verwaltung von Zertifikaten. |
MANAGED_CONFIGURATIONS | Gewährt Zugriff auf die Verwaltung von verwalteten Konfigurationen. |
BLOCK_UNINSTALL | Gewährt Zugriff zum Blockieren der Deinstallation. |
PACKAGE_ACCESS | Gewährt Zugriff auf den Status des Paketzugriffs. |
ENABLE_SYSTEM_APP | Gewährt Zugriff zum Aktivieren von Systemanwendungen. |
NETWORK_ACTIVITY_LOGS | Gewährt Zugriff auf Netzwerkaktivitätsprotokolle. Ermöglicht es der delegierten Anwendung, die Methoden `setNetworkLoggingEnabled`, `isNetworkLoggingEnabled` und `retrieveNetworkLogs` aufzurufen. Dieser Geltungsbereich kann an höchstens eine Anwendung delegiert werden. Wird für vollständig verwaltete Geräte unter Android 10 und höher unterstützt. Wird für ein Arbeitsprofil unter Android 12 und höher unterstützt. Wenn die Delegierung unterstützt und eingerichtet ist, wird `NETWORK_ACTIVITY_LOGS` ignoriert. |
SECURITY_LOGS | Gewährt Zugang zu Sicherheitsprotokollen. Ermöglicht der delegierten Anwendung den Aufruf der Methoden `setSecurityLoggingEnabled`, `isSecurityLoggingEnabled`, `retrieveSecurityLogs` und `retrievePreRebootSecurityLogs`. Dieser Geltungsbereich kann an höchstens eine Anwendung delegiert werden. Unterstützt für vollständig verwaltete Geräte und Geräte des Eigentums des Unternehmens mit einem Arbeitsprofil unter Android 12 und höher. Wenn die Delegierung unterstützt und festgelegt ist, wird `SECURITY_LOGS` ignoriert. |
CERT_SELECTION | Gewährt Zugriff auf die Auswahl von KeyChain-Zertifikaten im Auftrag anfragender Anwendungen. Sobald die Erteilung erfolgt ist, erhält die delegierte Anwendung den Call „DelegatedAdminReceiver#onChoosePrivateKeyAlias“. Zulässt der delegierten Anwendung den Aufruf der Methoden „grantKeyPairToApp “ und „revokeKeyPairFromApp “. Es kann höchstens eine Anwendung geben, die über diese Delegierung verfügt. „choosePrivateKeyRules“ muss leer sein, und „privateKeySelectionEnabled“ hat keine Auswirkung, wenn die Zertifikatsauswahl an eine Anwendung delegiert ist. |
Beispiel-Payload
Gewährte Berechtigungen:
Konfigurieren Sie die Android-Berechtigungsrichtlinie und deren Erteilungsstatus für die Anwendungskonfiguration:„alluser-choice“ (d. h. Abfrage) oder „verweigern“.
| Methoden | |
|---|---|
| „Berechtigung“ | Zeichenkette Dies ist die Android-Berechtigung oder -Gruppe; zum Beispiel: android.permission. READ_CALENDARandroid.permission_group.CALENDAR. |
| „Richtlinie“ | enum (Genehmigungspolitik) Dies ist die Richtlinie für die Erteilung der Berechtigung; zum Beispiel: GRANT |
Beispiel-Nutzdaten
Verwaltung der Gerätekonnektivität:
Steuerung der Gerätekonnektivität wie WLAN, USB-Datenzugriff, Tastatur-/Mausverbindungen und mehr.
| Methoden | |
|---|---|
| „usbDataAccess“ | enum (UsbDataAccess) Hiermit wird gesteuert, welche Dateien und/oder Daten über USB auf Geräten des Unternehmens übertragen werden dürfen. |
| „configureWifi“ | enum (Wi-Fi konfigurieren) Hiermit werden die Berechtigungen zum Wi-Fi-Konfigurieren gesteuert. Je nach eingestellter Option hat der Benutzer entweder volle, eingeschränkte oder gar keine Steuerung über die Konfiguration von Wi-Fi-Netzwerken. |
| „wifiDirectSettings“ | enum (WifiDirectSettings) Hiermit wird die Möglichkeit gesteuert, WLAN-Direct-Einstellungen zu konfigurieren und zu nutzen. Wird auf firmeneigenen Geräten mit Android 13 und höher unterstützt. |
| „tetheringSettings“ | enum (TetheringSettings) Hiermit werden die Tethering-Einstellungen gesteuert. Je nach eingestelltem Wert ist es dem Nutzer teilweise oder vollständig untersagt, verschiedene Formen des Tetherings zu nutzen. |
Beispiel-Payload
Verwalten des Factory Reset Protection (FRP):
Die FRP-Verwaltung ermöglicht es Systemadministratoren, ein bestimmtes Google-Konto anzugeben, das die FRP-E-Mail-Adresse auf Geräten außer Kraft setzt, die auf unbefugte Weise zurückgesetzt wurden (z. B. über den Wiederherstellungsmodus, durch erneutes Flashen oder nach zu vielen falschen Passwortversuchen). Sobald dies über eine Eingabezeichenfolge in „Policy/Security“ unter dem Titel „Factory Reset Protection allowlisted account“ festgelegt wurde, kann nur dieses Konto zum Entsperren eines zurückgesetzten Geräts verwendet werden.
 | Als bewährte Vorgehensweise wird von NinjaOne vorgeschlagen, dass diese gebundenen Konten nicht mit Nutzern verknüpft sein sollten. |
| Methoden | |
|---|---|
| „frpAdminEmails[]“ | Zeichenkette E-Mail-Adressen von Geräteadministratoren für den Schutz vor Werksrücksetzung. Wenn das Gerät auf die Werkseinstellungen zurückgesetzt wird, muss sich einer dieser Administratoren mit der E-Mail-Adresse und dem Passwort des Google-Kontos anmelden, um das Gerät zu entsperren. Wenn keine Administratoren angegeben sind, bietet das Gerät keinen Schutz vor Werksrücksetzung. |
Beispiel-Payload
Verfügbare Track-IDs:
Wählen Sie die Track-ID für eine Anwendung in einer beliebigen Android-MDM-Richtlinie aus. Die in der Antwort enthaltene Liste „appTrackInfo[]“ enthält für die angegebenen Anwendungen Folgendes:
trackId: Die eindeutige Kennung des Tracks, die von dem Parameter„releaseTrackId“in der URL der Seite in der Play Console stammt, auf der die Track-Informationen der App angezeigt werden.trackAlias: Der für Menschen lesbare Name des Tracks, der in der Play Console geändert werden kann.
Um einen geschlossenen Track auf dem Gerät eines Nutzers zu installieren, geben Sie die „accessibleTrackIds“ in der Richtlinie für dessen Gerät an.
Beispiel-Payload
Benutzerdefinierte Benachrichtigung:
Zulässt Organisationen, eine benutzerdefinierte Sperrbildschirm-Nachricht festzulegen, mit der Administratoren besser vermitteln können, warum etwas geblockt wurde.
| Methoden | |
|---|---|
| „deviceOwnerLockScreenInfo“ | Objekt (UserFacingMessage)„ “ Die Informationen zum Geräteeigentümer, die auf dem Sperrbildschirm angezeigt werden sollen. |
| „shortSupportMessage“ | Objekt (UserFacingMessage) Eine Nachricht, die dem Nutzer im Einstellungsbildschirm angezeigt wird, wenn die Funktionalität vom Administrator deaktiviert wurde. Ist die Nachricht länger als 200 Zeichen, wird sie möglicherweise gekürzt. |
| „longSupportMessage“ | Objekt (UserFacingMessage) Eine Nachricht, die dem Nutzer im Bildschirm der Geräteadministration angezeigt wird. |
| „localizedMessages“ | Map (Schlüssel: Zeichenfolge, Wert: Zeichenfolge) Ein Map, der <LOCALE, message>-Paare enthält, wobei „locale“ ein gültiger BCP-47-Sprachcode ist, z. B. en-US, es-ES oder fr. |
| „defaultMessage“ | Zeichenkette Die Standardnachricht, die angezeigt wird, wenn keine lokalisierte Nachricht angegeben ist oder das Gebietsschema des Nutzers mit keiner der lokalisierten Nachrichten übereinstimmt. Eine Standardnachricht muss angegeben werden, wenn lokalisierte Nachrichten vorhanden sind. |
Beispiel-Payload
Immer auf VPN-Paket:
Konfigurieren Sie die „AlwaysOnVpnPackage “-Felder in einer Android-Richtlinie.
| Methoden | |
|---|---|
| „packageName“ | Zeichenkette„ “ Der Paketname der VPN-App. |
| „lockdownEnabled“ | bool Verhindert Netzwerkzugriff, wenn die VPN-Verbindung nicht verbunden ist. |
Beispiel-Nutzdaten
