Configurar los ajustes de perfil para teléfonos de la serie 9800 y 8875 (BroadWorks)

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

Resincronizar el perfil de teléfono a través de TFTP

El teléfono admite múltiples protocolos de red para recuperar perfiles de configuración. El protocolo de transferencia de perfil más básico es TFTP (RFC1350). TFTP es ampliamente utilizado para el aprovisionamiento de dispositivos de red dentro de redes LAN privadas. Aunque no se recomienda para la implementación de puntos finales remotos a través de Internet, TFTP puede ser conveniente para la implementación dentro de organizaciones pequeñas, para el preaprovisionamiento 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	Dentro de un entorno LAN, conecte su computadora y el teléfono a un concentrador, conmutador o enrutador pequeño.
2	En el equipo, 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 ha aprovisionado en su teléfono más tarde, puede establecer algunos de los valores como marcas. Por ejemplo, establezca el valor de GPP_A en 12345678 como se muestra en el siguiente ejemplo: `<flat-profile>  <GPP_A> 12345678  </GPP_A> </flat-profile>`
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: solicite el archivo de perfil de configuración mediante un cliente TFTP que no sea el teléfono. Preferiblemente, utilice un cliente TFTP que se ejecute en un host separado del servidor de aprovisionamiento.
5	En el navegador web de su computadora, abra la página web de administración. Por ejemplo, supongamos que la dirección IP del teléfono es 192.168.1.100, abra la siguiente URL en su navegador web: `http://192.168.1.100/admin/advanced`
6	Seleccione la ficha Voz > Aprovisionamiento e inspeccione los valores de los parámetros de propósito general GPP_A a GPP_P. Estos deberían estar vacíos.
7	Resincronice el teléfono de prueba con el perfil de configuración que creó abriendo la dirección URL de resincronización en un navegador web. Ejemplo: Si la dirección IP del servidor TFTP es 192.168.1.200, el comando debe 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. A continuación, el teléfono analizará el archivo descargado y actualiza el parámetro GPP_A con el valor 12345678.
8	Verifique 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 debe 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 del producto. (La dirección MAC es el número, usando 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` (reemplazando `xxxx` por el número de modelo y `macaddress con la dirección` MAC del teléfono). Ejemplo: `CP-8875 000e08aabbcc.cfg`
3	Mueva el nuevo archivo al directorio raíz virtual del servidor TFTP.
4	Acceda a la página web de administración telefónica.
5	Seleccione Voz > Aprovisionamiento.
6	Introduzca la ruta del archivo de perfil en el campo Regla de perfil. Ejemplo: Suponga que la dirección IP del servidor TFTP es 192.168.1.200 y el nombre del archivo de perfil es `<Profile_Rule> tftp://192.168.1.200/CP-8875$MA.cfg </Profile_Rule>`
7	Haga clic en Enviar todos los cambios. Esto provoca un reinicio inmediato y una resincronización. Cuando se produce la siguiente resincronización, el teléfono recupera el nuevo archivo expandiendo la expresión macro $MA a su dirección MAC.

Resincronizar el perfil telefónico con HTTP GET

1	Instale un servidor HTTP en el equipo local u otro host accesible. El servidor Apache de código abierto se puede descargar de 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 regla de perfil del teléfono de prueba para que apunte al servidor HTTP en lugar del servidor TFTP, a fin de descargar su perfil periódicamente. Por ejemplo, suponiendo que el servidor HTTP está en 192.168.1.300 y el nombre del archivo del perfil es basic.txt, introduzca el siguiente valor: `<Profile_Rule> http://192.168.1.200/basic.txt </Profile_Rule>`
5	Haga clic en Enviar todos los cambios. Esto provoca un reinicio inmediato y una resincronización.
6	Observe los mensajes de Syslog que envía el teléfono. La resincronización periódica ahora debería ser obtener el perfil del servidor HTTP.
7	En los registros del servidor HTTP, observe cómo aparece la información que identifica el teléfono de prueba en el registro de los agentes de usuario. Esta información debe incluir el fabricante, el nombre del producto, la versión actual del firmware y el número de serie.

Resincronizar automáticamente el perfil del teléfono

Un dispositivo puede volver a sincronizar periódicamente con el servidor de aprovisionamiento para garantizar que los cambios de perfil realizados en el servidor se propaguen al dispositivo de punto final (en lugar de enviar una solicitud de resincronización explícita al punto final).

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

1	Acceda a la página web de administración telefónica.
2	Seleccione Voz > Aprovisionamiento.
3	Defina el parámetro Profile_Rule. En este ejemplo se asume una dirección IP del servidor TFTP de 192.168.1.200.
4	En el campo Periódico de resincronización, escriba 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 dirección URL.
6	Observe los mensajes resultantes en el seguimiento del syslog.
7	Asegúrese de que el campo Resincronizar al restablecer esté establecido en Sí. `<Resync_On_Reset>Yes</Resync_On_Reset>`
8	Encienda el teléfono para obligarlo a resincronizar 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 el número de segundos configurado en Reintento de error de resincronización) antes de intentar volver a sincronizar. Si el retraso de reintento de error de resincronización es cero, el teléfono no intenta resincronizar después de un intento fallido de resincronización.
9	(Opcional) Establezca el valor del campo Retardo de reintento de error de resincronización en un número pequeño, como 30. `<Resync_Error_Retry_Delay>30</Resync_Error_Retry_Delay>`
10	Desactive el servidor TFTP y observe los resultados en la salida del syslog.

Parámetros de resincronización del perfil

La siguiente tabla define 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 ficha Voz > Aprovisionamiento en la página web del teléfono. También define la sintaxis de la cadena que se agrega en el 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
Activación de provisiones	Permite o deniega acciones de resincronización del perfil de configuración. En el archivo de configuración del teléfono (cfg.xml) con XML, escriba una cadena en este formato: `<Provision_Enable ua="na">Si</Provision_Enable>` En la página web del teléfono, establezca este campo en Sí para permitir acciones de resincronización o No para bloquear acciones de resincronización. Predeterminado: Sí
Resincronización al reiniciar	Especifica si el teléfono resincroniza las configuraciones 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, escriba una cadena en este formato: `<Resync_On_Reset ua="na">Sí</Resync_On_Reset>` En la página web del teléfono, establezca este campo en Sí para permitir la resincronización al encender o reiniciar, o No para bloquear la resincronización al encender o reiniciar. Predeterminado: Sí
Retraso aleatorio de resincronización	Evita una sobrecarga del servidor de aprovisionamiento cuando una gran cantidad de dispositivos se enciende 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 reiniciar el dispositivo. El parámetro es el intervalo de tiempo máximo que el dispositivo espera antes de ponerse en contacto con el servidor de aprovisionamiento. El retraso 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, escriba una cadena en este formato: `<Resync_Random_Delay ua="na">2</Resync_Random_Delay>` En la página web del teléfono, especifique el número de unidades (20 segundos) para que el teléfono retrase la resincronización después de encenderlo o reiniciarlo. El valor predeterminado es 2 (40 segundos).
Resincronización en (HHmm)	La hora (HHmm) en que el teléfono se resincroniza con el servidor de aprovisionamiento. El valor de este campo debe ser un número de cuatro dígitos que va de 0000 a 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, escriba una cadena en este formato: `<Resync_At__HHmm_ ua="na">0959</Resync_At__HHmm_>` En la página web del teléfono, especifique la hora en formato HHMM para que el teléfono comience a resincronizarse. El valor predeterminado está vacío. Si el valor no es válido, se ignora el parámetro. Si este parámetro se establece con un valor válido, se omite el parámetro Resync Periodic.
Resincronización con retraso aleatorio	Evita una sobrecarga del servidor de aprovisionamiento cuando una gran cantidad de dispositivos se encienden simultáneamente. Para evitar que se inunden las solicitudes de resincronización al servidor desde varios teléfonos, el teléfono se resincroniza en el rango entre horas y minutos, y las horas y minutos más el retraso aleatorio (hhmm, hhmm+random_delay). Por ejemplo, si el retardo aleatorio = (Resincronización en retardo aleatorio + 30) /60 minutos, el valor de entrada en segundos se convierte en minutos, redondeando al siguiente minuto para calcular el intervalo final de retardo aleatorio. En el archivo de configuración del teléfono (cfg.xml) con XML, escriba una cadena en este formato: `<Resync_At_Random_Delay ua="na">600</Resync_At_Random_Delay>` 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 retardo aleatorio interno está entre 0 y 600. El valor predeterminado es 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 siguiente resincronización se produce en 3000 segundos. Múltiples números enteros Ejemplo: Una entrada de `600,1200.300` indica que la primera resincronización se produce en 600 segundos, la segunda resincronización ocurre en 1200 segundos después de la primera y la tercera resincronización se produce en 300 segundos después de la segunda. Un rango de tiempo Por ejemplo, una entrada de `2400+30` indica que la siguiente resincronización se produce 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, escriba una cadena en este formato: `<Resync_Periodic ua="na">3600</Resync_Periodic>` 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 3600 segundos.
Error de resincronización Retraso de reintento	Si una operación de resincronización falla porque el teléfono no pudo recuperar un perfil del servidor, o el archivo descargado está dañado o se produce un error interno, el teléfono intenta volver a sincronizar 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 el siguiente reintento de resincronización se produce en 300 segundos. Múltiples números enteros Ejemplo: Una entrada de `600,1200.300` indica que el primer reintento se produce 600 segundos después de la falla, el segundo reintento ocurre en 1200 segundos después del error del primer reintento y el tercer reintento se produce 300 segundos después del error del segundo reintento. Un rango de tiempo Por ejemplo, una entrada de `2400+30` indica que el siguiente reintento se produce entre 2400 y 2430 segundos después de un error de resincronización. Si el retraso se establece en 0, el dispositivo no intenta volver a sincronizar después de un intento fallido de resincronización. En el archivo de configuración del teléfono (cfg.xml) con XML, escriba una cadena en este formato: `<Resync_Error_Retry_Delay ua="na">60,120,240,480,960,1920,3840,7680,15360,30720,61440,86400</Resync_Error_Retry_Delay>` 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
Retraso de resincronización forzada	Retraso máximo (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. Debido a que una resincronización puede tardar varios segundos, es conveniente esperar hasta que el dispositivo haya estado inactivo durante un período prolongado antes de resincronizar. Esto permite que un usuario realice llamadas en sucesión sin interrupción. El dispositivo tiene un temporizador que comienza la cuenta regresiva cuando todas sus líneas se vuelven inactivas. Este parámetro es el valor inicial del contador. Los eventos de resincronización se retrasan hasta que este contador decrece a cero. El valor válido oscila entre 0 y 65535. En el archivo de configuración del teléfono (cfg.xml) con XML, escriba una cadena en este formato: `<Forced_Resync_Delay ua="na">14400</Forced_Resync_Delay>` En la página web del teléfono, especifique el período de tiempo en segundos. El valor predeterminado es 14.400 segundos.
Resincronización desde SIP	Controla las solicitudes de operaciones de resincronización mediante 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 enviando un mensaje SIP NOTIFY que contiene el encabezado Event: resync al dispositivo. En el archivo de configuración del teléfono (cfg.xml) con XML, escriba una cadena en este formato: `<Resync_From_SIP ua="na">Sí</Resync_From_SIP>` En la página web del teléfono, seleccione Sí para habilitar esta función o No para inhabilitarla. Predeterminado: Sí
Resincronizar después del intento de actualización	Habilita o deshabilita la operación de resincronización después de que se produzca cualquier actualización. Si se selecciona Sí, la sincronización se activa después de una actualización del firmware. En el archivo de configuración del teléfono (cfg.xml) con XML, escriba una cadena en este formato: `<Resync_After_Upgrade_Attempt ua="na">Sí</Resync_After_Upgrade_Attempt>` En la página web del teléfono, seleccione Sí para activar la resincronización después de una actualización del firmware, o No para no resincronizar. Predeterminado: Sí
Desencadenador de resincronización 1 Desencadenador de resincronización 2	Si la ecuación lógica en estos parámetros se evalúa como FALSE, la resincronización no se activa incluso cuando la resincronización al restablecer se establece en TRUE. Solo la resincronización mediante URL de acción directa y notificación SIP ignora estos desencadenantes de resincronización. Los parámetros se pueden programar con una expresión condicional que se somete a una macro expansión. Para obtener información sobre las expansiones de macro 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, escriba una cadena en este formato: `<Resync_Trigger_1 ua="na">$UPGTMR a 300 y $PRVTMR a 600</Resync_Trigger_1>` `<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 volver a sincronizar la configuración del teléfono ingresando la regla de perfil desde el teléfono. Cuando se establece en No, el parámetro de regla de 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, escriba una cadena en este formato: `<User_Configurable_Resync ua="na">Sí</User_Configurable_Resync>` En la página web del teléfono, seleccione Sí para mostrar el parámetro de regla de perfil en el menú del teléfono o seleccione No para ocultar este parámetro. Predeterminado: Sí
La resincronización falla en FNF	Una resincronización generalmente se considera infructuosa si no se recibe un perfil solicitado del servidor. Este parámetro invalida 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, escriba una cadena en este formato: `<Resync_Fails_On_FNF ua="na">Sí</Resync_Fails_On_FNF>` En la página web del teléfono, seleccione Sí para tomar una respuesta de `archivo no encontrado` como una resincronización no exitosa, o seleccione No para tomar una respuesta de `archivo` no encontrado como una resincronización exitosa. Predeterminado: Sí
Tipo de autenticación de perfil	Especifica las credenciales que se utilizarán para la autenticación de la cuenta de perfil. Las opciones disponibles son: Desactivado: Deshabilita la función de cuenta de perfil. Cuando esta función está deshabilitada, el menú de configuración de la cuenta de perfil no aparece 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 de perfil. Autenticación XSI: Las credenciales de inicio de sesión XSI o las credenciales SIP XSI se utilizan para autenticar la cuenta de 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 está configurado 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 está configurado en Credenciales SIP, se utilizan las credenciales SIP XSI. En el archivo de configuración del teléfono (cfg.xml) con XML, escriba una cadena en este formato: `<Profile_Authentication_Type ua="na">Autenticación Http básica</Profile_Authentication_Type>` 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 de perfil en Especificar el teléfono para la resincronización del perfil.
Regla de perfil Perfil Regla B Perfil Regla C Perfil Regla D	Cada regla de perfil informa al teléfono de una fuente de 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:` `[--clave]` <encryption key> Puede incluir la clave de cifrado entre comillas dobles (“) opcionalmente. En el archivo de configuración del teléfono (cfg.xml) con XML, escriba una cadena en este formato: `<Profile_Rule ua="na">/$PSN.xml</Profile_Rule>` `<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 de perfil. Predeterminado: `/$PSN.xml`
Opción DHCP a usar	Opciones DHCP, delimitadas por comas, utilizadas para recuperar firmware y perfiles. Predeterminado: 66,160,159,150,60,43,125
Opción de uso de DHCPv6	Opciones DHCP, delimitadas por comas, utilizadas para recuperar firmware y perfiles. Predeterminado: 17,160,159

Aprovisionamiento a través de Cisco XML

Puede aprovisionar teléfonos a través de las funciones XML de Cisco.

Puede enviar un objeto XML al teléfono mediante un paquete de notificación SIP o una publicación HTTP 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 mediante un objeto XML:


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

Una vez 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 macro

Los subdirectorios con múltiples perfiles en el servidor proporcionan un método conveniente 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 su 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 dirección 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, especificado mediante notación URL estándar y administrado por expansión de macros.

Por ejemplo, la siguiente regla de perfil solicita el archivo de perfil ($pn.cfg), en el subdirectorio del servidor /cisco/config, desde el servidor TFTP que se ejecuta en el host prov.telco.com escuchando una conexión en el puerto 6900:


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

Un perfil para cada teléfono se puede identificar en un parámetro de propósito general, con su valor referido dentro de una regla de perfil común mediante expansión macro.

Por ejemplo, supongamos que GPP_B se define como Dj6Lmp23Q.

El 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 dirección URL:


tftp://prov.telco.com/cisco/Dj6Lmp23Q/000e08012345.cfg

Especifique el tipo de autenticación del perfil

La autenticación de perfil permite a los usuarios telefónicos resincronizar el perfil de aprovisionamiento en el teléfono. Se requiere información de autenticación mientras el teléfono intenta resincronizar 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, la pantalla de configuración de la cuenta de perfil se muestra 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 que se reinicie el teléfono
Cuando el nombre de usuario y la contraseña de la cuenta de perfil están vacíos
Cuando no hay nombre de usuario y contraseña en la regla de perfil

Si se omite o se omite la pantalla de configuración de la cuenta de 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 de función Configuración, que solo se muestra cuando no hay ninguna línea registrada en el teléfono.

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

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

Cuando proporciona una URL correcta en el campo Regla de perfil sin nombre de usuario y contraseña, el teléfono requiere autenticación o resumen para resincronizar el perfil. Con la cuenta de 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 de perfil con un nombre de usuario y contraseña correctos, el teléfono requiere autenticación o resumen para resincronizar el perfil. La cuenta de perfil no se utiliza para la resincronización telefónica. El inicio de sesión es exitoso.
Cuando proporciona una URL correcta en el campo Regla de perfil con un nombre de usuario y contraseña incorrectos, el teléfono requiere autenticación o resumen para resincronizar el perfil. La cuenta de perfil no se utiliza para la resincronización telefónica. El inicio de sesión siempre falla.
Cuando proporciona una URL incorrecta en el campo Regla de 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 de perfil en la página web de administración del teléfono.

1	Acceda a la página web de administración telefónica.
2	Seleccione Voz > Aprovisionamiento.
3	En la sección Perfil de configuración, establezca el parámetro Tipo de autenticación de perfil para especificar las credenciales que se utilizarán para la autenticación de cuentas de perfil. Puede configurar este parámetro en el archivo XML de configuración del teléfono (cfg.xml) introduciendo una cadena en este formato: `<Profile_Authentication_Type ua="na">Disabled</Profile_Authentication_Type>` Opciones: Deshabilitado: deshabilita la función de cuenta de perfil. Cuando esta función está deshabilitada, el menú Configuración de la cuenta de 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 de perfil. Autenticación XSI: Las credenciales de inicio de sesión XSI o las credenciales SIP XSI se utilizan para autenticar la cuenta de 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 está configurado 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.

Aplique manualmente un perfil a su teléfono

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

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

1	Conecte su computadora al puerto LAN del teléfono.
2	Ejecute una aplicación de servidor TFTP en el equipo y asegúrese de que el archivo de configuración esté disponible en el directorio raíz TFTP.
3	En un navegador web, escriba la dirección IP de LAN del teléfono, la dirección IP del equipo, el nombre del archivo y las credenciales de inicio de sesión. Utilice este formato: `http://<WAN_IP_Address>/admin/resync?tftp://<PC_IP_Address>/<file_name>&xuser=admin&xpassword=<password>` Ejemplo: `http://192.168.15.1/admin/resync?tftp://192.168.15.100/my_config.xml&xuser=admin&xpassword=admin`

Descargue el archivo de configuración al teléfono con cURL

Complete estos pasos para descargar la configuración al 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 use cURL para publicar la configuración en el teléfono porque el nombre de usuario y la contraseña podrían capturarse mientras usa cURL.

1	Conecte su computadora al puerto LAN del teléfono.
2	Descargue el archivo de configuración al teléfono introduciendo el siguiente comando cURL: `curl –d @my_config.xml “http://192.168.15.1/admin/config.xml&xuser=admin&xpassword=admin”`

Referencias para la configuración del perfil

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 para el teléfono.

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

Sólo se admite el juego 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 características diferente y, por lo tanto, un conjunto diferente de parámetros.

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 usar herramientas estándar para crear el archivo de configuración. Un archivo de configuración XML se puede enviar desde el servidor de aprovisionamiento al teléfono durante una operación de resincronización, sin compilación como un objeto binario.

El teléfono puede aceptar formatos de configuración que generan las herramientas estándar. Esta característica 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 en el 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 de desinflado gzip (RFC1951).

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 elementos
Atributos
Parámetros
Características de formato
Comentarios XML

Ejemplo: Formato de perfil abierto


<flat-profile>
<Resync_On_Reset> Yes </Resync_On_Reset>
<Resync_Periodic> 7200 </Resync_Periodic>
<Profile_Rule> tftp://prov.telco.com:6900/cisco/config/CP_xxxx_MPP.cfg</Profile_Rule>
</flat-profile>

La <flat-profile>etiqueta del elemento incluye todos los elementos de parámetro que el teléfono reconoce.

Propiedades de etiqueta de 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 la configuración de la misma configuración. Los nombres de las etiquetas XML y los nombres de campo en la interfaz de usuario Web son similares pero varían debido a las restricciones de nombres de elementos XML. Por ejemplo, subraya (_) en el archivo de configuración XML en lugar de espacios en la interfaz de usuario web.

El teléfono reconoce elementos con nombres de parámetros adecuados que están encapsulados en el <flat-profile>elemento especial.

Los nombres de los elementos están entre corchetes angulares.

La mayoría de los nombres de elementos son similares a los nombres de campo en 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 subrayado para cada espacio o los caracteres especiales [,], (,) o/.

Ejemplo: El <Resync_On_Reset>elemento 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 página.

Ejemplo: El <Dial_Plan_1_>elemento representa el plan de marcado de la línea 1.

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

<flat-profile> <Resync_On_Reset> Yes </Resync_On_Reset> <Resync_Periodic> 7200 </Resync_Periodic> <Profile_Rule>tftp://prov.telco.com: 6900/cisco/config/CP_xxxx_MPP.cfg </Profile_Rule> </flat-profile>

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

Se permiten etiquetas de elementos vacíos y se interpretarán como configurar el valor para que esté vacío. Introduzca la etiqueta del elemento de apertura sin la etiqueta de elemento correspondiente e inserte un espacio y una barra inclinada hacia delante del soporte del ángulo de cierre (>). En este ejemplo, la regla de perfil B está vacía:

<Profile_Rule_B />

Se puede usar una etiqueta de elemento vacía para evitar la sobrescritura de cualquier valor proporcionado por el usuario durante una operación de resincronización. En el siguiente ejemplo, la configuración del marcado rápido del usuario no ha cambiado:

<flat-profile> <Speed_Dial_2_Name ua="rw"/> <Speed_Dial_2_Number ua="rw"/> <Speed_Dial_3_Name ua="rw"/> <Speed_Dial_3_Number ua="rw"/> <Speed_Dial_4_Name ua="rw"/> <Speed_Dial_4_Number ua="rw"/> <Speed_Dial_5_Name ua="rw"/> <Speed_Dial_5_Number ua="rw"/> <Speed_Dial_6_Name ua="rw"/> <Speed_Dial_6_Number ua="rw"/> <Speed_Dial_7_Name ua="rw"/> <Speed_Dial_7_Number ua="rw"/> <Speed_Dial_8_Name ua="rw"/> <Speed_Dial_8_Number ua="rw"/> <Speed_Dial_9_Name ua="rw"/> <Speed_Dial_9_Number ua="rw"/> </flat-profile>

Utilice un valor vacío para establecer el parámetro correspondiente en 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.

<flat-profile> <GPP_A> </GPP_A> </flat-profile>

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 apariciones de la misma etiqueta de parámetro, la última ocurrencia de este tipo anula las anteriores. Para evitar la anulación involuntaria de los valores de configuración de un parámetro, le recomendamos 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 del último perfil tiene prioridad.

Formatos de cadena

Estas propiedades se aplican al formato de las cadenas:
Los comentarios están permitidos a través de la sintaxis XML estándar.

Los espacios en blanco al frente y al final están permitidos para la legibilidad, pero se eliminan del valor del parámetro.
Las nuevas líneas dentro de un valor se convierten en espacios.
Un encabezado XML del formulario <? ? > está permitido, pero el teléfono lo ignora.
Para introducir caracteres especiales, utilice escapes de caracteres XML básicos, como se muestra en la siguiente tabla.
Carácter especial
Secuencia de escape XML
& (ampersand)
&
< (menos que)
<
> (mayor que)
>
'(apóstrofe)
'
” (cita doble)
“
En el siguiente ejemplo, los escapes de caracteres se introducen para representar los símbolos mayores que y menores que los que se requieren en una regla de plan de marcado. Este ejemplo define un plan de marcado de línea directa de información que establece el <Dial_Plan_1_>parámetro (Inicio de sesión de administrador > avanzado > Voz > Ext (n)) igual a (S0 <:18005551212>).
<flat-profile> <Dial_Plan_1_> (S0 <:18005551212>) </Dial_Plan_1_> </flat-profile>
Los escapes numéricos de caracteres, utilizando valores decimales y hexadecimales (s.a. (y.), se traducen.
El firmware del teléfono solo admite caracteres ASCII.

Carácter especial	Secuencia de escape XML
& (ampersand)	&
< (menos que)	<
> (mayor que)	>
'(apóstrofe)	'
” (cita doble)	“

Compresión de perfil abierto

El método de compresión admitido es el algoritmo de desinflado gzip (RFC1951). La utilidad gzip y la biblioteca de compresión que implementa el mismo algoritmo (zlib) están disponibles en 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 Open 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:

>gzip profile.xml

Reemplaza el archivo original por el archivo comprimido.

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

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

Cifrado de perfil abierto

El cifrado de clave simétrica se puede utilizar para cifrar un perfil de configuración abierto, ya sea que el archivo esté comprimido o no. La compresión, si se aplica, debe aplicarse antes del cifrado.

El servidor de aprovisionamiento utiliza HTTPS para manejar el aprovisionamiento inicial del teléfono después de la implementación. La preencriptación de perfiles de configuración fuera de línea permite el uso de HTTP para resincronizar 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 archivos de configuración:

Cifrado AES-256-CBC

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

La llave o el material de clave de entrada (IKM) se deben aprovisionar previamente en la unidad en un momento anterior. El arranque de la clave secreta se puede lograr de forma segura mediante HTTPS.

El nombre del archivo de configuración no requiere un formato específico, pero un nombre de archivo que termina 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 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 recompilación de la herramienta para habilitar el código AES. El firmware ha sido probado con la versión openssl-1.1.1d.

Para un archivo cifrado, el perfil espera que el archivo tenga el mismo formato que el generado por el siguiente comando:

# example encryption key = SecretPhrase1234 openssl enc –e –aes-256-cbc –k SecretPhrase1234 –in profile.xml –out profile.cfg # analogous invocation for a compressed xml file openssl enc –e –aes-256-cbc –k SecretPhrase1234 –in profile.xml.gz –out profile.cfg

Una -k minúscula precede a la clave secreta, que puede ser cualquier frase de texto plano 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 un calificador en la dirección URL del perfil. La sintaxis es la siguiente, usando una URL explícita:

[--key “SecretPhrase1234”] http://prov.telco.com/path/profile.cfg

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

Varios parámetros de aprovisionamiento se someten a una macro expansión interna antes de ser evaluados. Este paso de preevaluación proporciona una mayor flexibilidad en el control de las actividades de resincronización y actualización del teléfono.

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

Desincronización_disparador_*

Regla de perfil*

Log_XXX_MSG

Regla de actualización

Bajo ciertas condiciones, algunos parámetros de propósito general (GPP_*) también experimentan una expansión macro, 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 reemplaza las expresiones de la forma $NAME y $ (NAME). Estas variables incluyen parámetros de propósito 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, la expresión $ (MAU) se utiliza para insertar la dirección MAC 000E08012345.

El administrador ingresa: $ (MAU) config.cfg

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

Si no se reconoce un nombre de macro, permanece sin expandirse. 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 macro resultante para un dispositivo con dirección MAC 000E08012345 es: $strange000E08012345.cfg

La expansión macro no se aplica de forma recursiva. Por ejemplo, $$MAU” se expande a $MAU” (el $$ se expande) y no da como resultado la dirección MAC.

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

Las expresiones condicionales pueden activar eventos de resincronización y seleccionar direcciones 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 cumplirse para que la condición sea cierta.

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

Valores enteros

Números de versión de software o hardware

Cadenas entre citas dobles

Números de versión

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

PHONEOS, ¡aaaa! 1-0-1-0001 - BN

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

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

Al comparar la versión de software, la versión principal, la versión secundaria y la versión micro 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 citas se pueden comparar por igualdad o desigualdad. Los números enteros y de versión también se pueden comparar aritméticamente. Los operadores de comparación se pueden expresar 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

Aplicable a operandos enteros y de versión

Aplicable a operandos de cadena entre comillas

=

eq

igual a

Sí

Sí

!=

no

no es igual a

Sí

Sí

<

Lt.

menos que

Sí

No

<=

le

menor que o igual a

Sí

No

>

Gt

mayor que

Sí

No

>=

Se

mayor que o igual a

Sí

No

AND

y

Sí

Sí

Es importante encerrar las variables macro entre comillas dobles donde se espera un literal de cadena. No lo haga donde se espera un número o número de versión.

Cuando se utiliza en el contexto de los parámetros Profile_Rule* y Upgrade_Rule, las expresiones condicionales deben estar incluidas dentro de la sintaxis “(expr)?” como en este ejemplo de regla de actualización. Recuerde reemplazar BN con 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_*.

Operador	Sintaxis alternativa	Descripción	Aplicable a operandos enteros y de versión	Aplicable a operandos de cadena entre comillas
=	eq	igual a	Sí	Sí
!=	no	no es igual a	Sí	Sí
<	Lt.	menos que	Sí	No
<=	le	menor que o igual a	Sí	No
>	Gt	mayor que	Sí	No
>=	Se	mayor que o igual a	Sí	No
AND		y	Sí	Sí

Utilice la sintaxis de URL estándar para especificar cómo recuperar archivos de configuración y cargas de firmware en los parámetros Profile_Rule* y Upgrade_Rule, 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 del 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 actualización, se debe especificar el servidor.

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

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

La expansión macro se aplica dentro de las URL. Los siguientes son ejemplos de 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 es aplicable para la regla de 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 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 clave 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, al tiempo que permiten que elementos de red de terceros utilicen los encabezados de los mensajes con fines analíticos y de monitoreo.

El parámetro de configuración XML IKM_HTTP_ENCRYPT_CONTENT contiene el IKM en el teléfono. Por razones de seguridad, no se puede acceder a este parámetro en la página web de administración del teléfono. Tampoco está 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 de codificación de contenido en el archivo de configuración tenga aes128gcm.

En ausencia de este encabezado, se da prioridad al método AES-256-CBC. El teléfono aplica el descifrado AES-256-CBC si una clave AES-256-CBC está presente en una regla de perfil, independientemente de 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 direcciones URL ingresadas en los parámetros Profile_Rule*, entre corchetes.

llave
uid y pwd

La opción --key 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 del archivo indique cifrado aes128gcm. La clave en sí se especifica como una cadena que sigue al término --key. La clave puede estar entre comillas dobles (“) opcionalmente. 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 tramos están expandidos por macro. Los parámetros de propósito especial, GPP_SA a GPP_SD, se expanden macro en variables macro, $SA a $SD, solo cuando se usan como argumentos de opciones clave. Vea estos ejemplos:

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

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

Las opciones uid y pwd se pueden usar para especificar el ID de usuario y la contraseña que se enviarán en respuesta a los desafíos de autenticación HTTP Basic y Digest cuando se solicite la URL especificada. Los argumentos opcionales entre tramos están expandidos por macro. Los parámetros de propósito especial, GPP_SA a GPP_SD, se expanden macro en variables macro, $SA a $SD, solo cuando se usan como argumentos de opciones clave. Vea estos ejemplos:

GPP_SA = MyUserID GPP_SB = MySecretPassword

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

luego se expandiría 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 elección entre a, b, c,...

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

CADScript: un miniscript que especifica los parámetros de cadencia de una señal. Hasta 127 caracteres.

Sintaxis: S ₁ [; S ₂], donde:

_{_{S _i =D _i (en _{i,1 /off i,1} [, en _i,2 /off _i,2 [, en i,3 /off _i,3 _{[, en i,4} /off _i,4 _{[, en i,5 /off i,5} _{[, en _i,6 /desactivado i,6}]]]]) y se _conoce como una sección.}}

en _{i, j} y off _{i, j} son la duración de encendido/apagado en segundos de un segmento. i = 1 o 2, y j = 1 a 6.

D _i es la duración total de la sección en segundos.

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

Ejemplo 1:

60(2/4) Number of Cadence Sections = 1 Cadence Section 1: Section Length = 60 s Number of Segments = 1 Segment 1: On=2s, Off=4s Total Ring Length = 60s

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

60(.2/.2,.2/.2,.2/.2,1/4) Number of Cadence Sections = 1 Cadence Section 1: Section Length = 60s Number of Segments = 4 Segment 1: On=0.2s, Off=0.2s Segment 2: On=0.2s, Off=0.2s Segment 3: On=0.2s, Off=0.2s Segment 4: On=1.0s, Off=4.0s Total Ring Length = 60s

DialPlanScript: sintaxis de secuencias de comandos que se utiliza para especificar planes de marcado de línea 1 y línea 2.

Flotante<n>: un valor de coma flotante con hasta n decimales.

FQDN: nombre de dominio totalmente calificado. Puede contener hasta 63 caracteres. Los ejemplos son los siguientes:
SIP.cisco.com:5060 o 109.12.14. 12:12345
SIP.cisco.com o 109.12.14.12

FreqScript: un miniscript que especifica los parámetros de frecuencia y nivel de un tono. Contiene hasta 127 caracteres.

Sintaxis: F ₁ _{@L 1} [, F ₂ _{@L 2} [, F ₃ @L ₃ [, F ₄ _{@L 4} [, F ₅ _{@L 5} [, F ₆ @L ₆]]]], donde:

F ₁ —F ₆ son frecuencia en Hz (números enteros sin signo solamente).

L ₁ —L ₆ 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 recomienda.

Ejemplo 1: Llamar al tono de espera:

440@-10 Number of Frequencies = 1 Frequency 1 = 440 Hz at –10 dBm

Ejemplo 2: tono de marcado:

350@-19,440@-19 Number of Frequencies = 2 Frequency 1 = 350 Hz at –19 dBm Frequency 2 = 440 Hz at –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.

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 una coma (,). Se ignora el espacio en blanco al comienzo de cada patrón. “?” y “*” representan caracteres comodín. Para representar literalmente, use %xx. Por ejemplo, %2a representa *. La plantilla puede contener hasta 39 caracteres. Ejemplos: “1408*, 1510*”, “1408123??? ¿555? 1.”.

Puerto: número de puerto de la red (0-65535). Se puede especificar en formato decimal o hexadecimal.

ProvisioningRulesyntax: sintaxis de secuencias de comandos que se utiliza para definir reglas de resincronización de configuración y actualización de firmware.

Nivel PWR: nivel de potencia expresado en dBm con un decimal, como —13,5 o 1,5 (dBm).

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

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

Códigos estrella: código de activación para un servicio complementario, como *69. El código puede contener hasta 7 caracteres.

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

Tiempo<n>: duración del tiempo en segundos, con hasta n decimales. Se ignoran las posiciones decimales adicionales especificadas.

ToneScript: un miniscript que especifica los parámetros de frecuencia, nivel y cadencia de un tono de progreso de llamada. El script puede contener hasta 127 caracteres.

Sintaxis: FreqScript; Z ₁ [; Z ₂].

_{_{_{_{_{_{_{La sección Z ₁ es similar a la sección S ₁ en un CADScript, excepto que cada segmento de encendido/apagado va seguido de un parámetro de componentes de frecuencia: Z _{1 = D ₁} (en _{i,1 /desactivado i,1 /f i,1 [, en i,2} /desactivado _i,2 /f _i,2 _{[, en i,3 /f i,3} _{[, en _i,4 /desactivado _i,4 /f i,4 [, en i,5} _{/apagado _i,5 /f _i,5 [, encendido i,6 /apagado i,6} /f}}}}}}} _i,6]]]]]) donde:

f _{i, j} = n ₁ [+n ₂] +n ₃ [+n ₄ [+n ₅ [+n ₆]]]].

1 < n _k < 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.

Ejemplo 1: Tono de marcado:

350@-19,440@-19;10(*/0/1+2) Number of Frequencies = 2 Frequency 1 = 350 Hz at –19 dBm Frequency 2 = 440 Hz at –19 dBm Number of Cadence Sections = 1 Cadence Section 1: Section Length = 10 s Number of Segments = 1 Segment 1: On=forever, with Frequencies 1 and 2 Total Tone Length = 10s

Ejemplo 2: Tono de tartamudeo:

350@-19,440@-19;2(.1/.1/1+2);10(*/0/1+2) Number of Frequencies = 2 Frequency 1 = 350 Hz at –19 dBm Frequency 2 = 440 Hz at –19 dBm Number of Cadence Sections = 2 Cadence Section 1: Section Length = 2s Number of Segments = 1 Segment 1: On=0.1s, Off=0.1s with Frequencies 1 and 2 Cadence Section 2: Section Length = 10s Number of Segments = 1 Segment 1: On=forever, with Frequencies 1 and 2 Total Tone Length = 12s

Uns <n>—Valor de n bits sin signo, 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.

Mantenga esto bajo consideración:

<Par Name>representa un nombre de parámetro de configuración. En un perfil, la etiqueta correspondiente se forma reemplazando el espacio con un subrayado “_”, como Par_Name.
Un campo de valor predeterminado vacío implica una cadena vacía < “” >.
El teléfono continúa utilizando los últimos valores configurados para etiquetas que no están presentes en un perfil determinado.
Las plantillas se comparan en el orden dado. Se selecciona la primera coincidencia, no la más cercana. El nombre del parámetro debe coincidir exactamente.
Si se da más de una definición para un parámetro en un perfil, la última definición de este tipo en el archivo es la que surte efecto en el teléfono.
Una especificación de parámetro con un valor de parámetro vacío obliga al parámetro a volver a su valor predeterminado. Para especificar una cadena vacía en su lugar, utilice la cadena vacía “” como valor del parámetro.

Cisco AI Assistant

Gracias por sus comentarios.