Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Section
Panel
titleColor#F85404
titleBGColor#F0F0F0
titleRedirection server

When the VoIP phone contacts the Gigaset server, in order to get all the necessary configuration data, the redirection server supplies the URL of the provisioning server which is responsible for providing the VoIP phone with the provider data (SIP account).

To enable auto-provisioning (i.e. the end-user does not need to select the provider manually) the provisioner must add the redirection information for the VoIP phones to the redirection database.

Access is secured via HTTP digest 12 digits username and MAC-ID.

Panel
titleColor#F85404
titleBGColor#F0F0F0
titleSetting up redirection information using the web-interface
Section

To add the redirection data to the redirection database, Gigaset provides a web user interface for provisioners.

You need a user account (user name and password) which has to be provided by Gigaset Communications.

1. Open the web user interface:

http://prov.gigaset.net or https://prov.gigaset.net/Editor/#loginPage


2. Login using the user name and password provided by Gigaset.

Section

3. Select the option Redirect portal.

Section

The main menu is opened. The following functions are available:

  • Registration, control and deregistration of single devices
  • Display of devices list
  • Upload of prepared XML files
Panel
titleColor#F85404
titleBGColor#F0F0F0
titleRegistering VoIP phones
  • To register a Gigaset VoIP phone, enter the MAC-ID (XXXXXXXXXXXX-XXXX) of the device, the URL of the provisioning server and the Provider for the device configuration.

    URL and Provider can be entered manually or selected from a list of known provisioner URLs and providers.

Example: http://provider.com/xml/%MACD.xml

  • Click on the Register button when to save the entry.

    The corresponding parameters are checked and – if approved – saved in the Gigaset redirection database. The provisioner is informed accordingly.


Info

When using Maxwell 10, connection to the server and loading the XML configuration data takes longer then with other Gigaset devices. The reason is that other Android processes also need to be started after boot.

Connection to Redirect server 50 seconds after boot.

Activate new xml configuration 2 minutes after boot.

Panel
titleColor#F85404
titleBGColor#F0F0F0
titleExample of usage (Based on XML-RPC technique)
Section

Registration of the single device
         

To register a single device you may follow two different scenarios:

  • Manually, by using "Register" tab, as shown.
  • Using XML file of the next structure:
Section
Code Block
languagexml
themeConfluence
firstline1
titleRegistration of the single device
linenumberstrue
<?xml version='1.0'?>
<methodCall>
  <methodName>autoprov.registerDevice</methodName>
    <params>
     <param>
	 <value>
	   <string>7C2F80820EC0-55DF</string>
	 </value>
	 </param>
	 <param>
	 <value>
		<string>http://172.29.0.103/plainxml/42/2/xml/7C2F80820EC0.xml</string>
	 </value>
	 </param>
	 <param>
	 <value>
		<string>Daryna</string>
	 </value>
	 </param>
	</params>
</methodCall>
Section

XML template can be find here:


You need to create valid XML – file in accordance with the provided example, then “Browse” it and “Upload”.  

Section

Next server's answers are possible:

Code Block
languagescala
themeConfluence
firstline1
titleServer's answers
Return value (1) (Boolean) 1 | 0
                           1 = true, 0 = false
Return value (2) (String)
                          if true: OK: password
                          if false: mac_already_in_use
                                    mac_invalid
                                    url_invalid
                                    name_invalid
Section

After successful uploading your XML – file, you will see server response:

Section

Deregistration of a single device
        

You can deregister device with a MAC - ID – address e.g. “7C2F80820EC0” manually, by pressing, “Deregister” button on the left corner of the window:

Section

Usage of XML file instead is also possible:

Code Block
languagexml
themeConfluence
firstline1
titleDeregistration of the single device
linenumberstrue
<?xml version='1.0'?>
<methodCall>
  <methodName>autoprov.deregisterDevice</methodName>
   <params>
    <param>
    <value>
      <string>7C2F80820EC0-55DF</string>
    </value>
    </param>
   </params>
</methodCall>

XML template for the deregistration can be downloaded here:


After XML file was constructed, it is necessary to upload it, in the same way as it was described previously. Different
server's answers are possible:

Code Block
languagescala
themeConfluence
firstline1
titleServer's answers
Return value (1) (Boolean) 1 | 0
                           1 = true, 0 = false
Return value (2) (String)
                           if true: OK
                           if false: mac_not_found
                                     mac_invalid
Section

In our case XML file within MAC-ID were valid and we got next response:

Section

Register device list
Let's assume that at once, you may need to register not a single device, but a list containing several of them,

XML structure for such a case will look like this:

Code Block
languagexml
themeConfluence
firstline1
titleDeregistration of the single device
linenumberstrue
<?xml version='1.0'?>
<methodCall>
  <methodName>autoprov.registerDeviceList</methodName>
   <params>
    <param>
    <value>
      <array>
      <data>
         <value><string>7C2F80820EC0-55DF</string></value>
         <value><string>7C2F80208295-1910</string></value>
     </data>
     </array>
    </value>
    </param>
    <param>
        <value><string>http://172.29.0.103/plainxml/%DVID/xml/%MACD.xml</string></value>
   </param>
    <param>
       <value><string>Daryna</string></value>
   </param>
  </params>
</methodCall>

XML template can be downloaded here:


As previously, several server's answers are possible:

Code Block
languagescala
themeConfluence
firstline1
titleServer's answers
Return value (1) (Boolean) 1 | 0
                           1 = true, 0 = false
Return value (2-n) (String)
                           if true: OK: Password
                           if false: mac_invalid
                                     url_invalid
                                     name_invalid
                                     mac_already_in_use
                                     mac_not_exist
Section
Image Removed

The next picture shows, 'True' server's answer: Image Added


Section
Image RemovedImage Added

An example of real server response after usage of the XML – file with incorrect data (inappropriate MAC-ID was used ):


Section

Deregistration of the list of devices
Let's assume that at once, you may need to deregister not a single device, but a list containing several of them. 

XML structure for such a case will look like this:

Code Block
languagexml
themeConfluence
firstline1
titleDeregistration of the list of devices
linenumberstrue
<?xml version='1.0'?>
<methodCall>
 <methodName>autoprov.deregisterDeviceList</methodName>
   <params>
   <param>
     <value><array>
       <data>
       <value><string>7C2F80820EC0-55DF</string></value>
       <value><string>7C2F80208295-1910</string></value>
       </data>
     </array></value>
   </param>
   </params>
</methodCall>

XML template can be downloaded here:


Next server responds are possible:

Code Block
languagescala
themeConfluence
firstline1
titleServer's answers
Return value (1) (Boolean) 1 | 0
                           1 = true, 0 = false
Return value (2-n) (String)
                           if true: OK
                           if false: mac_invalid
                                     mac_not_found
Section
Image RemovedImage Added

An example of real server respond on the correct XML – file:

Section

An example of real server responds, while only one of the provided MAC – ID was invalid:

Section

List devices
The purpose of this request is to get:

  • MAC – address(es) of the registered device(s);
  • Provider name(s);
  • URL(s);
  • Date(s) of the registration;

General structure of the XML – file for such a case looks like this:

Code Block
languagexml
themeConfluence
firstline1
titleDevices listeng
linenumberstrue
<?xml version='1.0'?>
 <methodCall>
   <methodName>autoprov.listDevices</methodName>
     <params>
     </params>
</methodCall>

XML template can be downloaded here:


As in the previous cases, several server's responses are possible:

Code Block
languagescala
themeConfluence
firstline1
titleServer's answers
Return value (0-n)
             (Object[])
             [MAC,NAME,URL,DATE]

...