Riprendi al riavvio

In Android 11, gli aggiornamenti OTA possono essere applicati utilizzando i meccanismi di aggiornamento A/B o di aggiornamento A/B virtuale, combinati con i metodi della classe RecoverySystem. Dopo il riavvio del dispositivo per applicare un aggiornamento OTA, la funzionalità Riavvia da ibernazione (RoR) sblocca lo spazio di archiviazione con crittografia delle credenziali (CE) del dispositivo.

Sebbene i partner possano accoppiare questa procedura con una funzionalità di sistema OTA che applica gli aggiornamenti quando il dispositivo dovrebbe essere inattivo in Android 11, in Android 12 i partner non hanno bisogno di un'ulteriore funzionalità di sistema OTA. Il processo RoR offre maggiore sicurezza e praticità agli utenti perché gli aggiornamenti possono essere eseguiti durante i tempi di inattività del dispositivo, mentre le funzionalità di aggiornamento multi-client e basate su server di Android 12 forniscono insieme sicurezza di tipo hardware del dispositivo.

Sebbene tu debba fornire l'autorizzazione del dispositivo per la funzionalità android.hardware.reboot_escrow per supportare il RoR in Android 11, non è necessario farlo per attivare il RoR basato su server in Android 12 e versioni successive, perché non utilizzano l'HAL.

Premessa

A partire da Android 7, Android supporta Direct Boot, che consente alle app su un dispositivo di avviarsi prima che lo spazio di archiviazione CE venga sbloccato dall'utente. L'implementazione del supporto del boot diretto ha offerto agli utenti un'esperienza migliore prima che fosse necessario inserire il fattore di conoscenza della schermata di blocco (LSKF) dopo un avvio.

La funzionalità RoR consente di sbloccare lo spazio di archiviazione CE di tutte le app su un dispositivo, incluse quelle che non supportano il riavvio diretto, quando viene avviato un riavvio dopo un aggiornamento OTA. Questa funzionalità consente agli utenti di ricevere notifiche da tutte le app installate dopo il riavvio.

Modello di minaccia

Un'implementazione di RoR deve garantire che, quando un dispositivo finisce nelle mani di un malintenzionato, sia estremamente difficile per quest'ultimo recuperare i dati criptati con crittografia lato client dell'utente, anche se il dispositivo è acceso, lo spazio di archiviazione lato client è sbloccato e il dispositivo è sbloccato dall'utente dopo aver ricevuto un aggiornamento OTA. La resistenza agli attacchi di tipo insider deve essere efficace anche se l'aggressore ottiene l'accesso alle chiavi di firma di crittografia trasmesse.

Nello specifico, lo spazio di archiviazione CE non deve essere letto da un utente malintenzionato che ha il dispositivo e presenta le seguenti funzionalità e limitazioni:

Funzionalità

  • Può utilizzare la chiave di firma di qualsiasi fornitore o azienda per firmare messaggi arbitrari.
  • Può causare la ricezione di un aggiornamento OTA sul dispositivo.
  • Può modificare il funzionamento di qualsiasi hardware (ad esempio un processore di applicazioni o una memoria flash), tranne che come descritto nella sezione Limitazioni di seguito. Tuttavia, questa modifica comporta sia un ritardo di almeno un'ora sia un ciclo di alimentazione che distrugge i contenuti della RAM.

Limitazioni

  • Non è possibile modificare il funzionamento dell'hardware a prova di manomissione (ad esempio un chip Titan M).
  • Impossibile leggere la RAM del dispositivo in tempo reale.
  • Non può indovinare le credenziali dell'utente (PIN, sequenza, password) o causarne in altro modo l'inserimento.

Soluzione

Il sistema di aggiornamento RoR di Android 12 offre protezione contro attaccanti molto sofisticati e lo fa mantenendo le password e i PIN sul dispositivo, che non vengono mai inviati o memorizzati sui server di Google. Questa è una panoramica della procedura che garantisce che i livelli di sicurezza forniti siano simili a quelli di un sistema RoR basato su hardware e a livello di dispositivo:

  • Android applica protezioni crittografiche ai dati archiviati su un dispositivo.
  • Tutti i dati sono protetti da chiavi archiviate nel trusted execution environment (TEE).
  • Il TEE rilascia le chiavi solo se il sistema operativo in esecuzione supera l'autenticazione crittografica (avvio verificato).
  • Il servizio RoR in esecuzione sui server Google protegge i dati CE archiviando un segreto che può essere recuperato solo per un periodo di tempo limitato. Questa funzionalità è disponibile nell'ecosistema Android.
  • Una chiave crittografica, protetta dal PIN di un utente, viene utilizzata per sbloccare il dispositivo e decriptare lo spazio di archiviazione CE.
    • Quando è pianificato un riavvio notturno, Android chiede all'utente di inserire il PIN, quindi calcola una password sintetica (SP).
    • Quindi cripta l'SP due volte: una volta con una chiave K_s memorizzata nella RAM e di nuovo con una chiave K_k memorizzata nel TEE.
    • Il token con crittografia doppia viene archiviato su disco e viene cancellato dalla RAM. Entrambe le chiavi vengono generate di recente e utilizzate per un solo riavvio.
  • Al momento del riavvio, Android affida K_s al server. La ricevuta con K_k viene criptata prima di essere archiviata su disco.
  • Dopo il riavvio, Android utilizza K_k per decriptare la ricevuta, poi la invia al server per recuperare K_s.
    • K_k e K_s vengono utilizzati per decriptare l'SP memorizzato sul disco.
    • Android utilizza il gestore SP per sbloccare lo spazio di archiviazione CE e consentire l'avvio normale delle app.
    • K_k e K_s vengono ignorati.

Gli aggiornamenti che mantengono il tuo smartphone al sicuro possono essere eseguiti quando è più comodo per te: mentre dormi.

Ripetizione del PIN della SIM

In determinate condizioni, il codice PIN di una carta SIM viene verificato da una cache, una procedura chiamata riproduzione del PIN della SIM.

Una scheda SIM con un PIN abilitato deve anche essere sottoposta a una verifica del codice PIN senza interruzioni (una ripetizione del PIN della SIM) dopo un riavvio non supervisionato per ripristinare la connettività cellulare (obbligatoria per chiamate, SMS e servizi di dati). Il PIN della SIM e le relative informazioni corrispondenti (ICCID e numero dello slot della SIM) vengono archiviati insieme in modo sicuro. Il PIN memorizzato può essere recuperato e utilizzato per la verifica solo dopo un riavvio automatico riuscito. Se il dispositivo è protetto, il PIN della SIM viene memorizzato con le chiavi protette dalla LSKF. Se il PIN della SIM è attivo, l'interazione con il server RoR richiede una connessione Wi-Fi per l'aggiornamento OTA e il RoR basato su server, che garantisce la funzionalità di base (con connettività cellulare) dopo il riavvio.

Il PIN della SIM viene criptato di nuovo e archiviato ogni volta che l'utente lo attiva, lo verifica o lo modifica correttamente. Il PIN della SIM viene ignorato se si verifica una delle seguenti condizioni:

  • La SIM viene rimossa o reimpostata.
  • L'utente disattiva il PIN.
  • Si è verificato un riavvio non avviato da RoR.

Il PIN della SIM memorizzato può essere utilizzato una sola volta dopo il riavvio avviato da RoR e solo per un periodo di tempo molto breve (20 secondi) se i dettagli della scheda SIM corrispondono. Il PIN della SIM memorizzato non esce mai dall'app TelephonyManager e non può essere recuperato da moduli esterni.

Linee guida per l'implementazione

In Android 12, le funzioni RoR basate su server e multi-client forniscono un carico più leggero ai partner quando inviano aggiornamenti OTA. Gli aggiornamenti necessari possono avvenire durante i tempi di riposo del dispositivo, ad esempio durante le ore di sospensione designate.

Per assicurarti che gli aggiornamenti OTA durante questi periodi di tempo non interrompano gli utenti, impiega la modalità oscura per ridurre le emissioni di luce. Per farlo, chiedi al bootloader del dispositivo di cercare la stringa reason unattended. Se unattended è true, attiva la modalità Buio sul dispositivo. Tieni presente che è responsabilità di ogni OEM attenuare le emissioni di suoni e luce.

Se esegui l'upgrade ad Android 12 o se lanci dispositivi Android 12, non devi fare nulla per implementare la nuova funzionalità RoR.

Nel flusso multicliente è presente una nuova chiamata, isPreparedForUnattendedUpdate, mostrata di seguito:

@RequiresPermission(anyOf = {android.Manifest.permission.RECOVERY,
            android.Manifest.permission.REBOOT})
public static boolean isPreparedForUnattendedUpdate(@NonNull Context context)

Non è necessario implementare questa funzionalità, perché l'HAL è deprecato a partire da Android 12.

TelephonyManager

Il client OTA invoca l'API di sistema TelephonyManager quando è imminente un riavvio in Android 12. Questa API sposta tutti i codici PIN memorizzati nella cache dall'AVAILABLE allo stato REBOOT_READY. L'API di sistema TelephonyManager è protetta dall'autorizzazione Manifest REBOOT esistente.

 /**
    * The unattended reboot was prepared successfully.
    * @hide
    */
   @SystemApi
   public static final int PREPARE_UNATTENDED_REBOOT_SUCCESS = 0;

   /**
    * The unattended reboot was prepared, but the user will need to manually
    * enter the PIN code of at least one SIM card present in the device.
    * @hide
    */
   @SystemApi
   public static final int PREPARE_UNATTENDED_REBOOT_PIN_REQUIRED = 1;

   /**
    * The unattended reboot was not prepared due to generic error.
    * @hide
    */
   @SystemApi
   public static final int PREPARE_UNATTENDED_REBOOT_ERROR = 2;

   /** @hide */
   @Retention(RetentionPolicy.SOURCE)
   @IntDef(prefix = {"PREPARE_UNATTENDED_REBOOT_"},
           value = {
                   PREPARE_UNATTENDED_REBOOT_SUCCESS,
                   PREPARE_UNATTENDED_REBOOT_PIN_REQUIRED,
                   PREPARE_UNATTENDED_REBOOT_ERROR
           })
   public @interface PrepareUnattendedRebootResult {}

   /**
    * Prepare TelephonyManager for an unattended reboot. The reboot is
    * required to be done shortly after the API is invoked.
    *
    * Requires system privileges.
    *
    * <p>Requires Permission:
    *   {@link android.Manifest.permission#REBOOT}
    *
    * @return {@link #PREPARE_UNATTENDED_REBOOT_SUCCESS} in case of success.
    * {@link #PREPARE_UNATTENDED_REBOOT_PIN_REQUIRED} if the device contains
    * at least one SIM card for which the user needs to manually enter the PIN
    * code after the reboot. {@link #PREPARE_UNATTENDED_REBOOT_ERROR} in case
    * of error.
    * @hide
    */
   @SystemApi
   @RequiresPermission(android.Manifest.permission.REBOOT)
   @PrepareUnattendedRebootResult
   public int prepareForUnattendedReboot()

L'API di sistema TelephonyManager viene utilizzata dagli APK con privilegi.

Test

Per testare la nuova API, esegui questo comando:

    adb shell cmd phone unattended-reboot

Questo comando funziona solo quando la shell è in esecuzione come root (adb root).

Solo Android 11

Il resto di questa pagina si applica ad Android 11.

Da luglio 2020, le implementazioni di HAL RoR rientrano in due categorie:

  1. Se l'hardware SoC supporta la persistenza della RAM dopo i riavvii, gli OEM possono utilizzare l'implementazione predefinita in AOSP (Default RAM Escrow).
  2. Se l'hardware o il SoC del dispositivo supporta un'enclave hardware sicura (un coprocessore di sicurezza discreto con RAM e ROM proprie), deve inoltre:
    • Essere in grado di rilevare un riavvio della CPU principale.
    • Avere un'origine timer hardware che persiste dopo i riavvii. In altre parole, l'enclave deve essere in grado di rilevare il riavvio e far scadere un timer impostato prima del riavvio.
    • Supporta la memorizzazione di una chiave in custodia nella RAM/ROM dell'enclave in modo che non possa essere recuperata con attacchi offline. Deve memorizzare la chiave RoR in modo da impedire a persone interne o malintenzionate di recuperarla.

Cassa depositi RAM predefinita

AOSP ha un'implementazione dell'HAL RoR che utilizza la persistenza della RAM. Affinché ciò funzioni, gli OEM devono assicurarsi che i loro SoC supportino la persistenza della RAM tra i riavvii. Alcuni SoC non sono in grado di mantenere i contenuti della RAM dopo un riavvio, pertanto gli OEM sono invitati a consultare i propri partner SoC prima di attivare questo HAL predefinito. Il riferimento canonico a questo nella sezione seguente.

Flusso di aggiornamento OTA utilizzando RoR

L'app client OTA sullo smartphone deve disporre delle autorizzazioni Manifest.permission.REBOOT e Manifest.permission.RECOVERY per chiamare i metodi necessari per implementare il ripristino dei dati di fabbrica. Una volta soddisfatto questo prerequisito, il flusso di un update segue questi passaggi:

  1. L'app client OTA scarica l'aggiornamento.
  2. L'app client OTA chiama RecoverySystem#prepareForUnattendedUpdate, che attiva la richiesta del PIN, della sequenza o della password all'utente nella schermata di blocco durante il successivo sblocco.
  3. L'utente sblocca il dispositivo dalla schermata di blocco e il dispositivo è pronto per l'applicazione dell'aggiornamento.
  4. L'app client OTA chiama RecoverySystem#rebootAndApply, che attiva immediatamente un riavvio.

Al termine di questo flusso, il dispositivo si riavvia e il meccanismo di RiR sblocca lo spazio di archiviazione con crittografia delle credenziali (CE). Per le app, questo appare come un normale sblocco dell'utente, quindi ricevono tutti gli indicatori, ad esempio ACTION_LOCKED_BOOT_COMPLETED e ACTION_BOOT_COMPLETED, come di consueto.

Modificare le configurazioni dei prodotti

Un prodotto contrassegnato come supportante la funzionalità RoR in Android 11 deve includere un'implementazione dell'HAL RebootEscrow e il file XML dell'indicatore della funzionalità. L'implementazione predefinita funziona bene sui dispositivi che utilizzano il riavvio a caldo (quando l'alimentazione della DRAM rimane accesa durante il riavvio).

Indicatore della funzionalità di riavvio del blocco

Deve essere presente anche l'indicatore della funzionalità:

PRODUCT_COPY_FILES += \
    frameworks/native/data/etc/android.hardware.reboot_escrow.xml:$(TARGET_COPY_OUT_VENDOR)/etc/permissions/android.hardware.reboot_escrow.xml

Implementazione predefinita dell'HAL di escrow del riavvio

Per utilizzare l'implementazione predefinita, devi riservare 65.536 (0x10000) byte. Non scrivere mai questi byte in un'unità di archiviazione non volatile per assicurarti che le proprietà di sicurezza rimangano.

Modifiche al device tree del kernel Linux

Nella struttura ad albero del kernel di Linux, devi riservare memoria per una regione pmem. L'esempio seguente mostra che 0x50000000 è riservato:

  reserved-memory {
    my_reservation@0x50000000 {
      no-map;
      reg = <0x50000000 0x10000>;
    }
  }

  reboot_escrow@0 {
    compatible = "pmem-region";
    reg = <0x50000000 0x10000>;
  };

Verifica di avere un nuovo dispositivo nella directory dei blocchi con un nome come /dev/block/pmem0 (ad esempio pmem1 o pmem2).

Modifiche a Device.mk

Supponendo che il nuovo dispositivo del passaggio precedente sia denominato pmem0, devi assicurarti che le seguenti nuove voci vengano aggiunte a pmem0:vendor/<oem>/<product>/device.mk

# Resume on Reboot support
PRODUCT_PROPERTY_OVERRIDES += \
    ro.rebootescrow.device=/dev/block/pmem0
PRODUCT_PACKAGES += \
    android.hardware.rebootescrow-service.default
Regole SELinux

Aggiungi queste nuove voci a file_contexts del dispositivo:

/dev/block/pmem0  u:object_r:rebootescrow_device:s0
/vendor/bin/hw/android\.hardware\.rebootescrow-service\.default  u:object_r:hal_rebootescrow_default_exec:s0