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 prossime versioni. 

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/applicazione/Android/{packageName}

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

• Visualizza un elenco delle autorizzazioni per quell'applicazione (packageName), comprese quelle di runtime.
• Visualizza l'ultima versione pre-release e i dati di trasmissione 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 alle applicazioni interessate. Gli ambiti delegati sono un'API a selezione multipla, che consente a un'applicazione all'interno di Policy/Applicazioni/Impostazioni 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

Concessioni di autorizzazioni:

Configurare la politica dei permessi Android e il relativo 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 di tastiera/mouse e altro ancora. 

Esempio di payload

Gestione della protezione dal ripristino di fabbrica (FRP):

La gestione della FRP consente agli amministratori di sistema di inserire un account Google specifico che sostituisce l’indirizzo e-mail FRP sui dispositivi ripristinati in modo non autorizzato (ad esempio, tramite modalità di ripristino, re-flash, troppi tentativi di password errati, ecc.). Una volta impostato tramite una stringa di input in Policy/Security sotto il titolo “Account nella lista bianca della protezione dal ripristino delle impostazioni di fabbrica”, solo questo account potrà essere utilizzato per sbloccare un dispositivo ripristinato.

Come best practice, NinjaOne suggerisce che questi account associati non siano collegati a utenti specifici.

Esempio di payload

ID traccia accessibili: 

Seleziona l’ID traccia per un’applicazione in qualsiasi politica MDM Android. L’elenco appTrackInfo[] incluso nella risposta contiene le seguenti informazioni per le app specificate:

• trackId: l’identificatore univoco della traccia, ricavato dal campo “releaseTrackId” presente 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, specificare gli accessibleTrackIds nella politica relativa al dispositivo.

Esempio di payload

Messaggistica personalizzata:

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

Esempio di payload

Pacchetto VPN sempre attivo:

Configurare i campi AlwaysOnVpnPackage in una politica Android. 

Esempio di payload