Sicurezza

Le funzionalità descritte in questa guida illustrano le funzionalità di gestione della sicurezza che puoi implementare nell'app controller di policy dei dispositivi (DPC). Questo documento contiene esempi di codice e puoi anche utilizzare l'app Test DPC come fonte di codice campione per le funzionalità aziendali di Android.

Un'app DPC può essere eseguita in modalità profile owner sui dispositivi personali o in modalità device owner sui dispositivi completamente gestiti. Questa tabella indica quali funzionalità sono disponibili quando il DPC viene eseguito in modalità profile owner o modalità device owner:

Funzionalità Proprietario del profilo Proprietario del dispositivo
Disattiva l'accesso alle app ✓ ✓
Blocca le app di origini sconosciute ✓ ✓
Limitare gli account su Google Play ✓ ✓
Attiva la protezione aziendale del ripristino dei dati di fabbrica ✓
Monitora i log dei processi aziendali e le segnalazioni di bug da remoto ✓
Concedi e rimuovi l'accesso a un certificato client ✓ ✓
Reimpostazione sicura del passcode ✓ ✓
Verifica di sicurezza del profilo di lavoro ✓

Disattiva l'accesso alle app

Per le organizzazioni che vogliono impedire ai dipendenti di giocare o guardare YouTube sul proprio dispositivo Android in determinati orari del giorno o in determinati giorni della settimana, un DPC può disattivare temporaneamente l'accesso alle app.

Per disattivare l'accesso alle app, un DPC in esecuzione in modalità device owner o profile owner configura setPackagesSuspended(), dopodiché l'app selezionata si comporta come se fosse disattivata (il programma di avvio di Google disattiva l'app). Quando un utente tocca l'app, viene visualizzata una finestra di dialogo di sistema che indica che l'app è sospesa.

Quando un'app è sospesa, non può avviare attività e le notifiche al pacchetto vengono soppresse. I pacchetti sospesi non vengono visualizzati nella schermata di panoramica, non possono mostrare finestre di dialogo (inclusi toast e snackbar) e non possono riprodurre audio o far vibrare il dispositivo.

I launcher possono scoprire se un'app è sospesa chiamando il metodo isPackageSuspended(). Per maggiori dettagli su come configurare la sospensione delle app, consulta setPackagesSuspended.

Blocca le app da origini sconosciute

Le app non installate da Google Play (o da altri app store attendibili) sono chiamate app da origini sconosciute. I dispositivi e i dati possono essere maggiormente a rischio quando le persone installano queste app.

Per impedire a un utente di installare app da origini sconosciute, i componenti amministrativi dei dispositivi completamente gestiti e dei profili di lavoro possono aggiungere la limitazione utente DISALLOW_INSTALL_UNKNOWN_SOURCES.

Limitazione a livello di dispositivo del profilo di lavoro

Quando l'amministratore di un profilo di lavoro aggiunge DISALLOW_INSTALL_UNKNOWN_SOURCES, la limitazione si applica solo al profilo di lavoro. Tuttavia, l'amministratore di un profilo di lavoro può applicare una limitazione a livello di dispositivo impostando una configurazione gestita per Google Play. La limitazione a livello di dispositivo è disponibile in Android 8.0 (o versioni successive) quando l'app Google Play installata è la versione 80812500 o successive.

Per limitare le installazioni di app a Google Play, segui questi passaggi:

  1. Imposta un bundle di configurazione gestita per il pacchetto Google Play com.android.vending.
  2. Nel bundle, inserisci un valore booleano per la chiave verify_apps:device_wide_unknown_source_block.
  3. Aggiungi la limitazione utente ENSURE_VERIFY_APPS.

L'esempio seguente mostra come verificare che Google Play supporti questa impostazione e impostare il valore su true:

Kotlin

internal val DEVICE_WIDE_UNKNOWN_SOURCES = "verify_apps:device_wide_unknown_source_block"
internal val GOOGLE_PLAY_APK = "com.android.vending"

// ...

// Add the setting to Google Play's existing managed config. Supported in
// Google Play version 80812500 or higher--older versions ignore unsupported
// settings.
val dpm = context.getSystemService(Context.DEVICE_POLICY_SERVICE) as DevicePolicyManager
var existingConfig = dpm.getApplicationRestrictions(adminName, GOOGLE_PLAY_APK)
val newConfig = Bundle(existingConfig)
newConfig.putBoolean(DEVICE_WIDE_UNKNOWN_SOURCES, true)
dpm.setApplicationRestrictions(adminName, GOOGLE_PLAY_APK, newConfig)

// Make sure that Google Play Protect verifies apps.
dpm.addUserRestriction(adminName, UserManager.ENSURE_VERIFY_APPS)
dpm.addUserRestriction(adminName, UserManager.DISALLOW_INSTALL_UNKNOWN_SOURCES)

Java

static final String DEVICE_WIDE_UNKNOWN_SOURCES =
    "verify_apps:device_wide_unknown_source_block";
static final String GOOGLE_PLAY_APK = "com.android.vending";

// ...


// Add the setting to Google Play's existing managed config. Supported in
// Google Play version 80812500 or higher--older versions ignore unsupported
// settings.
DevicePolicyManager dpm =
    (DevicePolicyManager) context.getSystemService(Context.DEVICE_POLICY_SERVICE);
Bundle existingConfig =
    dpm.getApplicationRestrictions(adminName, GOOGLE_PLAY_APK);
Bundle newConfig = new Bundle(existingConfig);
newConfig.putBoolean(DEVICE_WIDE_UNKNOWN_SOURCES, true);
dpm.setApplicationRestrictions(adminName, GOOGLE_PLAY_APK, newConfig);

// Make sure that Google Play Protect verifies apps.
dpm.addUserRestriction(adminName, UserManager.ENSURE_VERIFY_APPS);
dpm.addUserRestriction(adminName, UserManager.DISALLOW_INSTALL_UNKNOWN_SOURCES);

L'interfaccia utente nelle impostazioni di sistema rimane attiva, ma il sistema blocca l'installazione delle app. Questa limitazione influisce sulle installazioni future, mentre le app installate in precedenza rimangono sul dispositivo. Gli utenti dei dispositivi possono continuare a installare app nel profilo personale utilizzando Android Debug Bridge (ADB).

Per scoprire di più sulle origini sconosciute, leggi Opzioni di distribuzione alternative.

Limitare gli account in Google Play

A volte un'organizzazione potrebbe voler consentire agli utenti di aggiungere Account Google personali (ad esempio per leggere la posta in Gmail), ma non vuole che l'account personale installi app. Il DPC può impostare un elenco di account che le persone possono utilizzare in Google Play.

I componenti amministrativi dei dispositivi completamente gestiti o dei profili di lavoro possono limitare gli account impostando una configurazione gestita per Google Play. La limitazione dell'account è disponibile quando la versione dell'app Google Play installata è 80970100 o successiva.

Per limitare gli account in Google Play:

  1. Imposta un bundle di configurazione gestita per il pacchetto Google Play com.android.vending.
  2. Nel bundle, inserisci gli indirizzi email separati da virgole come valore di stringa per la chiave allowed_accounts.

L'esempio seguente mostra come limitare gli account:

Kotlin

internal val ALLOWED_ACCOUNTS = "allowed_accounts"
internal val GOOGLE_PLAY_APK = "com.android.vending"

// ...

// Limit Google Play to one work and one personal account. Use
// a comma-separated list of account email addresses (usernames).
val googleAccounts = "ali@gmail.com,ali.connors@example.com"

// Supported in Google Play version 80970100 or higher.
val existingConfig = dpm.getApplicationRestrictions(adminName, GOOGLE_PLAY_APK)
val newConfig = Bundle(existingConfig)
newConfig.putString(ALLOWED_ACCOUNTS, googleAccounts)
dpm.setApplicationRestrictions(adminName, GOOGLE_PLAY_APK, newConfig)

Java

static final String ALLOWED_ACCOUNTS = "allowed_accounts";
static final String GOOGLE_PLAY_APK = "com.android.vending";

// ...


// Limit Google Play to one work and one personal account. Use
// a comma-separated list of account email addresses (usernames).
String googleAccounts = "ali@gmail.com,ali.connors@example.com";

// Supported in Google Play version 80970100 or higher.
Bundle existingConfig =
    dpm.getApplicationRestrictions(adminName, GOOGLE_PLAY_APK);
Bundle newConfig = new Bundle(existingConfig);
newConfig.putString(ALLOWED_ACCOUNTS, googleAccounts);
dpm.setApplicationRestrictions(adminName, GOOGLE_PLAY_APK, newConfig);

Per limitare Google Play solo all'account di lavoro, imposta allowed_accounts sull'account gestito singolo non appena il DPC conosce l'indirizzo email dell'account. Una stringa vuota impedisce agli utenti di utilizzare qualsiasi account in Google Play.

Attivare la protezione aziendale del ripristino dei dati di fabbrica

Utilizzando la protezione aziendale del ripristino dei dati di fabbrica, le organizzazioni possono specificare quali Account Google possono eseguire il provisioning di un dispositivo di cui è stato eseguito il ripristino dei dati di fabbrica.

La protezione del ripristino dei dati di fabbrica per i consumatori è progettata per scoraggiare il furto dei dispositivi. Prima di consentire a chiunque di eseguire il provisioning del dispositivo dopo il ripristino dei dati di fabbrica non autorizzato (ad esempio utilizzando un EMM), la configurazione guidata richiede all'utente di autenticarsi con gli Account Google precedentemente presenti nel profilo personale del dispositivo.

In un ambiente aziendale, il ripristino dei dati di fabbrica è uno strumento importante per gestire i dispositivi dei dipendenti quando questi lasciano l'organizzazione. Tuttavia, se l'organizzazione non conosce le credenziali dell'account di un dipendente, la protezione del ripristino dei dati di fabbrica può impedire all'organizzazione di assegnare un dispositivo a un altro dipendente.

Controlla il provisioning dopo un ripristino dei dati di fabbrica

Quando viene eseguito in modalità device owner, il DPC può utilizzare setFactoryResetProtectionPolicy() per controllare quali account sono autorizzati a eseguire il provisioning di un dispositivo dopo il ripristino dei dati di fabbrica. Se questa configurazione è impostata su null o su un elenco vuoto, gli account autorizzati a eseguire il provisioning di un dispositivo dopo un ripristino dei dati di fabbrica sono gli account nel profilo personale del dispositivo.

Un DPC può configurare questi account per tutta la durata di un dispositivo completamente gestito.

  1. L'amministratore IT può utilizzare il metodo people.get dell'API People con il valore speciale me. In questo modo viene recuperato il userId per l'account che ha eseguito l'accesso. userID viene restituito nella chiave resourceName nel formato people/[userId] come stringa di numeri interi. Gli account appena creati potrebbero non essere disponibili per il ripristino dei dati di fabbrica per 72 ore.
  2. Potresti anche voler consentire a uno o più amministratori IT di sbloccare il dispositivo dopo un ripristino dei dati di fabbrica. Chiedi a ciascuno di questi amministratori IT di accedere al proprio Account Google, di seguire il passaggio 1 e di condividere con te il proprio userId, in modo da poter aggiungere questi userIds all'elenco nel passaggio successivo.
  3. Il DPC imposta una limitazione dell'app appropriata utilizzando setFactoryResetProtectionPolicy() per impostare l'elenco di userId che possono eseguire il provisioning di un dispositivo con ripristino dei dati di fabbrica.
  4. Il DPC attiva gli account che possono eseguire il provisioning dei dispositivi dopo un ripristino dei dati di fabbrica inviando la trasmissione com.google.android.gms.auth.FRP_CONFIG_CHANGED come intent esplicito per evitare che venga ignorata a causa delle limitazioni in background.

Kotlin

const val ACTION_FRP_CONFIG_CHANGED =
    "com.google.android.gms.auth.FRP_CONFIG_CHANGED"
const val GMSCORE_PACKAGE = "com.google.android.gms"

// ...

// List of userId that can provision a factory reset device.
// You can use the value returned calling people/me endpoint.
val accountIds = listOf("000000000000000000000")

dpm.setFactoryResetProtectionPolicy(
    adminName,
    FactoryResetProtectionPolicy.Builder()
        .setFactoryResetProtectionAccounts(accountIds)
        .setFactoryResetProtectionEnabled(true)
        .build()
)

val frpChangedIntent = Intent(ACTION_FRP_CONFIG_CHANGED)

frpChangedIntent.setPackage(GMSCORE_PACKAGE)
context.sendBroadcast(frpChangedIntent)

Java

static final String ACTION_FRP_CONFIG_CHANGED =
    "com.google.android.gms.auth.FRP_CONFIG_CHANGED";
static final String GMSCORE_PACKAGE = "com.google.android.gms";

// ...

// List of userId that can provision a factory reset device.
// You can use the value returned calling people/me endpoint.
List<String> accountIds = new ArrayList<String>();
accountIds.add("000000000000000000000");

dpm.setFactoryResetProtectionPolicy(
    adminName,
    new FactoryResetProtectionPolicy.Builder()
        .setFactoryResetProtectionAccounts(accountIds)
        .setFactoryResetProtectionEnabled(true)
        .build());

Intent frpChangedIntent = new Intent(ACTION_FRP_CONFIG_CHANGED);

frpChangedIntent.setPackage(GMSCORE_PACKAGE);
context.sendBroadcast(frpChangedIntent);

Legacy

Per i dispositivi che non possono utilizzare setFactoryResetProtectionPolicy(), introdotto con il livello API 30, il DPC può utilizzare setApplicationRestrictions per aggiungere gli account scelti alla configurazione gestita di factoryResetProtectionAdmin per il pacchetto com.google.android.gms.

Kotlin

const val GOOGLE_PLAY_APK = "com.android.vending"
const val FACTORY_RESET_PROTECTION_ADMIN = "factoryResetProtectionAdmin"
const val DISABLE_FACTORY_RESET_PROTECTION_ADMIN = "disableFactoryResetProtectionAdmin"
const val GMSCORE_PACKAGE = "com.google.android.gms"

// ...

val existingConfig = dpm.getApplicationRestrictions(adminName, GOOGLE_PLAY_APK)
val newConfig = Bundle(existingConfig)
newConfig.putBoolean(DISABLE_FACTORY_RESET_PROTECTION_ADMIN, false)
newConfig.putString(FACTORY_RESET_PROTECTION_ADMIN, googleAccounts)
dpm.setApplicationRestrictions(adminName, GOOGLE_PLAY_APK, newConfig)

val frpChangedIntent = Intent(ACTION_FRP_CONFIG_CHANGED)

frpChangedIntent.setPackage(GMSCORE_PACKAGE)
context.sendBroadcast(frpChangedIntent)

Java

static final String GOOGLE_PLAY_APK = "com.android.vending";
static final String FACTORY_RESET_PROTECTION_ADMIN = "factoryResetProtectionAdmin";
static final String DISABLE_FACTORY_RESET_PROTECTION_ADMIN = "disableFactoryResetProtectionAdmin";
static final String GMSCORE_PACKAGE = "com.google.android.gms";

// ...

Bundle existingConfig =
        dpm.getApplicationRestrictions(adminName, GOOGLE_PLAY_APK);
Bundle newConfig = new Bundle(existingConfig);
newConfig.putBoolean(DISABLE_FACTORY_RESET_PROTECTION_ADMIN, false);
newConfig.putStringArray(FACTORY_RESET_PROTECTION_ADMIN,
        accountIds.toArray(new String[accountIds.size()]));
dpm.setApplicationRestrictions(adminName, GOOGLE_PLAY_APK, newConfig);

Intent frpChangedIntent = new Intent(ACTION_FRP_CONFIG_CHANGED);

frpChangedIntent.setPackage(GMSCORE_PACKAGE);
context.sendBroadcast(frpChangedIntent);

Disattiva la protezione aziendale del ripristino dei dati di fabbrica

Per disattivare la protezione del ripristino dei dati di fabbrica, il DPC può utilizzare setFactoryResetProtectionPolicy()passando il valore null.

Kotlin

const val ACTION_FRP_CONFIG_CHANGED =
    "com.google.android.gms.auth.FRP_CONFIG_CHANGED"
const val GMSCORE_PACKAGE = "com.google.android.gms"

// ...

dpm.setFactoryResetProtectionPolicy(adminName, null)

val frpChangedIntent = Intent(ACTION_FRP_CONFIG_CHANGED)

frpChangedIntent.setPackage(GMSCORE_PACKAGE)
context.sendBroadcast(frpChangedIntent)

Java

static final String ACTION_FRP_CONFIG_CHANGED =
    "com.google.android.gms.auth.FRP_CONFIG_CHANGED";
static final String GMSCORE_PACKAGE = "com.google.android.gms";

// ...

dpm.setFactoryResetProtectionPolicy(adminName, null);

Intent frpChangedIntent = new Intent(ACTION_FRP_CONFIG_CHANGED);

frpChangedIntent.setPackage(GMSCORE_PACKAGE);
context.sendBroadcast(frpChangedIntent);

Legacy

Per i dispositivi che non possono utilizzare setFactoryResetProtectionPolicy(), introdotto con il livello API 30, il DPC può utilizzare setApplicationRestrictions per impostare un valore chiave di true nella configurazione gestita disableFactoryResetProtectionAdmin per il pacchetto com.google.android.gms.

Kotlin

const val GOOGLE_PLAY_APK = "com.android.vending"
const val FACTORY_RESET_PROTECTION_ADMIN = "factoryResetProtectionAdmin"
const val DISABLE_FACTORY_RESET_PROTECTION_ADMIN = "disableFactoryResetProtectionAdmin"
const val GMSCORE_PACKAGE = "com.google.android.gms"

// ...

val existingConfig = dpm.getApplicationRestrictions(adminName, GOOGLE_PLAY_APK)
val newConfig = Bundle(existingConfig)
newConfig.putBoolean(DISABLE_FACTORY_RESET_PROTECTION_ADMIN, true)

dpm.setApplicationRestrictions(
    adminName, GOOGLE_PLAY_SERVICES_PACKAGE, restrictions
)

val frpChangedIntent = Intent(ACTION_FRP_CONFIG_CHANGED)

frpChangedIntent.setPackage(GMSCORE_PACKAGE)
context.sendBroadcast(frpChangedIntent)

Java

static final String GOOGLE_PLAY_APK = "com.android.vending";
static final String FACTORY_RESET_PROTECTION_ADMIN = "factoryResetProtectionAdmin";
static final String DISABLE_FACTORY_RESET_PROTECTION_ADMIN = "disableFactoryResetProtectionAdmin";
static final String GMSCORE_PACKAGE = "com.google.android.gms";

// ...

Bundle existingConfig =
        dpm.getApplicationRestrictions(adminName, GOOGLE_PLAY_APK);
Bundle newConfig = new Bundle(existingConfig);
newConfig.putBoolean(DISABLE_FACTORY_RESET_PROTECTION_ADMIN, true);

dpm.setApplicationRestrictions(
    adminName, GOOGLE_PLAY_SERVICES_PACKAGE, restrictions);

Intent frpChangedIntent = new Intent(ACTION_FRP_CONFIG_CHANGED);

frpChangedIntent.setPackage(GMSCORE_PACKAGE);
context.sendBroadcast(frpChangedIntent);

Monitora i log dei processi aziendali e le segnalazioni di bug da remoto

Nella console EMM, un amministratore può monitorare i dispositivi completamente gestiti utilizzando i log dei processi aziendali e le segnalazioni di bug da remoto.

Registra l'attività dei dispositivi aziendali

Un DPC in esecuzione in modalità device owner può identificare attività sospette monitorando da remoto l'attività del dispositivo, inclusi i lanci di app, l'attività di Android Debug Bridge (ADB) e gli sblocchi dello schermo. I log di processo non richiedono il consenso dell'utente.

Per attivare o disattivare il logging, un DPC chiama setSecurityLoggingEnabled().

Quando è disponibile un nuovo gruppo di log, un DeviceAdminReceiver riceve il callback onSecurityLogsAvailable(). Per recuperare i log (dopo aver ricevuto il callback), un DPC chiama retrieveSecurityLogs().

I DPC possono anche chiamare retrievePreRebootSecurityLogs() per recuperare i log di sicurezza generati nel ciclo di riavvio precedente. Questo è l'intervallo tra l'ultimo riavvio del dispositivo e il riavvio precedente. I dispositivi che non supportano retrieveSecurityLogs() restituiscono null. Se la tua app recupera i log utilizzando sia retrievePreRebootSecurityLogs() sia retrieveSecurityLogs(), devi verificare la presenza di voci duplicate.
Nota: questa funzionalità registra l'attività solo sui dispositivi completamente gestiti (da un proprietario del dispositivo o dal suo delegato DELEGATION_SECURITY_LOGGING) con un singolo utente o con utenti affiliati sul dispositivo. Questa funzionalità non è disponibile sui dispositivi personali, perché registra l'attività a livello di dispositivo.

Questa impostazione può essere utile per l'audit post-evento di sicurezza perché registra i seguenti tipi di azioni:

  • Ogni volta che l'app viene avviata da zero. In questo modo è possibile identificare se è presente un malware che inizia con un'app compromessa.
  • Tentativi di sblocco non riusciti su un dispositivo. In questo modo è possibile identificare se si verificano diversi tentativi di sblocco non riusciti in un breve periodo di tempo.
  • Comandi adb potenzialmente dannosi quando un utente connette il dispositivo a un computer utilizzando un cavo USB.

Per informazioni dettagliate su come leggere i log, consulta SecurityLog.

Durante lo sviluppo e i test, puoi forzare il sistema a rendere disponibili al tuo DPC tutti i log di sicurezza esistenti, senza dover attendere un batch completo. In Android 9.0 (livello API 28) o versioni successive, esegui il seguente comando Android Debug Bridge (adb) nel terminale:

adb shell dpm force-security-logs

Il sistema limita la frequenza con cui puoi utilizzare lo strumento e segnala eventuali rallentamenti intenzionali nell'output del terminale. Se sono disponibili log, il DPC riceve il callback onSecurityLogsAvailable().

Richiedi una segnalazione di bug da remoto

Un DPC in esecuzione in modalità device owner può richiedere da remoto segnalazioni di bug per i dispositivi degli utenti con un solo utente o con utenti affiliati. La segnalazione di bug acquisisce l'attività del dispositivo nel momento esatto in cui viene richiesta, ma può anche includere l'attività delle ore precedenti, a seconda della frequenza di aggiornamento del buffer logcat.

Per richiedere da remoto le segnalazioni di bug, il DPC chiama requestBugreport():

Concedi e rimuovi l'accesso a un certificato client

Se un DPC in esecuzione in modalità proprietario del profilo o modalità device owner concede a un'app di terze parti la possibilità di gestire i certificati, l'app può concedersi l'accesso ai certificati che installa senza l'intervento di un utente. Per installare un certificato a cui possono accedere tutte le app di un profilo, utilizza installKeyPair().

Per sapere quali parametri configurare, consulta installKeyPair(). Questa funzionalità funziona in combinazione con l'API esistente per la gestione dei certificati.

Scenario di deployment

Senza il metodo installKeyPair():

  • Gli utenti devono toccare il nome del certificato e poi Consenti ogni volta che vogliono concedere l'accesso a un certificato.
  • Gli utenti visualizzano un messaggio quando installano un certificato e devono assegnargli un nome.

Con il metodo installKeyPair():

  • Gli utenti non devono toccare Consenti ogni volta che vogliono concedere l'accesso a un certificato.
  • Gli utenti non possono rinominare i certificati.
  • Gli amministratori hanno un maggiore controllo, in quanto possono bloccare i certificati per le app che non dovrebbero avere accesso a certificati specifici.

Rimuovi un certificato client

Dopo aver concesso l'accesso a un certificato client, per rimuovere da remoto i certificati client installati tramite installKeyPair(), chiama removeKeyPair().

Un DPC in esecuzione in modalità device owner o profile owner o un programma di installazione di certificati delegato può chiamare removeKeyPair(). In questo modo viene rimossa una coppia di certificato e chiave privata installata con un determinato alias della chiave privata.

Scenario di deployment

Utilizza questa funzionalità se un'organizzazione sta eseguendo la migrazione a un tipo di certificato client più sicuro. Se un amministratore implementa un nuovo certificato e la sua distribuzione richiede molto tempo, può revocare i certificati deprecati al termine della migrazione.

Reimpostazione sicura del passcode

Il DPC può reimpostare la password di un utente autorizzando la modifica con un token sicuro preregistrato. I proprietari dei dispositivi e dei profili possono chiamare le API di reimpostazione del passcode sicuro per modificare la password dei dispositivi e dei profili di lavoro, rispettivamente. La reimpostazione sicura del passcode sostituisce resetPassword() con i seguenti miglioramenti:

Se la build DPC ha come target Android 8.0 (livello API 26) o versioni successive, devi utilizzare la reimpostazione sicura del passcode. La chiamata a resetPassword() genera un'eccezione SecurityException nei DPC che hanno come target Android 8.0 o versioni successive, pertanto potrebbe essere necessario aggiornare il DPC.

Imposta e attiva un token

Il DPC deve impostare e attivare un token prima di reimpostare una password. Poiché il DPC potrebbe non essere in grado di utilizzare subito il token, devi impostarlo prima che un amministratore IT debba utilizzarlo.

Un token di reimpostazione password è un valore casuale con crittografia avanzata e deve avere una lunghezza di almeno 32 byte. Crea un token per ogni dispositivo e profilo. Non riutilizzare o condividere i token generati.

Ti consigliamo di archiviare i token o i mezzi per decriptare un token criptato su un server. Se memorizzi i token localmente nello spazio di archiviazione con credenziali criptate, il DPC non può reimpostare la password finché l'utente non sblocca il dispositivo o il profilo. Se memorizzi i token localmente nello spazio di archiviazione criptato del dispositivo, che viene compromesso, un malintenzionato potrebbe utilizzare il token per accedere a un profilo di lavoro o a un utente principale.

Puoi generare un nuovo token nel tuo DPC o recuperarlo da un server. L'esempio seguente mostra un DPC che genera un token e lo segnala a un server:

Kotlin

val token = ByteArray(32)

// Generate a new token
val random = SecureRandom()
random.nextBytes(token)

// Set the token to use at a later date
val success: Boolean
success = dpm.setResetPasswordToken(DeviceAdminReceiver.getComponentName(context), token)

// Activate the token and update success variable...

// Store the token on a server
if (success) {
 sendTokenToServer(token)
}

Java

byte token[] = new byte[32]; // Minimum size token accepted

// Generate a new token
SecureRandom random = new SecureRandom();
random.nextBytes(token);

// Set the token to use at a later date
boolean success;
success = dpm.setResetPasswordToken(DeviceAdminReceiver.getComponentName(getContext()), token);

// Activate the token and update success variable ...

// Store the token on a server
if (success) {
 sendTokenToServer(token);
}

Nella maggior parte dei casi, il DPC deve attivare un token dopo averlo impostato. Tuttavia, se l'utente non ha una password per la schermata di blocco, il sistema attiva immediatamente un token. Per attivare un token, chiedi all'utente di confermare le proprie credenziali. Il tuo DPC può chiamare il metodo KeyguardManager createConfirmDeviceCredentialIntent() per ottenere un Intent che avvia la conferma. Spiega all'utente del dispositivo nell'interfaccia utente perché gli stai chiedendo di autenticarsi. Lo snippet di seguito mostra come attivare un token nel tuo DPC:

Kotlin

// In your DPC, you'll need to localize the user prompt
val ACTIVATE_TOKEN_PROMPT = "Use your credentials to enable remote password reset"
val ACTIVATE_TOKEN_REQUEST = 1

// Create or fetch a token and set it in setResetPasswordToken() ...
val keyguardManager = context.getSystemService(Context.KEYGUARD_SERVICE) as KeyguardManager
val confirmIntent = keyguardManager.createConfirmDeviceCredentialIntent(null, ACTIVATE_TOKEN_PROMPT)

if (confirmIntent != null) {
 startActivityForResult(confirmIntent, ACTIVATE_TOKEN_REQUEST)
 // Check your onActivityResult() callback for RESULT_OK
} else {
 // Null means the user doesn't have a lock screen so the token is already active.
 // Call isResetPasswordTokenActive() if you need to confirm
}

Java

// In your DPC, you'll need to localize the user prompt
static final String ACTIVATE_TOKEN_PROMPT =
 "Use your credentials to enable remote password reset";
static final int ACTIVATE_TOKEN_REQUEST = 1;

// Create or fetch a token and set it in setResetPasswordToken() ...

KeyguardManager keyguardManager = (KeyguardManager) getSystemService(Context.KEYGUARD_SERVICE);
Intent confirmIntent = keyguardManager.createConfirmDeviceCredentialIntent(
  null, ACTIVATE_TOKEN_PROMPT);

if (confirmIntent != null) {
 startActivityForResult(confirmIntent, ACTIVATE_TOKEN_REQUEST);
 // Check your onActivityResult() callback for RESULT_OK
} else {
 // Null means the user doesn't have a lock screen so the token is already active.
 // Call isResetPasswordTokenActive() if you need to confirm
}

Devi attivare un token impostato dal DPC prima del riavvio del dispositivo. Android memorizza un token non attivato nella memoria e non lo conserva dopo un riavvio. Se l'utente riavvia il dispositivo prima di attivare un token, il DPC può impostare di nuovo lo stesso token o generarne uno nuovo.

Il DPC può confermare che un token è attivo chiamando isResetPasswordTokenActive() e verificando che il risultato sia true.

Dopo che il DPC ha impostato e attivato un token, questo è valido finché il DPC non lo elimina o lo sostituisce (o finché non viene eseguito il ripristino dei dati di fabbrica del dispositivo). Il token è indipendente dalla password e non viene influenzato dalla modifica o dalla cancellazione della password da parte dell'utente.

Elimina un token

Puoi chiamare clearResetPasswordToken() per eliminare un token impostato in precedenza dal DPC. Potresti dover revocare un token compromesso o rimuovere la possibilità di reimpostare la password. L'esempio seguente mostra come puoi farlo nel tuo DPC:

Kotlin

val dpm = getDpm()
val admin = DeviceAdminReceiver.getComponentName(requireActivity())

// Clear the token
if (!dpm.clearResetPasswordToken(admin)) {
 // Report the failure and possibly try later ...
}

Java

DevicePolicyManager dpm = getDpm();
ComponentName admin = DeviceAdminReceiver.getComponentName(getActivity());

// Clear the token
if (!dpm.clearResetPasswordToken(admin)) {
 // Report the failure and possibly try later ...
}

Reimposta la password

Quando un amministratore IT deve reimpostare la password, chiama resetPasswordWithToken() e passa il token impostato e attivato in precedenza dal DPC:

Kotlin

val token: ByteArray = getTokenFromServer()
val newPassword = "password"

try {
 val result: Boolean = dpm.resetPasswordWithToken(
 DeviceAdminReceiver.getComponentName(requireContext()),
 newPassword,
 token,
 0
 )

 if (result) {
 // The password is now 'password'
 } else {
 // Using 'password' doesn't meet password restrictions
 }
} catch (e: IllegalStateException) {
 // The token doesn't match the one set earlier.
}

Java

byte token[] = getTokenFromServer();
String newPassword = "password";

try {
 boolean result = dpm.resetPasswordWithToken(
  DeviceAdminReceiver.getComponentName(getContext()), newPassword, token, 0);

 if (result) {
 // The password is now 'password'
 } else {
 // Using `password` doesn't meet password restrictions
 }
} catch (IllegalStateException e) {
 // The token doesn't match the one set earlier.
}

Una chiamata a resetPasswordWithToken() restituisce false e la password non cambia se la nuova password non soddisfa i seguenti vincoli:

  • Il numero di caratteri soddisfa qualsiasi vincolo di lunghezza minima della password. Chiama il numero getPasswordMinimumLength() per sapere se un amministratore IT ha impostato un vincolo di lunghezza.
  • La gamma e la complessità dei caratteri della password soddisfano un vincolo di composizione. Chiama getPasswordQuality() per sapere se un amministratore IT ha impostato un vincolo di composizione.

Se i vincoli di qualità della password non richiedono l'impostazione di una password, puoi passare null o una stringa vuota a resetPasswordWithToken() per rimuovere la password.

Verifica di sicurezza del profilo di lavoro

Un DPC in esecuzione in modalità proprietario del profilo può richiedere agli utenti di specificare una verifica di sicurezza per le app in esecuzione nel profilo di lavoro. Il sistema mostra la verifica di sicurezza quando l'utente tenta di aprire un'app di lavoro. Se l'utente completa correttamente la verifica di sicurezza, il sistema sblocca il profilo di lavoro e lo decripta, se necessario.

Come funziona la verifica di sicurezza del profilo di lavoro

  1. Se un DPC invia un intent ACTION_SET_NEW_PASSWORD, il sistema chiede all'utente di configurare una verifica di sicurezza.
  2. Il DPC può anche inviare un intent ACTION_SET_NEW_PARENT_PROFILE_PASSWORD per chiedere all'utente di impostare un blocco del dispositivo.

Un DPC può impostare le policy relative alle password per la verifica di lavoro in modo diverso dalle policy per le altre password del dispositivo. Ad esempio, la lunghezza minima della risposta alla verifica del dispositivo può essere diversa da quella richiesta per altre password. Un DPC imposta le policy di verifica utilizzando i consueti metodi DevicePolicyManager, come setPasswordQuality() e setPasswordMinimumLength().

Considerazioni

  • Il DPC può reimpostare la password del profilo di lavoro, ma non quella del dispositivo (personale). Se un utente sceglie di impostare password di lavoro e personali uguali, resetPassword() nel profilo di lavoro comporta la reimpostazione della password solo nel profilo di lavoro e la password non sarà uguale a quella della schermata di blocco del dispositivo.
  • Un DPC può personalizzare la schermata delle credenziali per la verifica lavoro utilizzando setOrganizationColor() e setOrganizationName().
  • Gli amministratori dei dispositivi non possono utilizzare resetPassword() per cancellare le password o modificare quelle già impostate. Gli amministratori dei dispositivi possono comunque impostare una password, ma solo quando il dispositivo non ha una password, un PIN o una sequenza.

Per ulteriori informazioni, consulta getParentProfileInstance() e la documentazione di riferimento in DevicePolicyManager.