Connected Wi-Fi name and BSSID
Reads the name and ID of the Wi-Fi network the phone is on, which gives away place.
In one line
Can see your Wi-Fi name, but only with location access and extra approval
Reads the name and ID of the Wi-Fi network the phone is on, which gives away place.
SSID and BSSID are lookup keys for geolocation databases, so apps need location permission to read them.
What it can and can't do
What the user does: You tap Allow Location when the app asks to see your Wi-Fi
It can
- See the Wi-Fi name (SSID) and BSSID on Android after Location is allowed
- See the current Wi-Fi name on iPhone with the entitlement and Precise Location
- Use the Wi-Fi name to guess a place such as home or work
It cannot
- See the name on Android when Location services are off (you get unknown ssid)
- See the name on iPhone without the Apple entitlement and Precise Location
- Scan more than 4 times per 2 minutes in the foreground on Android
- Get the name if you decline Location
How it differs between platforms: Android needs a Location grant. iPhone needs a special Apple entitlement plus Precise Location, or hotspot, VPN or MDM role.
On Android and iPhone
| Android | iPhone | |
|---|---|---|
| Status | Partial | Behind a flag |
| First version | Android 8.1 (API 27) | iOS 12 |
| Permission or entitlement | ACCESS_WIFI_STATE (normal) plus ACCESS_FINE_LOCATION; NEARBY_WIFI_DEVICES (API 33) for scans | com.apple.developer.networking.wifi-info plus Precise Location (iOS 13), or hotspot config, VPN or MDM |
| Protection level | dangerous | entitlement |
| How access is granted | prompt | entitlement |
| What the user sees | Precise location prompt | Precise location prompt; Wi-Fi Info capability in Xcode |
| How long it lasts | Until revoked | Until revoked |
| How to take it back | Settings > Apps > Permissions > Location | Settings > Privacy & Security > Location Services |
| Store policy | Play: location policy applies to Wi-Fi scanning | App Review 5.1.1 |
| API | WifiManager.getConnectionInfo, ConnectivityManager callback with FLAG_INCLUDE_LOCATION_INFO | NEHotspotNetwork.fetchCurrent, CNCopyCurrentNetworkInfo |
| Notes | Location services must be on; SSID returns <unknown ssid> without grant; scan throttle 4 scans per 2 minutes foreground | Without entitlement and location the call returns nil |
Data you get
What comes back: SSID, BSSID, RSSI
Shape: object
How often: per call
| Field | Type | Unit | Range | Precision |
|---|---|---|---|---|
ssid | string | None | up to 32 bytes | Not listed |
bssid | string | MAC | 6 bytes | unique per access point |
Technical limits
- Apple requires both entitlement and location
- Android requires location services to be on
- Location services must be on
- iOS needs an entitlement Apple must approve
The story
What it is
An app can read the name and ID of your Wi-Fi network, which gives away where you are.
For you
You see a location prompt if an app wants to read your Wi-Fi name. If you allow it, the app can tell whether you are at home or in a cafe. If you deny it, the name comes back as unknown.
For makers
Makers need the name for device setup and diagnostics. The router ID can be looked up in a database to find a street address, so platforms put it behind the location permission.
Where you see it
| Type | Example | Apps |
|---|---|---|
| smart-home | A smart bulb app reads your home Wi-Fi name so it can send it to the new bulb. | Philips Hue, TP-Link Kasa |
| utilities | A Wi-Fi tool shows the name, channel and speed of the network you are on. | Speedtest |
| travel | A hotel app notices you joined the hotel Wi-Fi and shows a welcome screen. | None named |
| enterprise | A work app turns on features only at the office network. | None named |
| ads | A data broker reads the router ID and looks up your street address in a database. | None named |
| security | A security tool warns you when you join an open network with a familiar name that has a new ID. | None named |
Risks
- Home and work location
- Address lookup from router ID
Android and iPhone in short
- Android: Android hides the network name unless the app has location permission and location is on.
- iPhone: iPhone needs the Access Wi-Fi Information entitlement and location permission to read it.
Good uses and abuse
Legitimate uses
- Smart device onboarding
- Wi-Fi diagnostics
Known abuse
- Indoor location via BSSID lookup
Scores
| Score | Value | Meaning |
|---|---|---|
| Sensitivity | 4 of 5 | How revealing the data is |
| Utility | 3 of 5 | How useful it is to honest apps |
| Friction | 3 of 5 | How much the user has to do |
| Fingerprint bits | 6 | Rough identifying entropy, when known |
History
- 2018-03, Android 8.1 (API 27): Location permission required to see SSID
- 2018-04, Android 8.1 (API 27): SSID needs location permission and location on
- 2018-09, iPhone iOS 12: wifi-info entitlement required
- 2019-09, iPhone iOS 13: Precise location also required
- 2019-09, Android 10 (API 29): Now needs ACCESS_FINE_LOCATION
- 2020-09, iPhone iOS 14: NEHotspotNetwork.fetchCurrent added; CNCopyCurrentNetworkInfo deprecated
- 2022-08, Android 13 (API 33): NEARBY_WIFI_DEVICES added
- 2022-08, Android 13 (API 33): NEARBY_WIFI_DEVICES permission added
Related capabilities
Related
- Local network access. Can talk to devices on your home or office network, after you tap Allow
- Join or suggest a Wi-Fi network. Can add a Wi-Fi network to your phone, usually to set up a smart device
- Wi-Fi signal strength and link speed. Can see Wi-Fi signal strength and speed on Android; iPhone needs special approval
- Nearby Wi-Fi networks scan. Can list nearby Wi-Fi networks on Android, with limits and a location prompt
Same idea on the web
- Wi-Fi name, BSSID and signal strength. Can't see your Wi-Fi name, router ID, or signal bars
Sources
- Apple: NEHotspotNetwork
- Android: Wi-Fi scanning and permissions
- Apple: Wi-Fi info entitlement
- Android: Wi-Fi permissions
- Android: WifiInfo
- Apple Support: Control access to Wi-Fi information and Private Wi-Fi addresses
How well checked: Based on official documentation.