Ip Phone Configuration Profiles - Cisco Small Business SPA509G Administration Manual

Provisioning Basics

IP Phone Configuration Profiles

IP Phone Configuration Profiles
Cisco Small Business SPA300 Series, SPA500 Series, and WIP310 IP Phone Administration Guide
tftp://192.168.1.5/spa525.cfg
The IP phone configuration profile defines the parameter values for a specific
device. The configuration profile can be used in two formats:
• Open (XML-style) format
• Proprietary, plain-text format
The XML-style format lets you use standard tools to compile the parameters and
values. To protect confidential information contained in the configuration profile,
this type of file is generally delivered from the provisioning server to the IP phone
over a secure channel provided by HTTPS.
The XML file consists of a series of elements (one per configuration parameter),
encapsulated within the element tags <flat-profile> ... </flat-profile>. The
encapsulated elements specify values for individual parameters. The following is
an example of a valid XML profile:
<flat-profile>
<Admin_Passwd>some secret</Admin_Passwd>
<Upgrade_Enable>Yes</Upgrade_Enable>
</flat-profile>
The names of parameters in XML profiles can generally be inferred from the Cisco
IP phones configuration web pages, by substituting underscores (_) for spaces
and other control characters. Further, to distinguish between Lines 1, 2, 3, and 4,
corresponding parameter names are augmented by the strings _1_, _2_, _3_, and
_4_. For example, Line 1 Proxy is named Proxy_1_ in XML profiles.
The plain-text configuration file uses a proprietary format, which can be encrypted
to prevent unauthorized use of confidential information. By convention, the profile
is named with the extension .cfg (for example, spa504.cfg). The Cisco SIP Profile
Compiler (SPC) tool is provided for compiling the plain-text file containing
parameter-value pairs into an encrypted CFG file. The SPC tool is available from
Cisco for the Win32 environment (spc.exe) and Linux-i386-elf environment (spc-
linux-i386-static). Availability of the SPC tool for the OpenBSD environment is
available on a case-by-case basis.
6
169