Autorizzazione di accesso alla rete locale

I dispositivi su una local area network (LAN) sono accessibili da qualsiasi app che disponga dell'autorizzazione INTERNET. In questo modo, le app possono connettersi facilmente ai dispositivi locali, ma ciò comporta anche implicazioni sulla privacy, come la creazione di un'impronta dell'utente e l'utilizzo come proxy per la posizione.

Il progetto Protezioni della rete locale mira a proteggere la privacy dell'utente limitando l'accesso alla rete locale tramite una nuova autorizzazione di runtime.

Impatto

A partire da Android 17 (livello API 37), le protezioni della rete locale vengono applicate per le app che hanno come target Android 17 o versioni successive. La configurazione di attivazione precedente di Android 16 è deprecata. Consulta Applicazione di Android 17 per i requisiti di implementazione attuali.

Le app saranno interessate se accedono alla rete locale dell'utente utilizzando:

  • Utilizzo diretto o tramite libreria di socket non elaborati su indirizzi di rete locale, ad esempio Multicast DNS (mDNS) o Simple Service Discovery Protocol (SSDP).
  • Utilizzo di classi a livello di framework che accedono alla rete locale, ad esempio NsdManager.

Dettagli dell'impatto

Il traffico da e verso un indirizzo di rete locale richiede l'autorizzazione di accesso alla rete locale. La tabella seguente elenca alcuni casi comuni:

Operazione di rete a basso livello dell'app Autorizzazione di accesso alla rete locale richiesta
Creazione di una connessione TCP in uscita sì
Accettazione di una connessione TCP in entrata sì
Invio di un unicast, multicast, broadcast UDP sì
Ricezione di un pacchetto UDP unicast, multicast, broadcast in entrata sì

Queste limitazioni sono implementate in profondità nello stack di networking e, pertanto, si applicano a tutte le API di networking. Sono inclusi i socket creati nella piattaforma o nel codice gestito, le librerie di networking come Cronet e OkHttp e tutte le API implementate su queste. Il tentativo di risolvere i servizi sulla rete locale con un suffisso .local richiede l'autorizzazione di accesso alla rete locale.

Eccezioni alle regole precedenti:

  • Se il server DNS di un dispositivo si trova su una rete locale, il traffico da/verso il server (sulla porta 53) non richiede l'autorizzazione di accesso alla rete locale.
  • Le applicazioni che utilizzano il selettore di output come selettore in-app non avranno bisogno delle autorizzazioni per la rete locale (ulteriori indicazioni verranno fornite in una release successiva).

Applicazione di Android 17

A partire da Android 17, le protezioni della rete locale sono obbligatorie e applicate per le app che hanno come target Android 17 o versioni successive.

Aspetto Android 16 Android 17
SDK target 36 37 o superiore
Autorizzazione Utilizzo temporaneo di NEARBY_WIFI_DEVICES ACCESS_LOCAL_NETWORK
Accesso predefinito L'accesso alla rete locale è aperto La rete locale è bloccata per impostazione predefinita per tutte le app che aggiornano l'SDK target
Gruppo di autorizzazioni Parte del gruppo di autorizzazioni NEARBY_DEVICES esistente

Per verificare che la funzionalità dell'app non sia compromessa dopo l'applicazione, le applicazioni che hanno come target l'SDK 37 o versioni successive devono adottare uno dei seguenti percorsi per gestire l'accesso alla rete locale:

Percorso A: utilizzo di selettori che tutelano la privacy

Per le attività di rilevamento e connessione mediate dal sistema, utilizza i selettori per evitare di richiedere l'autorizzazione di runtime completa. Utilizza i seguenti selettori in base al tuo caso d'uso:

  • Streaming di contenuti multimediali: le applicazioni che supportano Google Cast possono utilizzare la funzionalità del selettore di output. In questo modo, gli sviluppatori possono consentire agli utenti di selezionare dispositivi di streaming specifici senza che l'app debba richiedere l'autorizzazione generale ACCESS_LOCAL_NETWORK.
  • Connettività generale: NsdManager include un selettore di servizi gestito dal sistema per il rilevamento mDNS. Anziché consentire all'app di scansionare l'intera rete, il sistema visualizza una finestra di dialogo che consente all'utente di selezionare un singolo dispositivo a cui l'app può accedere.
val discoveryRequest = DiscoveryRequest.Builder("_http._tcp")
    .setFlags(DiscoveryRequest.FLAG_SHOW_PICKER)
    .build()

nsdManager.registerServiceInfoCallback(discoveryRequest, executor, object : NsdManager.ServiceInfoCallback {
    override fun onServiceUpdated(serviceInfo: NsdServiceInfo) {
        // Handle the user-selected and discovered service
        // NsdServiceInfo.getHostAddresses() can now be connected to
        // without ACCESS_LOCAL_NETWORK permission
    }
})

Percorso B: richiesta dell'autorizzazione di runtime (accesso ampio)

Questo percorso è necessario per casi d'uso complessi come la domotica o la gestione di dispositivi IoT che richiedono un accesso ampio e persistente alla rete locale.

  • Dichiara l'autorizzazione nel manifest: dichiara esplicitamente ACCESS_LOCAL_NETWORK in AndroidManifest.xml.

  • Richiedi l'autorizzazione in fase di runtime: prima di tentare qualsiasi accesso alla rete locale, le applicazioni devono verificare se l'autorizzazione è stata concessa. In caso contrario, deve chiamare Activity.requestPermission() per attivare il prompt di sistema standard.

  • Scenario di autorizzazione pre-concessa: l'autorizzazione ACCESS_LOCAL_NETWORK fa parte del gruppo di autorizzazioni NEARBY_DEVICES. Se un utente ha già concesso un'altra autorizzazione in questo gruppo (ad esempio le autorizzazioni Bluetooth), non gli verrà richiesto di nuovo l'accesso alla rete locale.

  • Gestione del rifiuto e della revoca: le app devono gestire correttamente i casi in cui l'utente rifiuta la richiesta o revoca l'autorizzazione in un secondo momento nelle impostazioni di sistema. In questi scenari, il traffico di rete locale verrà bloccato.

Strategia di reimpostazione del contatore delle richieste di autorizzazione

La piattaforma implementa una strategia di reimpostazione del contatore che gestisce gli scenari in cui il rifiuto precedente da parte di un'app del gruppo di autorizzazioni NEARBY_DEVICES (che ora include ACCESS_LOCAL_NETWORK) ha impedito all'app di richiedere l'autorizzazione dopo aver presentato adeguatamente la motivazione. Questo meccanismo offre all'app ulteriori opportunità di richiamare l'API requestPermission(), reimpostando di fatto il conteggio dei rifiuti per l'autorizzazione ACCESS_LOCAL_NETWORK. In questo modo, è possibile coinvolgere nuovamente l'utente in modo più mirato, soprattutto se il rifiuto iniziale è avvenuto prima che l'app potesse comunicare la necessità di accedere alla rete locale per la sua funzionalità di base.

Modello di autorizzazione suddiviso

L'autorizzazione per la rete locale utilizza una strategia di migrazione delle autorizzazioni suddivisa per gestire le applicazioni nuove e legacy in modo diverso, in base all'SDK target

Categoria Livello SDK target Comportamento di accesso alla rete locale Azione richiesta allo sviluppatore
Nuove app/App aggiornate >= 37 (Android 17) Bloccato per impostazione predefinita Dichiara e richiedi l'autorizzazione di runtime ACCESS_LOCAL_NETWORK
App legacy < 37 Le app con l'autorizzazione INTERNET ricevono un'autorizzazione implicita per ACCESS_LOCAL_NETWORK, che consente loro di mantenere l'accesso. Questa è una misura temporanea e verrà bloccata per impostazione predefinita quando l'app passerà all'SDK target 37 Non è necessaria alcuna modifica immediata al codice. Non richiedere ACCESS_LOCAL_NETWORK in fase di runtime prima di scegliere come target l'SDK 37.

Strategia LNP per caso d'uso

  • Trasmissione: per le funzionalità di trasmissione di contenuti multimediali, la strategia più appropriata e che tutela la privacy è utilizzare il selettore di output. Questo metodo consente al sistema di gestire il rilevamento e la connessione alla rete locale per conto dell'utente, eliminando la necessità per l'app di richiedere l'autorizzazione ACCESS_LOCAL_NETWORK.

  • Browser: la gestione degli errori richiede approcci diversi in base al protocollo. Gli errori UDP generano il codice di errore EPERM. Per le connessioni TCP, i browser devono utilizzare l'API NDK android_getnetworkblockedreason(int sockFd) per determinare se un pacchetto è stato bloccato da LNP. Questa API restituisce ANDROID_NETWORK_BLOCKED_REASON_LNP.

  • Altri casi d'uso (ad esempio, IoT): le applicazioni che trovano dispositivi utilizzando mDNS devono utilizzare android.net.nsd.DiscoveryRequest#FLAG_SHOW_PICKER, che consente di trovare dispositivi senza l'autorizzazione, e NsdManager#registerServiceInfoCallback/NsdManager#resolveService per ottenere gli indirizzi IP. Le connessioni agli indirizzi IP ottenuti in questo modo non richiedono l'autorizzazione ACCESS_LOCAL_NETWORK.

Per le applicazioni che richiedono la comunicazione diretta con la rete locale e non possono utilizzare i selettori mediati dal sistema, l'approccio suggerito è utilizzare la strategia del contatore di reimpostazione delle autorizzazioni quando il target è Android 17 (SDK 37) o versioni successive. Se l'autorizzazione ACCESS_LOCAL_NETWORK viene revocata dall'utente, questo meccanismo offre all'app ulteriori opportunità di richiedere nuovamente l'autorizzazione, consentendo agli sviluppatori di presentare all'utente una motivazione più chiara.

Indicazioni per Android 16 (deprecato)

Per attivare le limitazioni della rete locale su Android 16, segui questi passaggi:

  1. Esegui il flashing del dispositivo su una build con Android 16 Beta 3 o versioni successive
  2. Installa l'app da testare
  3. Attiva/disattiva la configurazione Appcompat utilizzando adb

    adb shell am compat enable RESTRICT_LOCAL_NETWORK <package_name>
    
  4. Riavvia il dispositivo

Ora l'accesso dell'app alla rete locale è limitato e qualsiasi tentativo di accesso alla rete locale genera errori di socket. Se utilizzi API che eseguono operazioni di rete locale al di fuori del processo dell'app (ad esempio NsdManager), queste non sono interessate durante l'attivazione.

Per ripristinare l'accesso, devi concedere alla tua app l'autorizzazione per NEARBY_WIFI_DEVICES.

  • Assicurati che l'app dichiari l'autorizzazione NEARBY_WIFI_DEVICES nel suo manifest.
  • Vai a Impostazioni > App > [Nome app] > Autorizzazioni > Dispositivi nelle vicinanze > Consenti

Ora l'accesso dell'app alla rete locale dovrebbe essere ripristinato e tutti gli scenari dovrebbero funzionare come prima dell'attivazione dell'app. Ecco come viene influenzato il traffico di rete dell'app.

Autorizzazione Richiesta LAN in uscita Richiesta internet in uscita/in entrata Richiesta LAN in entrata
Concessa Works Works Works
Non concesso Fallimenti Works Fallimenti

Utilizza il seguente comando per disattivare la configurazione Appcompat

adb shell am compat disable RESTRICT_LOCAL_NETWORK <package_name>

Errori

Se una richiesta di accesso alla rete locale non va a buon fine a causa di un'autorizzazione mancante:

  • Le connessioni TCP in genere generano un errore di timeout.

  • Gli errori UDP e i rifiuti di autorizzazione generali in genere generano un codice di errore EPERM

Bug

Invia bug e feedback per:

  • Discrepanze nell'accesso alla LAN (ritieni che un determinato accesso non debba essere considerato un accesso alla "rete locale")
  • Bug per cui l'accesso alla LAN dovrebbe essere bloccato, ma non lo è
  • Bug per cui l'accesso alla LAN non dovrebbe essere bloccato, ma lo è

Quanto segue non dovrebbe essere interessato da questa modifica:

  • Accesso a internet
  • Rete mobile