Grandstream Networks GXV-3140 Manuel utilisateur

Grandstream Networks, Inc.

XML Provisioning Guide

GXV3140/GXV3175 IP Multimedia Phone

GXV21XX/GXP14XX Enterprise IP Phone

HT50x Analog Telephone Adapters

GXW40xx FXS Analog IP Gateways

Grandstream Networks, Inc. XML Provisioning Guide Page 2 of 5

www.grandstream.com Last Updated: 7/2011

www.grandstream.com

TABLE OF CONTENTS

XML PROVISIONING GUIDE

OVERVIEW.........................................................................................................................................................3

PROVISIONINGFLOW.........................................................................................................................................3

XMLSCHEMAANDEXAMPLEFILE.......................................................................................................................3

XMLFILEENCRYPTION.......................................................................................................................................4

SECUREPROVISIONING......................................................................................................................................5

TABLE OF FIGURES

XML PROVISIONING GUIDE

FIGURE 1: PROVISIONING FLOW.........................................................................................................................3

FIGURE 2:USING WEB UI TO DEFINE THE XML CONFIGURATION FILE PASSWORD..............................................4

Grandstream Networks, Inc. XML Provisioning Guide Page 3 of 5

www.grandstream.com Last Updated: 7/2011

OVERVIEW

The XML provisioning system allows Grandstream phones to perform configuration updates via XML

configuration files. In addition, the XML provisioning implementation may also allow generic XML

configuration file on top of the MAC based configuration file.

Note: Currently, XML provisioning is supported on the following Grandstream products:

•GXV3140 IP Multimedia Phone

•GXV3175 IP Multimedia Phone

•GXP21XX/GXP14XX Enterprise IP phones

•HT50X Analog Telephone Adapters

•GXW40XX FXS Analog IP Gateways

PROVISIONING FLOW

Figure 1: Provisioning Flow.

The provision program on the phone will apply and reload the settings after downloading the legacy

binary cfgMAC config file. This means that a provision/re-direction server can redirect the device to a XML

provision server without reboot. It can also be used to send the XML encryption password.

XML SCHEMA AND EXAMPLE FILE

The general XML syntax consists of a list of name-value pairs. P-Value is the element and the value of

the element is represents the value for that particular configuration that the corresponding P-Value

represents. For the complete P-value list, please refer to the legacy configuration templates at

http://www.grandstream.com/index.php/support/tools

Example XML configuration file (cfgxxxxxxxxxxxx.xml):

<?xml version="1.0" encoding="UTF-8" ?>

Start

provisioning

Request

legacy

configfile

cfgMAC

Parseand

applynew

configurations

Parseand

applynew

configurations

RequestXML

config file

cfgMAC.xml

Done

Grandstream Networks, Inc. XML Provisioning Guide Page 4 of 5

www.grandstream.com Last Updated: 7/2011

<gs_provision version="1">

<P270>Account name</P270>

</config>

</gs_provision>

The mac element is not mandatory. It is designed this way because not all provision systems support

MAC address. If it is present, the provision program will validate the mac element with the actual MAC

address on the device.

XML FILE ENCRYPTION

The XML configuration file may be encrypted using AES-256-CBC algorithm. The encryption password is

defined in P1359 (XML Config File Password) of the configuration file. The encryption may use salt to

enhance security. The algorithm to derive the key and IV from a password is the same as the one used

by OpenSSL:

The OpenSSL command-line to encrypt the file is as follows:

Openssl enc –e –aes-256-cbc –k password –in config.xml –out cfgxxxxxxxxxxxx.xml

Alternatively, users can also set the XML Config File Password in the web UI of the phone.

Figure 2: Using web UI to define the XML Configuration File Password

When the XML configuration file is encrypted using this method, the phone would only be able to decrypt

and parse the file if user set the XML Config File Password in P1349 of binary configuration file or in the

web UI.

Grandstream Networks, Inc. XML Provisioning Guide Page 5 of 5

www.grandstream.com Last Updated: 7/2011

SECURE PROVISIONING

Although the XML config file can be encrypted and the encryption algorithm itself is regarded as safe and

strong by using AES with 256-bit key length, it remains a question on how to bootstrap and provision the

initial XML encryption password. There are several methods to provide solutions to this:

1. Use legacy binary config file to set the initial XML encryption password. The legacy binary file is

encrypted and it generally regarded safe.

2. Use HTTPS and use client side authentication. This is the industry standard approach and has

the strongest safety.

Autres manuels pour GXV-3140

Ce manuel convient aux modèles suivants

Table des matières

Autres manuels Grandstream Networks Téléphone

Grandstream Networks

Grandstream Networks GXV3350 Manuel utilisateur

Grandstream Networks

Grandstream Networks GXP2135 Manuel utilisateur

Grandstream Networks

Grandstream Networks GXV3470 Manuel utilisateur

Grandstream Networks

Grandstream Networks GXP2160 Manuel utilisateur

Grandstream Networks

Grandstream Networks HT802 Manuel utilisateur

Grandstream Networks

Grandstream Networks Grandstream GXP-2000 Manuel utilisateur

Grandstream Networks

Grandstream Networks GXV3370 Manuel utilisateur

Grandstream Networks

Grandstream Networks BudgeTone 101 Manuel utilisateur

Grandstream Networks

Grandstream Networks GXP2110 Manuel utilisateur

Grandstream Networks

Grandstream Networks WP820 Instructions d'utilisation et de sécurité

Grandstream Networks

Grandstream Networks GXV3380 Manuel

Grandstream Networks

Grandstream Networks GXV-3000 Manuel utilisateur

Grandstream Networks

Grandstream Networks GXP2130v2 Manuel utilisateur

Grandstream Networks

Grandstream Networks GXP2130 Series Manuel utilisateur

Grandstream Networks

Grandstream Networks GXP2124 Manuel utilisateur

Grandstream Networks

Grandstream Networks GXP1450 Manuel

Grandstream Networks

Grandstream Networks UCM6510 Manuel utilisateur

Grandstream Networks

Grandstream Networks GXP2130 Series Manuel utilisateur

Grandstream Networks

Grandstream Networks GHP610 Manuel utilisateur

Grandstream Networks

Grandstream Networks GHP620/W Manuel utilisateur

Grandstream Networks

Grandstream Networks GXV3350 Mode d’emploi

Grandstream Networks

Grandstream Networks GXV 3006 Manuel utilisateur

Grandstream Networks

Grandstream Networks GXP1628 Manuel utilisateur

Grandstream Networks

Grandstream Networks GXV3275 Manuel utilisateur

Manuels Téléphone populaires d'autres marques

GE 2-9480 Manuel utilisateur

Geemarc

Geemarc PHOTOPHONE 155 Manuel utilisateur

D-Link

D-Link DWR-720/PW Manuel utilisateur

Interquartz

Interquartz Gemini IQ333 Manuel utilisateur

SSS Siedle

SSS Siedle HT 840-0 Manuel utilisateur

Motorola

Motorola TITANIUM Manuel utilisateur

Panasonic

Panasonic ICX Manuel utilisateur

LG H870DS Manuel utilisateur

Samsung

Samsung GT-I9500 Manuel utilisateur

AT&T

AT&T Trimline 205 Manuel utilisateur

Selta

Selta zenyth 600 Manuel utilisateur

Doro

Doro AFTI 20 Manuel utilisateur

UNIQCELL

UNIQCELL A1 Manuel utilisateur

Panasonic

Panasonic KX Series Manuel utilisateur

Jabra

Jabra SP5050 - Bluetooth hands-free Speakerphone Manuel utilisateur

BT Decor 425 Manuel utilisateur

NEC

NEC SV8500 Manuel utilisateur

Teledex

Teledex PEARL Manuel utilisateur