Supporto criteri API Gestione Android

Argomento

NinjaOne ha implementato alcuni set di API di base descritti in questo articolo in formato JSON. Stiamo lavorando per rilasciare ulteriori API nelle versioni future. 

Ambiente

• Sistema operativo Android
• NinjaOne MDM

Descrizione

Per ulteriori informazioni sull'API di gestione Android (AMAPI), consultare la documentazione per gli sviluppatori Android. 

• Endpoint dell'applicazione Android
• Ambito delegato
• Concessione di autorizzazioni 
• Gestione della connettività del dispositivo
• Gestione della protezione dal ripristino delle impostazioni di fabbrica (FRP)
• ID traccia accessibili 
• Messaggistica personalizzata
• Pacchetto VPN sempre attivo

Endpoint dell'applicazione Android:

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

L'endpoint sopra indicato è stato creato per recuperare i dati riportati di seguito.

• Visualizza un elenco delle autorizzazioni per quell'applicazione (packageName), incluso il runtime.
• Visualizza l'ultima versione pre-release e le transazioni dell'app per qualsiasi app a cui è stato concesso l'accesso. 
• Restituisce un array appTracks con i dati del pacchetto. 

Ambito delegato:

Imposta i campi DelegatedScope su un'applicazione con policy Android. Questi forniscono privilegi aggiuntivi per le applicazioni interessate. Gli ambiti delegati sono un'API a selezione multipla, che consente a un'applicazione all'interno delle impostazioni Policy/Applicazioni/App di ottenere uno o più ambiti delegati per funzionalità aggiuntive sul dispositivo.

Gli ambiti possono essere applicati a più applicazioni, ad eccezione di SECURITY_LOGS, CERT_SELECTION e NETWORK_ACTIVITY_LOGS, che possono essere delegati a una sola app alla volta.

Esempio di payload

Concessione dell'autorizzazione:

Configurare la politica di autorizzazione Android e il suo stato di concessione per la configurazione dell'applicazione:alluser-choice (ovvero, richiesta di conferma) o deny.

 android.permission.

READ_CALENDARandroid.permission_group.CALENDAR.

 GRANT

Esempio di payload

Gestione della connettività del dispositivo:

Controlla la connettività del dispositivo, come Wi-Fi, accesso ai dati USB, connessioni tastiera/mouse e altro. 

Esempio di payload

Gestione della protezione dal ripristino delle impostazioni di fabbrica (FRP):

La gestione FRP consente agli amministratori di sistema di inserire un account Google specifico che sostituisce l'e-mail FRP sui dispositivi che vengono ripristinati in modo non autorizzato (ad esempio, ripristino, re-flash, troppi tentativi di password errati, ecc.). Una volta impostato tramite una stringa di input in Policy/Security sotto il titolo "Factory Reset Protection allowlisted account", solo questo account può essere utilizzato per sbloccare un dispositivo ripristinato.

Come best practice, NinjaOne suggerisce che questi account associati non siano collegati a un utente.

Esempio di payload

ID traccia accessibili: 

Seleziona l'ID traccia per un'applicazione su qualsiasi politica MDM Android. L'elenco appTrackInfo[] incluso nella risposta contiene quanto segue per le app specificate:

• trackId: l'identificatore univoco della traccia, ricavato dal releaseTrackId nell'URL della pagina della Play Console che mostra le informazioni sulla traccia dell'app.
• trackAlias: il nome leggibile dall'utente per la traccia, modificabile nella Play Console.

Per installare una traccia chiusa sul dispositivo di un utente, specifica gli accessibleTrackIds nella policy del dispositivo.

Esempio di payload

Messaggi personalizzati:

Consente alle organizzazioni di impostare un messaggio personalizzato sulla schermata di blocco, che può aiutare gli amministratori a comunicare meglio il motivo per cui qualcosa è stato bloccato. 

Esempio di payload

Pacchetto Always On VPN:

Configurare i campi AlwaysOnVpnPackage in una policy Android. 

Esempio di payload