Configure el teléfono para la resincronización del perfil

Resincronización del perfil del teléfono mediante TFTP

El teléfono admite varios protocolos de red para recuperar los perfiles de configuración. El protocolo de transferencia de perfil más básico es TFTP (RFC1350). TFTP se utiliza ampliamente para el aprovisionamiento de dispositivos de red dentro de redes LAN privadas. Aunque no se recomienda para la implementación de extremos remotos a través de Internet, TFTP puede ser conveniente para la implementación dentro de pequeñas organizaciones, para el aprovisionamiento previo interno y para el desarrollo y las pruebas. En el siguiente procedimiento, se modifica un perfil después de descargar un archivo de un servidor TFTP.

1

En un entorno LAN, conecte la computadora y el teléfono a un concentrador, conmutador o router pequeño.

2

En la computadora, instale y active un servidor TFTP.

3

Utilice un editor de texto para crear un perfil de configuración.

Para verificar si el perfil se aprovisionó en el teléfono más tarde, puede establecer algunos de los valores como marcas. Por ejemplo, defina el valor de GPP_A en 12345678 como se muestra en el siguiente ejemplo:
 <perfil plano>   <GPP_A> 12345678   A> </perfil plano>
_
4

Guarde el archivo de configuración XML en el directorio raíz del servidor TFTP.

Puede verificar que el servidor TFTP esté configurado correctamente: solicitar el archivo de perfil de configuración mediante un cliente TFTP que no sea el teléfono. Preferiblemente, utilice un cliente TFTP que se esté ejecutando en un host independiente del servidor de aprovisionamiento.

5

En el navegador web de su computadora, abra la página web de administración. Por ejemplo, suponga que la dirección IP del teléfono es 192.168.1.100; abra la siguiente URL en el navegador web:


http://192.168.1.100/admin/advanced
6

Seleccione la ficha Voz > Aprovisionamiento e inspeccione los valores de los parámetros de uso general GPP_A a GPP_P. Deben estar vacíos.

7

Vuelva a sincronizar el teléfono de prueba con el perfil de configuración que creó al abrir la URL de resincronización en un navegador web.

Ejemplo:

Si la dirección IP del servidor TFTP es 192.168.1.200, el comando debería ser similar al siguiente ejemplo:


http://192.168.1.100/admin/resync?tftp://192.168.1.200/basic.txt

Cuando el teléfono recibe este comando, el dispositivo en la dirección 192.168.1.100 solicita el archivo de perfil de configuración basic.txt del servidor TFTP en la dirección IP 192.168.1.200. Luego, el teléfono analiza el archivo descargado y actualiza el parámetro GPP_A con el valor 12345678.

8

Compruebe que el parámetro se haya actualizado correctamente. Actualice la página web de administración y vaya a Voz > Aprovisionamiento.

El parámetro GPP_A ahora debería contener el valor 12345678.

Aprovisionar un perfil específico de teléfono en un servidor TFTP
1

Obtenga la dirección MAC del teléfono de la etiqueta de producto. (La dirección MAC es el número, con números y dígitos hexadecimales en minúsculas, por ejemplo, 000e08aabbcc.

2

Cambie el nombre de su archivo de configuración a CP-xxxx macaddress.cfg (reemplace xxxx por el número de modelo y macaddress por la dirección MAC del teléfono).

Ejemplo:

CP-8875 000e08aabbcc.cfg

3

Mueva el archivo nuevo al directorio raíz virtual del servidor TFTP.

4

Acceda a la página web de administración del teléfono.

5

Seleccione Voz  > Aprovisionamiento.

6

Introduzca la ruta del archivo de perfil en el campo Regla del perfil .

Ejemplo: Suponga que la dirección IP del servidor TFTP es 192.168.1.200 y que el nombre del archivo de perfil es 

 <Profile_Rule> tftp://192.168.1.200/CP-8875$MA.cfg Rule>
rofile_
7

Haga clic en Enviar todos los cambios. Esto provoca un reinicio y una resincronización inmediatos.

Cuando se produce la próxima resincronización, el teléfono recupera el archivo nuevo expandiendo la expresión de macro $MA a su dirección MAC.

Resincronización del perfil del teléfono con HTTP GET
1

Instale un servidor HTTP en la computadora local o en otro host accesible.

El servidor Apache de código abierto se puede descargar desde Internet.

2

Cargue el archivo de perfil de configuración en el directorio raíz virtual del servidor instalado.

3

Para verificar la instalación correcta del servidor y el acceso al archivo de perfil, abra el perfil con un navegador web.

4

Modifique la Profile_Rule (Regla P) del teléfono de prueba para que apunte al servidor HTTP en lugar del servidor TFTP para descargar su perfil periódicamente.

Por ejemplo, si el servidor HTTP está en 192.168.1.300 y el nombre del archivo del perfil es basic.txt, ingrese el siguiente valor:

<Profile_Regla> http://192.168.1.200/basic.txt Regla>
rofile_
5

Haga clic en Enviar todos los cambios. Esto provoca un reinicio y una resincronización inmediatos.

6

Observe los mensajes syslog que envía el teléfono. Las resincronizaciones periódicas deberían obtener el perfil del servidor HTTP.

7

En los registros del servidor HTTP, observe cómo la información que identifica al teléfono de prueba aparece en el registro de los agentes del usuario.

Esta información debe incluir el fabricante, el nombre del producto, la versión actual de firmware y el número de serie.

Resincronizar automáticamente el perfil del teléfono

Un dispositivo puede resincronizarse periódicamente con el servidor de aprovisionamiento para garantizar que cualquier cambio de perfil realizado en el servidor se propague al dispositivo del extremo (en lugar de enviar una solicitud de resincronización explícita al extremo).

Para hacer que el teléfono se resincronice periódicamente con un servidor, se define una URL de perfil de configuración mediante el parámetro Profile_Regla, y un período de resincronización mediante el parámetro Resync_Periodic.

1

Acceda a la página web de administración del teléfono.

2

Seleccione Voz  > Aprovisionamiento.

3

Defina el parámetro Profile_Regla. En este ejemplo se supone que la dirección IP del servidor TFTP es 192.168.1.200.

4

En el campo Resincronización periódica , introduzca un valor pequeño para la prueba, como 30 segundos.

5

Haga clic en Enviar todos los cambios.

Con la nueva configuración de parámetros, el teléfono se resincroniza dos veces por minuto con el archivo de configuración que especifica la URL.

6

Observe los mensajes resultantes en el seguimiento de syslog.

7

Asegúrese de que el campo Resincronización al restablecer esté definido en Sí.

 <Resync_On_Reset>SíOn_Reset>
esync_
8

Reinicie el teléfono para forzar la resincronización con el servidor de aprovisionamiento.

Si la operación de resincronización falla por cualquier motivo, como si el servidor no responde, la unidad espera (durante la cantidad de segundos configurada en Demora de reintento de error de resincronización) antes de intentar volver a sincronizar. Si la demora de reintento de error de resincronización es cero, el teléfono no intenta resincronizarse después de un intento fallido de resincronización.

9

(Opcional) Defina el valor del campo Demora de reintento de error de resincronización en un número pequeño, como 30.

 <Resync_Error_Retry_Delay>30Error_Retry_Delay>
esync_
10

Desactive el servidor TFTP y observe los resultados en la salida de syslog.

Parámetros de resincronización del perfil

En la siguiente tabla, se definen la función y el uso de los parámetros de resincronización del perfil en la sección Perfil de configuración en la pestaña Voz > Aprovisionamiento en la página web del teléfono. También define la sintaxis de la cadena que se agrega al archivo de configuración del teléfono (cfg.xml) con código XML para configurar un parámetro.

Tabla 1. Parámetros de resincronización del perfil

Parámetro

Descripción

Habilitación de aprovisionamiento

Permite o rechaza las acciones de resincronización del perfil de configuración.

  • En el archivo de configuración del teléfono (cfg.xml) con XML, ingrese una cadena con este formato:

    <Provision_Enable ua="na">SíEnable>rovision_

  • En la página web del teléfono, establezca este campo en Sí para permitir las acciones de resincronización, o No para bloquear las acciones de resincronización.

Predeterminado: Sí

Resincronización al restablecer

Especifica si el teléfono vuelve a sincronizar la configuración con el servidor de aprovisionamiento después del encendido y después de cada intento de actualización.

  • En el archivo de configuración del teléfono (cfg.xml) con XML, ingrese una cadena con este formato:

    <Resync_On_Reset ua="na">SíOn_Reset>esync_

  • En la página web del teléfono, configure este campo en Sí para permitir la resincronización durante el encendido o el restablecimiento, o No para bloquear la resincronización durante el encendido o el restablecimiento.

Predeterminado: Sí

Intervalo aleatorio de resincronización

Evita una sobrecarga del servidor de aprovisionamiento cuando se enciende una gran cantidad de dispositivos simultáneamente e intenta la configuración inicial. Este retraso solo es efectivo en el intento de configuración inicial después de encender o restablecer el dispositivo.

El parámetro es el intervalo de tiempo máximo que el dispositivo espera antes de establecer contacto con el servidor de aprovisionamiento. El intervalo real es un número pseudoaleatorio entre 0 y este valor.

Este parámetro está en unidades de 20 segundos.

El valor válido oscila entre 0 y 65535.

  • En el archivo de configuración del teléfono (cfg.xml) con XML, ingrese una cadena con este formato:

    <Resync_Random_Delay ua="na">2Random_Delay>esync_

  • En la página web del teléfono, especifique el número de unidades (20 segundos) en las que el teléfono demorará la resincronización después del encendido o el restablecimiento.

El valor predeterminado es 2 (40 segundos).

Resincronización En (HHmm)

Hora (HHmm) en la que el teléfono vuelve a sincronizarse con el servidor de aprovisionamiento.

El valor de este campo debe ser un número de cuatro dígitos entre 0000 y 2400 para indicar la hora en formato HHmm. Por ejemplo, 0959 indica 09:59.

  • En el archivo de configuración del teléfono (cfg.xml) con XML, ingrese una cadena con este formato:

    <Resync_At__HHmm_ ua="na">0959At__HHmm_>esync_

  • En la página web del teléfono, especifique la hora en formato HHMM para que el teléfono inicie la resincronización.

El valor predeterminado es vacío. Si el valor no es válido, el parámetro será ignorado. Si este parámetro se establece con un valor válido, el parámetro Resync Periodic (Resincronización periódica) será ignorado.

Resincronización A Demora Aleatoria

Evita una sobrecarga del servidor de aprovisionamiento cuando se enciende una gran cantidad de dispositivos simultáneamente.

Para evitar la acumulación de solicitudes de resincronización al servidor de varios teléfonos, el teléfono se resincroniza en el intervalo entre las horas y los minutos, y las horas y los minutos más el intervalo aleatorio (hhmm, hhmm+random_delay). Por ejemplo, si el intervalo aleatorio es igual a (Resync At Random Delay + 30)/60 minutos, el valor de entrada en segundos se convierte en minutos y se redondea hasta el minuto siguiente para calcular el random_delay intervalo final.

  • En el archivo de configuración del teléfono (cfg.xml) con XML, ingrese una cadena con este formato:

    <Resync_At_Random_Delay ua="na">600At_Random_Delay>esync_

  • En la página web del teléfono, especifique el período de tiempo en segundos.

El valor válido oscila entre 600 y 65535.

Si el valor es menor que 600, el intervalo interno aleatorio está entre 0 y 600.

El valor predeterminado es de 600 segundos (10 minutos).

Resincronización periódica

El intervalo de tiempo entre la resincronización periódica con el servidor de aprovisionamiento. El temporizador de resincronización asociado solo está activo después de la primera sincronización exitosa con el servidor.

Los formatos válidos son los siguientes:

  • Un número entero

    Ejemplo: Una entrada de 3000 indica que la próxima resincronización ocurrirá en 3000 segundos.

  • Varios números enteros

    Ejemplo: Una entrada de 600.1200.300 indica que la primera resincronización ocurre en 600 segundos, la segunda 1200 segundos después de la primera y la tercera 300 segundos después de la segunda.

  • Un intervalo de tiempo

    Por ejemplo, una entrada de 2400+30 indica que la próxima resincronización ocurrirá entre 2400 y 2430 segundos después de una resincronización exitosa.

  • En el archivo de configuración del teléfono (cfg.xml) con XML, ingrese una cadena con este formato:

    <Resync_Periodic ua="na">3600Periodic>esync_

  • En la página web del teléfono, especifique el período de tiempo en segundos.

Establezca este parámetro en cero para deshabilitar la resincronización periódica.

El valor predeterminado es de 3600 segundos.

Demora de reintento por error de resincronización

Si una operación de resincronización falla porque el teléfono no pudo recuperar un perfil del servidor, porque el archivo descargado está dañado o porque se produce un error interno, el teléfono intenta resincronizarse después de un tiempo especificado en segundos.

Los formatos válidos son los siguientes:

  • Un número entero

    Ejemplo: Una entrada de 300 indica que la próxima resincronización ocurrirá en 300 segundos.

  • Varios números enteros

    Ejemplo: Una entrada de 600.1200.300 indica que la primera repetición se produce 600 segundos después de la falla, la segunda repetición se produce 1200 segundos después de la falla del primer intento y la tercera repetición se produce 300 segundos después de la falla del segundo intento.

  • Un intervalo de tiempo

    Por ejemplo, una entrada de 2400+30 indica que la próxima repetición se produce entre 2400 y 2430 segundos después de una falla en la resincronización.

Si el retraso se establece en 0, el dispositivo no intenta resincronizarse después de un intento fallido de resincronización.

  • En el archivo de configuración del teléfono (cfg.xml) con XML, ingrese una cadena con este formato:

    <Resync_Error_Retry_Delay ua="na">60,120,240,480,960,1920,3840,7680,15360,30720,61440,86400Error_Retry_Delay>esync_

  • En la página web del teléfono, especifique el período de tiempo en segundos.

Predeterminado: 60,120,240,480,960,1920,3840,7680,15360,30720,61440,86400

Demora de resincronización forzada

Demora máxima (en segundos) que el teléfono espera antes de realizar una resincronización.

El dispositivo no se resincroniza mientras una de sus líneas telefónicas está activa. Dado que una resincronización puede demorar varios segundos, es deseable esperar hasta que el dispositivo haya estado inactivo durante un período prolongado antes de la resincronización. Esto permite que el usuario realice llamadas sucesivas sin interrupciones.

El dispositivo tiene un temporizador que comienza a contar hacia abajo cuando todas sus líneas están inactivas. Este parámetro es el valor inicial del contador. Los eventos de resincronización se retrasan hasta que este contador disminuya a cero.

El valor válido oscila entre 0 y 65535.

  • En el archivo de configuración del teléfono (cfg.xml) con XML, ingrese una cadena con este formato:

    <Forced_Resync_Delay ua="na">14400Resync_Delay>orced_

  • En la página web del teléfono, especifique el período de tiempo en segundos.

El valor predeterminado es de 14 400 segundos.

Resincronización desde SIP

Controla las solicitudes de operaciones de resincronización a través de un evento SIP NOTIFY enviado desde el servidor proxy del proveedor de servicios al teléfono. Si está habilitado, el proxy puede solicitar una resincronización mediante el envío de un mensaje SIP NOTIFY que contenga el evento: el encabezado de resincronización con el dispositivo.

  • En el archivo de configuración del teléfono (cfg.xml) con XML, ingrese una cadena con este formato:

    <Resync_From_SIP ua="na">SíFrom_SIP>esync_

  • En la página web del teléfono, seleccione Sí para habilitar esta función, o No para deshabilitarla.

Predeterminado: Sí

Resincronización después del intento de mejora

Habilita o deshabilita la operación de resincronización después de que se produce una mejora. Si se selecciona Sí , la sincronización se activa después de una actualización de firmware.

  • En el archivo de configuración del teléfono (cfg.xml) con XML, ingrese una cadena con este formato:

    <Resync_After_Upgrade_Attempt ua="na">SíAfter_Upgrade_Attempt>esync_

  • En la página web del teléfono, seleccione Sí para activar la resincronización después de una actualización de firmware, o No para no volver a sincronizar.

Predeterminado: Sí

Activador de resincronización 1

Activador de resincronización 2

Si la ecuación lógica en estos parámetros se evalúa como FALSA, la resincronización no se activa incluso cuando la opción Resincronización al restablecer se establece en VERDADERA. Solo la resincronización a través de una URL de acción directa y de la notificación SIP ignora estos activadores de resincronización.

Los parámetros se pueden programar con una expresión condicional que se somete a expansión de macros. Para ver las expansiones de macros válidas, consulte Variables de expansión de macros en Parámetros de aprovisionamiento.

  • En el archivo de configuración del teléfono (cfg.xml) con XML, ingrese una cadena con este formato:

    <Resync_Trigger_1 ua="na">$UPGTMR gt 300 y $PRVTMR ge 600Trigger_1>esync_

    <Resync_Trigger_2 ua="na"/>

  • En la página web del teléfono, especifique los desencadenantes.

Predeterminado: En blanco

Resincronización configurable por el usuario

Permite que un usuario resincronice el teléfono desde el menú de la pantalla del teléfono. Cuando se establece en Sí, un usuario puede resincronizar la configuración del teléfono al introducir la regla del perfil desde el teléfono. Cuando se establece en No, el parámetro Regla perfil no se muestra en el menú de la pantalla del teléfono.

  • En el archivo de configuración del teléfono (cfg.xml) con XML, ingrese una cadena con este formato:

    <User_Configurable_Resync ua="na">SíConfigurable_Resync>ser_

  • En la página web del teléfono, seleccione Sí para mostrar el parámetro Regla de perfil en el menú del teléfono, o seleccione No para ocultar este parámetro.

Predeterminado: Sí

Falla la resincronización en FNF

Por lo general, una resincronización se considera incorrecta si no se recibe un perfil solicitado del servidor. Este parámetro anula este comportamiento. Cuando se establece en No, el dispositivo acepta una respuesta de archivo no encontrado del servidor como una resincronización exitosa.

  • En el archivo de configuración del teléfono (cfg.xml) con XML, ingrese una cadena con este formato:

    <Resync_Fails_On_FNF ua="na">SíFails_On_FNF>esync_

  • En la página web del teléfono, seleccione Sí para tomar una respuesta de archivo no encontrado como una resincronización incorrecta, o seleccione No para tomar una respuesta de archivo no encontrado como una resincronización exitosa.

Predeterminado: Sí

Tipo de autenticación del perfil

Especifica las credenciales que se utilizarán para la autenticación de la cuenta del perfil. Las opciones disponibles son las siguientes:

  • Disabled (Deshabilitada): Deshabilita la característica de la cuenta del perfil. Cuando esta característica está desactivada, el menú Configuración de la cuenta del perfil no se muestra en la pantalla del teléfono.

  • Autenticación HTTP básica: Las credenciales de inicio de sesión HTTP se utilizan para autenticar la cuenta del perfil.

  • Autenticación de XSI: Las credenciales de inicio de sesión XSI o las credenciales SIP XSI se utilizan para autenticar la cuenta del perfil. Las credenciales de autenticación dependen del Tipo de autenticación XSI para el teléfono:

    • Cuando el Tipo de autenticación XSI para el teléfono se establece en Credenciales de inicio de sesión, se utilizan las credenciales de inicio de sesión XSI.

    • Cuando el Tipo de autenticación XSI para el teléfono se establece en Credenciales SIP, se utilizan las credenciales SIP XSI.

  • En el archivo de configuración del teléfono (cfg.xml) con XML, ingrese una cadena con este formato:

    <Profile_Authentication_Type ua="na">Autenticación Http básicaAuthentication_Type>rofile_

  • En la página web del teléfono, seleccione una opción de la lista para que el teléfono autentique la resincronización del perfil.

Predeterminado: Autenticación HTTP básica

Para obtener más información, consulte Especificar el tipo de autenticación del perfil en Especificar el teléfono para la resincronización del perfil.

Regla del perfil

Regla del perfil B

Regla del perfil C

Regla del perfil D

Cada regla de perfil informa al teléfono de una fuente desde la que obtener un perfil (archivo de configuración). Durante cada operación de resincronización, el teléfono aplica todos los perfiles en secuencia.

Si está aplicando el cifrado AES-256-CBC a los archivos de configuración, especifique la clave de cifrado con la palabra clave --key de la siguiente manera:

[--key ]

Opcionalmente, puede incluir la clave de cifrado entre comillas dobles (").

  • En el archivo de configuración del teléfono (cfg.xml) con XML, ingrese una cadena con este formato:

    <Profile_Regla ua="na">/$PSN.xmlRegla>rofile_

    <Profile_Rule_B ua="na"/>

    <Profile_Rule_C ua="na"/>

    <Profile_Rule_D ua="na"/>

  • En la página web del teléfono, especifique la regla del perfil.

Valor predeterminado: /$PSN.xml

Opción DHCP para utilizar

Las opciones de DHCP, delimitadas por comas, se utilizan para recuperar firmware y perfiles.

Predeterminado: 66,160,159,150,60,43,125

Opción DHCPv6 para utilizar

Las opciones de DHCP, delimitadas por comas, se utilizan para recuperar firmware y perfiles.

Predeterminado: 17,160,159

Aprovisionamiento a través de XML de Cisco

Puede aprovisionar teléfonos mediante funciones XML de Cisco.

Puede enviar un objeto XML al teléfono mediante un paquete SIP Notify o un HTTP POST a la interfaz CGI del teléfono: http://PhoneIPAddress/CGI/Execute.

El CP-xxxx-3PCC amplía la función XML de Cisco para admitir el aprovisionamiento a través de un objeto XML:

 <CP-xxxx-3PCCExecute> <ExecuteItem URL=Resync:[profile-rule]/> </CP-xxxx-3PCCExecute>

Después de que el teléfono recibe el objeto XML, descarga el archivo de aprovisionamiento de [profile-rule]. Esta regla utiliza macros para simplificar el desarrollo de la aplicación de servicios XML.

Resolución de URL con expansión de macros

Los subdirectorios con varios perfiles en el servidor proporcionan un método práctico para administrar una gran cantidad de dispositivos implementados. La URL del perfil puede contener:

  • Un nombre de servidor de aprovisionamiento o una dirección IP explícita. Si el perfil identifica el servidor de aprovisionamiento por el nombre, el teléfono realiza una búsqueda de DNS para resolver el nombre.

  • Un puerto de servidor no estándar que se especifica en la URL mediante la sintaxis estándar :puerto que sigue al nombre del servidor.

  • El subdirectorio del directorio raíz virtual del servidor donde se almacena el perfil, que se especifica mediante la notación de URL estándar y se administra mediante la expansión de macros.

Por ejemplo, la siguiente Profile_Rule solicita el archivo de perfil ($PN.cfg), en el subdirectorio del servidor /cisco/config, del servidor TFTP que se está ejecutando en el host prov.telco.com que escucha una conexión en el puerto 6900: 

 <Profile_Rule> tftp://prov.telco.com:6900/cisco/config/$PN.cfg Rule>
rofile_

Se puede identificar un perfil para cada teléfono en un parámetro de uso general, con su valor mencionado en una regla de perfil común mediante la expansión de macros.

Por ejemplo, suponga que GPP_B se define como Dj6Lmp23Q.

La Profile_Rule tiene el valor:

 tftp://prov.telco.com/cisco/$B/$MA.cfg

Cuando el dispositivo se resincroniza y las macros se expanden, el teléfono con una dirección MAC de 000e08012345 solicita el perfil con el nombre que contiene la dirección MAC del dispositivo en la siguiente URL:

 tftp://prov.telco.com/cisco/dj6lmp23Q/000e08012345.cfg
Especificar el tipo de autenticación del perfil

La autenticación de perfil permite que los usuarios del teléfono vuelvan a sincronizar el perfil de aprovisionamiento en el teléfono. La información de autenticación es necesaria mientras el teléfono intenta volver a sincronizar y descargar el archivo de configuración por primera vez y recibe un error de autenticación HTTP o HTTPS 401. Cuando habilita esta función, se muestra la pantalla Configuración de la cuenta del perfil en el teléfono para las siguientes situaciones:

  • Cuando se produce el error de autenticación HTTP o HTTPs 401 durante el primer aprovisionamiento después de reiniciar el teléfono

  • Cuando el nombre de usuario y la contraseña de la cuenta del perfil están vacíos

  • Cuando no hay un nombre de usuario y una contraseña en la regla perfil

Si se omite o se ignora la pantalla Configuración de la cuenta del perfil , el usuario también puede acceder a la pantalla de configuración a través del menú de la pantalla del teléfono o la tecla programable Configuración , que se muestra solo cuando no se registra ninguna línea en el teléfono.

Cuando deshabilita la función, la pantalla Configuración de la cuenta del perfil no se muestra en el teléfono.

El nombre de usuario y la contraseña en el campo Regla del perfil tienen una prioridad más alta que la cuenta del perfil.

  • Cuando proporciona una URL correcta en el campo Regla del perfil sin un nombre de usuario y una contraseña, el teléfono requiere autenticación o resumen para volver a sincronizar el perfil. Con la cuenta del perfil correcta, la autenticación pasa. Con una cuenta de perfil incorrecta, la autenticación falla.

  • Cuando proporciona una URL correcta en el campo Regla del perfil con un nombre de usuario y una contraseña correctos, el teléfono requiere autenticación o resumen para volver a sincronizar el perfil. La cuenta del perfil no se utiliza para la resincronización del teléfono. El inicio de sesión se ha realizado correctamente.

  • Cuando proporciona una URL correcta en el campo Regla del perfil con un nombre de usuario y una contraseña incorrectos, el teléfono requiere autenticación o resumen para volver a sincronizar el perfil. La cuenta del perfil no se utiliza para la resincronización del teléfono. El inicio de sesión siempre falla.

  • Cuando proporciona una URL incorrecta en el campo Regla del perfil , el inicio de sesión siempre falla.

También puede configurar los parámetros en el archivo de configuración del teléfono con código XML(cfg.xml).

Puede especificar el tipo de autenticación del perfil en la página web de administración del teléfono.

1

Acceda a la página web de administración del teléfono.

2

Seleccione Voz > Aprovisionamiento.

3

En la sección Perfil de configuración , defina el parámetro Tipo de autenticación de perfil para especificar las credenciales que se utilizarán para la autenticación de la cuenta del perfil.

Puede configurar este parámetro en el archivo XML de configuración del teléfono (cfg.xml) si ingresa una cadena con este formato:

<Profile_Authentication_Type ua="na">DeshabilitadoAuthentication_Type>
rofile_

Opciones:

  • Disabled (Deshabilitada): Deshabilita la característica de la cuenta del perfil. Cuando esta característica está deshabilitada, el menú Configuración de la cuenta del perfil no se muestra en la pantalla del teléfono.

  • Autenticación HTTP básica: Las credenciales de inicio de sesión HTTP se utilizan para autenticar la cuenta del perfil.

  • Autenticación de XSI: Las credenciales de inicio de sesión XSI o las credenciales SIP XSI se utilizan para autenticar la cuenta del perfil. Las credenciales de autenticación dependen del Tipo de autenticación XSI para el teléfono:

    Cuando el Tipo de autenticación XSI para el teléfono se establece en Credenciales de inicio de sesión, se utilizan las credenciales de inicio de sesión XSI.

    Cuando el Tipo de autenticación XSI para el teléfono se establece en Credenciales SIP, se utilizan las credenciales SIP XSI.

Predeterminado: Autenticación HTTP básica

4

Haga clic en Enviar todos los cambios.

Aplicar manualmente un perfil a su teléfono

Descargar el archivo de configuración al teléfono desde un servidor TFTP

Siga estos pasos para descargar el archivo de configuración en una aplicación de servidor TFTP en su PC.

1

Conecte la computadora al puerto LAN del teléfono.

2

Ejecute una aplicación de servidor TFTP en la computadora y asegúrese de que el archivo de configuración esté disponible en el directorio raíz TFTP.

3

En un navegador web, ingrese la dirección IP LAN del teléfono, la dirección IP de la computadora, el nombre de archivo y las credenciales de inicio de sesión. Utilice este formato:

http://<Dirección IP_WAN_>/admin/resync?tftp://<Dirección IP_PC_>/<file_name>&xuser=admin&xpassword=

Ejemplo: 

http://192.168.15.1/admin/resync?tftp://192.168.15.100/my_config.xml&xuser=admin&xpassword=admin
Descargar el archivo de configuración al teléfono con cURL

Siga estos pasos para descargar la configuración en el teléfono mediante cURL. Esta herramienta de línea de comandos se utiliza para transferir datos con una sintaxis de URL. Para descargar cURL, visite:

https://curl.haxx.se/download.html

Le recomendamos que no utilice cURL para publicar la configuración en el teléfono porque es posible que el nombre de usuario y la contraseña se capturen mientras utiliza cURL.

1

Conecte la computadora al puerto LAN del teléfono.

2

Para descargar el archivo de configuración en el teléfono, ingrese el siguiente comando cURL:

curl –d @my_config.xml “http://192.168.15.1/admin/config.xml&xuser=admin&xpassword=admin”

Perfiles de configuración

El teléfono acepta configuraciones en formato XML.

Los ejemplos de esta sección utilizan perfiles de configuración con sintaxis XML.

Formatos de perfil de configuración

El perfil de configuración define los valores de los parámetros del teléfono.

El formato XML del perfil de configuración utiliza herramientas de creación de XML estándar para compilar los parámetros y valores.

Solo se admite el conjunto de caracteres UTF-8. Si modifica el perfil en un editor, no cambie el formato de codificación; de lo contrario, el teléfono no podrá reconocer el archivo.

Cada teléfono tiene un conjunto de funciones diferente y, por lo tanto, un conjunto de parámetros diferente.

Formato de perfil abierto

El perfil de formato abierto es un archivo de texto con sintaxis similar a XML en una jerarquía de elementos, con atributos y valores de elementos. Este formato le permite utilizar herramientas estándares para crear el archivo de configuración. Se puede enviar un archivo de configuración XML desde el servidor de aprovisionamiento al teléfono durante una operación de resincronización, sin compilación como objeto binario.

El teléfono puede aceptar formatos de configuración que generan las herramientas estándares. Esta función facilita el desarrollo de software de servidor de aprovisionamiento back-end que genera perfiles de configuración a partir de bases de datos existentes.

Para proteger la información confidencial del perfil de configuración, el servidor de aprovisionamiento entrega el archivo de configuración XML al teléfono a través de un canal protegido por TLS. Opcionalmente, el archivo se puede comprimir mediante el algoritmo deflate de gzip (RFC ).

El archivo se puede cifrar con uno de estos métodos de cifrado:

  • Cifrado AES-256-CBC

  • Cifrado de contenido HTTP basado en RFC-8188 con cifrado AES-128-GCM

Un archivo de configuración puede incluir estos componentes:

  • Etiquetas de elemento

  • Atributos

  • Parámetros

  • Características de formato

  • Comentarios XML

Ejemplo: Formato de perfil abierto

 <flat-profile> <Resync_On_Reset> Sí On_Reset> <Resync_Periodic> 7200 Periodic> <Profile_Rule> tftp://prov.telco.com:6900/cisco/config/CP_xxxx_MPP.cfgRule> </flat-profile>
esync_esync_rofile_

La etiqueta de elementos incluye todos los elementos de parámetros que el teléfono reconoce.

Propiedades de la etiqueta del elemento

Tenga en cuenta las siguientes reglas cuando cree o actualice el archivo de configuración.

  • El formato de aprovisionamiento XML y la interfaz de usuario web permiten configurar los mismos ajustes. Los nombres de las etiquetas XML y los nombres de los campos en la interfaz de usuario web son similares, pero varían debido a las restricciones de nombres de elementos XML. Por ejemplo, guiones bajos (_ ) en el archivo de configuración XML en lugar de espacios en la interfaz de usuario web.

  • El teléfono reconoce los elementos con nombres de parámetros adecuados que están encapsulados en el elemento especial .

  • Los nombres de los elementos se incluyen entre corchetes angulares.

  • La mayoría de los nombres de los elementos son similares a los nombres de los campos de la interfaz de usuario web del teléfono, con las siguientes modificaciones:

    • Los nombres de los elementos no pueden incluir espacios ni caracteres especiales. Para derivar el nombre del elemento del nombre del campo web, sustituya un guión bajo por cada espacio o por los caracteres especiales [, ], (, ) o /.

      Ejemplo: El elemento <Resync_On_Reset> representa el campo Resincronización al restablecer .

    • El nombre de cada elemento debe ser único. En la interfaz de usuario web del teléfono, los mismos campos pueden aparecer en varias páginas web, como las páginas Línea, Usuario y Extensión. Anexe [n] al nombre del elemento para indicar el número que se muestra en la ficha de la página.

      Ejemplo: El elemento <Dial_Plan_1_> representa el Plan de marcación para la línea 1.

  • Cada etiqueta de elemento de apertura debe tener una etiqueta de elemento de cierre coincidente. Por ejemplo:

      <Resync_On_Reset> Sí On_Reset> <Resync_Periodic> 7200 Periodic> <Profile_Rule>tftp://prov.telco.com:esync_esync_ 6900/cisco/config/CP_xxxx_MPP.cfg Regla>
    rofile_

  • Las etiquetas de elementos distinguen entre mayúsculas y minúsculas.

  • Se permiten etiquetas de elementos vacías y se interpretarán como la configuración del valor para que esté vacío. Introduzca la etiqueta de elemento de apertura sin una etiqueta de elemento correspondiente e inserte un espacio y una barra diagonal antes del soporte angular de cierre (>). En este ejemplo, la regla de perfil B está vacía:

     <Profile_Rule_B />

  • Se puede utilizar una etiqueta de elemento vacía para evitar la sobreescritura de cualquier valor proporcionado por el usuario durante una operación de resincronización. En el siguiente ejemplo, la configuración de la marcación rápida del usuario no cambia:

     <Speed_dial_2_Nombre ua="rw"/> <Speed_dial_2_Número ua="rw"/> <Speed_dial_3_Nombre ua="rw"/> <Speed_dial_3_Número ua="rw"/> <Speed_dial_4_Nombre ua="rw"/> <Speed_dial_4_Número ua="rw"/> <Speed_dial_5_Nombre ua="rw"/> <Speed_dial_5_Número ua="rw"/> <Speed_dial_6_Nombre ua="rw"/> <Speed_dial_6_Número ua="rw"/> <Speed_dial_7_Nombre ua="rw"/> <Speed_dial_7_Número ua="rw"/> <Speed_dial_8_Nombre ua="rw"/> <Speed_dial_8_Número ua="rw"/> <Speed_dial_9_Nombre ua="rw"/> <Speed_dial_9_Número ua="rw"/>

  • Utilice un valor vacío para establecer el parámetro correspondiente como una cadena vacía. Introduzca un elemento de apertura y cierre sin ningún valor entre ellos. En el siguiente ejemplo, el parámetro GPP_A se establece en una cadena vacía.

     <perfil plano> <GPP_A>   A> </perfil plano>
    _

  • Los nombres de elementos no reconocidos se ignoran.

Propiedades de los parámetros

Estas propiedades se aplican a los parámetros:

  • Cualquier parámetro que no esté especificado por un perfil se deja sin cambios en el teléfono.

  • Los parámetros no reconocidos se ignoran.

  • Si el perfil de formato abierto contiene varias frecuencias de la misma etiqueta de parámetro, la última de dichas frecuencias anula las anteriores. Para evitar la anulación involuntaria de los valores de configuración de un parámetro, se recomienda que cada perfil especifique, como máximo, una instancia de un parámetro.

  • El último perfil procesado tiene prioridad. Si varios perfiles especifican el mismo parámetro de configuración, el valor de este último perfil tiene prioridad.

Formatos de cadena

Estas propiedades se aplican al formato de las cadenas:

  • Los comentarios se permiten a través de sintaxis XML estándar.

  • Se permiten los espacios en blanco iniciales y finales por razones de legibilidad, pero se eliminan del valor del parámetro.

  • Las nuevas líneas dentro de un valor se convierten en espacios.

  • Se permite un encabezado XML con el formulario <? ?> , pero el teléfono lo ignora.

  • Para introducir caracteres especiales, utilice caracteres de escape XML básicos, como se muestra en la siguiente tabla.

    Carácter especial

    Secuencia de escape XML

    & (ampersand)

    &

    < (menos de)

    <

    > (mayor que)

    >

    » (apóstrofe)

    '

    ” (comilla doble)

    "

    En el siguiente ejemplo, se ingresan caracteres de escape para representar los símbolos mayor que y menor que que se requieren en una regla de plan de marcación. Este ejemplo define un plan de marcado de línea directa de información que establece el parámetro <Dial_Plan_1_> (Inicio de sesión de administración > avanzado > Voz > Extensión (n)) igual a (S0 ).

     <perfil plano> <Dial_Plan_1_> (S0 ) Plan_1_> </perfil plano>
    ial_

  • Se escapa el carácter numérico, usando valores decimales y hexadecimales (s.a. ( y .), están traducidos.

  • El firmware del teléfono solo admite caracteres ASCII.

Compresión y cifrado de perfil abierto (XML)

El perfil de configuración abierto se puede comprimir para reducir la carga de red en el servidor de aprovisionamiento. El perfil también se puede cifrar para proteger la información confidencial. La compresión no es necesaria, pero debe preceder al cifrado.

Compresión de perfil abierto

El método de compresión admitido es el algoritmo deflate gzip (RFC ). La utilidad gzip y la biblioteca de compresión que implementa el mismo algoritmo (zlib) están disponibles en los sitios de Internet.

Para identificar la compresión, el teléfono espera que el archivo comprimido contenga un encabezado compatible con gzip. La invocación de la utilidad gzip en el perfil abierto original genera el encabezado. El teléfono inspecciona el encabezado del archivo descargado para determinar el formato del archivo.

Por ejemplo, si profile.xml es un perfil válido, también se acepta el archivo profile.xml.gz . Cualquiera de los siguientes comandos puede generar este tipo de perfil:

  • >perfil de gzip.xml

    Sustituye el archivo original por un archivo comprimido.

  • >cat profile.xml | gzip > profile.xml.gz

    Deja el archivo original en su lugar y genera un nuevo archivo comprimido.

Cifrado de perfil abierto

El cifrado de claves simétricas se puede utilizar para cifrar un perfil de configuración abierto, independientemente de si el archivo está comprimido o no. La compresión, si se aplica, debe aplicarse antes del cifrado.

El servidor de aprovisionamiento utiliza HTTPS para gestionar el aprovisionamiento inicial del teléfono después de la implementación. El cifrado previo de los perfiles de configuración sin conexión permite el uso de HTTP para volver a sincronizar los perfiles posteriormente. Esto reduce la carga en el servidor HTTPS en implementaciones a gran escala.

El teléfono admite dos métodos de cifrado para los archivos de configuración:

  • Cifrado AES-256-CBC

  • Cifrado de contenido HTTP basado en RFC 8188 con cifrado AES-128-GCM

La clave o el material de claves de entrada (IKM) debe suministrarse previamente en la unidad. El arranque de la clave secreta se puede realizar de forma segura mediante HTTPS.

El nombre del archivo de configuración no requiere un formato específico, pero un nombre de archivo que finalice con la extensión .cfg normalmente indica un perfil de configuración.

Cifrado AES-256-CBC

El teléfono admite el cifrado AES-256-CBC para los archivos de configuración.

La herramienta de cifrado OpenSSL, disponible para su descarga desde varios sitios de Internet, puede realizar el cifrado. El soporte para el cifrado AES de 256 bits puede requerir la recopilación de la herramienta para habilitar el código AES. El firmware se ha probado en la versión openssl-1.1.1d.

En el caso de un archivo cifrado, el perfil espera que el archivo tenga el mismo formato que el que genera el siguiente comando:

 # clave de cifrado de ejemplo = SecretPhrase187 openssl enc –e –aes-256-cbc –k SecretPhrase187 –in profile.xml –out profile.cfg # invocación análoga para un archivo xml comprimido openssl enc –e –aes-256-cbc –k SecretPhrase187 –in profile.xml.gz –out profile.cfg

Una -k minúscula precede a la clave secreta, que puede ser cualquier frase de texto sin formato, y que se utiliza para generar una sal aleatoria de 64 bits. Con el secreto especificado por el argumento -k, la herramienta de cifrado deriva un vector inicial aleatorio de 128 bits y la clave de cifrado real de 256 bits.

Cuando se utiliza esta forma de cifrado en un perfil de configuración, se debe informar al teléfono del valor de la clave secreta para descifrar el archivo. Este valor se especifica como calificador en la URL del perfil. La sintaxis es la siguiente, usando una URL explícita:

 [--clave “FraseSecreta187”] http://prov.telco.com/path/profile.cfg

Este valor se programa mediante uno de los parámetros Profile_Regla .

Expansión de macros

Varios parámetros de aprovisionamiento se someten internamente a la expansión de macros antes de ser evaluados. Este paso previo a la evaluación proporciona mayor flexibilidad para controlar las actividades de resincronización y actualización del teléfono.

Estos grupos de parámetros se someten a la expansión de macros antes de la evaluación:

  • Resync_Trigger_*

  • Profile_Regla*

  • Log_xxx_Msg

  • Upgrade_regla

En ciertas condiciones, algunos parámetros de propósito general (GPP_*) también se someten a la expansión de macros, como se indica explícitamente en la sección Argumentos de resincronización opcionales a continuación.

Durante la expansión de macros, el contenido de las variables nombradas sustituye a las expresiones de los formularios $NAME y $(NAME). Estas variables incluyen parámetros de uso general, varios identificadores de productos, ciertos temporizadores de eventos y valores de estado de aprovisionamiento. Para obtener una lista completa, consulte Variables de expansión de macros en Parámetros de aprovisionamiento.

En el siguiente ejemplo, se utiliza la expresión $(MAU) para insertar la dirección MAC 000E08012345.

El administrador ingresa: $(MAU)config.cfg

La expansión de macros resultante para un dispositivo con la dirección MAC 000E08012345 es: 000E08012345config.cfg

Si no se reconoce un nombre de macro, permanece sin expandir. Por ejemplo, el nombre STRANGE no se reconoce como un nombre de macro válido, mientras que MAU se reconoce como un nombre de macro válido.

El administrador ingresa: $STRANGE$MAU.cfg

La expansión de macros resultante para un dispositivo con la dirección MAC 000E08012345 es: $STRANGE000E08012345.cfg

La expansión de macros no se aplica de manera recursiva. Por ejemplo, $$MAU” se expande a $MAU” (el $$ se expande), y no genera la dirección MAC.

El contenido de los parámetros de propósito especial, de GPP_SA a GPP_SD, se asigna a las expresiones de macros $SA a $SD. Estos parámetros solo son macros expandidas como el argumento de las opciones --key , --uid y --pwd en una URL de resincronización.

Expresiones condicionales

Las expresiones condicionales pueden activar eventos de resincronización y seleccionar de URL alternativas para operaciones de resincronización y actualización.

Las expresiones condicionales consisten en una lista de comparaciones, separadas por el operador y . Todas las comparaciones deben satisfacerse para que la condición sea verdadera.

Cada comparación puede estar relacionada con uno de los siguientes tres tipos de literales:

  • Valores enteros

  • Números de versión de software o hardware

  • Cadenas entre comillas dobles

Números de versión

La versión del software para Cisco Video Phone 8875 utiliza este formato (donde BN es el número de compilación):

PHONEOSyyyy.1-0-1-0001-BN

donde yyyy indica el modelo o la serie de teléfonos; 1 es la versión principal; 0 es la versión menor; 1-0001 es la versión micro; y BN es el número de compilación.

La cadena de comparación debe utilizar el mismo formato. De lo contrario, se produce un error de análisis de formato.

Al comparar la versión del software, la versión principal, la versión menor y la micro versión se comparan en secuencia, y los dígitos más a la izquierda tienen prioridad sobre los últimos. Cuando los números de versión son idénticos, se compara el número de compilación.

Ejemplos de número de versión válido

phoneos-8875.1-0-1-0001-19

Comparación

Las cadenas entre comillas se pueden comparar para determinar la igualdad o la desigualdad. Los números enteros y los números de versión también se pueden comparar aritméticamente. Los operadores de comparación pueden expresarse como símbolos o como acrónimos. Los acrónimos son convenientes para expresar la condición en un perfil de formato abierto.

Operador

Sintaxis alternativa

Descripción

Se aplica a los operandos de número entero y versión

Se aplica a los operandos de cadenas entrecomilladas

=

eq

es igual a

Sí

Sí

!=

ne

no es igual que

Sí

Sí

<

lt

menos de

Sí

No

<=

le

menor o igual que

Sí

No

>

gt

mayor que

Sí

No

>=

ge

mayor o igual que

Sí

No

Y

Y

Sí

Sí

Es importante incluir las variables de las macros entre comillas dobles donde se espera un literal de cadenas. No lo haga donde se espera un número o número de versión.

Cuando se utilizan en el contexto de los parámetros Profile_Rule* y Upgrade_Rule, las expresiones condicionales deben incluirse dentro de la sintaxis “(expr)?”, como en este ejemplo de regla de actualización. Recuerde reemplazar BN por el número de compilación de su carga de firmware a la que desea actualizar.

($SWVER ne PHONEOS-8875.1-0-1-0001-19)? http://ps.tell.com/sw/PHONEOS-8875.1-0-1-0001-BN.loads

No utilice la sintaxis anterior con paréntesis para configurar los parámetros Resync_Trigger_*.

Sintaxis de URL

Utilice la sintaxis de URL estándar para especificar cómo recuperar los archivos de configuración y las cargas de firmware en los parámetros Profile_Regla* y Upgrade_Regla, respectivamente. La sintaxis es la siguiente:

[ esquema:// ] [ servidor [:puerto]] filepath

Donde el esquema es uno de estos valores:

  • tftp

  • http

  • https

Si se omite el esquema , se asume tftp. El servidor puede ser un nombre de host reconocido por DNS o una dirección IP numérica. El puerto es el número de puerto UDP o TCP de destino. La ruta de archivo debe comenzar con el directorio raíz (/); debe ser una ruta absoluta.

Si falta el servidor , se utiliza el servidor tftp especificado a través de DHCP (opción 66).

Para las reglas de mejora, se debe especificar el servidor.

Si falta el puerto , se utiliza el puerto estándar para el esquema especificado. Tftp utiliza el puerto UDP 69, http utiliza el puerto TCP 80, https utiliza el puerto TCP 443.

Debe haber una ruta de archivo presente. No es necesario que se refiera a un archivo estático, pero puede indicar contenido dinámico obtenido a través de CGI.

La expansión de macros se aplica en las URL. Los siguientes son ejemplos de direcciones URL válidas:

 /$MA.cfg /cisco/cfg.xml 192.168.1.130/profiles/init.cfg tftp://prov.call.com/cpe/cisco$MA.cfg http://neptune.speak.net:8080/prov/$D/$E.cfg https://secure.me.com/profile?Linksys

Cuando se utiliza la opción 66 de DHCP, las reglas de actualización no admiten la sintaxis vacía. Solo se aplica a Profile Rule* (Regla perfil*).

Cifrado de contenido HTTP basado en RFC 8188

El teléfono admite el cifrado de contenido HTTP basado en RFC 8188 con cifrado AES-128-GCM para los archivos de configuración. Con este método de cifrado, cualquier entidad puede leer los encabezados de los mensajes HTTP. Sin embargo, solo las entidades que conocen el Material de claves de entrada (IKM) pueden leer la carga útil. Cuando el teléfono se aprovisiona con el IKM, el teléfono y el servidor de aprovisionamiento pueden intercambiar archivos de configuración de forma segura, a la vez que permiten que los elementos de red de terceros utilicen los encabezados de los mensajes con fines analíticos y de supervisión.

El parámetro de configuración XML IKM_HTTP_Encrypt_Content mantiene el IKM en el teléfono. Por motivos de seguridad, no se puede acceder a este parámetro en la página web de administración del teléfono. Tampoco es visible en el archivo de configuración del teléfono, al que puede acceder desde la dirección IP del teléfono o desde los informes de configuración del teléfono enviados al servidor de aprovisionamiento.

Si desea utilizar el cifrado basado en RFC 8188, asegúrese de lo siguiente:

  • Aprovisione el teléfono con el IKM especificando el IKM con el parámetro XML IKM_HTTP_Encrypt_Content en el archivo de configuración que se envía desde el servidor de aprovisionamiento al teléfono.

  • Si este cifrado se aplica a los archivos de configuración enviados desde el servidor de aprovisionamiento al teléfono, asegúrese de que el encabezado HTTP Codificación de contenido en el archivo de configuración tenga aes 128gcm.

    En ausencia de este encabezado, se da prioridad al método AES-256-CBC. El teléfono aplica el descifrado AES-256-CBC si hay una clave AES-256-CBC en una regla de perfil, independientemente del IKM.

  • Si desea que el teléfono aplique este cifrado a los informes de configuración que envía al servidor de aprovisionamiento, asegúrese de que no haya ninguna clave AES-256-CBC especificada en la regla del informe.

Argumentos de resincronización opcionales

Los argumentos opcionales, key, uid y pwd, pueden preceder a las URL introducidas en los parámetros Profile_Rule* , incluidos colectivamente entre corchetes.

tecla

La opción --key le indica al teléfono que el archivo de configuración que recibe del servidor de aprovisionamiento está cifrado con cifrado AES-256-CBC, a menos que el encabezado Content-Encoding (Codificación de contenido) del archivo indique cifrado aes 128gcm . La clave en sí se especifica como una cadena después del término --clave. La clave se puede incluir entre comillas dobles (") de manera opcional. El teléfono utiliza la clave para descifrar el archivo de configuración.

Ejemplos de uso
 [--key VerySecretValue] [--key “my secret phrase”] [--key a37d2fb9055c1d04883a0745eb0917a4]

Los argumentos opcionales entre corchetes son macros expandidas. Los parámetros de propósito especial, GPP_SA a GPP_SD, son macros que se expanden en variables de macros, $SA a $SD, solo cuando se utilizan como argumentos de opción clave. Consulte estos ejemplos:

[--clave $SC] [--clave “$SD”]

En los perfiles de formato abierto, el argumento a --key debe ser el mismo que el argumento a la opción -k que se le proporciona a openssl.

uid y pwd

Las opciones uid y pwd se pueden utilizar para especificar el userID y la contraseña que se enviarán en respuesta a los desafíos de autenticación básica y implícita de HTTP cuando se solicite la URL especificada. Los argumentos opcionales entre corchetes son macros expandidas. Los parámetros de propósito especial, GPP_SA a GPP_SD, son macros que se expanden en variables de macros, $SA a $SD, solo cuando se utilizan como argumentos de opción clave. Consulte estos ejemplos:

GPP_SA = MyUserID GPP_SB = MySecretPassword

[--uid $SA --pwd $SB] https://provisioning_server_url/path_to_your_config/your_config.xml

se expandirá a:

[--uid MyUserID --pwdMySecretPassword] https://provisioning_server_url/path_to_your_config/your_config.xml

Tipos de datos

Estos tipos de datos se utilizan con los parámetros del perfil de configuración:

  • {a,b,c,…}: una opción entre a, b, c, …

  • Bool: valor booleano de “sí” o “no”.

  • CadScript: una mini secuencia de comandos que especifica los parámetros de cadencia de una señal. Hasta 127 caracteres.

    Sintaxis: S1[;S2], donde:

    • Si=Di(oni,1/offi,1[,oni,2/offi,2[,oni,3/offi,3[,oni,4/offi,4[,oni,5/offi,5[,oni,6/offi,6]]]]]) y se conoce como una sección.

    • oni,j y offi,j son la duración de encendido/apagado en segundos de un segmento. i = 1 o 2, y j = 1 a 6.

    • Di es la duración total de la sección en segundos.

    Todas las duraciones pueden tener hasta tres posiciones decimales para proporcionar una resolución de 1 ms. El carácter comodín “*” significa duración infinita. Los segmentos de una sección se reproducen en orden y se repiten hasta que se reproduce la duración total.

    Ejemplo 1:

     60(2/4) Número de secciones de cadencia = 1 Sección de cadencia 1: Longitud de la sección = 60 s Número de segmentos = 1 Segmento 1: On=2 s, Off=4 s Longitud total del anillo = 60 s

    Ejemplo 2: anillo distintivo (corto, corto, corto, largo):

     60(.2/.2,.2/.2,.2/.2,1/4) Número de secciones de cadencia = 1 Sección de cadencia 1: Longitud de la sección = 60s Número de segmentos = 4 Segmento 1: On=0,2s, Off=0,2s Segmento 2: On=0,2s, Off=0,2s Segmento 3: On=0,2s, Off=0,2s Segmento 4: On=1.0s, Off=4.0s Longitud total del anillo = 60 s

  • DialPlanScript (Secuencia de comandos del plan de marcación): sintaxis de secuencias de comandos que se utiliza para especificar planes de marcación de línea 1 y línea 2.

  • Flotante: valor de punto flotante con hasta n decimales.

  • FQDN: nombre de dominio completamente calificado. Puede contener hasta 63 caracteres. Algunos ejemplos son los siguientes:

    • sip.Cisco.com:5060 o 109.12.14.12:12345

    • sip.Cisco.com o 109.12.14.12

  • FreqScript: una mini secuencia de comandos que especifica los parámetros de frecuencia y nivel de un tono. Contiene hasta 127 caracteres.

    Sintaxis: F1@L1[,F2@L2[,F3@L3[,F4@L4[,F5@L5[,F6@L6]]]]]], donde:

    • Los números F1–F6 son frecuencias en Hz (solo números enteros no firmados).

    • L1–L6 son los niveles correspondientes en dBm (con hasta un decimal).

    Se permiten espacios en blanco antes y después de la coma, pero no se recomiendan.

    Ejemplo 1: tono de llamada en espera:

     440@-10 Número de frecuencias = 1 Frecuencia 1 = 440 Hz a –10 dBm

    Ejemplo 2: tono de marcación:

     350@-19,440@-19 Número de frecuencias = 2 Frecuencia 1 = 350 Hz a –19 dBm Frecuencia 2 = 440 Hz a –19 dBm

  • IP: dirección IPv4 válida en forma de x.x.x.x, donde x está entre 0 y 255. Ejemplo: 10.1.2.100.

  • UserID (ID de usuario): ID de usuario tal como aparece en una URL; hasta 63 caracteres.

  • Teléfono: una cadena de número de teléfono, como 14081234567, *69, *72, 345678; o una URL genérica, como 1234@10.10.10.100:5068 o jsmith@Cisco.com. La cadena puede contener hasta 39 caracteres.

  • PhTmplt: una plantilla de número de teléfono. Cada plantilla puede contener uno o más patrones separados por comas (,). Se ignora el espacio en blanco al comienzo de cada patrón. “?” y “*” representan caracteres comodín. Para representar literalmente, utilice %xx. For example, %2a representa *. La plantilla puede contener hasta 39 caracteres. Ejemplos: “1408*, 1510*”, “1408123????, 555?1.”.

  • Puerto: número de puerto TCP/UDP (0-65535). Se puede especificar en formato decimal o hexadecimal.

  • ProvisioningRuleSyntax (Sintaxis de reglas de aprovisionamiento): sintaxis de secuencias de comandos que se utiliza para definir las reglas de resincronización de configuración y actualización de firmware.

  • PwrLevel: nivel de potencia expresado en dBm con un decimal, como –13,5 o 1,5 (dBm).

  • RscTmplt: una plantilla del código de estado de respuesta de SIP, como “404, 5*”, “61?”, “407, 408, 487, 481”. Puede contener hasta 39 caracteres.

  • Sig: valor de n bits firmado. Se puede especificar en formato decimal o hexadecimal. Un signo “-” debe preceder a los valores negativos. El signo + antes de los valores positivos es opcional.

  • Star Codes (Códigos de asterisco): código de activación para un servicio complementario, como *69. El código puede contener hasta 7 caracteres.

  • Str: una cadena genérica con hasta n caracteres no reservados.

  • Tiempo: duración en segundos, con hasta n decimales. Las posiciones decimales especificadas adicionales son ignoradas.

  • ToneScript (SecuenciaDeComandosDeTono): una mini secuencia de comandos que especifica los parámetros de frecuencia, nivel y cadencia del tono de progreso de una llamada. La secuencia de comandos puede contener hasta 127 caracteres.

    Sintaxis: FreqScript;Z1[;Z2].

    La sección Z1 es similar a la sección S1 de un CadScript, excepto que cada segmento de encendido/apagado está seguido de un parámetro de componentes de frecuencia: Z1 = D1(oni,1/offi,1/fi,1[,oni,2/offi,2/fi,2 [,oni,3/offi,3/fi,3 [,oni,4/offi,4/fi,4 [,oni,5/offi,5/fi,5 [,oni,6/offi,6/fi,6]]]]]) donde:

    • fi,j = n1[+n2]+n3[+n4[+n5[+n6]]]]].

    • 1 < nk < 6 especifica los componentes de frecuencia en el FreqScript que se utilizan en ese segmento.

    Si se utiliza más de un componente de frecuencia en un segmento, los componentes se suman juntos.

    Ejemplo 1: tono de marcación:

     350@-19,440@-19;10(*/0/1+2) Número de frecuencias = 2 Frecuencia 1 = 350 Hz a –19 dBm Frecuencia 2 = 440 Hz a –19 dBm Número de secciones de cadencia = 1 Sección de cadencia 1: Longitud de la sección = 10 s Número de segmentos = 1 Segmento 1: on=forever, con frecuencias 1 y 2 longitud total de tono = 10s

    Ejemplo 2: tono intermitente:

     350@-19,440@-19;2(.1/.1/1+2);10(*/0/1+2) Número de frecuencias = 2 Frecuencia 1 = 350 Hz a –19 dBm Frecuencia 2 = 440 Hz a –19 dBm Número de secciones de cadencia = 2 Sección de cadencia 1: Longitud de la sección = 2s Número de segmentos = 1 Segmento 1: On=0,1 s, Off=0,1 s con frecuencias 1 y 2 Cadencia Sección 2: Longitud de la sección = 10 s Número de segmentos = 1 Segmento 1: on=forever, con frecuencias 1 y 2 longitud total del tono = 12s

  • Uns: valor de n bits sin firmar, donde n = 8, 16 o 32. Se puede especificar en formato decimal o hexadecimal, como 12 o 0x18, siempre que el valor pueda caber en n bits.

Tenga en cuenta lo siguiente:

  • representa un nombre de parámetro de configuración. En un perfil, la etiqueta correspondiente se forma al reemplazar el espacio con un guion bajo “_”, como Par_Nombre.
  • Un campo de valor predeterminado vacío implica una cadena < “” > vacía.
  • El teléfono sigue utilizando los últimos valores configurados para las etiquetas que no están presentes en un perfil determinado.
  • Las plantillas se comparan en el orden especificado. Se selecciona la primera coincidencia, no la más cercana. El nombre del parámetro debe coincidir con exactitud.
  • Si un perfil proporciona más de una definición para un parámetro, la última definición en el archivo es la que surte efecto en el teléfono.
  • Una especificación de parámetros con un valor de parámetro vacío fuerza al parámetro a su valor por defecto. Para especificar una cadena vacía en su lugar, utilice la cadena vacía "" como valor de parámetro.