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)oderSimple 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_NETWORKanfordern muss. - Allgemeine Konnektivität: Die
NsdManagerenthä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_NETWORKexplizit imAndroidManifest.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_NETWORKist Teil der BerechtigungsgruppeNEARBY_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_NETWORKanfordern.Browser: Die Fehlerbehandlung erfordert je nach Protokoll unterschiedliche Ansätze. UDP-Fehler führen zum Fehlercode
EPERM. Bei TCP-Verbindungen sollten Browser die NDK APIandroid_getnetworkblockedreason(int sockFd)verwenden, um festzustellen, ob ein Paket von LNP blockiert wurde. Diese API gibtANDROID_NETWORK_BLOCKED_REASON_LNPzurück.Andere Anwendungsfälle (z. B. IoT): Anwendungen, die Geräte mithilfe von mDNS finden, sollten
android.net.nsd.DiscoveryRequest#FLAG_SHOW_PICKERverwenden, um Geräte ohne die Berechtigung zu finden, undNsdManager#registerServiceInfoCallback/NsdManager#resolveService, um IP-Adressen abzurufen. Für Verbindungen zu IP-Adressen, die auf diese Weise abgerufen werden, ist die BerechtigungACCESS_LOCAL_NETWORKnicht 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:
- Flashe dein Gerät auf einen Build mit Android 16 Beta 3 oder höher.
- Zu testende App installieren
Appcompat-Konfiguration mit adb aktivieren/deaktivieren
adb shell am compat enable RESTRICT_LOCAL_NETWORK <package_name>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_DEVICESin ihrermanifestdeklarieren. - 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