Share via

Proxy configuration

  • Article

OEMs can configure proxy connections on the phone. The following example shows a proxy configuration. For a more detailed connectivity configuration sample, see Connectivity configuration.

Important  

For dual SIM phones, connection settings must be unique for each SIM. To ensure unique settings, OEMs can use the $(__MVID) macro as part of all connection names.

<Settings Path="Connections">
    <Setting Name="Proxies/contoso_mms_proxy $(__MVID)/Server" Value="proxy.contoso.com" />
    <Setting Name="Proxies/contoso_mms_proxy $(__MVID)/Port" Value="80" />
    <Setting Name="Proxies/contoso_mms_proxy $(__MVID)/ConnectionName" Value="zzzcontoso_mms $(__MVID)" />
    <Setting Name="Proxies/contoso_mms_proxy $(__MVID)/Type" Value="HTTP" />
</Settings>

Important  

All APN, proxy, and policy entries referring to the same connection must be defined within the same <Settings> element in the answer file.

Settings

  • proxy name
    Defines the name of the connection proxy. In the above example, the proxy name is “contoso_mms_proxy $(__MVID)”.

    Each cellular entry can have only one proxy entry. For example, an Internet connection can have no more than one HTTP proxy specified but it might also have a WAP proxy. If two applications need access to the same APN but one application needs a proxy and the other application cannot have a proxy, two entries can be created with different names for the same APN.

  • ConnectionName
    Specifies the name of the connection the proxy is associated with. This is the connection name of a connection configured in APN configuration.

  • BypassLocal
    Specifies if the proxy should be bypassed when local hosts are accessed by the device.

    A value of "0" specifies that the proxy bypass for local hosts is disabled. A value of "1" specifies that the proxy bypass for local hosts is enabled.

  • EnableProxy
    Specifies if the proxy is enabled.

    A value of "0" specifies that the proxy is disabled. A value of "1" specifies that the proxy is enabled.

  • Exception
    Specifies a list of external hosts which should bypass the proxy when accessed.

    The exception list is a semi-colon delimited list of host names. For example, to bypass the proxy when either MSN or Yahoo is accessed, the value for the Exception list would be "www.msn.com;www.yahoo.com".

  • Password
    Specifies the password used to connect to the proxy.

    Passwords are only required for WAP and SOCKS proxies and are not used for HTTP proxies. Queries of this parameter return a string composed of asterisks (*).

    When setting the password, passing in the same string causes the new password to be ignored and does not change the existing password.

  • Port
    Specifies the port number of the proxy server.

  • Server
    Specifies the name of the proxy server.

  • Type
    Specifies the type of proxy connection for this entry.

    The following list enumerates the values allowed for the Type parameter.

    • "0" = Null proxy

    • "1" = HTTP proxy

    • "2" = WAP proxy

    • "4" = SOCKS4 proxy

    • "5" = SOCKS5 proxy

    The Null proxy can be used to allow Connection Manager to treat one network as a superset of another network by creating a null proxy from one network to the other.

  • UserName
    Specifies the username used to connect to the proxy.

Connectivity configuration

APN configuration

Connection policy configuration

 

 

Send comments about this topic to Microsoft