key
key
The --key option tells the phone that the configuration file that it receives from the provisioning server is
encrypted with AES-256-CBC encryption, unless the Content-Encoding header in the file indicates "aes128gcm"
encryption. The key itself is specified as a string following the term --key. The key can be enclosed in
double-quotes (") optionally. The phone uses the key to decrypt the configuration file.
Usage Examples
[--key VerySecretValue]
[--key "my secret phrase"]
[--key a37d2fb9055c1d04883a0745eb0917a4]
The bracketed optional arguments are macro expanded. Special purpose parameters, GPP_SA through
GPP_SD, are macro expanded into macro variables, $SA through $SD, only when they are used as
key option arguments. See these examples:
[--key $SC]
[--key "$SD"]
In Open format profiles, the argument to --key must be the same as the argument to the -k option
that is given to openssl.
uid and pwd
The uid and pwd options can be used to specify the userID and password that will be sent in response to
HTTP Basic and Digest authentication challenges when the specified URL is requested. The bracketed optional
arguments are macro expanded. Special purpose parameters, GPP_SA through GPP_SD, are macro expanded
into macro variables, $SA through $SD, only when they are used as key option arguments. See these examples:
GPP_SA = MyUserID
GPP_SB = MySecretPassword
[--uid $SA --pwd $SB] https://provisioning_server_url/path_to_your_config/your_config.xml
would then expand to:
[--uid MyUserID --pwdMySecretPassword]
https://provisioning_server_url/path_to_your_config/your_config.xml
Application of a Profile to the Phone
After you create an XML configuration script, it must be passed to the phone for application. To apply the
configuration, you can either download the configuration file to the phone from a TFTP, HTTP, or HTTPS
server using a web browser or by using cURL command line utility.
Download the Configuration File to the Phone from a TFTP Server
Complete these steps to download the configuration file to a TFTP server application on your PC.
Cisco IP Phone 8800 Series Multiplatform Phone Administration Guide for Release 11.3(1) and Later
86
Cisco IP Phone Provisioning