Supporto criteri API Gestione Android

Argomento

NinjaOne ha implementato alcuni set API di base descritti in questo articolo in rappresentazioni JSON. Stiamo lavorando per rilasciare API aggiuntive con le versioni future.

Ambiente

• Sistema operativo Android
• NinjaOne MDM

Descrizione

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

• Applicazione Android Endpoint
• Ambito delegato
• Concessione di autorizzazioni
• Gestione della connettività dei dispositivi
• Gestione della protezione da ripristino delle impostazioni di fabbrica (FRP)
• ID traccia accessibili
• Messaggistica personalizzata
• Pacchetto VPN sempre attivo

Applicazione Android Endpoint:

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

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

• Visualizza un elenco delle autorizzazioni per quell'applicazione (nome pacchetto), incluso il runtime.
• Visualizza l'ultima versione pre-release e app trans 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 dei criteri 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 di Criteri/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

Concessione di autorizzazioni:

Configura il criterio di autorizzazione Android e il relativo stato di concessione per la configurazione dell'applicazione:alluser-choice (ovvero, richiesta) o deny.

android.permission.

READ_CALENDARandroid.permission_group.CALENDAR.

GRANT

Esempio Payload

Gestione della connettività del dispositivo:

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

Esempio Payload

Gestione della protezione da 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, reinstallazione del firmware, troppi tentativi di password errati, ecc. Una volta impostato tramite una stringa di input in Criteri/Sicurezza sotto il titolo "Account consentito per la protezione da ripristino delle impostazioni di fabbrica", solo questo account può essere utilizzato per sbloccare un dispositivo ripristinato.

Come best practice, NinjaOne suggerisce che questi account associati non siano associati agli utenti.

Esempio Payload

ID traccia accessibili:

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

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

Per installare una traccia chiusa sul dispositivo di un utente, specificare gli accessibleTrackIds nel criterio del dispositivo.

Esempio di payload

Messaggistica personalizzata:

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

Esempio Payload

Pacchetto VPN sempre attivo:

Configura i campi AlwaysOnVpnPackage su un criterio Android.

Esempio Payload