Configure seu telefone para ressincronização de perfil

Sincronizar novamente o perfil do telefone por 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 é 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 terminais remotos pela Internet, o TFTP pode ser conveniente para implantação em pequenas organizações, para provisionamento interno e para desenvolvimento e teste. No procedimento a seguir, um perfil é modificado após baixar um arquivo de um servidor TFTP.

1

Em um ambiente LAN, conecte seu computador e o telefone a um hub, comutador 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 o telefone mais tarde, você pode definir alguns dos valores como marcas. Por exemplo, defina o valor para GPP_A a 12345678 como mostrado no exemplo a seguir:
 
  <GPP_A> 12345678
  A>
_
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 em execução 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 no seu navegador da Web:


http://192.168.1.100/admin/advanced
6

Selecione a guia Voice > Provisioning e inspecione os valores dos parâmetros de finalidade geral GPP _ A por meio de GPP _ P. Estes devem estar vazios.

7

Sincronize o telefone de teste com o perfil de configuração que você criou abrindo a 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 seguinte exemplo:


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. 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 Voice > Provisioning .

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 no rótulo do produto. (O endereço MAC é o número, usando números e dígitos hexadecimais minúsculos, por exemplo, 000e08aabbcc.

2

Renomeie o arquivo de configuração para CP-xxxx macaddress.cfg (substituindo xxxx pelo número do modelo e macaddress com o 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 Voice   > 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 do perfil seja 

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

Clique em Enviar todas as alterações . Isso causa uma reinicialização e ressincronização imediatas.

Quando ocorre a próxima ressincronização, o telefone recupera o novo arquivo expandindo a expressão de macro $MA para seu endereço MAC.

Sincronizar novamente 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 de 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 regra P rofile_ 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 que o nome do arquivo do perfil seja basic.txt, insira o seguinte valor:

<P rofile_ Rule> http://192.168.1.200/basic.txt  Rule>
rofile_
5

Clique em Enviar todas as alterações . Isso causa uma reinicialização e ressincronização imediatas.

6

Observe as mensagens do 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 log 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.

Sincronizar novamente o perfil do telefone automaticamente

Um dispositivo pode ser ressincronizado periodicamente para o servidor de provisionamento para garantir que todas as alterações de perfil feitas no servidor sejam propagadas para o dispositivo do terminal (em oposição ao envio de uma solicitação de ressincronização explícita para o terminal).

Para fazer com que o telefone seja periodicamente sincronizado com um servidor, um URL de perfil de configuração é definido usando o parâmetro P rofile_ Rule e um período de ressincronização é definido usando o parâmetro R esync_ Periodic.

1

Acesse a página da Web de administração do telefone.

2

Selecione Voice   > Provisionamento .

3

Defina o parâmetro P rofile_ Rule. Este exemplo assume um endereço IP do servidor TFTP de 192.168.1.200.

4

No campo Ressincronização periódica , insira um valor pequeno para teste, como 30 segundos.

5

Clique em Enviar todas as alterações .

Com as novas configurações de parâmetros, o telefone é ressincronizado duas vezes por minuto ao arquivo de configuração especificado pela URL.

6

Observe as mensagens resultantes no rastreamento do syslog.

7

Certifique-se de que o campo Ressincronização na redefinição esteja definido como Sim .

 <R esync_ O n_ Reset>Sim O n_ Reset>
esync_
8

Desligue o telefone para forçá-lo a ressincronizar com o servidor de provisionamento.

Se a operação de ressincronização falhar por qualquer motivo, como se o servidor não estiver respondendo, a unidade aguardará (para o número de segundos configurado no atraso de repetição de erro de ressincronização ) antes de tentar sincronizar novamente. Se O atraso de repetição de erro de ressincronização for zero, o telefone não tentará sincronizar novamente após uma tentativa de ressincronização com falha.

9

(Opcional) Defina o valor do campo Atraso de repetição de erro de ressincronização para um número pequeno, como 30 .

 <R esync_ E rror_ R etry_ Atraso>30 E rror_ R etry_ Atraso>
esync_
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 de 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 no 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

Ativação de 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:

    <P rovision_ Habilitar ua="na">Sim Habilitar>rovision_

  • 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

Ressincronização ao redefinir

Especifica se o telefone sincroniza novamente 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:

    <R esync_ O n_ Redefinir ua="na">Sim O n_ Redefinir>esync_

  • Na página da Web do telefone , defina esse campo como Sim para permitir a ressincronização na inicialização ou redefinição ou Não para bloquear a ressincronização na inicialização ou redefinição.

Padrão: Sim

Atraso aleatório de ressincronização

Impede uma sobrecarga do servidor de provisionamento quando um grande número de dispositivos liga simultaneamente e tenta a configuração inicial. Esse atraso é efetivo apenas na tentativa de configuração inicial, seguindo um dispositivo ligado ou redefinido.

O parâmetro é o intervalo máximo de tempo que o dispositivo aguarda antes de fazer 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:

    <R esync_ R andom_ Atraso ua="na">2 R andom_ Atraso>esync_

  • Na página da Web do telefone , especifique o número das unidades (20 segundos) para que o telefone atrase a ressincronização após ligar ou redefinir.

O valor padrão é 2 (40 segundos).

Ressincronização às (HHmm)

A hora (HHmm) que o telefone sincroniza novamente 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:

    <R esync_ A t__ HH mm_ ua="na">0959 A t__ HH mm_>esync_

  • Na página da Web do telefone , especifique a hora no formato HHMM para que o telefone inicie 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 Ressincronização periódica será ignorado.

Ressincronização Com Atraso Aleatório

Impede uma 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 no servidor de vários telefones, o telefone é ressincronizado 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 = (Ressincronização com atraso aleatório + 30)/60 minutos, o valor de entrada em segundos será convertido em minutos, arredondando para o próximo minuto para calcular o intervalo final random_delay .

  • No arquivo de configuração do telefone (cfg.xml) com XML , insira uma string neste formato:

    <R esync_ A t_ R andom_ Atraso ua="na">600 A t_ R andom_ Atraso>esync_

  • Na página da Web do telefone , especifique o período de tempo 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 temporizador de ressincronização associado ficará 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 3000 segundos.

  • Vários números inteiros

    Exemplo: Uma entrada de 600.1200.300 indica que a primeira ressincronização ocorre em 600 segundos, a segunda ressincronização ocorre 1200 segundos após a primeira e a terceira ressincronização ocorre 300 segundos após a segunda.

  • Um intervalo de tempo

    Por exemplo, a inserção de 2400+30 indica que a próxima ressincronização ocorrerá 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:

    <R esync_ ua periódica="na">3600 Periódica>esync_

  • Na página da Web do telefone , especifique o período de tempo em segundos.

Defina esse parâmetro como zero para desativar a ressincronização periódica.

O valor padrão é 3600 segundos.

Atraso de repetição de erro de ressincronização

Se uma operação de ressincronização falhar porque o telefone não pôde recuperar um perfil do servidor ou o arquivo baixado estiver corrompido ou ocorrer um erro interno, o telefone tentará sincronizar 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 ocorrerá em 300 segundos.

  • Vários números inteiros

    Exemplo: Uma entrada de 600.1200.300 indica que a primeira tentativa ocorre em 600 segundos após a falha, a segunda tentativa ocorre em 1200 segundos após a falha da primeira tentativa e a terceira tentativa ocorre em 300 segundos após a falha da segunda tentativa.

  • Um intervalo de tempo

    Por exemplo, a entrada de 2400+30 indica que a próxima tentativa ocorrerá entre 2400 e 2430 segundos após uma falha de ressincronização.

Se o atraso for definido como 0, o dispositivo não tentará sincronizar novamente após uma tentativa de ressincronização com falha.

  • No arquivo de configuração do telefone (cfg.xml) com XML , insira uma string neste formato:

    <R esync_ E rror_ R etry_ Atraso ua="na">60,120,240,480,960,1920,3840,7680,15360,30720,61440,86400 E rror_ R etry_ Atraso>esync_

  • Na página da Web do telefone , especifique o período de tempo 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 aguarda antes de executar uma ressincronização.

O dispositivo não é ressincronizado enquanto uma de suas linhas telefônicas está ativa. Como uma ressincronização pode levar vários segundos, é desejável aguardar até que o dispositivo fique ocioso por um período longo antes da ressincronização. Isso permite que um usuário faça chamadas sucessivas sem interrupção.

O dispositivo tem um temporizador 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 atrasados até que este 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:

    <F orced_ R esync_ Atraso ua="na">14400 R esync_ Atraso>orced_

  • Na página da Web do telefone , especifique o período de tempo em segundos.

O valor padrão é 14.400 segundos.

Ressincronização De SIP

Controla as solicitações de operações de ressincronização por meio de um evento de notificação SIP enviado do servidor proxy do provedor de serviços para o telefone. Se ativado, o proxy pode solicitar uma ressincronização enviando uma mensagem de notificação SIP contendo o evento: cabeçalho de ressincronização do dispositivo.

  • No arquivo de configuração do telefone (cfg.xml) com XML , insira uma string neste formato:

    <R esync_ F rom_ SIP ua="na">Sim F rom_ SIP>esync_

  • Na página da Web do telefone , selecione Sim para ativar esse recurso ou Não para disalbe-lo.

Padrão: Sim

Ressincronização após tentativa de atualização

Ativa ou desativa a operação de ressincronização após ocorrer qualquer atualização. Se Yes for selecionada, a sincronização será acionada após uma atualização do firmware.

  • No arquivo de configuração do telefone (cfg.xml) com XML , insira uma string neste formato:

    <R esync_ A fter_ U pgrade_ Tentativa de ua="na">Sim A fter_ U pgrade_ Tentativa>esync_

  • Na página da Web do telefone , selecione Sim para acionar a ressincronização após uma atualização de firmware ou Não para não sincronizar novamente.

Padrão: Sim

Gatilho de ressincronização 1

Gatilho de ressincronização 2

Se a equação lógica nesses parâmetros for avaliada como FALSA, a ressincronização não será disparada mesmo quando Ressincronização na redefinição estiver definida como VERDADEIRO . Somente a ressincronização via URL de ação direta e notificação SIP ignora esses disparadores de ressincronização.

Os parâmetros podem ser programados com uma expressão condicional que passa pela expansão da macro. Para as expansões de macro válidas, consulte Variáveis de expansão de macro sob Parâmetros de provisionamento .

  • No arquivo de configuração do telefone (cfg.xml) com XML , insira uma string neste formato:

    <R esync_ T rigger_ 1 ua="na">$UPGTMR gt 300 e $PRVTMR ge 600 T rigger_ 1>esync_

    <R esync_ T rigger_ 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 sincronize o telefone no menu da tela do telefone. Quando definido como Sim , um usuário pode sincronizar novamente a configuração do telefone inserindo a regra de perfil do telefone. Quando definido como Não , o parâmetro 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:

    <U ser_ C onfigurable_ Ressincronizar ua="na">Sim C onfigurable_ Ressincronização>ser_

  • Na página da Web do telefone , selecione Sim para mostrar o parâmetro Regra de perfil no menu do telefone ou selecione Não para ocultar esse parâmetro.

Padrão: Sim

Falha na ressincronização em FNF

Uma ressincronização normalmente é 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 file-not-found do servidor como uma ressincronização bem-sucedida.

  • No arquivo de configuração do telefone (cfg.xml) com XML , insira uma string neste formato:

    <R esync_ F ails_ O n_ FNF ua="na">Sim F ails_ O n_ FNF>esync_

  • Na página da Web do telefone , selecione Sim para ter uma resposta file-not-found como uma ressincronização malsucedida ou selecione Não para ter uma resposta file-not-found como uma ressincronização bem-sucedida.

Padrão: Sim

Tipo de autenticação do perfil

Especifica as credenciais a serem usadas para a autenticação da conta do perfil. As opções disponíveis são:

  • Desabilitado: Desativa o recurso de conta do perfil. Quando esse recurso está desativado, o menu 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 de perfil.

  • Autenticação XSI : As credenciais de login XSI ou as credenciais SIP XSI são usadas para autenticar a conta do perfil. As credenciais de autenticação dependem do tipo de autenticação XSI do telefone:

    • Quando o tipo de autenticação XSI do telefone é definido como Credenciais de login, as credenciais de login XSI são usadas.

    • Quando o tipo de autenticação XSI do 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:

    <P rofile_ A uthentication_ Type ua="na">Autenticação Http básica A uthentication_ Type>rofile_

  • Na página da Web do telefone , selecione uma opção na lista para o telefone autenticar a ressincronização do perfil.

Padrão: Autenticação HTTP básica

Para obter mais informações, consulte Especificar o tipo de autenticação de perfil em Especificar o telefone para ressincronização de perfil .

Regra De Perfil

Regra de perfil B

Regra de perfil C

Regra de perfil D

Cada regra de perfil informa o telefone sobre uma fonte da qual se obtém 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 --key palavra-chave da seguinte forma:

[--chave ]

Você pode incluir a chave de criptografia em aspas duplas ("), se desejar.

  • No arquivo de configuração do telefone (cfg.xml) com XML , insira uma string neste formato:

    <P rofile_ Regra ua="na">/$PSN.xml Regra>rofile_

    <P rofile_ R ule_ B ua="na"/>

    <P rofile_ R ule_ C ua="na"/>

    <P rofile_ R ule_ D ua="na"/>

  • Na página da Web do telefone , especifique a regra de perfil.

Padrão: /$PSN.xml

Opção de 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 de 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 de funções Cisco XML.

Você pode enviar um objeto XML ao telefone por um pacote de notificação SIP ou um HTTP Post 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=Ressincronização:[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

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 provisionamento 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 :porta seguindo o nome do servidor.

  • O subdiretório do diretório raiz virtual do servidor onde o perfil é armazenado, especificado usando a notação de URL padrão e gerenciado por expansão de macro.

Por exemplo, o seguinte P rofile_ 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 ouvindo uma conexão na porta 6900: 

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

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

Por exemplo, suponha que GPP _ B seja definido como Dj6Lmp23Q .

A regra P rofile_ 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
Especificar o tipo de autenticação do perfil

A autenticação de perfil permite que os usuários do telefone sincronizem novamente o perfil de provisionamento no telefone. As informações de autenticação são necessárias enquanto o telefone tenta sincronizar novamente 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 Configuração da conta de perfil é exibida no telefone para as seguintes situações:

  • Quando ocorre o erro de autenticação HTTP ou HTTPs 401 durante o provisionamento inicial após a reinicialização do telefone

  • Quando o nome de usuário e a senha da conta de perfil estão vazios

  • Quando não há nome de usuário e senha na regra de perfil

Se a tela Configuração da conta de perfil for perdida ou ignorada, o usuário também poderá acessar a tela de configuração através do menu da tela do telefone ou da tecla de função Configuração , que é exibida somente quando não há nenhuma linha no telefone registrada.

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

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

  • Quando você fornece uma URL correta no campo Regra de perfil sem um nome de usuário e senha, o telefone exige autenticação ou resumo para sincronizar novamente 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 um nome de usuário e senha corretos, o telefone exige autenticação ou resumo para sincronizar novamente o perfil. A conta de perfil não é usada para ressincronização do telefone. O início de sessão foi bem-sucedido.

  • Quando você fornece um URL correto no campo Regra de perfil com um nome de usuário e senha incorretos, o telefone exige autenticação ou resumo para sincronizar novamente o perfil. A conta de perfil não é usada para ressincronização do telefone. O início de sessão sempre falha.

  • Quando você fornece uma URL incorreta no campo Regra de perfil , o início de sessão sempre falha.

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

Você pode especificar o tipo de autenticação de 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 Voice > Provisioning .

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 para a autenticação da conta do perfil.

Você pode configurar esse parâmetro no arquivo XML de configuração do telefone (cfg.xml) inserindo uma string neste formato:

<P rofile_ A uthentication_ Type ua="na">Desativado A uthentication_ Type>
rofile_

Opções:

  • Desabilitado: Desativa o recurso de conta do perfil. Quando esse recurso está desativado, o menu 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 de perfil.

  • Autenticação XSI : As credenciais de login XSI ou as credenciais SIP XSI são usadas para autenticar a conta do perfil. As credenciais de autenticação dependem do tipo de autenticação XSI do telefone:

    Quando o tipo de autenticação XSI do telefone é definido como Credenciais de login, as credenciais de login XSI são usadas.

    Quando o tipo de autenticação XSI do 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 .

Aplicar manualmente um perfil ao seu telefone

Baixar 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 no seu PC.

1

Conecte seu computador à porta LAN do telefone.

2

Execute um aplicativo de servidor TFTP no computador e certifique-se de que o arquivo de configuração esteja disponível no diretório raiz TFTP.

3

Em um navegador da Web, digite 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=

Exemplo: 

http://192.168.15.1/admin/resync?tftp://192.168.15.100/my_config.xml&xuser=admin&xpassword=admin
Baixar o arquivo de configuração para o telefone com cURL

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

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

Recomendamos que você não use a rotação para postar a configuração no telefone porque o nome de usuário e a senha podem ser capturados durante o uso da rotação.

1

Conecte seu computador à porta LAN do telefone.

2

Baixe o arquivo de configuração para o telefone inserindo o seguinte comando cURL:

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

Perfis de configuração

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 de parâmetro do telefone.

O formato XML do perfil de configuração usa ferramentas de criação XML padrão 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 de codificação; caso contrário, o telefone não poderá reconhecer o arquivo.

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

Abrir formato de perfil

O perfil de formato aberto é um arquivo de texto com sintaxe do tipo XML em uma hierarquia de elementos, com atributos e valores de elementos. Esse formato permite que você use 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 do software do servidor de provisionamento de back-end que gera perfis de configuração a partir de bancos de dados existentes.

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

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

  • Criptografia AES-256-CBC

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

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

  • Tags do elemento

  • Atributos

  • Parâmetros

  • Recursos de formatação

  • Comentários XML

Exemplo: Abrir formato de perfil

  <Resync_On_Redefinir> Sim On_Redefinir> <Resync_Periódico> 7200 Periódico> <Profile_Regra> tftp://prov.telco.com:6900/cisco/config/CP_xxxx_MPP.cfgRegra>
esync_esync_rofile_

A tag de elemento contém todos os elementos de parâmetro que o telefone reconhece.

Propriedades da marca de elemento

Tenha em mente as seguintes regras ao criar ou atualizar o arquivo de configuração.

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

  • 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 campos 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 um sublinhado por cada espaço ou os caracteres especiais [, ], (, ), ou /.

      Exemplo: O elemento <R esync_ O n_ Reset> representa o campo Ressincronização no campo Redefinir .

    • 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 Ramal. Acrescente [n] ao nome do elemento para indicar o número que é mostrado na guia de página.

      Exemplo: O <D ial_ P lan_ 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:

      <R esync_ O n_ Reset> Sim  O n_ Reset> <R esync_ Periódico> 7200 <R esync_ Periódico> <P rofile_ Regra>tftp://prov.telco.com:esync_ 6900/cisco/config/CP _xxxx_ MPP.cfg  Rule>
    rofile_

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

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

     <P rofile_ R ule_ B />

  • Uma tag de elemento vazia pode ser usada para evitar a substituição de quaisquer valores fornecidos pelo usuário durante uma operação de ressincronização. No exemplo a seguir, as configurações de discagem rápida do usuário não são alteradas:

     <Speed_Dial_2_Nome ua="rw"/> <Speed_Dial_2_Número ua="rw"/> <Speed_Dial_3_Nome ua="rw"/> <Speed_Dial_3_Número ua="rw"/> <Speed_Dial_4_Nome ua="rw"/> <Speed_Dial_4_Número ua="rw"/> <Speed_Dial_5_Nome ua="rw"/> <Speed_Dial_5_Número ua="rw"/> <Speed_Dial_6_Nome ua="rw"/> <Speed_Dial_6_Número ua="rw"/> <Speed_Dial_7_Nome ua="rw"/> <Speed_Dial_7_Número ua="rw"/> <Speed_Dial_8_Nome ua="rw"/> <Speed_Dial_8_Número ua="rw"/> <Speed_Dial_9_Nome ua="rw"/> <Speed_Dial_9_Número ua="rw"/>

  • Use um valor vazio para definir o parâmetro correspondente como uma string vazia. Insira um elemento de abertura e fechamento sem qualquer valor entre eles. No exemplo a seguir, o parâmetro GPP _ A é definido como uma string vazia.

     <flat-profile> <GPP _ A>    A> </flat-profile>
    _

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

Propriedades do parâmetro

Estas propriedades se aplicam aos parâmetros:

  • Todos os parâmetros que não são especificados por um perfil são deixados inalterados no telefone.

  • Parâmetros não reconhecidos são ignorados.

  • Se o perfil de formato aberto contiver várias ocorrências da mesma marca de parâmetro, a última ocorrência substituirá todas as anteriores. Para evitar a substituição inadvertida de valores de configuração para 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.

  • Espaço em branco à esquerda e à direita é permitido para legibilidade, mas é removido do valor do parâmetro.

  • Novas linhas dentro de um valor são convertidas em espaços.

  • Um cabeçalho XML do formulário <? ?> é permitido, mas o telefone o ignora.

  • Para inserir caracteres especiais, use os escapes de caracteres XML básicos, conforme mostrado na tabela a seguir.

    Caractere Especial

    Sequência de escape XML

    & (e comercial)

    &

    < (menor que)

    <

    > (maior que)

    >

    ’ (apóstrofo)

    '

    ” (aspas)

    "

    No exemplo a seguir, os escapes de caracteres são inseridos para representar os símbolos maiores e menores que são necessários em uma regra de plano de discagem. Este exemplo define um plano de discagem da linha direta de informações que define o <Dial_Plan_1_> parâmetro (Login do Administrador > avançado > Voz > Ramal (n)) igual a (S0 ).

      <D ial_ P lan_ 1 _> (S0 )  P lan_ 1 _>
    ial_

  • Caractere numérico escapa, usando valores decimais e hexadecimais (s.a. ( e .), são traduzidos.

  • O firmware do telefone suporta apenas caracteres ASCII.

Compactação e criptografia de perfil aberto (XML)

O perfil de configuração aberto pode ser compactado para reduzir a carga de rede no servidor de provisionamento. O perfil também pode ser criptografado para proteger informações confidenciais. A compactação não é necessária, mas deve preceder a criptografia.

Compactação de perfil aberto

O método de compactação suportado é o algoritmo de redução gzip (RFC1951). O utilitário gzip e a biblioteca de compactaçã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 aberto 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 seguintes comandos pode gerar este 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 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, se o arquivo está 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 do HTTP para sincronização posterior de perfis. Isso reduz a carga no servidor HTTPS em implantações em larga 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 AES-128-GCM

A chave ou o material de chaveamento de entrada (IKM) deve ser pré-provisionado na unidade em um momento anterior. 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 termina com o ramal .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 a partir de vários sites da Internet, pode executar a criptografia. O suporte para criptografia AES de 256 bits pode exigir a recompilação da ferramenta para ativar o código AES. O firmware foi testado contra a 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

Uma letra minúscula -k 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 de 128 bits aleatório 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 P rofile_ Rule .

Expansão de macro

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

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

  • R esync_ T rigger_*

  • Regra rofile_ P *

  • L og_xxx_ Msg

  • Regra pgrade_ U

Sob certas condições, alguns parâmetros de propósito geral (GPP _*) também passam pela expansão da 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 expressões da forma $NAME e $(NAME). Essas variáveis incluem parâmetros de propósito 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 macro sob 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 um nome de 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 macro 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 finalidade especial, GPP _ SA a GPP _ SD, é mapeado para as expressões de macro $SA a $SD. Esses parâmetros são apenas macro expandida como o argumento das opções --key, --uid , e --pwd em uma URL de ressincronização.

Expressões condicionais

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

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

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

  • Valores inteiros

  • Números de versão de software ou hardware

  • Strings com aspas duplas

Números de versão

A versão do software para o Telefone de vídeo Cisco 8875 usa esse formato (onde BN é o número da versão):

PHONEOS aaaa . 1-0-1-0001 - BN

onde aaaa indica o modelo do telefone ou a série do telefone; 1 é a versão principal; 0 é a versão menor; 1-0001 é a versão micro; e BN é o número do build.

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

Ao comparar a versão do software, a versão principal, a versão secundária e a microversão são comparadas em sequência e os dígitos mais à esquerda têm precedência sobre as últimas. 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

Strings citados podem ser comparados para igualdade ou desigualdade. Os números integrais e de versão também podem ser comparados de forma aritmética. 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 aos operandos de inteiro e de versão

Aplicável a operandos de string entre aspas

=

eq

igual a

Sim

Sim

!=

ne

não igual a

Sim

Sim

<

lt

menor que

Sim

Não

<=

le

menor que ou igual a

Sim

Não

>

gt

maior que

Sim

Não

>=

ge

maior que ou igual a

Sim

Não

E

e

Sim

Sim

É importante incluir variáveis de macro em aspas duplas onde uma string literal é esperada. Não faça isso onde um número ou número de versão é esperado.

Quando usadas no contexto dos parâmetros P rofile_ Rule* e U pgrade_ 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 a ser atualizada.

($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 R esync_ T rigger_*.

sintaxe de URL

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

[  scheme:// ] [  server [:port]] filepath

Onde scheme é um destes valores:

  • tftp

  • http

  • https

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

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

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

Se port estiver ausente, a porta padrão do esquema especificado será usada. O Tftp usa a porta UDP 69, http usa a porta TCP 80 e 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 o conteúdo dinâmico obtido por meio de CGI.

A expansão de macro se aplica a URLs. A seguir estão os exemplos de URLs 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

Ao usar a opção 66 do DHCP, a sintaxe vazia não é suportada pelas regras de atualização. Ela se aplica apenas à Regra de perfil*.

Criptografia de conteúdo HTTP baseada em RFC 8188

O telefone suporta a criptografia de conteúdo HTTP baseada no RFC 8188 com a cifragem AES-128-GCM para arquivos de configuração. Com esse método de criptografia, qualquer entidade pode ler os cabeçalhos de mensagens HTTP. No entanto, apenas as entidades que conhecem o material de chaveamento de entrada (IKM) podem ler a carga. Quando o telefone é provisionado com o IKM, o telefone e o servidor de provisionamento podem trocar arquivos de configuração com segurança, enquanto permite que elementos de rede de terceiros usem os cabeçalhos de mensagens para fins de análise e monitoramento.

O parâmetro de configuração XML IKM _ HTTP _ E ncrypt_ Content manté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 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 no RFC 8188, assegure-se do seguinte:

  • Provisione o telefone com o IKM especificando o IKM com o parâmetro XML IKM _ HTTP _ E ncrypt_ Conteúdo 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 ao telefone, assegure-se de que o cabeçalho Codificação de conteúdo HTTP no arquivo de configuração tenha aes128gcm .

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

  • Se desejar que o telefone aplique essa criptografia aos relatórios de configuração que ele envia para o servidor de provisionamento, assegure-se de que não há chave AES-256-CBC especificada na regra de relatório.

Argumentos de ressincronização opcionais

Argumentos opcionais, key , uid , e pwd , podem preceder as URLs inseridas nos parâmetros P rofile_ Rule* , coletivamente incluídas por colchetes.

chave

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 aes128gcm criptografia. A chave em si é especificada como uma string após o termo --key . A chave pode ser colocada entre aspas duplas ("), se desejar. O telefone usa a chave para descriptografar o arquivo de configuração.

Exemplos de uso 
 [--key VerySecretValue] [--key “minha frase secreta”] [--key a37d2fb9055c1d04883a0745eb0917a4]

Os argumentos opcionais entre colchetes são macros expandidas. Os parâmetros especiais, GPP _ SA a GPP _ SD, são macro expandida em variáveis de macro, $SA a $SD, somente quando usados como argumentos de opção de chave. Veja estes 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 é dado a openssl .

uid e pwd

As opções uid e pwd podem ser usadas para especificar o ID do 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 macros expandidas. Os parâmetros especiais, GPP _ SA a GPP _ SD, são macro expandida em variáveis de macro, $SA a $SD, somente quando usados como argumentos de opção de chave. Veja estes exemplos:

 GPP _ SA = MyUserID GPP _ SB = MySecretPassword

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

em seguida, expanda 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 parâmetros de perfil de configuração:

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

  • Bool — Valor booleano de "sim" ou "não".

  • CadScript — Miniscript que especifica os parâmetros de cadência de um sinal. Até 127 caracteres.

    Sintaxe: S 1 [;S 2 ], onde:

    • Si=Di(ativadoi,1/desativari,1[,oni,2/desativari,2[,oni,3/desativari,3[,oni,4/desativari,4[,oni,5/desativari,5[,oni,6/desativari,6]]]]]) e é conhecido como uma seção.

    • em i, j e off i, j são a duração de ativação/desativação 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 de uma seção são reproduzidos em ordem e repetidos até que a duração total seja reproduzida.

    Exemplo:

     60(2/4) Número de Seções de Cadência = 1 Seção de Cadência 1: Comprimento da seção = 60 s Número de segmentos = 1 segmento 1: On=2s, Off=4s Comprimento total do toque = 60s

    Exemplo 2 — Toque distinto (curto, curto, curto, longo):

     60(.2/.2,.2/.2,.2/.2,1/4) Número de seções de cadência = 1 seção de cadência 1: Comprimento da seção = 60s Número de segmentos = 4 segmento 1: On=0.2s, Off=0.2s Segmento 2: On=0.2s, Off=0.2s Segmento 3: On=0.2s, Off=0.2s Segmento 4: On=1.0s, Off=4.0s Comprimento total do toque = 60s

  • DialPlanScript — Sintaxe de script usada para especificar os planos de discagem da Linha 1 e da Linha 2.

  • Flutuar—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 — Miniscript que especifica os parâmetros de frequência e nível de um tom. Contém até 127 caracteres.

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

    • F 1 –F 6 são frequência em Hz (apenas números inteiros não assinados).

    • L 1 –L 6 são níveis correspondentes em dBm (com até uma casa decimal).

    Os 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 Número de frequências = 1 Frequência 1 = 440 Hz a –10 dBm

    Exemplo 2 — Tom de discagem:

     350@-19,440@-19 Número de frequências = 2 Frequência 1 = 350 Hz a –19 dBm Frequência 2 = 440 Hz a –19 dBm

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

  • UserID — ID de usuário como aparece em uma URL; até 63 caracteres.

  • Telefone — String de número de telefone, como 14081234567, *69, *72, 345678; ou um URL genérico, 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. For example, % 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 energia expresso em dBm com uma casa decimal, como –13.5 ou 1.5 (dBm).

  • RscTmplt — Um modelo de código de status de resposta SIP, como "404, 5*", "61?", "407, 408, 487, 481". Ele pode conter até 39 caracteres.

  • Sig—Valor de n-bit assinado. Ele pode ser especificado no formato decimal ou hexadecimal. Um sinal "-" deve preceder valores negativos. Um sinal + antes de valores positivos é opcional.

  • Códigos de estrela — Código de ativação para um serviço complementar, como *69. O código pode conter até 7 caracteres.

  • Str—Uma cadeia genérica com até n caracteres não reservados.

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

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

    Sintaxe: FreqScript;Z 1 [;Z 2 ].

    A seção Z 1 é semelhante à seção S 1 em um CadScript, exceto que cada segmento ligado/desligado é seguido por um parâmetro de componentes de frequência: Z1 = D1(ativadoi,1/desativari,1/fi,1[,oni,2/desativari,2/fi,2 [,oni,3/desativari,3/fi,3 [,oni,4/desativari,4/fi,4 [,oni,5/desativari,5/fi,5 [,oni,6/desativari,6/fi,6]]]]]) onde:

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

    • 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 juntos.

    Exemplo 1 — Tom de discagem:

     350@-19,440@-19;10(*/0/1+2) Número de frequências = 2 Frequência 1 = 350 Hz at –19 dBm Frequência 2 = 440 Hz at –19 dBm Número de seções de cadência = 1 Cadência Seção 1: Comprimento da seção = 10 s Número de segmentos = 1 segmento 1: On=para sempre, com Frequências 1 e 2 Comprimento total do tom = 10s

    Exemplo 2 — Tom pulsado:

     350@-19,440@-19;2(.1/.1/1+2);10(*/0/1+2) Número de frequências = 2 Frequência 1 = 350 Hz at –19 dBm Frequência 2 = 440 Hz at –19 dBm Número de seções de cadência = 2 Cadence Seção 1: Comprimento da seção = 2s Número de segmentos = 1 segmento 1: On=0.1s, Off=0.1s com Frequências 1 e 2 Cadence Seção 2: Comprimento da seção = 10 s Número de segmentos = 1 segmento 1: On = para sempre, com Frequências 1 e 2 Comprimento total do tom = 12s

  • Uns—Valor de n-bit não assinado, onde n = 8, 16 ou 32. Ele pode ser especificado em formato decimal ou hexadecimal, como 12 ou 0x 18, contanto que o valor possa caber em n bits.

Mantenha estes em consideração:

  • representa um nome de parâmetro de configuração. Em um perfil, a tag correspondente é formada substituindo o espaço por um sublinhado "_", como P ar_ Name .
  • Um campo de valor padrão vazio implica uma string vazia < "" >.
  • O telefone continua a usar os últimos valores configurados para tags que não estão presentes em um determinado perfil.
  • Os modelos são comparados na ordem fornecida. A primeira, não a mais próxima , correspondência é selecionada. O nome do parâmetro deve corresponder exatamente.
  • Se mais de uma definição de um parâmetro for fornecida em um perfil, a última definição no arquivo será aquela que entra 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. Para especificar uma string vazia, use a string vazia "" como valor de parâmetro.