Skip to Content
Platform.Ontology

Connected Wi-Fi name and BSSID

Reads the name and ID of the Wi-Fi network the phone is on, which gives away place.

Asks you firstNetwork and connectionNetworkAndroid and iPhoneWhile you use itWhen the app opens

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

AndroidiPhone
StatusPartialBehind a flag
First versionAndroid 8.1 (API 27)iOS 12
Permission or entitlementACCESS_WIFI_STATE (normal) plus ACCESS_FINE_LOCATION; NEARBY_WIFI_DEVICES (API 33) for scanscom.apple.developer.networking.wifi-info plus Precise Location (iOS 13), or hotspot config, VPN or MDM
Protection leveldangerousentitlement
How access is grantedpromptentitlement
What the user seesPrecise location promptPrecise location prompt; Wi-Fi Info capability in Xcode
How long it lastsUntil revokedUntil revoked
How to take it backSettings > Apps > Permissions > LocationSettings > Privacy & Security > Location Services
Store policyPlay: location policy applies to Wi-Fi scanningApp Review 5.1.1
APIWifiManager.getConnectionInfo, ConnectivityManager callback with FLAG_INCLUDE_LOCATION_INFONEHotspotNetwork.fetchCurrent, CNCopyCurrentNetworkInfo
NotesLocation services must be on; SSID returns <unknown ssid> without grant; scan throttle 4 scans per 2 minutes foregroundWithout entitlement and location the call returns nil

Data you get

What comes back: SSID, BSSID, RSSI
Shape: object
How often: per call

FieldTypeUnitRangePrecision
ssidstringNoneup to 32 bytesNot listed
bssidstringMAC6 bytesunique 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

TypeExampleApps
smart-homeA smart bulb app reads your home Wi-Fi name so it can send it to the new bulb.Philips Hue, TP-Link Kasa
utilitiesA Wi-Fi tool shows the name, channel and speed of the network you are on.Speedtest
travelA hotel app notices you joined the hotel Wi-Fi and shows a welcome screen.None named
enterpriseA work app turns on features only at the office network.None named
adsA data broker reads the router ID and looks up your street address in a database.None named
securityA 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

ScoreValueMeaning
Sensitivity4 of 5How revealing the data is
Utility3 of 5How useful it is to honest apps
Friction3 of 5How much the user has to do
Fingerprint bits6Rough 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

Same idea on the web

Sources

How well checked: Based on official documentation.

On this page