Cisco SPA921 - - IP Phone Provisioning Manual page 41

Creating Provisioning Scripts
Encrypting a File with the SPC
Cisco Small Business IP Telephony Devices Provisioning Guide
Two algorithms are available for this type of encryption:
• RC4 (--rc4)
• AES (--aes)
In addition, the key can be specified either explicitly as a hexadecimal digit
sequence (--hex-key) or by hashing a secret phrase (--ascii-key). With the --hex-
key option, the key can be up to 256 bits in length. With the --ascii-key option the
generated key is 128 bits.
The following examples illustrate explicit key-based encryption.
spc –-rc4 –-ascii-key apple4sale spa962.txt spa962.cfg
spc –-aes –-ascii-key lucky777 spa962.txt spa962.cfg
spc –-aes –-ascii-key "my secret phrase" spa962.txt spa962.cfg
spc –-aes –-hex-key 8d23fe7...a5c29 spa962.txt spa962.cfg
Any combination of scrambling, targeting, and explicit-key encrypting can be
applied to a CFG file, as shown by the following example:
spc –-target 000e08aaa010 –-aes –-ascii-key VerySecret a.txt a.cfg
After each compilation, SPC prints a final status message. Syntax error messages
are also printed if a compilation is not successful.
The status and error messages printed by SPC are suppressed with the --quiet
command line option. Messages can be redirected to a file with the --log
file_name option. In the latter case, the SPC command itself is also printed in the
log file, preceded by a timestamp.
spc –-quiet . . .
spc –-log prov.log . . .
SPC can also be used to generate sample configuration source files (for both plain
text and XML formats), corresponding to the accompanying firmware release. The
commands for producing sample files are as follows:
# sample plain.txt to be used as source file for eventual spc compilation:
spc –-sample-profile plain.txt
# sample config.xml to be fed directly to a device running 2.0.6 or above:
spc --sample-xml config.xml
2
39