Getting Started
Nur für den internen Gebrauch
A31003-S2000-R102-16-7620 02/2016
14
Provisioning Service, Developer’s Guide
c01.fm
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.
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.
>
The content-length of HTTPS responses should be set to the length of the XML mes-
sage content.