Support für Android-Verwaltungs-API-Richtlinien

Thema

NinjaOne hat einige grundlegende API-Sätze implementiert, die in diesem Artikel in JSON-Darstellungen beschrieben sind. Wir arbeiten daran, mit zukünftigen Versionen weitere APIs zu veröffentlichen.

Umgebung

• Android OS
• NinjaOne MDM

Beschreibung

Um mehr über die Android Management API (AMAPI) zu erfahren, lesen Sie bitte die Android-Entwicklerdokumentation.

• Android-Anwendungs-Endpunkt
• Delegierter Umfang
• Gewährte Berechtigungen
• Gerätekonnektivitätsverwaltung
• Verwaltung des Schutzes vor Zurücksetzen auf Werkseinstellungen (FRP)
• Zugängliche Track-IDs
• Benutzerdefinierte Benachrichtigungen
• Immer auf VPN-Paket

Android-Anwendung Endpunkt:

{{server}}/ws/mdm/application/android/{packageName}

Der oben genannte Endpunkt wurde erstellt, um die folgenden Daten abzurufen.

• Anzeige einer Liste der Berechtigungen für diese Anwendung (packageName), einschließlich Laufzeit.
• Zeigen Sie die neueste Vorabversion und App-Transfers für jede App an, für die der Zugriff gewährt wurde.
• Gibt ein appTracks-Array mit Paketdaten zurück.

Delegierter Umfang:

Legen Sie die DelegatedScope-Felder in einer Android-Richtlinienanwendung fest. Diese bieten zusätzliche Berechtigungen für die betroffenen Anwendungen. Delegierte Bereiche sind eine API mit Mehrfachauswahl, mit der einer Anwendung in den Einstellungen für Richtlinien/Anwendungen/Apps ein oder mehrere delegierte Bereiche für zusätzliche Funktionen auf dem Gerät gewährt werden können.

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.

Beispiel Nutzlast

Gewährte Berechtigungen:

Konfigurieren Sie die Android-Berechtigungsrichtlinie und ihren Gewährungsstatus für die Anwendungskonfiguration:alluser-choice (d. h. Aufforderung) oder deny.

android.permission.

READ_CALENDARandroid.permission_group.CALENDAR.

GRANT

Beispiel Nutzlast

Gerätekonnektivität verwalten:

Steuerung der Gerätekonnektivität wie WLAN, USB-Datenzugriff, Tastatur-/Mausverbindungen und mehr.

Beispiel Nutzlast

Verwalten des Schutzes vor Zurücksetzen auf Werkseinstellungen (FRP):

Die FRP-Verwaltung ermöglicht es Systemadministratoren, ein bestimmtes Google-Konto einzugeben, das die FRP-E-Mail auf Geräten überschreibt, die auf unbefugte Weise zurückgesetzt werden (z. B. Wiederherstellung, erneutes Flashen, zu viele falsche Passwortversuche usw.). Sobald dies über eine Eingabezeichenfolge in "Richtlinie/Sicherheit" unter dem Titel "Für den Schutz vor Zurücksetzen auf Werkseinstellungen zugelassene Konten" festgelegt wurde, kann nur dieses Konto zum Entsperren eines zurückgesetzten Geräts verwendet werden.

Als bewährte Vorgehensweise empfiehlt NinjaOne, diese gebundenen Konten nicht mit Benutzern zu verknüpfen.

Beispiel Nutzdaten

Zugängliche 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 Titels, die aus der releaseTrackId in der URL der Seite in der Play Console übernommen wird, auf der die Titelinformationen der App angezeigt werden.
• trackAlias: Der für Menschen lesbare Name des Titels, 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 das Gerät an.

Beispiel für Nutzdaten

Benutzerdefinierte Benachrichtigungen:

Erlauben Sie Organisationen, eine benutzerdefinierte Sperrbildschirm-Nachricht festzulegen, mit der Administratoren besser kommunizieren können, warum etwas blockiert ist.

Beispiel Nutzlast

Immer auf VPN-Paket:

Konfigurieren Sie die Felder "AlwaysOnVpnPackage " in einer Android-Richtlinie.

Beispiel Nutzlast