Definir configurações de perfil para telefones das séries 9800 e 8875 (BroadWorks)

Configure seu telefone para ressincronização de perfil

Ressincronize o perfil do telefone via TFTP

O telefone suporta vários protocolos de rede para recuperar perfis de configuração. O protocolo de transferência de perfil mais básico é o TFTP (RFC1350). O TFTP é amplamente usado para o provisionamento de dispositivos de rede em redes LAN privadas. Embora não seja recomendado para a implantação de endpoints remotos na Internet, o TFTP pode ser conveniente para implantação em pequenas organizações, para pré-provisionamento interno e para desenvolvimento e teste. No procedimento a seguir, um perfil é modificado após o download de um arquivo de um servidor TFTP.

1	Em um ambiente de LAN, conecte o computador e o telefone a um hub, switch ou roteador pequeno.
2	No computador, instale e ative um servidor TFTP.
3	Use um editor de texto para criar um perfil de configuração. Para verificar se o perfil foi provisionado para seu telefone posteriormente, você pode definir alguns dos valores como marcas. Por exemplo, defina o valor de GPP_A como 12345678 conforme mostrado no exemplo a seguir: `<flat-profile>  <GPP_A> 12345678  </GPP_A> </flat-profile>`
4	Salve o arquivo de configuração XML no diretório raiz do servidor TFTP. Você pode verificar se o servidor TFTP está configurado corretamente: solicite o arquivo de perfil de configuração usando um cliente TFTP diferente do telefone. De preferência, use um cliente TFTP que esteja sendo executado em um host separado do servidor de provisionamento.
5	No navegador da Web do seu computador, abra a página da Web de administração. Por exemplo, suponha que o endereço IP do telefone seja 192.168.1.100, abra o seguinte URL em seu navegador: `http://192.168.1.100/admin/advanced`
6	Selecione a guia Voz > Provisionamento e inspecione os valores dos parâmetros de uso geral GPP_A a GPP_P. Eles devem estar vazios.
7	Ressincronize o telefone de teste com o perfil de configuração que você criou abrindo o URL de ressincronização em um navegador da Web. Exemplo: Se o endereço IP do servidor TFTP for 192.168.1.200, o comando deverá ser semelhante ao exemplo a seguir: `http://192.168.1.100/admin/resync?tftp://192.168.1.200/basic.txt` Quando o telefone recebe esse comando, o dispositivo no endereço 192.168.1.100 solicita o arquivo de perfil de configuração `basic.txt` do servidor TFTP no endereço IP 192.168.1.200. Em seguida, o telefone analisa o arquivo baixado e atualiza o parâmetro GPP_A com o valor 12345678.
8	Verifique se o parâmetro foi atualizado corretamente. Atualize a página da web de administração e vá para Voz > Provisionamento. O parâmetro GPP_A agora deve conter o valor 12345678.

Provisionar um perfil específico do telefone em um servidor TFTP

1	Obtenha o endereço MAC do telefone na etiqueta do produto. (O endereço MAC é o número, usando números e dígitos hexadecimais minúsculos, por exemplo, 000e08aabbcc.
2	Renomeie seu arquivo de configuração para `CP-xxxx macaddress.cfg` (substituindo `xxxx` pelo número do modelo e `macaddress pelo endereço` MAC do telefone). Exemplo: `CP-8875 000e08aabbcc.cfg`
3	Mova o novo arquivo para o diretório raiz virtual do servidor TFTP.
4	Acesse a página da web de administração do telefone.
5	Selecione Voz > Provisionamento.
6	Insira o caminho do arquivo de perfil no campo Regra de perfil. Exemplo: Suponha que o endereço IP do servidor TFTP seja 192.168.1.200 e o nome do arquivo de perfil seja `<Profile_Rule> tftp://192.168.1.200/CP-8875$MA.cfg </Profile_Rule>`
7	Clique em Enviar todas as alterações. Isso causa uma reinicialização e ressincronização imediatas. Quando a próxima ressincronização ocorrer, o telefone recuperará o novo arquivo expandindo a expressão da macro $MA em seu endereço MAC.

Ressincronize o perfil do telefone com HTTP GET

1	Instale um servidor HTTP no computador local ou em outro host acessível. O servidor Apache de código aberto pode ser baixado da Internet.
2	Carregue o arquivo do perfil de configuração no diretório raiz virtual do servidor instalado.
3	Para verificar a instalação adequada do servidor e o acesso ao arquivo de perfil, abra o perfil com um navegador da Web.
4	Modifique a Profile_Rule do telefone de teste para apontar para o servidor HTTP no lugar do servidor TFTP, de modo a baixar seu perfil periodicamente. Por exemplo, supondo que o servidor HTTP esteja em 192.168.1.300 e o nome do arquivo do perfil seja basic.txt, insira o seguinte valor: `<Profile_Rule> http://192.168.1.200/basic.txt </Profile_Rule>`
5	Clique em Enviar todas as alterações. Isso causa uma reinicialização e ressincronização imediatas.
6	Observe as mensagens de syslog que o telefone envia. As ressincronizações periódicas agora devem estar obtendo o perfil do servidor HTTP.
7	Nos registros do servidor HTTP, observe como as informações que identificam o telefone de teste aparecem no registro dos agentes do usuário. Essas informações devem incluir o fabricante, o nome do produto, a versão atual do firmware e o número de série.

Ressincronize o perfil do telefone automaticamente

Um dispositivo pode ressincronizar periodicamente com o servidor de provisionamento para garantir que todas as alterações de perfil feitas no servidor sejam propagadas para o dispositivo de endpoint (em vez de enviar uma solicitação explícita de ressincronização para o endpoint).

Para fazer com que o telefone seja ressincronizado periodicamente com um servidor, uma URL de perfil de configuração é definida usando o parâmetro Profile_Rule, e um período de ressincronização é definido usando o parâmetro Resync_Periodic.

1	Acesse a página da web de administração do telefone.
2	Selecione Voz > Provisionamento.
3	Defina o parâmetro Profile_Rule. Este exemplo pressupõe um endereço IP do servidor TFTP de 192.168.1.200.
4	No campo Periódico de Ressincronização, insira um pequeno valor para teste, como 30 segundos.
5	Clique em Enviar todas as alterações. Com as novas configurações de parâmetros, o telefone ressincroniza duas vezes por minuto com o arquivo de configuração que o URL especifica.
6	Observe as mensagens resultantes no rastreamento do syslog.
7	Certifique-se de que o campo Resync On Reset esteja definido como Sim. `<Resync_On_Reset>Yes</Resync_On_Reset>`
8	Desligue e desligue o telefone para forçá-lo a ressincronizar com o servidor de aprovisionamento. Se a operação de ressincronização falhar por qualquer motivo, como se o servidor não estiver respondendo, a unidade aguardará (pelo número de segundos configurado em Resync Error Retry Delay) antes de tentar ressincronizar novamente. Se o atraso na tentativa de resincronização do erro de ressincronização for zero, o telefone não tentará ressincronizar após uma tentativa fracassada de ressincronização.
9	(Opcional) Defina o valor do campo Ressync Error Retry Delay como um número pequeno, como 30. `<Resync_Error_Retry_Delay>30</Resync_Error_Retry_Delay>`
10	Desative o servidor TFTP e observe os resultados na saída do syslog.

Parâmetros de ressincronização de perfil

A tabela a seguir define a função e o uso dos parâmetros de ressincronização do perfil na seção Perfil de configuração na guia Voz > Provisionamento na página da web do telefone. Ele também define a sintaxe da string que é adicionada ao arquivo de configuração do telefone (cfg.xml) com código XML para configurar um parâmetro.

Tabela 1. Parâmetros de ressincronização de perfil
Parâmetro	Descrição
Ativar provisionamento	Permite ou nega ações de ressincronização do perfil de configuração. No arquivo de configuração do telefone (cfg.xml) com XML, insira uma string neste formato: `<Provision_Enable ua="na">Sim</Provision_Enable>` Na página da web do telefone, defina esse campo como Sim para permitir ações de ressincronização ou Não para bloquear ações de ressincronização. Padrão: Sim
Ressincronizar na reinicialização	Especifica se o telefone ressincroniza as configurações com o servidor de provisionamento após a inicialização e após cada tentativa de atualização. No arquivo de configuração do telefone (cfg.xml) com XML, insira uma string neste formato: `<Resync_On_Reset ua="na">Sim</Resync_On_Reset>` Na página da web do telefone, defina esse campo como Sim para permitir a ressincronização na inicialização ou na reinicialização, ou Não para bloquear a ressincronização na inicialização ou na reinicialização. Padrão: Sim
Atraso aleatório de ressincronização	Evita a sobrecarga do servidor de provisionamento quando um grande número de dispositivos é ligado simultaneamente e tenta a configuração inicial. Esse atraso é efetivo somente na tentativa inicial de configuração, após a inicialização ou reinicialização do dispositivo. O parâmetro é o intervalo de tempo máximo que o dispositivo espera antes de entrar em contato com o servidor de provisionamento. O atraso real é um número pseudo-aleatório entre 0 e esse valor. Esse parâmetro está em unidades de 20 segundos. O valor válido varia entre 0 e 65535. No arquivo de configuração do telefone (cfg.xml) com XML, insira uma string neste formato: `<Resync_Random_Delay ua="na">2</Resync_Random_Delay>` Na página da web do telefone, especifique o número de unidades (20 segundos) para o telefone atrasar a ressincronização após a inicialização ou a reinicialização. O valor padrão é 2 (40 segundos).
Ressincronizar em (HHmm)	A hora (hHmm) em que o telefone ressincroniza com o servidor de provisionamento. O valor desse campo deve ser um número de quatro dígitos que varia de 0000 a 2400 para indicar a hora no formato HHmm. Por exemplo, 0959 indica 09:59. No arquivo de configuração do telefone (cfg.xml) com XML, insira uma string neste formato: `<Resync_At__HHmm_ ua="na">0959</Resync_At__HHmm_>` Na página da web do telefone, especifique a hora no formato HHMM para o telefone iniciar a ressincronização. O valor padrão é vazio. Se o valor for inválido, o parâmetro será ignorado. Se esse parâmetro for definido com um valor válido, o parâmetro Resync Periodic será ignorado.
Ressincronizar com atraso aleatório	Evita a sobrecarga do servidor de provisionamento quando um grande número de dispositivos é ligado simultaneamente. Para evitar a inundação de solicitações de ressincronização para o servidor de vários telefones, o telefone ressincroniza no intervalo entre as horas e os minutos e as horas e os minutos mais o atraso aleatório (hhmm, hhmm+random_delay). Por exemplo, se o atraso aleatório = (Resync At Random Delay + 30) /60 minutos, o valor de entrada em segundos será convertido em minutos, arredondando para o próximo minuto para calcular o intervalo final de random_delay. No arquivo de configuração do telefone (cfg.xml) com XML, insira uma string neste formato: `<Resync_At_Random_Delay ua="na">600</Resync_At_Random_Delay>` Na página da web do telefone, especifique o período em segundos. O valor válido varia entre 600 e 65535. Se o valor for menor que 600, o atraso aleatório interno estará entre 0 e 600. O valor padrão é 600 segundos (10 minutos).
Ressincronização periódica	O intervalo de tempo entre a ressincronização periódica com o servidor de provisionamento. O cronômetro de ressincronização associado fica ativo somente após a primeira sincronização bem-sucedida com o servidor. Os formatos válidos são os seguintes: Um número inteiro Exemplo: Uma entrada de `3000` indica que a próxima ressincronização ocorrerá em 3.000 segundos. Vários números inteiros Exemplo: Uma entrada de `600.200.300` indica que a primeira ressincronização ocorre em 600 segundos, a segunda ressincronização ocorre em 1200 segundos após a primeira e a terceira ressincronização ocorre em 300 segundos após a segunda. Um intervalo de tempo Por exemplo, uma entrada de `2400+30` indica que a próxima ressincronização ocorre entre 2400 e 2430 segundos após uma ressincronização bem-sucedida. No arquivo de configuração do telefone (cfg.xml) com XML, insira uma string neste formato: `<Resync_Periodic ua="na">3600</Resync_Periodic>` Na página da web do telefone, especifique o período em segundos. Defina esse parâmetro como zero para desativar a ressincronização periódica. O valor padrão é 3600 segundos.
Erro de ressincronização \| Atraso na nova tentativa	Se uma operação de ressincronização falhar porque o telefone não conseguiu recuperar um perfil do servidor, se o arquivo baixado estiver corrompido ou ocorrer um erro interno, o telefone tentará ressincronizar novamente após um tempo especificado em segundos. Os formatos válidos são os seguintes: Um número inteiro Exemplo: Uma entrada de `300` indica que a próxima tentativa de ressincronização ocorre em 300 segundos. Vários números inteiros Exemplo: Uma entrada de `600.200.300` indica que a primeira tentativa ocorre em 600 segundos após a falha, a segunda ocorre em 1200 segundos após a falha da primeira tentativa e a terceira ocorre em 300 segundos após a falha da segunda tentativa. Um intervalo de tempo Por exemplo, uma entrada de `2400+30` indica que a próxima tentativa ocorre entre 2400 e 2430 segundos após uma falha de ressincronização. Se o atraso for definido como 0, o dispositivo não tentará ressincronizar novamente após uma falha na tentativa de ressincronização. No arquivo de configuração do telefone (cfg.xml) com XML, insira uma string neste formato: `<Resync_Error_Retry_Delay ua="na">60.120.240.480.960.1920.3840.7680,15360,30720,61440,86400</Resync_Error_Retry_Delay>` Na página da web do telefone, especifique o período em segundos. Padrão: 60,120,240,480,960,1920,3840,7680,15360,30720,61440,86400
Atraso de ressincronização forçada	Atraso máximo (em segundos) que o telefone espera antes de realizar uma ressincronização. O dispositivo não ressincroniza enquanto uma de suas linhas telefônicas está ativa. Como a ressincronização pode levar vários segundos, é desejável esperar até que o dispositivo fique inativo por um longo período antes de ressincronizar. Isso permite que um usuário faça chamadas em sucessão sem interrupção. O dispositivo tem um cronômetro que começa a contagem regressiva quando todas as linhas ficam ociosas. Esse parâmetro é o valor inicial do contador. Os eventos de ressincronização são adiados até que esse contador diminua para zero. O valor válido varia entre 0 e 65535. No arquivo de configuração do telefone (cfg.xml) com XML, insira uma string neste formato: `<Forced_Resync_Delay ua="na">14400</Forced_Resync_Delay>` Na página da web do telefone, especifique o período em segundos. O valor padrão é 14.400 segundos.
Ressincronizar a partir do SIP	Controla as solicitações de operações de ressincronização por meio de um evento SIP NOTIFY enviado do servidor proxy do provedor de serviços para o telefone. Se ativado, o proxy pode solicitar uma ressincronização enviando uma mensagem SIP NOTIFY contendo o cabeçalho Event: resync para o dispositivo. No arquivo de configuração do telefone (cfg.xml) com XML, insira uma string neste formato: `<Resync_From_SIP ua="na">Sim</Resync_From_SIP>` Na página da web do telefone, selecione Sim para ativar esse recurso ou Não para desativá-lo. Padrão: Sim
Ressincronizar após tentativa de atualização	Ativa ou desativa a operação de ressincronização após a ocorrência de qualquer atualização. Se a opção Sim for selecionada, a sincronização será acionada após a atualização do firmware. No arquivo de configuração do telefone (cfg.xml) com XML, insira uma string neste formato: `<Resync_After_Upgrade_Attempt ua="na">Sim</Resync_After_Upgrade_Attempt>` Na página da web do telefone, selecione Sim para acionar a ressincronização após uma atualização do firmware ou Não para não ressincronizar. Padrão: Sim
Acionador de ressincronização 1 Resync Trigger 2	Se a equação lógica nesses parâmetros for avaliada como FALSE, a ressincronização não será acionada mesmo quando a ressincronização na reinicialização estiver definida como TRUE. Somente a ressincronização via URL de ação direta e notificação SIP ignora esses gatilhos de ressincronização. Os parâmetros podem ser programados com uma expressão condicional que sofre expansão macro. Para as expansões de macro válidas, consulte Variáveis de expansão de macros em Parâmetros de provisionamento. No arquivo de configuração do telefone (cfg.xml) com XML, insira uma string neste formato: `<Resync_Trigger_1 ua="na">$ UPGTMR obtém 300 e $ PRVTMR obtém 600</Resync_Trigger_1>` `<Resync_Trigger_2 ua="na"/>` Na página da web do telefone, especifique os gatilhos. Padrão: Em branco
Ressincronização configurável pelo usuário	Permite que um usuário ressincronize o telefone a partir do menu da tela do telefone. Quando definido como Sim, um usuário pode ressincronizar a configuração do telefone inserindo a regra de perfil no telefone. Quando definido como Não, o parâmetro da regra de perfil não é exibido no menu da tela do telefone. No arquivo de configuração do telefone (cfg.xml) com XML, insira uma string neste formato: `<User_Configurable_Resync ua="na">Sim</User_Configurable_Resync>` Na página da web do telefone, selecione Sim para mostrar o parâmetro da regra de perfil no menu do telefone ou selecione Não para ocultar esse parâmetro. Padrão: Sim
A ressincronização falha no FNF	Normalmente, uma ressincronização é considerada malsucedida se um perfil solicitado não for recebido do servidor. Esse parâmetro substitui esse comportamento. Quando definido como Não, o dispositivo aceita uma resposta `de arquivo não encontrado` do servidor como uma ressincronização bem-sucedida. No arquivo de configuração do telefone (cfg.xml) com XML, insira uma string neste formato: `<Resync_Fails_On_FNF ua="na">Sim</Resync_Fails_On_FNF>` Na página da web do telefone`, selecione Sim para considerar uma resposta de arquivo não encontrado como uma ressincronização malsucedida ou selecione Não para considerar uma resposta de arquivo não encontrado como uma ressincronização bem-sucedida.` Padrão: Sim
Tipo de autenticação de perfil	Especifica as credenciais a serem usadas para autenticação da conta de perfil. As opções disponíveis são: Desativado: desativa o recurso de conta de perfil. Quando esse recurso está desativado, o menu de configuração da conta Perfil não é exibido na tela do telefone. Autenticação HTTP básica: as credenciais de login HTTP são usadas para autenticar a conta do perfil. Autenticação XSI: as credenciais de login XSI ou as credenciais XSI SIP são usadas para autenticar a conta do perfil. As credenciais de autenticação dependem do tipo de autenticação XSI para o telefone: Quando o Tipo de Autenticação XSI para o telefone é definido como Credenciais de Login, as credenciais de login XSI são usadas. Quando o Tipo de Autenticação XSI para o telefone é definido como Credenciais SIP, as credenciais SIP XSI são usadas. No arquivo de configuração do telefone (cfg.xml) com XML, insira uma string neste formato: `<Profile_Authentication_Type ua="na">Autenticação Http básica</Profile_Authentication_Type>` Na página da web do telefone, selecione uma opção na lista para que o telefone autentique a ressincronização do perfil. Padrão: Autenticação HTTP básica Para obter mais informações, consulte Especificar o tipo de autenticação do perfil em Especificar o telefone para ressincronização do perfil.
Regra de perfil Regra de perfil B Regra de perfil C Regra de perfil D	Cada regra de perfil informa ao telefone uma fonte da qual obter um perfil (arquivo de configuração). Durante cada operação de ressincronização, o telefone aplica todos os perfis em sequência. `Se você estiver aplicando a criptografia AES-256-CBC aos arquivos de configuração, especifique a chave de criptografia com a palavra-chave --key da seguinte forma:` `[--chave]` <encryption key> Opcionalmente, você pode colocar a chave de criptografia entre aspas duplas (“). No arquivo de configuração do telefone (cfg.xml) com XML, insira uma string neste formato: `<Profile_Rule ua="na">/$PSN.xml</Profile_Rule>` `<Profile_Rule_B ua="na"/>` `<Profile_Rule_C ua="na"/>` `<Profile_Rule_D ua="na"/>` Na página da web do telefone, especifique a regra do perfil. Padrão: `/$PSN.xml`
Opção DHCP a ser usada	Opções de DHCP, delimitadas por vírgulas, usadas para recuperar firmware e perfis. Padrão: 66,160,159,150,60,43,125
Opção DHCPv6 a ser usada	Opções de DHCP, delimitadas por vírgulas, usadas para recuperar firmware e perfis. Padrão: 17,160,159

Provisionamento por meio do Cisco XML

Você pode provisionar telefones por meio das funções Cisco XML.

Você pode enviar um objeto XML para o telefone por meio de um pacote SIP Notify ou uma postagem HTTP para a interface CGI do telefone: http://PhoneIPAddress/CGI/Execute.

O CP-xxxx-3PCC estende o recurso Cisco XML para suportar o provisionamento por meio de um objeto XML:


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

Depois que o telefone recebe o objeto XML, ele baixa o arquivo de provisionamento de [profile-rule]. Essa regra usa macros para simplificar o desenvolvimento do aplicativo de serviços XML.

Resolução de URL com expansão de macro

Os subdiretórios com vários perfis no servidor fornecem um método conveniente para gerenciar um grande número de dispositivos implantados. O URL do perfil pode conter:

Um nome de servidor de aprovisionamento ou um endereço IP explícito. Se o perfil identificar o servidor de provisionamento pelo nome, o telefone executará uma pesquisa de DNS para resolver o nome.
Uma porta de servidor não padrão especificada na URL usando a sintaxe padrão:port após o nome do servidor.
O subdiretório do diretório raiz virtual do servidor em que o perfil está armazenado, especificado usando a notação de URL padrão e gerenciado pela expansão de macros.

Por exemplo, a seguinte Profile_Rule solicita o arquivo de perfil ($PN.cfg), no subdiretório do servidor /cisco/config, do servidor TFTP que está sendo executado no host prov.telco.com escutando uma conexão na porta 6900:


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

Um perfil para cada telefone pode ser identificado em um parâmetro de uso geral, com seu valor referenciado em uma regra de perfil comum usando a expansão de macro.

Por exemplo, suponha que GPP_B esteja definido como Dj6Lmp23Q.

O Profile_Rule tem o valor:


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

Quando o dispositivo é sincronizado novamente e as macros são expandidas, o telefone com um endereço MAC 000e08012345 solicita o perfil com o nome que contém o endereço MAC do dispositivo no seguinte URL:


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

Especifique o tipo de autenticação do perfil

A Autenticação de Perfil permite que os usuários do telefone ressincronizem o perfil de provisionamento no telefone. As informações de autenticação são necessárias enquanto o telefone tenta ressincronizar e baixar o arquivo de configuração pela primeira vez e recebe um erro de autenticação HTTP ou HTTPS 401. Quando você ativa esse recurso, a tela de configuração da conta de perfil é exibida no telefone para as seguintes situações:

Quando o erro de autenticação HTTP ou HTTPs 401 ocorre durante o primeiro provisionamento após a reinicialização do telefone
Quando o nome de usuário e a senha da conta do perfil estão vazios
Quando não há nome de usuário e senha na regra de perfil

Se a tela de configuração da conta de perfil for perdida ou ignorada, o usuário também poderá acessar a tela de configuração por meio do menu da tela do telefone ou da tecla programável Configuração, que é exibida somente quando nenhuma linha no telefone está registrada.

Quando você desativa o recurso, a tela de configuração da conta de perfil não é exibida no telefone.

O nome de usuário e a senha no campo Regra do perfil têm uma prioridade maior do que a conta do perfil.

Quando você fornece um URL correto no campo Regra de perfil sem nome de usuário e senha, o telefone exige autenticação ou resumo para ressincronizar o perfil. Com a conta de perfil correta, a autenticação passa. Com uma conta de perfil incorreta, a autenticação falha.
Quando você fornece um URL correto no campo Regra de perfil com nome de usuário e senha corretos, o telefone exige autenticação ou resumo para ressincronizar o perfil. A conta do perfil não é usada para ressincronização telefônica. O login foi bem-sucedido.
Quando você fornece um URL correto no campo Regra de perfil com nome de usuário e senha incorretos, o telefone exige autenticação ou resumo para ressincronizar o perfil. A conta do perfil não é usada para ressincronização telefônica. O login sempre falha.
Quando você fornece um URL incorreto no campo Regra de perfil, o login sempre falha.

Você também pode configurar os parâmetros no arquivo de configuração do telefone com o código XML (cfg.xml).

Você pode especificar o tipo de autenticação do perfil na página da web de administração do telefone.

1	Acesse a página da web de administração do telefone.
2	Selecione Voz > Provisionamento.
3	Na seção Perfil de Configuração, defina o parâmetro Tipo de Autenticação de Perfil para especificar as credenciais a serem usadas na autenticação da conta de perfil. Você pode configurar esse parâmetro no arquivo XML de configuração do telefone (cfg.xml) inserindo uma string neste formato: `<Profile_Authentication_Type ua="na">Disabled</Profile_Authentication_Type>` Opções: Desativado: desativa o recurso de conta de perfil. Quando esse recurso está desativado, o menu de configuração da conta de perfil não é exibido na tela do telefone. Autenticação HTTP básica: as credenciais de login HTTP são usadas para autenticar a conta do perfil. Autenticação XSI: as credenciais de login XSI ou as credenciais XSI SIP são usadas para autenticar a conta do perfil. As credenciais de autenticação dependem do tipo de autenticação XSI para o telefone: Quando o Tipo de Autenticação XSI para o telefone é definido como Credenciais de Login, as credenciais de login XSI são usadas. Quando o Tipo de Autenticação XSI para o telefone é definido como Credenciais SIP, as credenciais SIP XSI são usadas. Padrão: Autenticação HTTP básica
4	Clique em Enviar todas as alterações.

Aplique manualmente um perfil ao seu telefone

Baixe o arquivo de configuração para o telefone a partir de um servidor TFTP

Conclua estas etapas para baixar o arquivo de configuração para um aplicativo de servidor TFTP em seu PC.

1	Conecte seu computador à porta LAN do telefone.
2	Execute um aplicativo de servidor TFTP no computador e verifique se o arquivo de configuração está disponível no diretório raiz do TFTP.
3	Em um navegador da Web, insira o endereço IP da LAN do telefone, o endereço IP do computador, o nome do arquivo e as credenciais de login. Use este formato: `http://<WAN_IP_Address>/admin/resync?tftp://<PC_IP_Address>/<file_name>&xuser=admin&xpassword=<password>` Exemplo: `http://192.168.15.1/admin/resync?tftp://192.168.15.100/my_config.xml&xuser=admin&xpassword=admin`

Baixe o arquivo de configuração para o telefone com cURL

Conclua estas etapas para baixar a configuração para o telefone usando cURL. Essa ferramenta de linha de comando é usada para transferir dados com uma sintaxe de URL. Para baixar o cURL, visite:

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

Recomendamos que você não use cURL para publicar a configuração no telefone, pois o nome de usuário e a senha podem ser capturados ao usar cURL.

1	Conecte seu computador à porta LAN do telefone.
2	Faça o download do arquivo de configuração para o telefone digitando o seguinte comando cURL: `curl –d @my_config.xml “http://192.168.15.1/admin/config.xml&xuser=admin&xpassword=admin”`

Referências para configuração de perfil

O telefone aceita configurações no formato XML.

Os exemplos nesta seção usam perfis de configuração com sintaxe XML.

Formatos de perfil de configuração

O perfil de configuração define os valores dos parâmetros para o telefone.

O formato XML do perfil de configuração usa ferramentas padrão de criação de XML para compilar os parâmetros e valores.

Somente o conjunto de caracteres UTF-8 é suportado. Se você modificar o perfil em um editor, não altere o formato da codificação; caso contrário, o telefone não reconhecerá o arquivo.

Cada telefone tem um conjunto de recursos diferente e, portanto, um conjunto diferente de parâmetros.

Formato de perfil aberto

O perfil de formato aberto é um arquivo de texto com sintaxe semelhante a XML em uma hierarquia de elementos, com atributos e valores de elementos. Esse formato permite usar ferramentas padrão para criar o arquivo de configuração. Um arquivo de configuração XML pode ser enviado do servidor de provisionamento para o telefone durante uma operação de ressincronização, sem compilação como um objeto binário.

O telefone pode aceitar formatos de configuração gerados por ferramentas padrão. Esse recurso facilita o desenvolvimento de software de servidor de provisionamento de back-end que gera perfis de configuração a partir de bancos de dados existentes.

Para proteger as informações confidenciais no perfil de configuração, o servidor de provisionamento entrega o arquivo de configuração XML ao telefone por meio de um canal protegido por TLS. Opcionalmente, o arquivo pode ser compactado usando o algoritmo gzip deflate (RFC1951).

O arquivo pode ser criptografado com um desses métodos de criptografia:

Criptografia AES-256-CBC
Criptografia de conteúdo HTTP baseada em RFC-8188 com criptografia AES-128-GCM

Um arquivo de configuração pode incluir esses componentes:

Etiquetas de elementos
Atributos
Parâmetros
Recursos de formatação
Comentários XML

Exemplo: formato de perfil aberto


<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>

A <flat-profile>tag do elemento inclui todos os elementos de parâmetros que o telefone reconhece.

Propriedades da tag do elemento

Lembre-se das seguintes regras ao criar ou atualizar o arquivo de configuração.

O formato de provisionamento XML e a interface de usuário da Web permitem a configuração das mesmas configurações. Os nomes das tags XML e os nomes dos campos na interface do usuário da Web são semelhantes, mas variam devido às restrições do nome do elemento XML. Por exemplo, sublinhados (_) no arquivo de configuração XML em vez de espaços na interface do usuário da Web.

<flat-profile>O telefone reconhece elementos com nomes de parâmetros adequados que estão encapsulados no elemento especial.

Os nomes dos elementos estão entre colchetes angulares.

A maioria dos nomes de elementos é semelhante aos nomes de campo na interface de usuário da Web do telefone, com as seguintes modificações:

Os nomes dos elementos não podem incluir espaços ou caracteres especiais. Para derivar o nome do elemento do nome do campo da web, substitua cada espaço ou os caracteres especiais [,], (,) ou/por um sublinhado.

Exemplo: O <Resync_On_Reset>elemento representa o campo Resync On Reset.

Cada nome de elemento deve ser exclusivo. Na interface de usuário da Web do telefone, os mesmos campos podem aparecer em várias páginas da Web, como as páginas Linha, Usuário e Extensão. Anexe [n] ao nome do elemento para indicar o número que é mostrado na guia da página.

Exemplo: O <Dial_Plan_1_>elemento representa o plano de discagem para a linha 1.

Cada tag de elemento de abertura deve ter uma tag de elemento de fechamento correspondente. Por exemplo:

<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>

As tags de elemento diferenciam maiúsculas de minúsculas.

Tags de elementos vazios são permitidas e serão interpretadas como uma configuração do valor como vazio. Insira a tag do elemento de abertura sem uma tag de elemento correspondente e insira um espaço e uma barra antes do colchete angular de fechamento (>). Neste exemplo, a regra de perfil B está vazia:

<Profile_Rule_B />

Uma tag de elemento vazia pode ser usada para evitar a substituição de qualquer valor fornecido pelo usuário durante uma operação de ressincronização. No exemplo a seguir, as configurações de discagem rápida do usuário permanecem inalteradas:

<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>

Use um valor vazio para definir o parâmetro correspondente como uma string vazia. Insira um elemento de abertura e fechamento sem nenhum valor entre eles. No exemplo a seguir, o parâmetro GPP_A está definido como uma string vazia.

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

Nomes de elementos não reconhecidos são ignorados.

Propriedades dos parâmetros

Essas propriedades se aplicam aos parâmetros:
Todos os parâmetros não especificados por um perfil permanecem inalterados no telefone.
Parâmetros não reconhecidos são ignorados.
Se o perfil de formato aberto contiver várias ocorrências da mesma tag de parâmetro, a última dessas ocorrências substituirá as anteriores. Para evitar a substituição inadvertida dos valores de configuração de um parâmetro, recomendamos que cada perfil especifique no máximo uma instância de um parâmetro.
O último perfil processado tem precedência. Se vários perfis especificarem o mesmo parâmetro de configuração, o valor do último perfil terá precedência.

Formatos de string

Essas propriedades se aplicam à formatação das cadeias de caracteres:
Os comentários são permitidos por meio da sintaxe XML padrão.

Os espaços em branco à esquerda e à direita são permitidos para facilitar a leitura, mas são removidos do valor do parâmetro.
Novas linhas dentro de um valor são convertidas em espaços.
Um cabeçalho XML no formato <? ? > é permitido, mas o telefone o ignora.
Para inserir caracteres especiais, use escapes básicos de caracteres XML, conforme mostrado na tabela a seguir.
Caractere especial
Sequência de escape XML
& (e comercial)
&
< (menor que)
<
> (maior que)
>
'(apóstrofo)
'
” (aspas duplas)
“
No exemplo a seguir, os escapes de caracteres são inseridos para representar os símbolos maior que e menor que que são necessários em uma regra de plano de discagem. Este exemplo define um plano de discagem de linha direta de informações que define o <Dial_Plan_1_>parâmetro (Login de administrador > avançado > Voz > Ext (n)) igual a (S0 <:18005551212>).
<flat-profile> <Dial_Plan_1_> (S0 <:18005551212>) </Dial_Plan_1_> </flat-profile>
Os escapes de caracteres numéricos, usando valores decimais e hexadecimais (s.a. (e.), são traduzidos.
O firmware do telefone suporta apenas caracteres ASCII.

Caractere especial	Sequência de escape XML
& (e comercial)	&
< (menor que)	<
> (maior que)	>
'(apóstrofo)	'
” (aspas duplas)	“

Compressão de perfil aberto

O método de compressão suportado é o algoritmo gzip deflate (RFC1951). O utilitário gzip e a biblioteca de compressão que implementa o mesmo algoritmo (zlib) estão disponíveis em sites da Internet.

Para identificar a compactação, o telefone espera que o arquivo compactado contenha um cabeçalho compatível com gzip. A invocação do utilitário gzip no perfil Open original gera o cabeçalho. O telefone inspeciona o cabeçalho do arquivo baixado para determinar o formato do arquivo.

Por exemplo, se profile.xml for um perfil válido, o arquivo profile.xml.gz também será aceito. Qualquer um dos comandos a seguir pode gerar esse tipo de perfil:

>gzip profile.xml

Substitui o arquivo original pelo arquivo compactado.

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

Deixa o arquivo original no lugar certo e produz um novo arquivo compactado.

Criptografia de perfil aberto

A criptografia de chave simétrica pode ser usada para criptografar um perfil de configuração aberto, independentemente de o arquivo estar compactado ou não. A compactação, se aplicada, deve ser aplicada antes da criptografia.

O servidor de provisionamento usa HTTPS para lidar com o provisionamento inicial do telefone após a implantação. A pré-criptografia de perfis de configuração off-line permite o uso de HTTP para ressincronizar perfis posteriormente. Isso reduz a carga no servidor HTTPS em implantações em grande escala.

O telefone suporta dois métodos de criptografia para arquivos de configuração:

Criptografia AES-256-CBC

Criptografia de conteúdo HTTP baseada em RFC 8188 com criptografia AES-128-GCM

A chave ou o material de chaveamento de entrada (IKM) deve ser pré-provisionado na unidade mais cedo. A inicialização da chave secreta pode ser realizada com segurança usando HTTPS.

O nome do arquivo de configuração não exige um formato específico, mas um nome de arquivo que termine com a extensão.cfg normalmente indica um perfil de configuração.

Criptografia AES-256-CBC

O telefone suporta criptografia AES-256-CBC para arquivos de configuração.

A ferramenta de criptografia OpenSSL, disponível para download em vários sites da Internet, pode realizar a criptografia. O suporte à criptografia AES de 256 bits pode exigir a recompilação da ferramenta para ativar o código AES. O firmware foi testado em relação à versão openssl-1.1.1d.

Para um arquivo criptografado, o perfil espera que o arquivo tenha o mesmo formato gerado pelo seguinte 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

Um -k minúsculo precede a chave secreta, que pode ser qualquer frase de texto simples e que é usada para gerar um sal aleatório de 64 bits. Com o segredo especificado pelo argumento -k, a ferramenta de criptografia deriva um vetor inicial aleatório de 128 bits e a chave de criptografia real de 256 bits.

Quando essa forma de criptografia é usada em um perfil de configuração, o telefone deve ser informado sobre o valor da chave secreta para descriptografar o arquivo. Esse valor é especificado como um qualificador na URL do perfil. A sintaxe é a seguinte, usando uma URL explícita:

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

Esse valor é programado usando um dos parâmetros Profile_Rule.

Vários parâmetros de provisionamento passam por expansão macro internamente antes de serem avaliados. Essa etapa de pré-avaliação oferece maior flexibilidade no controle das atividades de ressincronização e atualização do telefone.

Esses grupos de parâmetros passam por expansão macro antes da avaliação:

Resync_Trigger_*

Regra_do_perfil*

Log_xxx_msg

Upgrade_Rule

Sob certas condições, alguns parâmetros de uso geral (GPP_*) também passam por expansão de macro, conforme explicitamente indicado na seção Argumentos de ressincronização opcionais abaixo.

Durante a expansão da macro, o conteúdo das variáveis nomeadas substitui as expressões do formato $NAME e $ (NAME). Essas variáveis incluem parâmetros de uso geral, vários identificadores de produtos, determinados temporizadores de eventos e valores de estado de provisionamento. Para obter uma lista completa, consulte Variáveis de expansão de macros em Parâmetros de provisionamento.

No exemplo a seguir, a expressão $ (MAU) é usada para inserir o endereço MAC 000E08012345.

O administrador insere: $ (MAU) config.cfg

A expansão de macro resultante para um dispositivo com endereço MAC 000E08012345 é: 000E08012345config.cfg

Se o nome de uma macro não for reconhecido, ele permanecerá não expandido. Por exemplo, o nome STRANGE não é reconhecido como um nome de macro válido, enquanto MAU é reconhecido como um nome de macro válido.

O administrador insere: $strange$mau.cfg

A expansão de macro resultante para um dispositivo com endereço MAC 000E08012345 é: $strange000E08012345.cfg

A expansão de macros não é aplicada recursivamente. Por exemplo, $$MAU” se expande para $MAU” (o $$ é expandido) e não resulta no endereço MAC.

O conteúdo dos parâmetros de propósito especial, GPP_SA a GPP_SD, é mapeado para as expressões de macro $SA a $SD. Esses parâmetros são expandidos apenas para macro como argumento das opções --key, --uid e --pwd em um URL de ressincronização.

As expressões condicionais podem acionar eventos de ressincronização e selecionar URLs alternativos para operações de ressincronização e atualização.

As expressões condicionais consistem em uma lista de comparações, separadas pelo operador e. Todas as comparações devem ser satisfeitas para que a condição seja verdadeira.

Cada comparação pode estar relacionada a um dos três tipos de literais a seguir:

Valores inteiros

Números de versão de software ou hardware

Cadeias de caracteres com aspas duplas

Números de versão

A versão do software do Cisco Video Phone 8875 usa este formato (onde BN é o número da compilação):

TELEFONES yyyy. 1-0-1-0001 - BN

onde yyyy indica o modelo ou a série do telefone; 1 é a versão principal; 0 é a versão secundária; 1-0001 é a versão micro; e BN é o número da compilação.

A string de comparação deve usar o mesmo formato. Caso contrário, ocorrerá um erro de análise de formato.

Ao comparar a versão do software, a versão principal, a versão secundária e a versão micro são comparadas em sequência, e os dígitos mais à esquerda têm precedência sobre os últimos. Quando os números de versão são idênticos, o número da compilação é comparado.

Exemplos de número de versão válido

PHONEOS-8875.1-0-1-0001-19

Comparação

As sequências de caracteres entre aspas podem ser comparadas quanto à igualdade ou desigualdade. Números inteiros e números de versão também podem ser comparados aritmeticamente. Os operadores de comparação podem ser expressos como símbolos ou acrônimos. Os acrônimos são convenientes para expressar a condição em um perfil de formato aberto.

Operador

Sintaxe alternativa

Descrição

Aplicável a operandos de números inteiros e de versão

Aplicável a operandos de string entre aspas

=

eq

igual a

sim

sim

!=

um

não é igual a

sim

sim

<

lt

menos do que

sim

Não

<=

le

menor ou igual a

sim

Não

>

gt

maior que

sim

Não

>=

idade

maior ou igual a

sim

Não

AND

e

sim

sim

É importante colocar as variáveis macro entre aspas duplas onde se espera um literal de string. Não faça isso onde um número ou número de versão é esperado.

Quando usadas no contexto dos parâmetros Profile_Rule* e Upgrade_Rule, as expressões condicionais devem ser incluídas na sintaxe “(expr)?” como neste exemplo de regra de atualização. Lembre-se de substituir o BN pelo número de compilação da carga do firmware para o qual fazer o upgrade.

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

Não use a sintaxe anterior com parênteses para configurar os parâmetros Resync_Trigger_*.

Operador	Sintaxe alternativa	Descrição	Aplicável a operandos de números inteiros e de versão	Aplicável a operandos de string entre aspas
=	eq	igual a	sim	sim
!=	um	não é igual a	sim	sim
<	lt	menos do que	sim	Não
<=	le	menor ou igual a	sim	Não
>	gt	maior que	sim	Não
>=	idade	maior ou igual a	sim	Não
AND		e	sim	sim

Use a sintaxe de URL padrão para especificar como recuperar arquivos de configuração e cargas de firmware nos parâmetros Profile_Rule* e Upgrade_Rule, respectivamente. A sintaxe é a seguinte:

[scheme://] [server [:port]] caminho do arquivo

Onde o esquema é um desses valores:

tftp

http

https

Se o esquema for omitido, o tftp será assumido. O servidor pode ser um nome de host reconhecido pelo DNS ou um endereço IP numérico. A porta é o número da porta UDP ou TCP de destino. O caminho do arquivo deve começar com o diretório raiz (/); deve ser um caminho absoluto.

Se o servidor estiver ausente, o servidor tftp especificado por meio do DHCP (opção 66) será usado.

Para regras de atualização, o servidor deve ser especificado.

Se a porta estiver ausente, a porta padrão para o esquema especificado será usada. O Tftp usa a porta UDP 69, o http usa a porta TCP 80, o https usa a porta TCP 443.

Um caminho de arquivo deve estar presente. Ele não precisa necessariamente se referir a um arquivo estático, mas pode indicar conteúdo dinâmico obtido por meio de CGI.

A expansão de macros se aplica aos URLs. Veja a seguir exemplos de URLs válidos:

/$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

Ao usar a opção 66 do DHCP, a sintaxe vazia não é suportada pelas regras de atualização. É aplicável somente à regra de perfil*.

Criptografia de conteúdo HTTP baseada em RFC 8188

O telefone suporta criptografia de conteúdo HTTP baseada em RFC 8188 com criptografia AES-128-GCM para arquivos de configuração. Com esse método de criptografia, qualquer entidade pode ler os cabeçalhos das mensagens HTTP. No entanto, somente as entidades que conhecem o Input Keying Material (IKM) podem ler a carga útil. Quando o telefone é provisionado com o IKM, o telefone e o servidor de aprovisionamento podem trocar arquivos de configuração com segurança, permitindo que elementos de rede de terceiros usem os cabeçalhos das mensagens para fins analíticos e de monitoramento.

O parâmetro de configuração XML IKM_HTTP_ENCRYPT_CONTENT contém o IKM no telefone. Por motivos de segurança, esse parâmetro não está acessível na página da web de administração do telefone. Também não está visível no arquivo de configuração do telefone, que você pode acessar a partir do endereço IP do telefone ou dos relatórios de configuração do telefone enviados ao servidor de provisionamento.

Se você quiser usar a criptografia baseada em RFC 8188, verifique o seguinte:

Provisione o telefone com o IKM especificando o IKM com o parâmetro XML IKM_HTTP_ENCRYPT_CONTENT no arquivo de configuração que é enviado do servidor de provisionamento para o telefone.

Se essa criptografia for aplicada aos arquivos de configuração enviados do servidor de provisionamento para o telefone, certifique-se de que o cabeçalho HTTP Content-Encoding no arquivo de configuração tenha aes128gcm.

Na ausência desse cabeçalho, o método AES-256-CBC tem precedência. O telefone aplica a decodificação AES-256-CBC se uma chave AES-256-CBC estiver presente em uma regra de perfil, independentemente do IKM.

Se você quiser que o telefone aplique essa criptografia aos relatórios de configuração que ele envia ao servidor de provisionamento, certifique-se de que não haja uma chave AES-256-CBC especificada na regra do relatório.

Argumentos de ressincronização opcionais

Argumentos opcionais, key, uid e pwd, podem preceder os URLs inseridos nos parâmetros Profile_Rule*, delimitados coletivamente por colchetes.

chave
uid e pwd

A opção --key informa ao telefone que o arquivo de configuração que ele recebe do servidor de provisionamento é criptografado com criptografia AES-256-CBC, a menos que o cabeçalho Content-Encoding no arquivo indique criptografia aes128gcm. A chave em si é especificada como uma string após o termo --key. A chave pode ser colocada entre aspas duplas (“) opcionalmente. O telefone usa a chave para descriptografar o arquivo de configuração.

Exemplos de uso

[--key VerySecretValue] [--key “my secret phrase”] [--key a37d2fb9055c1d04883a0745eb0917a4]

Os argumentos opcionais entre colchetes são expandidos para macro. Parâmetros para fins especiais, GPP_SA a GPP_SD, são macroexpandidos em variáveis de macro, de $SA a $SD, somente quando usados como argumentos de opções-chave. Veja esses exemplos:

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

Em perfis de formato aberto, o argumento para --key deve ser o mesmo que o argumento para a opção -k que é fornecido ao openssl.

As opções uid e pwd podem ser usadas para especificar o ID de usuário e a senha que serão enviados em resposta aos desafios de autenticação HTTP Basic e Digest quando a URL especificada for solicitada. Os argumentos opcionais entre colchetes são expandidos para macro. Parâmetros para fins especiais, GPP_SA a GPP_SD, são macroexpandidos em variáveis de macro, de $SA a $SD, somente quando usados como argumentos de opções-chave. Veja esses exemplos:

GPP_SA = MyUserID GPP_SB = MySecretPassword

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

então se expandiria para:

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

Tipos de dados

Esses tipos de dados são usados com os parâmetros do perfil de configuração:

{a, b, c,...} —Uma escolha entre a, b, c,...

Bool — Valor booleano de “sim” ou “não”.

CADScript — Um miniscrito que especifica os parâmetros de cadência de um sinal. Até 127 caracteres.

Sintaxe: S ₁ [; S ₂], onde:

_{_{_{_{S _i =D _i (em _{i,1 /off i,1} [, em _{i,2 /off i,2} _{[, em i,3} /off _i,3 _{[, em i,4 /off i,4} _{[, em i,5 /off _i,5 [, em i,6 /off i,6}_]]]]]) e é conhecida como uma seção.}}}}

em _{i, j} e off _{i, j} são a duração de ligar/desligar em segundos de um segmento. i = 1 ou 2 e j = 1 a 6.

D _i é a duração total da seção em segundos.

Todas as durações podem ter até três casas decimais para fornecer resolução de 1 ms. O caractere curinga “*” significa duração infinita. Os segmentos dentro de uma seção são reproduzidos em ordem e repetidos até que a duração total seja reproduzida.

Exemplo 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

Exemplo 2 — Anel distintivo (curto, curto, curto, longo):

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 — sintaxe de script usada para especificar os planos de discagem da Linha 1 e da Linha 2.

Flutuante <n>— Um valor de ponto flutuante com até n casas decimais.

FQDN — Nome de domínio totalmente qualificado. Ele pode conter até 63 caracteres. Os exemplos são os seguintes:
SIP.cisco.com:5060 ou 109.12.14. 12:12345
SIP.cisco.com ou 109.12.14.12

FreqScript — um miniscrito que especifica os parâmetros de frequência e nível de um tom. Contém até 127 caracteres.

Sintaxe: F ₁ @L ₁ [, F ₂ @L ₂ [, F ₃ @L ₃ [, F ₄ @L ₄ [, F ₅ @L ₅ [, F ₆ @L ₆]]]]], onde:

F ₁ —F ₆ são frequências em Hz (somente números inteiros sem sinal).

L ₁ —L ₆ são níveis correspondentes em dBm (com até uma casa decimal).

Espaços em branco antes e depois da vírgula são permitidos, mas não recomendados.

Exemplo 1 — Tom de chamada em espera:

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

Exemplo 2 — Tom de discagem:

350@-19,440@-19 Number of Frequencies = 2 Frequency 1 = 350 Hz at –19 dBm Frequency 2 = 440 Hz at –19 dBm

IP — Endereço IPv4 válido na forma x.x.x.x, em que x está entre 0 e 255. Exemplo: 10.1.2.100.

UserID — ID do usuário conforme aparece em um URL; até 63 caracteres.

Telefone — Uma sequência de caracteres de número de telefone, como 14081234567, *69, *72, 345678; ou uma URL genérica, como 1234 @10 .10.10. 100:5068 ou jsmith@Cisco.com. A string pode conter até 39 caracteres.

phtmplt—um modelo de número de telefone. Cada modelo pode conter um ou mais padrões separados por uma vírgula (,). O espaço em branco no início de cada padrão é ignorado. “?” e “*” representam caracteres curinga. Para representar literalmente, use %xx. Por exemplo, %2a representa *. O modelo pode conter até 39 caracteres. Exemplos: “1408*, 1510*”, “1408123???? , 555? 1.”.

Porta — Número da porta TCP/UDP (0-65535). Ele pode ser especificado no formato decimal ou hexadecimal.

ProvisioningRuleSyntax — Sintaxe de script usada para definir regras de ressincronização de configuração e atualização de firmware.

PWRlevel — Nível de potência expresso em dBm com uma casa decimal, como —13,5 ou 1,5 (dBm).

RSCtmplt — um modelo do código de status de resposta SIP, como “404, 5*”, “61?” , “407, 408, 487, 481”. Ele pode conter até 39 caracteres.

Sig <n>— Valor assinado de n bits. Ele pode ser especificado no formato decimal ou hexadecimal. Um sinal “-” deve preceder os valores negativos. Um sinal + antes dos valores positivos é opcional.

Star Codes — Código de ativação para um serviço suplementar, como *69. O código pode conter até 7 caracteres.

Str <n>— Uma string genérica com até n caracteres não reservados.

Tempo <n>— Duração do tempo em segundos, com até n casas decimais. Casas decimais adicionais especificadas são ignoradas.

ToneScript — Um miniscrito que especifica os parâmetros de frequência, nível e cadência de um tom de progresso de chamada. O script pode conter até 127 caracteres.

_{Sintaxe: FreqScript; Z ₁ [; Z 2].}

_{_{_{_{_{_{_{_{_{_{A seção Z _{1 é semelhante à seção S ₁} em um CADscript, exceto que cada segmento ligado/desligado é seguido por um parâmetro de componentes de frequência: Z 1 = D 1 (em i,1 /off i,1 /f _i,1 [, em i,2 /off i,2 /f _{i,2 [, em i,3} _{/off _i,3 /f _{i,3 [, em i,4} /off i,4 /off i,4} /off _{_i,3}] f i, 4 [, em _{i, 5} /off i, 5 /f i, 5 [, em i, _{6 /off i}, 6 /f}}}}}}}}}} _i,6]]]]]]) onde:

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

1 < n _k < 6 especifica os componentes de frequência no FreqScript que são usados nesse segmento.

Se mais de um componente de frequência for usado em um segmento, os componentes serão somados.

Exemplo 1 — Tom de discagem:

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

Exemplo 2 — Tom de gagueira:

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 não assinado de n bits, em que n = 8, 16 ou 32. Ele pode ser especificado no formato decimal ou hexadecimal, como 12 ou 0x18, desde que o valor possa caber em n bits.

Leve isso em consideração:

<Par Name>representa um nome de parâmetro de configuração. Em um perfil, a tag correspondente é formada substituindo o espaço por um sublinhado “_”, como Par_Name.
Um campo de valor padrão vazio implica uma string vazia < “” >.
O telefone continua usando os últimos valores configurados para tags que não estão presentes em um determinado perfil.
Os modelos são comparados na ordem indicada. A primeira partida, não a mais próxima, é selecionada. O nome do parâmetro deve corresponder exatamente.
Se mais de uma definição para um parâmetro for fornecida em um perfil, a última definição desse tipo no arquivo será aquela que entrará em vigor no telefone.
Uma especificação de parâmetro com um valor de parâmetro vazio força o parâmetro de volta ao seu valor padrão. Em vez disso, para especificar uma string vazia, use a string vazia “” como valor do parâmetro.

Cisco AI Assistant

Obrigado pelos seus comentários.