Views

Difference between revisions of "Zero Touch Deployment"

The Wiki of Unify contains information on clients and devices, communications systems and unified communications. - Unify GmbH & Co. KG is a Trademark Licensee of Siemens AG.

Jump to: navigation, search
(POST)
Line 32: Line 32:
 
|-
 
|-
 
! width="100" | Key
 
! width="100" | Key
! width="400" | Value
+
! width="500" | Value
 
|-
 
|-
 
| mac
 
| mac

Revision as of 19:45, 4 December 2019

Introduction

Zero Touch Deployment describes a method of deploying a Desk Phone CP SIP device, without user interaction, via the Unify redirect server. For this to work, a service provider needs access to the redirect server API, in order to prepare the deployment of the device. On initial startup or after a factory reset, the device will contact the redirect server and will receive information about the service providers deployment system.

API

The redirect server API is available at https://cloud-setup.com/api/devices and supports the following methods

  • POST
  • PUT
  • DELETE

POST

The POST method is used to retrieve information about devices prepared for zero touch deployment. The data sent in the POST request must contain the mac address of up to 100 devices per request.

 [{"mac":"01:23:45:67:89:ab"},...]

the mac address can be provided in the following format

Key Value
mac
required
01:23:45:67:89:AB
01-23-45-67-89-AB
01:23:45:67:89:ab
01-23-45-67-89-ab

The data received on a successful request.

 [{"mac":"01:23:45:67:89:ab","result":"OK","data":"'<Item name="bw-dms-addr">https://192.168.0.100/home</Item>\r\n<Item name="language-iso">de</Item>'"},...]
Key Value
mac The MAC address sent in the request or ERROR if no MAC given
result The result of the request. Can be OK or ERROR
data
optional
If the result is OK, value will contain the data prepared for the given MAC address
reason
optional
If the result is ERROR, will contain the reason for the ERROR response