Skip to Content
Platform.Ontology

System proxy settings

Reads the HTTP proxy configured on the device.

Gets silentlyNetwork and connectionConnectivityAndroid and iPhoneWhen the app opensWhile you use it

In one line

Can see if your phone sends web traffic through a proxy

Reads the HTTP proxy configured on the device.

Shows corporate or debugging proxies and can indicate traffic inspection.

What it can and can't do

What the user does: Nothing. It happens when the app opens a network connection

It can

  • See the proxy host, port and any PAC script address
  • Route its traffic through the same proxy
  • Spot a work or school network setup

It cannot

  • See the traffic that goes through the proxy
  • Change your proxy settings
  • See a proxy set by a VPN app in every case

On Android and iPhone

AndroidiPhone
StatusSupportedSupported
First versionAndroid 1.0 (API 1)iOS 2.0
Permission or entitlementNot listednone
Protection levelnonenone
How access is grantednonenone
What the user seesNot listedNot listed
How long it lastsNot listedNot listed
How to take it backNot listedNot listed
Store policyNone listedNone listed
APIProxyInfo via ConnectivityManager.getDefaultProxy(); System.getProperty(http.proxyHost)Dictionary of HTTP, HTTPS, PAC settings
NotesHost, port, PAC URLNone

Data you get

What comes back: Proxy config
Shape: object
How often: On change

FieldTypeUnitRangePrecision
hoststringNonehostnameexact

Technical limits

  • Does not reveal VPN proxies

The story

What it is

An app can see whether your phone sends its web traffic through a proxy.

For you

You do not see it. If you use a work or school network with a proxy, apps can tell. It may show that someone is inspecting the traffic of your phone, or that a developer is testing.

For makers

Makers use it to help with support and to spot tools that sit between the app and the server. Banks and games use the flag to detect people who intercept traffic to cheat. It is a weak but useful signal.

Where you see it

TypeExampleApps
enterpriseA work app notes that the phone uses a company proxy and picks safe settings.None named
bankingA bank app refuses to run when a proxy is set, to stop someone reading its traffic.None named
gamesA mobile game blocks players who use a proxy tool to edit the game's messages.None named
developerA developer sets a proxy on a test phone to watch the app's requests and fix a bug.Charles Proxy
securityA fraud tool sees a proxy that matches a known scam setup and raises the risk score.None named
utilitiesA support tool shows a help article when a proxy breaks the connection.None named

Risks

  • Flags privacy tool users
  • Weak fingerprint bit

Android and iPhone in short

  • Android: Android apps can read the system proxy setting with no prompt.
  • iPhone: iPhone apps can read the system proxy settings through the network settings, with no prompt.

Good uses and abuse

Legitimate uses

  • Support, debugging

Known abuse

  • Detect interception tools

Scores

ScoreValueMeaning
Sensitivity2 of 5How revealing the data is
Utility2 of 5How useful it is to honest apps
Friction0 of 5How much the user has to do
Fingerprint bits1Rough identifying entropy, when known

Same idea on the web

Sources

How well checked: Based on official documentation.

On this page