Berechtigung für das lokale Netzwerk

Auf Geräte in einem Local Area Network (LAN) kann jede App zugreifen, die die Berechtigung INTERNET hat. Dadurch können Apps ganz einfach eine Verbindung zu lokalen Geräten herstellen. Das hat aber auch Auswirkungen auf den Datenschutz, z. B. die Erstellung eines Fingerabdrucks des Nutzers und die Verwendung als Proxy für den Standort.

Das Projekt „Schutzmaßnahmen für lokale Netzwerke“ soll die Privatsphäre der Nutzer schützen, indem der Zugriff auf das lokale Netzwerk an eine neue Laufzeitberechtigung geknüpft wird.

Auswirkungen

Ab Android 17 (API-Level 37) werden Schutzmaßnahmen für lokale Netzwerke für Apps erzwungen, die auf Android 17 oder höher ausgerichtet sind. Die vorherige Konfiguration für die Aktivierung von Android 16 ist veraltet. Informationen zu den aktuellen Implementierungsanforderungen finden Sie unter Erzwingung von Android 17.

Apps sind betroffen, wenn sie über Folgendes auf das lokale Netzwerk des Nutzers zugreifen:

  • Direkte oder Bibliotheksnutzung von Raw Sockets für lokale Netzwerkadressen, z. B. Multicast DNS (mDNS) oder Simple Service Discovery Protocol (SSDP).
  • Verwendung von Klassen auf Framework-Ebene, die auf das lokale Netzwerk zugreifen, z. B. NsdManager.

Details zu den Auswirkungen

Für Traffic zu und von einer lokalen Netzwerkadresse ist die Berechtigung für den Zugriff auf das lokale Netzwerk erforderlich. In der folgenden Tabelle sind einige gängige Fälle aufgeführt:

Low-Level-Netzwerkvorgang der App Berechtigung für das lokale Netzwerk erforderlich
Ausgehende TCP-Verbindung herstellen Ja
Eingehende TCP-Verbindung akzeptieren Ja
UDP-Unicast, -Multicast, -Broadcast senden Ja
Eingehende UDP-Unicast-, Multicast- oder Broadcast-Nachrichten empfangen Ja

Diese Einschränkungen sind tief im Netzwerkstack implementiert und gelten daher für alle Netzwerk-APIs. Dazu gehören Sockets, die auf der Plattform oder im verwalteten Code erstellt wurden, Netzwerkbibliotheken wie Cronet und OkHttp sowie alle APIs, die darauf implementiert sind. Für den Versuch, Dienste im lokalen Netzwerk mit dem Suffix .local aufzulösen, ist die Berechtigung für das lokale Netzwerk erforderlich.

Ausnahmen von den vorherigen Regeln:

  • Wenn sich der DNS-Server eines Geräts in einem lokalen Netzwerk befindet, ist für den Traffic zu/von diesem Server (über Port 53) keine Berechtigung für den Zugriff auf das lokale Netzwerk erforderlich.
  • Anwendungen, die die Ausgabewechsel-Funktion als In-App-Auswahl verwenden, benötigen keine Berechtigungen für das lokale Netzwerk (weitere Informationen folgen in einer späteren Version).

Erzwingung von Android 17

Ab Android 17 sind Schutzmaßnahmen für lokale Netzwerke für Apps, die auf Android 17 oder höher ausgerichtet sind, obligatorisch und werden erzwungen.

Aspekt Android 16 Android 17
Ziel-SDK 36 37 oder höher
Berechtigung NEARBY_WIFI_DEVICES vorübergehend verwendet ACCESS_LOCAL_NETWORK
Standardzugriff Zugriff auf lokales Netzwerk ist offen Das lokale Netzwerk ist standardmäßig für alle Apps blockiert, die ihr Ziel-SDK aktualisieren.
Berechtigungsgruppe Teil der vorhandenen Berechtigungsgruppe „NEARBY_DEVICES“

Damit die App-Funktionen nach der Durchsetzung nicht beeinträchtigt werden, müssen Apps, die auf SDK 37 oder höher ausgerichtet sind, einen der folgenden Pfade zur Verwaltung des lokalen Netzwerkzugriffs verwenden:

Pfad A: Datenschutzfreundliche Auswahltools verwenden

Verwenden Sie für systemgesteuerte Erkennungs- und Verbindungsaufgaben die Auswahl, um die umfassende Laufzeitberechtigung nicht anfordern zu müssen. Verwenden Sie je nach Anwendungsfall die folgenden Picker:

  • Medienstreaming: Für Apps, die Google Cast unterstützen, kann die Ausgabeauswahl verwendet werden. So können Entwickler Nutzern die Möglichkeit geben, bestimmte Streaminggeräte auszuwählen, ohne dass die App die allgemeine Berechtigung ACCESS_LOCAL_NETWORK anfordern muss.
  • Allgemeine Konnektivität: Die NsdManager enthält eine systemgesteuerte Dienstauswahl für die mDNS-Erkennung. Anstatt dass die App das gesamte Netzwerk scannt, wird ein Dialogfeld angezeigt, in dem der Nutzer ein einzelnes Gerät auswählen kann, auf das die App zugreifen darf.
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
    }
})

Pfad B: Laufzeitberechtigung anfordern (umfassender Zugriff)

Dieser Pfad ist für komplexe Anwendungsfälle wie Heimautomatisierung oder IoT-Geräteverwaltung erforderlich, die einen umfassenden, dauerhaften Zugriff auf das lokale Netzwerk benötigen.

  • Berechtigung im Manifest deklarieren: Deklarieren Sie ACCESS_LOCAL_NETWORK explizit im AndroidManifest.xml.

  • Berechtigung zur Laufzeit anfordern: Bevor Anwendungen auf das lokale Netzwerk zugreifen, müssen sie prüfen, ob die Berechtigung erteilt wurde. Andernfalls muss Activity.requestPermission() aufgerufen werden, um die Standard-Systemaufforderung auszulösen.

  • Szenario mit vorab gewährten Berechtigungen: Die Berechtigung ACCESS_LOCAL_NETWORK ist Teil der Berechtigungsgruppe NEARBY_DEVICES. Wenn ein Nutzer bereits eine andere Berechtigung in dieser Gruppe erteilt hat (z. B. Bluetooth-Berechtigungen), wird er nicht noch einmal aufgefordert, den Zugriff auf das lokale Netzwerk zu erlauben.

  • Umgang mit Ablehnung und Widerruf: Apps müssen angemessen auf Fälle reagieren, in denen der Nutzer die Anfrage ablehnt oder die Berechtigung später in den Systemeinstellungen widerruft. In solchen Fällen wird der lokale Netzwerkverkehr blockiert.

Strategie zum Zurücksetzen des Zählers für Berechtigungsanfragen

Die Plattform implementiert eine Strategie zum Zurücksetzen des Zählers, die Szenarien berücksichtigt, in denen die vorherige Ablehnung der Berechtigungsgruppe NEARBY_DEVICES (die jetzt ACCESS_LOCAL_NETWORK enthält) durch eine App verhindert hat, dass die App die Berechtigung anfordert, nachdem sie ihre Begründung angemessen dargelegt hat. Dieser Mechanismus bietet der App zusätzliche Möglichkeiten, die requestPermission() API aufzurufen, wodurch die Anzahl der Ablehnungen für die Berechtigung ACCESS_LOCAL_NETWORK effektiv zurückgesetzt wird. So können Sie den Nutzer noch einmal gezielt ansprechen, insbesondere wenn die ursprüngliche Ablehnung erfolgte, bevor die App die Notwendigkeit des Zugriffs auf das lokale Netzwerk für ihre Hauptfunktionen vermitteln konnte.

Modell mit geteilten Berechtigungen

Bei der Berechtigung für lokale Netzwerke wird eine Migrationsstrategie mit geteilten Berechtigungen verwendet, um neue und alte Anwendungen je nach Ziel-SDK unterschiedlich zu behandeln.

Kategorie SDK-Zielversion Verhalten beim Zugriff auf das lokale Netzwerk Erforderliche Entwickleraktion
Neue Apps / Aktualisierte Apps >= 37 (Android 17) Standardmäßig blockiert Laufzeitberechtigung ACCESS_LOCAL_NETWORK deklarieren und anfordern
Legacy-Apps < 37 Apps mit der Berechtigung INTERNET erhalten eine implizite Berechtigung für ACCESS_LOCAL_NETWORK, sodass sie weiterhin Zugriff haben. Dies ist vorübergehend und wird standardmäßig blockiert, sobald die App das Ziel-SDK auf 37 erhöht. Es sind keine sofortigen Codeänderungen erforderlich. Fordern Sie ACCESS_LOCAL_NETWORK nicht zur Laufzeit an, bevor Sie das SDK 37 als Ziel festlegen.

LNP-Strategie nach Anwendungsfall

  • Streaming: Für Medienstreaming-Funktionen ist die Verwendung der Ausgabeauswahl die am besten geeignete und datenschutzfreundlichste Strategie. Mit dieser Methode kann das System die Erkennung und Verbindung im lokalen Netzwerk im Namen des Nutzers übernehmen. Die App muss dann nicht mehr die Berechtigung ACCESS_LOCAL_NETWORK anfordern.

  • Browser: Die Fehlerbehandlung erfordert je nach Protokoll unterschiedliche Ansätze. UDP-Fehler führen zum Fehlercode EPERM. Bei TCP-Verbindungen sollten Browser die NDK API android_getnetworkblockedreason(int sockFd) verwenden, um festzustellen, ob ein Paket von LNP blockiert wurde. Diese API gibt ANDROID_NETWORK_BLOCKED_REASON_LNP zurück.

  • Andere Anwendungsfälle (z. B. IoT): Anwendungen, die Geräte mithilfe von mDNS finden, sollten android.net.nsd.DiscoveryRequest#FLAG_SHOW_PICKER verwenden, um Geräte ohne die Berechtigung zu finden, und NsdManager#registerServiceInfoCallback / NsdManager#resolveService, um IP-Adressen abzurufen. Für Verbindungen zu IP-Adressen, die auf diese Weise abgerufen werden, ist die Berechtigung ACCESS_LOCAL_NETWORK nicht erforderlich.

Für Anwendungen, die eine direkte Kommunikation im lokalen Netzwerk erfordern und keine systemgesteuerten Auswahlen verwenden können, wird empfohlen, die Strategie zum Zurücksetzen des Berechtigungszählers zu verwenden, wenn sie auf Android 17 (SDK 37) oder höher ausgerichtet sind. Wenn die Berechtigung ACCESS_LOCAL_NETWORK vom Nutzer widerrufen wird, bietet dieser Mechanismus der App zusätzliche Möglichkeiten, die Berechtigung noch einmal anzufordern. So können Entwickler dem Nutzer eine klarere Begründung präsentieren.

Leitfaden für Android 16 (eingestellt)

So aktivieren Sie die Einschränkungen für das lokale Netzwerk unter Android 16:

  1. Flashe dein Gerät auf einen Build mit Android 16 Beta 3 oder höher.
  2. Zu testende App installieren
  3. Appcompat-Konfiguration mit adb aktivieren/deaktivieren

    adb shell am compat enable RESTRICT_LOCAL_NETWORK <package_name>
    
  4. Gerät neu starten

Der Zugriff Ihrer App auf das lokale Netzwerk ist jetzt eingeschränkt und jeder Versuch, auf das lokale Netzwerk zuzugreifen, führt zu Socket-Fehlern. Wenn du APIs verwendest, die lokale Netzwerkvorgänge außerhalb deines App-Prozesses ausführen (z. B. NsdManager), sind diese während des Opt-ins nicht betroffen.

Wenn Sie den Zugriff wiederherstellen möchten, müssen Sie Ihrer App die Berechtigung für NEARBY_WIFI_DEVICES gewähren.

  • Die App muss die Berechtigung NEARBY_WIFI_DEVICES in ihrer manifest deklarieren.
  • Gehe zu den Einstellungen > Apps > [App-Name] > Berechtigungen > Geräte in der Nähe > Zulassen.

Der Zugriff deiner App auf das lokale Netzwerk sollte jetzt wiederhergestellt sein und alle Szenarien sollten wie vor der Aktivierung der App funktionieren. So wird der Netzwerkverkehr der App beeinflusst.

Berechtigung Ausgehende LAN-Anfrage Ausgehende/eingehende Internetanfrage Eingehende LAN-Anfrage
Gewährt YouTube? YouTube? YouTube?
Nicht gewährt Pannen YouTube? Pannen

Verwenden Sie den folgenden Befehl, um die Appcompat-Konfiguration zu deaktivieren:

adb shell am compat disable RESTRICT_LOCAL_NETWORK <package_name>

Fehler

Wenn eine Anfrage für den Zugriff auf ein lokales Netzwerk aufgrund einer fehlenden Berechtigung fehlschlägt, gilt Folgendes:

  • TCP-Verbindungen führen in der Regel zu einem Zeitüberschreitungsfehler.

  • UDP-Fehler und allgemeine Berechtigungsverweigerungen führen in der Regel zu einem EPERM-Fehlercode.

Fehler

Fehler melden und Feedback geben für:

  • Unstimmigkeiten beim LAN-Zugriff (Sie sind der Meinung, dass ein bestimmter Zugriff nicht als Zugriff auf das lokale Netzwerk betrachtet werden sollte)
  • Fehler, bei denen der LAN-Zugriff blockiert werden sollte, aber nicht blockiert wird
  • Fehler, bei denen der LAN-Zugriff nicht blockiert werden sollte, aber blockiert wird

Folgendes sollte von dieser Änderung nicht betroffen sein:

  • Internetzugriff
  • Mobilfunknetz