Table of Contents
Advertisement
c01.fm
Getting Started
Network Communication
1.4.4
HTTP/HTTPS Messages
Generally, two types of HTTP/HTTPS messages are used by the provisioning interface: XML
messages for phone control and data exchange, and HTML messages for initiating an interac-
tion by the provisioning service.
The content-length of HTTPS responses should be set to the length of the XML mes-
>
sage content.
1.4.4.1
XML Messages For Data Exchange
Regular XML messages used for interactions between phone and provisioning service are
transmitted via HTTPS. The HTTP method is POST, and the Content-type is text/xml. The
structure of the XML messages is described in Section 3, "Basic Communication Procedures".
This is the structure of a URI for a request sent by the phone to the provisioning server:
https://<host>:<port>/<path to provisioning service>
Example: https://192.168.1.103:18443/provisioningService
1.4.4.2
Contact-me Messages
With this type of message, the provisioning service announces to the phone that it has a new
message for the phone.
Initial contact-me messages from the provisioning service are transmitted via non-encrypted
HTTP. The POST method is used. The HTTP Content-type is application/x-www-
form-urlencoded. The following parameters must/can be sent to the phone:
•
ContactMe (required): Set to true if a response from the phone is expected.
•
dls_ip_addr (optional): Target IP address for the response from the phone.
•
dls_ip_port (optional): Port associated with the IP address provided with dls_ip_ad-
dr.
The parameters described above enable the provisioning service to scan a certain range of IP
addresses for phones simply by sending contact-me requests to each address consecutively.
The complete URI for contact-me messages has the following structure:
http://<IP address>:8085/contact_dls.html/ContactDLS
Example: http://192.168.1.4:8085/contact_dls.html/ContactDLS
The following examples show the HTTP communication initiated by a contact-me message.
14
Nur für den internen Gebrauch
A31003-S2000-R102-16-7620 02/2016
Provisioning Service, Developer's Guide
Advertisement
Table of Contents
