Nur für den internen Gebrauch
3.6
Provisioning Service Driven Interaction
To initiate an interaction with the phone, the provisioning service must send an HTML-based
contact-me message to the phone's contact-me URI. In turn the phone will send a response
with solicited as a ReasonForContact. For the corresponding XML schema, please refer
to Section 3.6.3.2, "XML Data Exchange".
3.6.1
Start an Interaction: Contact-me
The main purpose of the contact-me message is to allow the phone to decide when to send a
response. If the provisioning service is acting as a web server, this initial message is required,
as the service must be contacted by the phone, which acts as a web client. For details about
the structure of a contact-me message, see Section 1.4.4.2, "Contact-me Messages".
If the phones and the provisioning service reside in different networks or subnets, which are
separated by a firewall and/or NAT, it may be impossible for the provisioning service to send a
contact-me message. To solve this problem, the phone can be configured so that it periodically
polls the provisioning service, or a special proxy, for new messages. For further information,
please refer to Section 1.4.4.3, "Polling Request To Bridge A Firewall" and Section 3.1.2.2,
"Provisioning Service Located Behind A Firewall".
3.6.2
End an Interaction: CleanUp
An interaction is terminated when the phone receives a CleanUp message from the provision-
ing service. Together with the CleanUp message, the provisioning service should also invali-
date the HTTPS session. See the following example:
<DLSMessage xsi:schemaLocation="http://www.siemens.com/DLS"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns="http://www.siemens.com/DLS">
<Message nonce="9A6439F4E323CDB19283E40459828B56">
<Action>CleanUp</Action>
</Message>
</DLSMessage>
When sending a 'send-solicited' with the CleanUp message as response to a 'busy' state mes-
sage of the phone, the phone is forced to contact automatically the provisioning service when
it switches to 'idle' state. See also Section 3.7.3, "Contact-Me during Busy State".
<DLSMessage xsi:schemaLocation="http://www.siemens.com/DLS"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns="http://www.siemens.com/DLS">
<Message nonce="9A6439F4E323CDB19283E40459828B56">
<Action>CleanUp</Action>
<ItemList>
<Item name="send-solicited">true</Item>
A31003-S2000-R102-16-7620, 02/2016
Provisioning Service, Developer's Guide
Basic Communication Procedures
Provisioning Service Driven Interaction
c03.fm
41