3.1.5.1 Downloading Policy Settings
This section specifies how the client downloads policy settings from the server by using the Provision command (section 2.2.1.14).
The first command the client issues to the server SHOULD<20> be a Provision command, as specified in [MS-ASPROV]. The client can send the HTTP OPTIONS command to the server before sending the Provision command, to retrieve server settings, but the HTTP OPTIONS command is optional. If the client sends other commands to the server before sending the Provision command, the server will return a Status element (as specified in [MS-ASPROV] section 2.2.2.54) value of 142 to the client.
The initial Provision command request MUST contain the provision:PolicyType element (as specified in [MS-ASPROV] section 2.2.2.43), which specifies the format in which the policy settings are provided. If the provision:PolicyType element is not included in the initial Provision command request, the server responds with a provision:Status element value of 2. The server then responds with the provision:PolicyType, provision:PolicyKey (as specified in [MS-ASPROV] section 2.2.2.42), and provision:Data ([MS-ASPROV] section 2.2.2.24) elements. The provision:PolicyKey element is used by the server to mark the state of policy settings on the client device. The policy settings, in the format specified in the provision:PolicyType element, are contained in the provision:Data element.
The client device then applies the policy settings that were received from the server and sends an acknowledgement back to the server in another Provision command request. The acknowledgement from the client device contains provision:PolicyType, provision:PolicyKey, and provision:Status elements. The provision:Status element indicates whether the policy settings were successfully applied by the client. The response from the server contains provision:PolicyType, provision:PolicyKey, and provision:Status elements. The provision:Status element indicates whether the server successfully recorded the client's acknowledgement.
The following figure shows the process for downloading policy settings.
Figure 3 Downloading policy settings
The following table lists the command sequence for downloading policy settings.
|
Order |
Client action |
Server action |
|---|---|---|
|
1 |
The client sends a Provision command request with the type of policy settings to be downloaded. |
The server responds with the policy type, policy key, data, and status code. |
|
2 |
The client acknowledges that it received and applied the policy settings by sending another Provision command request with the policy type, policy key, and status code. |
The server responds with the policy type, policy key, and status code to indicate that the server recorded the client's acknowledgement. |