A free, simple, easy-to-implement, standards-based,
feature-rich dialtone for your SIP hardware or softphone...

Engineers Testing or Implementing Plug-N-Dial

Provisioning Method:

The HTTPS Provisioning Method is defined as follows:

Step 1: Retrieve Configuration File

At boot time the SIP device should initially attempt to download the encrypted configuration file from the Automatic Provisioning System. This is done by placing a HTTPS request to the APS server which has a HTTPS server running to accomodate this request.

Example: A HTTPS get request should be formatted as follows:

https://<SERVER>/<Make/Model>/app?class=<Make/Model>;mac_address=xxxxxxxxxx

The format of the return file can be either in plaintext / XML / encrypted:

For example:

The SIP device updates via HTTPS with a plaintext response then the field format will be as follows

sip_server="proxy01.sipphone.com"
sip_server_port="5060"
local_rtp_port="5004"
local_sip_port="5060"
codec3="G711u"

The SIP device updates via HTTPS using XML then the field names would directly translate as follows:

<sip_server>
        proxy01.sipphone.com
</sip_server>
<sip_server_port>
        5060
</sip_server_port>

The SIP device updates via HTTPS w/ encryption then the field names would directly translate as follows:

<xml>
 <flat-profile>
   <ENC>
      c7fc19404e0b0bcc8885d31f2d8ff7e8e09f0e28......
   </ENC>
 </flat-profile>
 <sessionData>
   <proc>provision</proc>
   <class>OEM</class>
 </sessionData>
</xml>

Step 2: Automatic Firmware Updates

The firmware updating process is accomplished by first grabbing a file "currentversion.txt" and determining from the contents of that file whether it is necessary to download the new firmware.

To begin the Firmware Updating process a HTTP / HTTPS request should be formatted as follows:

https://<SERVER>/firmware/<OEM>/<Model/Make>/currentversion.txt

An Example of this would be: https://aps.sipphone.com/firmware/leadtek/LR8051S/currentversion.txt

Contents Example:

Image_file="some_file_format.bin"
Prom_file="some_other_format.blah"

The device should then determine from the currentversion.txt file whether a firmware update is required. If an update is not required then the device should then continue in the boot process, otherwise the device must download the file from our server.

To download the firmware the format of the request should be like the following:

https://<SERVER>/firmware/<OEM>/<Model/Make>/some_file_format.bin

An Example of this would be: http://aps.sipphone.com/firmware/leadtek/LR8051S/SIP_1.0_US_LDTK_AR15.rom

After the device has downloaded the firmware the device must update, reboot, and return to the beginning of the Auto Provisioning process.