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
Concepts
Configuration Service Provider Reference for Windows Mobile Devices
Bootstrapping To Use an OMA Client Provisioning Server