BOOTSTRAP Configuration Service Provider

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.

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