PROXY Configuration Service Provider

  • Article

Send Feedback

The PROXY Configuration Service Provider is used to configure proxy networks. Each proxy node configures a proxy connection. This proxy connection can apply to one or more connectivity objects (ConRefs), as long as the ConRefs point to the same metanetwork. One or more proxy connections can be provisioned.

The ACCESS Configuration Service Provider must be configured before configuring the PROXY object. The ACCESS Configuration Service Provider maps a particular connection (using the ConRef field) with a metanetwork, such as the Internet or Work.

Note   This Configuration Service Provider is part of the OMA DM protocol, with some proprietary extensions, and must be used when provisioning devices using OMA DM. To provision devices using the OMA Client Provisioning (formerly WAP) protocol, use the CM_ProxyEntries Configuration Service Provider instead.

Note   Access to this Configuration Service Provider is determined by Security roles. Because OEMs and Mobile Operators can selectively disallow access, ask them about the availability of this Configuration Service Provider. For more information about roles, see Security Roles and Default Roles for Configuration Service Providers.

The following image shows the management object used by OMA DM.

  • PROXY
    The root node for PROXY object. The following table shows the default settings.

    Format Node
    Roles allowed to query and update setting Manager

    AuthenticatedUser
    Access Type Read/Write
    Occurs Once

  • PROXY/PROXYXXX
    Specifies a proxy connection. The suggested name of this node is PROXYXXX, a numbered node beginning at zero. For example, if you wanted to provision two different proxies, each using a separate proxy server, you would use two nodes, PROXY0 and PROXY1. You can use any unique name for this node, but no spaces may appear in the node name (use %20 instead).

    Format Node
    Roles allowed to query and update setting Manager

    AuthenticatedUser

  • PROXY/PROXYXXX/PROXYID
    Specifies the identifier of the proxy. The value of the PROXYID must match a ConRef specified using the ACCESS Configuration Service Provider. The PROXYID must be unique.

    The following table shows the default settings.

    Format String
    Roles allowed to query and update setting Manager

    AuthenticatedUser

  • PROXY/PROXYXXX/NAME
    Specifies the user-friendly name of the proxy connection.

    The following table shows the default settings.

    Format String
    Roles allowed to query and update setting Manager

    AuthenticatedUser

  • PROXY/PROXYXXX/ADDR
    Specifies the address of the proxy server. The ADDR may be the network name of the server, or any other string (such as an IP address) used to uniquely identify the proxy connection.

    The following table shows the default settings.

    Format String
    Roles allowed to query and update setting Manager

    AuthenticatedUser

  • PROXY/PROXYXXX/ADDRTYPE
    Specifies the type of address used to identify proxy server. This value is always set to "IPv4" for proxy servers.

    The following table shows the default settings.

    Format String
    Roles allowed to query and update setting Manager

    AuthenticatedUser

  • PROXY/PROXYXXX/PROXYTYPE
    Specifies the type of proxy. This value is set to one of the following values, depending on the PROXYID: ISA, WAP, SOCKS, or NULL.

    The following table shows the default settings.

    Format String
    Roles allowed to query and update setting Manager

    AuthenticatedUser

  • PROXY/PROXYXXX/PORTS/PORTXXX/Services/SERVICEXXX/Service/ServiceName
    Specifies the protocols to be associated with the port specified by PORTXXX. One commonly used value is "HTTP".

    The following table shows the default settings.

    Format String
    Roles allowed to query and update setting Manager

    AuthenticatedUser

  • PROXY/PROXYXXX/PORTS/PORTXXX/PortNbr
    Specifies the port number to be associated with the parent port.

    The following table shows the default settings.

    Format Int
    Roles allowed to query and update setting Manager

    AuthenticatedUser

  • PROXY/PROXYXXX/CONREFS/CONREFXXX/ConRef
    Specifies one single connectivity object associated with the proxy connection. The value must match a ConRef specified using the ACCESS Configuration Service Provider.

    The following table shows the default settings.

    Format String
    Roles allowed to query and update setting Manager

    AuthenticatedUser

-See Also

Configuration Service Provider Reference for Windows Mobile-Based Devices | PROXY Configuration Service Provider Example for OMA DM

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.