BOOTSTRAP Configuration Service Provider

  • Article

4/8/2010

The BOOTSTRAP Configuration Service Provider sets the Trusted Provisioning Server (TPS) for the device.

This Configuration Service Provider is managed over the OMA Client Provisioning protocol.

The following table shows the default security settings for the BOOTSTRAP Configuration Service Provider. The default security role maps to each subnode unless specific permission is granted to the subnode.

Permissions

Read/write

Roles allowed to query and update setting

Manager

Operator

Operator TPS

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 Configuration Service Provider in tree format as used by OMA Client Provisioning.

Bb737510.b84094d1-b36f-4476-87b1-b622a896c1ec(en-us,MSDN.10).gif

Characteristics

  • BOOTSTRAP
    Groups the parameters for the Trusted Provisioning Server (TPS). This Root-level characteristic must be present to set the TPS for the device.

    Data type

    node

    Occurs

    One

Parameters

  • CONTEXT-ALLOW
    Specifies a context for the TPS. Only one context is supported. This parameter is ignored and 0 is assumed for its value.

    Data type

    int

    Occurs

    ZeroOrOne

  • NAME
    Identifies the friendly server name. If this parameter is missing, the default is "Trust WAP Config Server". This parameter is used in the root BOOTSTRAP characteristic.

    Data type

    string

    Occurs

    ZeroOrOne

  • PROVURL
    Required. Identifies the location of a Trusted Provisioning Server (TPS). This must be a complete URL, starting with "https://", "https://", "wsp://", or "wsps://". The length of the value of PROVURLmust be equal to or smaller than 256 characters.

    This parameter is used in the root BOOTSTRAP characteristic.

    Data type

    string

    Occurs

    One

  • PROXY-ID
    Identifies a proxy that is available with the bootstrap information. If this parameter is present, a browser favorite will be added, whose URL is the PROVURL parameter, and whose name is the NAME parameter. If the URL has a scheme of "http" or "https", it will be converted to "wsp" or "wsps", respectively.

    This parameter is used in the root BOOTSTRAP characteristic.

    Data type

    string

    Occurs

    ZeroOrOne

Microsoft Custom Elements

The following table shows the Microsoft custom elements that this Configuration Service Provider supports for OMA Client Provisioning.

Elements Available

parm-query

No

noparm

No

nocharacteristic

No

characteristic-query

No

Use these elements to build standard OMA Client Provisioning (formerly WAP Client Provisioning) configuration XML. For information about specific elements, see MSPROV DTD Elements. For examples of how to generally use the Microsoft custom elements, see OMA Client Provisioning XML File Examples.

For information about OMA Client Provisioning, see OMA Client Provisioning Files.

See Also

Tasks

BOOTSTRAP Configuration Service Provider Examples for OMA Client Provisioning

Reference

BOOTSTRAP

Concepts

Configuration Service Provider Reference for Windows Mobile Devices
Bootstrapping To Use an OMA Client Provisioning Server