ProxyResolver

ProxyResolver allows simply resolve the actual proxy information from users system configuration and could be used for setting up Stream-based connections, for example for Web Sockets.

Usage example:

import ProxyResolver

let proxy = ProxyResolver()
let url = URL(string: "https://github.com")!
  proxy.resolve(for: url) { result in
  switch result {
    case .direct:
      // Direct connection allowed - no proxy required
      break
    case .proxy(let proxy):
      // here you can establish connection to proxy or whatever you want
      // proxy.type - one of ProxyType enum: .http, .https or .socks
      // proxy.host - host name of proxy to use
      // proxy.port - port number
      break
    case .error(let error):
      // Handle error
      break
  }
}

Features

Supported system configurations

• Auto Proxy Discovery*
• Automatic Proxy Configuration URL*
• Web Proxy (HTTP)
• Secure Web Proxy (HTTPS)
• SOCKS Proxy
• FTP Proxy
• Streaming Proxy (RTSP)
• Gopher Proxy

* due to ATS protection auto-configuration url should be HTTPS or have *.local or unresolvable globally domain, otherwise you will need to set the NSAllowsLocalNetworking key in plist. More info could be found in NSAppTransportSecurity reference.

Other (TBD)

• Proxy with required password support

Proxy.credentials will automatically access Proxy keychain to retrieve configured for proxy account and password. As it would require permission from user the credentials are retrieved lazily only when you try to get them.

• Configurable

You can use custom proxy configuration provider instead of system one, or provide your own fetcher for downloading auto-configuration scripts instead of default one based on NSURLSession.

• [In Progress] Aligned with Apple recommendations

In general, you should try to download a URL using the first proxy in the array, try the second proxy if the first one fails, and so on.

Requirements

• Swift: 4+
• macOS: 10.10+

Installation

ProxyResolver is available through CocoaPods. To install it, simply add the following line to your Podfile:

pod 'ProxyResolver'

Author

ProxyResolver was initially inspired by the Starscream proxy support merge request.

rinold, mihail.churbanov@gmail.com

License

ProxyResolver is available under the MIT license. See the LICENSE file for more info.