Configurazione del telefono per la risincronizzazione del profilo

Risincronizzazione del profilo del telefono su TFTP

Il telefono supporta più protocolli di rete per il recupero dei profili di configurazione. Il protocollo di trasferimento del profilo di base è TFTP (RFC1350). TFTP è ampiamente utilizzato per il provisioning di dispositivi di rete all'interno di reti LAN private. Sebbene non sia consigliato per la distribuzione di endpoint remoti su Internet, TFTP può essere utile per la distribuzione all'interno di piccole organizzazioni, per il preprovisioning interno e per lo sviluppo e i test. Nella procedura riportata di seguito, un profilo viene modificato dopo il download di un file da un server TFTP.

1

All'interno di un ambiente LAN, collegare il computer e il telefono a un hub, uno switch o un piccolo router.

2

Sul computer, installare e attivare un server TFTP.

3

Utilizzare un editor di testo per creare un profilo di configurazione.

Per verificare se il profilo è stato predisposto sul telefono in un secondo momento, è possibile impostare alcuni valori come contrassegni. Ad esempio, impostare il valore per GPP_A su 12345678 come mostrato nell'esempio seguente:
 <flat-profile>   <GPP_A> 12345678   A> </flat-profile>
_
4

Salvare il file di configurazione XML nella directory principale del server TFTP.

È possibile verificare che il server TFTP sia configurato correttamente: richiedere il file del profilo di configurazione utilizzando un client TFTP diverso dal telefono. Preferibilmente, utilizzare un client TFTP che sia in esecuzione su un host separato dal server di provisioning.

5

Nel browser Web del computer, aprire la pagina Web di amministrazione. Ad esempio, si supponga che l'indirizzo IP del telefono sia 192.168.1.100; aprire il seguente URL nel browser Web in uso:


http://192.168.1.100/admin/advanced
6

Selezionare la scheda Voce > Provisioning e controllare i valori dei parametri per scopi generici da GPP_A a GPP_P. Questi devono essere vuoti.

7

Risincronizzare il telefono del test con il profilo di configurazione creato aprendo l'URL di risincronizzazione in un browser Web.

Esempio:

Se l'indirizzo IP del server TFTP è 192.168.1.200, il comando deve essere simile al seguente esempio:


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

Quando il telefono riceve questo comando, il dispositivo all'indirizzo 192.168.1.100 richiede il file di profilo di configurazione basic.txt dal server TFTP all'indirizzo IP 192.168.1.200. Il telefono quindi analizza il file scaricato e aggiorna il parametro GPP_A con il valore 12345678.

8

Verificare che il parametro sia stato aggiornato correttamente. Aggiornare la pagina Web di amministrazione e andare a Voce > Provisioning.

Il parametro GPP_A ora deve contenere il valore 12345678.

Provisioning di un profilo specifico del telefono su un server TFTP
1

Ottenere l'indirizzo MAC del telefono dall'etichetta del prodotto. L'indirizzo MAC è il numero, utilizzando numeri e cifre esadecimali minuscole, ad esempio 000e08aabbcc.

2

Rinominare il file di configurazione in CP-xxxx macaddress.cfg (sostituendo xxxx con il numero del modello e macaddress con l'indirizzo MAC del telefono).

Esempio:

CP-8875 000e08aabbcc.cfg

3

Spostare il nuovo file nella directory principale virtuale del server TFTP.

4

Accedere alla pagina Web di amministrazione del telefono.

5

Selezionare Voce  > Provisioning.

6

Immettere il percorso del file di profilo nel campo Regola profilo .

Esempio: Si supponga che l'indirizzo IP del server TFTP sia 192.168.1.200 e che il nome del file del profilo sia 

 <Profile_Regola> tftp://192.168.1.200/CP-8875$MA.cfg Regola>
rofile_
7

Fare clic su Invia tutte le modifiche. Ciò causa un immediato riavvio e risincronizzazione.

Quando si verifica la successiva risincronizzazione, il telefono recupera il nuovo file espandendo l'espressione macro di $MA nel relativo indirizzo MAC.

Risincronizzazione del profilo del telefono con HTTP GET
1

Installare un server HTTP sul computer locale o su un altro host accessibile.

Il server open source Apache può essere scaricato da Internet.

2

Caricare il file di profilo di configurazione nella directory principale virtuale del server installato.

3

Per verificare la corretta installazione del server e l'accesso al file del profilo, aprire il profilo con un browser Web.

4

Modificare la Regola Profile_ del telefono del test per puntare sul server HTTP al posto del server TFTP, in modo da scaricare periodicamente il relativo profilo.

Ad esempio, presupponendo che il server HTTP sia all'indirizzo 192.168.1.300 e che il nome del file del profilo sia basic.txt, immettere il valore seguente:

<Profile_Regola> http://192.168.1.200/basic.txt Regola>
rofile_
5

Fare clic su Invia tutte le modifiche. Ciò causa un immediato riavvio e risincronizzazione.

6

Osservare i messaggi syslog inviati dal telefono. Le risincronizzazioni periodiche ora devono ottenere il profilo dal server HTTP.

7

Nei registri del server HTTP, osservare le modalità in cui le informazioni che identificano il telefono del test vengono visualizzate nel registro degli agenti utente.

Queste informazioni devono includere il produttore, il nome del prodotto, la versione del firmware corrente e il numero di serie.

Risincronizzazione automatica del profilo del telefono

Un dispositivo può eseguire periodicamente la risincronizzazione al server di provisioning per garantire che eventuali modifiche del profilo apportate sul server vengano propagate al dispositivo endpoint (in alternativa all'invio di una richiesta di risincronizzazione esplicita all'endpoint).

Per fare in modo che il telefono si risincronizzi periodicamente su un server, viene definito un URL del profilo di configurazione utilizzando il parametro Profile_Rule e viene definito un periodo di risincronizzazione utilizzando il parametro Resync_Periodic.

1

Accedere alla pagina Web di amministrazione del telefono.

2

Selezionare Voce  > Provisioning.

3

Definire il parametro Profile_Rule. Questo esempio presuppone un indirizzo IP del server TFTP pari a 192.168.1.200.

4

Nel campo Risincronizzazione periodica , immettere un valore piccolo per il test, ad esempio 30 secondi.

5

Fare clic su Invia tutte le modifiche.

Con le nuove impostazioni dei parametri, il telefono si risincronizza due volte al minuto con il file di configurazione specificato dall'URL.

6

Osservare i messaggi risultanti nella traccia syslog.

7

Assicurarsi che il campo Risincronizzazione al ripristino sia impostato su Sì.

 <Resync_On_Reset>SìOn_Reset>
esync_
8

Spegnere e riaccendere il telefono per forzare la risincronizzazione sul server di provisioning.

Se l'operazione di risincronizzazione non riesce per qualsiasi motivo, ad esempio se il server non risponde, l'unità attende (per il numero di secondi configurato in Ritardo nuovo tentativo da errore risincronizzazione) prima di tentare nuovamente la risincronizzazione. Se l'opzione Ritardo nuovo tentativo errore risincronizzazione è zero, il telefono non tenta di risincronizzarsi dopo un tentativo di risincronizzazione non riuscito.

9

(Opzionale) Impostare il valore del campo Risincronizzazione ritardo nuovo tentativo errore su un numero piccolo, come 30.

 <Resync_Error_Retry_Ritardo>30Error_Retry_Ritardo>
esync_
10

Disabilitare il server TFTP e osservare i risultati nell'output syslog.

Parametri di risincronizzazione profilo

La seguente tabella definisce la funzione e l'utilizzo dei parametri per la risincronizzazione del profilo nella sezione Configuration Profile della scheda Voice > Provisioning nella pagina Web del telefono. Definisce inoltre la sintassi della stringa aggiunta nel file di configurazione del telefono (cfg.xml) con codice XML per la configurazione di un parametro.

Tabella 1. Parametri di risincronizzazione profilo

Parametro

Descrizione

Abilita provisioning

Consente di autorizzare o negare azioni di risincronizzazione del profilo.

  • Nel file di configurazione del telefono (cfg.xml) con XML, immettere una stringa in questo formato:

    <Provision_Abilita ua="na">SìAbilita>rovision_

  • Nella pagina Web del telefono, impostare questo campo su Sì per consentire le azioni di risincronizzazione o No per bloccare le azioni di risincronizzazione.

Predefinito: Sì

Risincronizza al ripristino

Specifica se il telefono risincronizza le configurazioni con il server di provisioning dopo l'accensione e dopo ogni tentativo di aggiornamento.

  • Nel file di configurazione del telefono (cfg.xml) con XML, immettere una stringa in questo formato:

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

  • Nella pagina Web del telefono, impostare questo campo su Sì per consentire la risincronizzazione all'accensione o alla reimpostazione o No per bloccare la risincronizzazione all'accensione o alla reimpostazione.

Predefinito: Sì

Ritardo casuale risincronizzazione

Impedisce un sovraccarico del server di provisioning quando un numero elevato di dispositivi si accende contemporaneamente e tenta la configurazione iniziale. Questo ritardo è efficace solo per il tentativo di configurazione iniziale, in seguito all'accensione o al ripristino di un dispositivo.

Il parametro è l'intervallo di tempo massimo che il dispositivo attende prima di effettuare il contatto con il server di provisioning. Il ritardo effettivo è un numero pseudo-casuale compreso tra 0 e questo valore.

Questo parametro è in unità di 20 secondi.

Il valore valido è compreso tra 0 e 65535.

  • Nel file di configurazione del telefono (cfg.xml) con XML, immettere una stringa in questo formato:

    <Resync_Random_Ritardo ua="na">2Random_Ritardo>esync_

  • Nella pagina Web del telefono, specificare il numero di unità (20 secondi) per ritardare la risincronizzazione dopo l'accensione o la reimpostazione.

Il valore predefinito è 2 (40 secondi).

Risincronizza alle (HHmm)

L'ora (HHmm) in cui il telefono si risincronizza con il server di provisioning.

Il valore per questo campo deve essere un numero a quattro cifre compreso tra 0000 e 2400 per indicare l'ora nel formato HHmm. Ad esempio, 0959 indica 09:59.

  • Nel file di configurazione del telefono (cfg.xml) con XML, immettere una stringa in questo formato:

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

  • Nella pagina Web del telefono, specificare l'ora in formato HHMM per l'avvio della risincronizzazione del telefono.

Il valore predefinito è vuoto. Se il valore non è valido, il parametro viene ignorato. Se questo parametro è impostato con un valore valido, il parametro Resync Periodic viene ignorato.

Risincronizzazione con ritardo casuale

Impedisce un sovraccarico del server di provisioning quando un numero elevato di dispositivi si accende contemporaneamente.

Per evitare di sovraccaricare le richieste di risincronizzazione al server da più telefoni, il telefono si risincronizza nell'intervallo tra le ore e minuti e le ore e minuti più il ritardo casuale (hhmm, hhmm+random_delay). Ad esempio, se il ritardo casuale = (risincronizzazione ritardo casuale + 30)/60 minuti, il valore di input in secondi viene convertito in minuti, con arrotondamento per eccesso al minuto successivo per calcolare l'random_delay intervallo finale.

  • Nel file di configurazione del telefono (cfg.xml) con XML, immettere una stringa in questo formato:

    <Resync_At_Random_Ritardo ua="na">600At_Random_Ritardo>esync_

  • Nella pagina Web del telefono, specificare il periodo di tempo in secondi.

Il valore valido è compreso tra 600 e 65535.

Se il valore è minore di 600, il ritardo casuale interno è compreso tra 0 e 600.

Il valore predefinito è 600 secondi (10 minuti).

Risincronizzazione periodica

L'intervallo di tempo tra le sincronizzazioni periodiche con il server di provisioning. Il timer di risincronizzazione associato è attivo solo dopo la prima sincronizzazione corretta con il server.

I formati validi sono i seguenti:

  • Un intero

    Esempio: Un input di 3000 indica che la risincronizzazione successiva si verifica tra 3000 secondi.

  • Più numeri interi

    Esempio: Un input di 600.1200.300 indica che la prima risincronizzazione si verifica tra 600 secondi, la seconda si verifica tra 1200 secondi dopo la prima e la terza si verifica tra 300 secondi dopo la seconda.

  • Un intervallo di tempo

    Esempio, un input di 2400+30 indica che la risincronizzazione successiva si verifica tra 2400 e 2430 secondi dopo una risincronizzazione riuscita.

  • Nel file di configurazione del telefono (cfg.xml) con XML, immettere una stringa in questo formato:

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

  • Nella pagina Web del telefono, specificare il periodo di tempo in secondi.

Impostare questo parametro su zero per disabilitare la risincronizzazione periodica.

Il valore predefinito è 3600 secondi.

Ritardo nuovo tentativo da errore risincronizzazione

Se un'operazione di risincronizzazione non viene completata perché il telefono non è stato in grado di recuperare un profilo dal server oppure se il file scaricato è danneggiato o si è verificato un errore interno, il telefono tenta nuovamente la risincronizzazione dopo un tempo specificato in secondi.

I formati validi sono i seguenti:

  • Un intero

    Esempio: Un input di 300 indica che il successivo tentativo di risincronizzazione si verifica tra 300 secondi.

  • Più numeri interi

    Esempio: Un input pari a 600.1200.300 indica che il primo tentativo si verifica 600 secondi dopo l'errore, il secondo si verifica 1200 secondi dopo l'errore del primo tentativo e il terzo si verifica 300 secondi dopo l'errore del secondo tentativo.

  • Un intervallo di tempo

    Esempio, un input di 2400+30 indica che il tentativo successivo si verifica tra 2400 e 2430 secondi dopo un errore di risincronizzazione.

Se il ritardo è impostato su 0, il dispositivo non tenta nuovamente la risincronizzazione dopo un tentativo di risincronizzazione non riuscito.

  • Nel file di configurazione del telefono (cfg.xml) con XML, immettere una stringa in questo formato:

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

  • Nella pagina Web del telefono, specificare il periodo di tempo in secondi.

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

Ritardo risincronizzazione forzata

Massimo ritardo (in secondi) che il telefono attende prima di eseguire una risincronizzazione.

Il dispositivo non esegue la risincronizzazione mentre una delle sue linee telefoniche è attiva. Una risincronizzazione può richiedere alcuni secondi. È opportuno attendere fino a quando il dispositivo è in stato inattivo per un periodo prolungato prima di eseguire la risincronizzazione. Ciò consente all'utente di effettuare chiamate in successione senza interruzioni.

Il dispositivo dispone di un timer che inizia il conteggio alla rovescia quando tutte le linee diventano inattive. Questo parametro è il valore iniziale del contatore. Gli eventi di risincronizzazione vengono ritardati fino a quando il contatore non diminuisce fino a raggiungere zero.

Il valore valido è compreso tra 0 e 65535.

  • Nel file di configurazione del telefono (cfg.xml) con XML, immettere una stringa in questo formato:

    <Forced_Resync_Ritardo ua="na">14400Resync_Ritardo>orced_

  • Nella pagina Web del telefono, specificare il periodo di tempo in secondi.

Il valore predefinito è 14.400 secondi.

Risincronizza da SIP

Controlla le richieste di operazioni di risincronizzazione tramite un evento NOTIFICA SIP inviato dal server proxy del provider di servizi al telefono. Se abilitato, il proxy può richiedere una risincronizzazione inviando un messaggio di NOTIFICA SIP contenente l'evento: risincronizza l'intestazione con il dispositivo.

  • Nel file di configurazione del telefono (cfg.xml) con XML, immettere una stringa in questo formato:

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

  • Nella pagina Web del telefono, selezionare Sì per abilitare questa funzione o No per disabilitarla.

Predefinito: Sì

Risincronizzazione dopo tentativo di aggiornamento

Consente di abilitare o disabilitare l'operazione di risincronizzazione dopo qualsiasi aggiornamento. Se è selezionato Sì , la sincronizzazione viene attivata dopo un aggiornamento del firmware.

  • Nel file di configurazione del telefono (cfg.xml) con XML, immettere una stringa in questo formato:

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

  • Nella pagina Web del telefono, selezionare Sì per attivare la risincronizzazione dopo un aggiornamento del firmware o No per non eseguire la risincronizzazione.

Predefinito: Sì

Attivazione risincronizzazione 1

Trigger risincronizzazione 2

Se l'equazione logica in questi parametri viene valutata come FALSE, la risincronizzazione non viene attivata anche quando Resync On Reset è impostato su TRUE. Le attivazioni di risincronizzazione vengono ignorate solo dalla sincronizzazione tramite URL di azione diretta e notifica SIP.

I parametri possono essere programmati con un'espressione condizionale che viene sottoposta a espansione macro. Per le espansioni macro valide, vedere Variabili espansione macro in Parametri di provisioning.

  • Nel file di configurazione del telefono (cfg.xml) con XML, immettere una stringa in questo formato:

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

    <Resync_Trigger_2 ua="na"/>

  • Nella pagina Web del telefono, specificare gli attivatori.

Predefinito: Vuoto

Risincronizzazione configurabile dall'utente

Consente a un utente di risincronizzare il telefono dal menu dello schermo del telefono. Se impostato su Yes, un utente può risincronizzare la configurazione del telefono immettendo la regola del profilo dal telefono. Se impostato su No, il parametro Regola profilo non viene visualizzato nel menu dello schermo del telefono.

  • Nel file di configurazione del telefono (cfg.xml) con XML, immettere una stringa in questo formato:

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

  • Nella pagina Web del telefono, selezionare Sì per visualizzare il parametro Regola profilo nel menu del telefono oppure selezionare No per nascondere questo parametro.

Predefinito: Sì

Risincronizzazione non riuscita su FNF

Una risincronizzazione viene solitamente considerata come non riuscita se il server non riceve un profilo richiesto. Questo parametro ignora questo funzionamento. Se è impostato su No, il dispositivo accetta una risposta file-not-found dal server come risincronizzazione riuscita.

  • Nel file di configurazione del telefono (cfg.xml) con XML, immettere una stringa in questo formato:

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

  • Nella pagina Web del telefono, selezionare Sì per considerare una risposta file-not-found come risincronizzazione non riuscita oppure selezionare No per considerare una risposta file-not-found come risincronizzazione riuscita.

Predefinito: Sì

Tipo di autenticazione profilo

Specifica le credenziali da utilizzare per l'autenticazione dell'account del profilo. Le opzioni disponibili sono:

  • Disabled (Disabilitato): Consente di disabilitare la funzione di account profilo. Se questa funzione è disabilitata, il menu Impostazione account profilo non viene visualizzato sullo schermo del telefono.

  • Autenticazione HTTP di base: Le credenziali di accesso HTTP vengono utilizzate per autenticare l'account del profilo.

  • Autenticazione XSI: Le credenziali di accesso XSI o le credenziali SIP XSI vengono utilizzate per autenticare l'account del profilo. Le credenziali di autenticazione dipendono dal Tipo di autenticazione XSI del telefono:

    • Se il Tipo di autenticazione XSI del telefono è impostato su Credenziali di accesso, vengono utilizzate le credenziali di accesso XSI.

    • Se il Tipo di autenticazione XSI del telefono è impostato su Credenziali SIP, vengono utilizzate le credenziali SIP XSI.

  • Nel file di configurazione del telefono (cfg.xml) con XML, immettere una stringa in questo formato:

    <Profile_Authentication_Type ua="na">Autenticazione Http baseAuthentication_Type>rofile_

  • Nella pagina Web del telefono, selezionare un'opzione dall'elenco per consentire l'autenticazione della risincronizzazione del profilo del telefono.

Predefinito: Autenticazione HTTP di base

Per ulteriori informazioni, vedere Specifica del tipo di autenticazione profilo in Specifica del telefono per la risincronizzazione del profilo.

Regola profilo

Regola profilo B

Regola profilo C

Regola profilo D

Ogni regola profilo informa il telefono di un'origine da cui ottenere un profilo (file di configurazione). Durante ogni operazione di risincronizzazione, il telefono applica tutti i profili in sequenza.

Se si applica la crittografia AES-256-CBC ai file di configurazione, specificare la chiave di crittografia con la parola chiave --key nel seguente modo:

[--chiave ]

Facoltativamente, è possibile racchiudere la chiave di crittografia tra virgolette (").

  • Nel file di configurazione del telefono (cfg.xml) con XML, immettere una stringa in questo formato:

    <Profile_Regola ua="na">/$PSN.xmlRegola>rofile_

    <Profile_Rule_B ua="na"/>

    <Profile_Rule_C ua="na"/>

    <Profile_Rule_D ua="na"/>

  • Nella pagina Web del telefono, specificare la regola del profilo.

Impostazione predefinita: /$PSN.xml

Opzione DHCP da utilizzare

Opzioni DHCP, delimitate da virgole, utilizzate per recuperare firmware e profili.

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

Opzione DHCPv6 da utilizzare

Opzioni DHCP, delimitate da virgole, utilizzate per recuperare firmware e profili.

Predefinito: 17,160,159

Il provisioning tramite Cisco XML

È possibile eseguire il provisioning dei telefoni tramite le funzioni Cisco XML.

È possibile inviare un oggetto XML al telefono da un pacchetto di notifica SIP o da un HTTP POST all'interfaccia CGI del telefono: http://PhoneIPAddress/CGI/Execute.

CP-xxxx-3PCC estende la funzione Cisco XML per supportare il provisioning tramite un oggetto XML:

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

Dopo aver ricevuto l'oggetto XML, il telefono scarica il file di provisioning da [profile-rule]. Questa regola utilizza le macro per semplificare lo sviluppo dell'applicazione dei servizi XML.

Risoluzione URL con espansione macro

Sottodirectory con più profili sul server forniscono un pratico metodo per gestire un numero elevato di dispositivi distribuiti. L'URL del profilo può contenere:

  • Un nome del server di provisioning o un indirizzo IP esplicito. Se il profilo identifica il server di provisioning in base al nome, il telefono esegue una ricerca DNS per risolvere il nome.

  • Una porta del server non standard specificata nell'URL utilizzando la sintassi standard :porta che segue il nome del server.

  • La sottodirectory della directory principale virtuale del server in cui è memorizzato il profilo, specificato utilizzando una notazione URL standard e gestita dall'espansione macro.

Ad esempio, la seguente regola Profile_richiede il file di profilo ($PN.cfg), nella sottodirectory del server /cisco/config, dal server TFTP in esecuzione sull'host prov.telco.com in attesa di una connessione sulla porta 6900: 

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

Un profilo per ciascun telefono può essere identificato in un parametro per scopi generici, con il relativo valore denominato all'interno di una regola del profilo comune tramite l'espansione macro.

Ad esempio, si supponga che GPP_B sia definito come Dj6Lmp23Q.

La regola Profile_ ha il valore:

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

Quando il dispositivo si risincronizza e le macro vengono espanse, il telefono con l'indirizzo MAC di 000e08012345 richiede il profilo con il nome che contiene l'indirizzo MAC del dispositivo al seguente URL:

 tftp://prov.telco.com/cisco/Dj6Lmp23Q/000e08012345.cfg
Specifica il tipo di autenticazione del profilo

L'autenticazione del profilo consente agli utenti del telefono di risincronizzare il profilo di provisioning sul telefono. Le informazioni di autenticazione sono necessarie quando il telefono tenta di risincronizzare e scaricare il file di configurazione per la prima volta e riceve un errore di autenticazione HTTP o HTTPS 401. Se si abilita questa funzione, la schermata Impostazione account profilo viene visualizzata sul telefono nelle situazioni seguenti:

  • Se l'errore di autenticazione HTTP o HTTPs 401 si verifica durante il primo provisioning dopo il riavvio del telefono

  • Se il nome utente e la password dell'account profilo sono vuoti

  • Se non sono presenti nome utente e password nella regola del profilo

Se la schermata Impostazione account profilo viene ignorata o ignorata, l'utente può accedere alla schermata di impostazione anche tramite il menu dello schermo del telefono o il softkey Imposta che viene visualizzato solo se sul telefono non è registrata alcuna linea.

Se si disabilita la funzione, la schermata Impostazione account profilo non viene visualizzata sul telefono.

Il nome utente e la password nel campo Regola profilo hanno una priorità superiore rispetto all'account del profilo.

  • Se si fornisce un URL corretto nel campo Regola profilo senza nome utente e password, il telefono richiede l'autenticazione o il digest per risincronizzare il profilo. Con l'account profilo corretto, l'autenticazione passa. Con un account profilo errato, l'autenticazione ha esito negativo.

  • Se si fornisce un URL corretto nel campo Regola profilo con nome utente e password corretti, il telefono richiede l'autenticazione o il digest per risincronizzare il profilo. L'account del profilo non viene utilizzato per la risincronizzazione del telefono. Accesso eseguito correttamente.

  • Se si fornisce un URL corretto nel campo Regola profilo con nome utente e password errati, il telefono richiede l'autenticazione o il digest per risincronizzare il profilo. L'account del profilo non viene utilizzato per la risincronizzazione del telefono. L'accesso ha sempre esito negativo.

  • Se si fornisce un URL errato nel campo Regola profilo , l'accesso ha sempre esito negativo.

È inoltre possibile configurare i parametri nel file di configurazione del telefono con codice XML (cfg.xml).

È possibile specificare il tipo di autenticazione di profilo dalla pagina Web di amministrazione del telefono.

1

Accedere alla pagina Web di amministrazione del telefono.

2

Selezionare Voce > Provisioning.

3

Nella sezione Profilo di configurazione , impostare il parametro Tipo di autenticazione profilo per specificare le credenziali da utilizzare per l'autenticazione dell'account profilo.

È possibile configurare questo parametro nel file XML di configurazione del telefono (cfg.xml) immettendo una stringa in questo formato:

<Profile_Authentication_Type ua="na">DisabilitatoAuthentication_Type>
rofile_

Opzioni:

  • Disabled (Disabilitato): Disabilita la funzione di account profilo. Con questa funzione disabilitata, il menu Impostazione account profilo non viene visualizzato sullo schermo del telefono.

  • Autenticazione HTTP di base: Le credenziali di accesso HTTP vengono utilizzate per autenticare l'account del profilo.

  • Autenticazione XSI: Le credenziali di accesso XSI o le credenziali SIP XSI vengono utilizzate per autenticare l'account del profilo. Le credenziali di autenticazione dipendono dal Tipo di autenticazione XSI del telefono:

    Se il Tipo di autenticazione XSI del telefono è impostato su Credenziali di accesso, vengono utilizzate le credenziali di accesso XSI.

    Se il Tipo di autenticazione XSI del telefono è impostato su Credenziali SIP, vengono utilizzate le credenziali SIP XSI.

Predefinito: Autenticazione HTTP di base

4

Fare clic su Invia tutte le modifiche.

Applicazione manuale di un profilo al telefono

Download del file di configurazione per il telefono da un server TFTP

Completare questa procedura per scaricare il file di configurazione in un'applicazione server TFTP sul proprio PC.

1

Collegare il computer alla porta LAN del telefono.

2

Eseguire un'applicazione server TFTP sul computer e assicurarsi che il file di configurazione sia disponibile nella directory principale TFTP.

3

In un browser Web, immettere l'indirizzo IP della LAN del telefono, l'indirizzo IP del computer, il nome del file e le credenziali di accesso. Utilizzare questo formato:

http://<Indirizzo_IP_WAN>/admin/resync?tftp://<Indirizzo_IP_PC>/<file_name>&xuser=admin&xpassword=

Esempio: 

http://192.168.15.1/admin/resync?tftp://192.168.15.100/my_config.xml&xuser=admin&xpassword=admin
Download del file di configurazione sul telefono con cURL

Per scaricare la configurazione del telefono utilizzando cURL, completare questa procedura. Questo strumento a riga di comando viene utilizzato per trasferire i dati con una sintassi URL. Per scaricare cURL, visitare:

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

Si consiglia di non utilizzare cURL per pubblicare la configurazione sul telefono, poiché il nome utente e la password potrebbero essere acquisiti durante l'uso di cURL.

1

Collegare il computer alla porta LAN del telefono.

2

Per scaricare il file di configurazione sul telefono, immettere il seguente comando cURL:

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

Profili di configurazione

Il telefono accetta le configurazioni in formato XML.

Gli esempi in questa sezione utilizzano profili di configurazione con sintassi XML.

Formati di profili di configurazione

Il profilo di configurazione definisce i valori del parametro per il telefono.

Il formato XML profilo di configurazione utilizza gli strumenti di creazione XML standard per compilare i parametri e i valori.

È supportato solo il set di caratteri UTF-8. Se si modifica il profilo in un editor, non modificare il formato di codifica; in caso contrario, il telefono non sarà in grado di riconoscere il file.

Ogni telefono dispone di un set di funzioni diverso e, pertanto, di una serie di parametri diversa.

Apri formato profilo

Il profilo in formato Open è un file di testo con sintassi simile a XML in una gerarchia di elementi, con attributi e valori degli elementi. Questo formato consente di utilizzare gli strumenti standard per creare il file di configurazione. È possibile inviare un file di configurazione XML dal server di provisioning al telefono durante un'operazione di risincronizzazione, senza compilazione come oggetto binario.

Il telefono può accettare formati di configurazione generati dagli strumenti standard. Questa funzione facilita lo sviluppo del software del server di provisioning back-end che genera profili di configurazione dai database esistenti.

Per proteggere le informazioni riservate nel profilo di configurazione, il server di provisioning fornisce il file di configurazione XML al telefono tramite un canale protetto da TLS. Se si desidera, il file può essere compresso utilizzando l'algoritmo di deflazione gzip (RFC1951).

Il file può essere crittografato con uno dei seguenti metodi di crittografia:

  • Crittografia AES-256-CBC

  • Crittografia dei contenuti HTTP basata su RFC 8188 con cifratura AES-128-GCM

Un file di configurazione può includere i seguenti componenti:

  • Tag elementi

  • Attributi

  • Parametri

  • Funzioni di formattazione

  • Commenti XML

Esempio: Apri formato profilo

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

Il tag elemento racchiude tutti gli elementi parametri riconosciuti dal telefono.

Proprietà tag elemento

Quando si crea o si aggiorna il file di configurazione, tenere presente le seguenti regole.

  • Il formato di provisioning XML e l'interfaccia utente Web consentono la configurazione delle stesse impostazioni. I nomi dei tag XML e i nomi dei campi nell'interfaccia utente Web sono simili ma variano a causa di limitazioni del nome degli elementi XML. Ad esempio, caratteri di sottolineatura ( _ ) nel file di configurazione XML anziché negli spazi sull'interfaccia utente Web.

  • Il telefono riconosce elementi con nomi di parametri corretti che sono incapsulati nell'elemento speciale .

  • I nomi degli elementi sono racchiusi tra parentesi angolari.

  • La maggior parte dei nomi degli elementi sono simili ai nomi dei campi nell'interfaccia utente Web del telefono, con le seguenti modifiche:

    • I nomi degli elementi non possono includere spazi o caratteri speciali. Per derivare il nome dell'elemento dal nome del campo Web, sostituire un trattino basso per ogni spazio o carattere speciale [, ], (, ) o /.

      Esempio: L'elemento <Resync_On_Reset> rappresenta il campo Risincronizza su ripristino .

    • Il nome di ciascun elemento deve essere univoco. Nell'interfaccia utente Web del telefono, gli stessi campi possono essere visualizzati su più pagine Web, ad esempio le pagine di linea, dell'utente e degli interni. Aggiungere [n] al nome dell'elemento per indicare il numero visualizzato nella scheda pagina.

      Esempio: L'elemento <Dial_Plan_1_> rappresenta il Piano di chiamata per la linea 1.

  • Ogni tag elemento di apertura deve avere un tag elemento di chiusura corrispondente. Ad esempio:

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

  • I tag elemento distinguono tra maiuscole e minuscole.

  • I tag elemento vuoti sono consentiti e verranno interpretati come configurazione del valore vuoto. Immettere il tag dell'elemento di apertura senza un tag di elemento corrispondente e inserire uno spazio e una barra prima della parentesi angolare di chiusura (>). In questo esempio, la regola del profilo B è vuota:

     <Profile_Rule_B />

  • È possibile utilizzare un tag elemento vuoto per evitare la sovrascrittura dei valori forniti dall'utente durante un'operazione di risincronizzazione. Nell'esempio seguente, le impostazioni di chiamata rapida utente non vengono modificate:

     <Speed_dial_2_Nome ua="rw"/> <Speed_dial_2_Numero ua="rw"/> <Speed_dial_3_Nome ua="rw"/> <Speed_dial_3_Numero ua="rw"/> <Speed_dial_4_Nome ua="rw"/> <Speed_dial_4_Numero ua="rw"/> <Speed_dial_5_Nome ua="rw"/> <Speed_dial_5_Numero ua="rw"/> <Speed_dial_6_Nome ua="rw"/> <Speed_dial_6_Numero ua="rw"/> <Speed_dial_7_Nome ua="rw"/> <Speed_dial_7_Numero ua="rw"/> <Speed_dial_8_Nome ua="rw"/> <Speed_dial_8_Numero ua="rw"/> <Speed_dial_9_Nome ua="rw"/> <Speed_dial_9_Numero ua="rw"/>

  • Utilizzare un valore vuoto per impostare il parametro corrispondente a una stringa vuota. Immettere un elemento di apertura e chiusura senza alcun valore tra di essi. Nell'esempio seguente, il parametro GPP_A è impostato su una stringa vuota.

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

  • I nomi di elementi non riconosciuti vengono ignorati.

Proprietà dei parametri

Queste proprietà si applicano ai parametri:

  • Tutti i parametri non specificati da un profilo vengono lasciati invariati nel telefono.

  • I parametri non riconosciuti vengono ignorati.

  • Se il profilo in formato Open contiene più occorrenze dello stesso tag parametro, l'ultima di tali occorrenze ha la priorità su tutte le occorrenze precedenti. Per evitare la sostituzione accidentale dei valori di configurazione per un parametro, è consigliabile che ciascun profilo specifichi al massimo un'istanza di un parametro.

  • L'ultimo profilo elaborato ha la precedenza. Se più profili specificano lo stesso parametro di configurazione, il valore dell'ultimo profilo ha la precedenza.

Formati stringa

Queste proprietà si applicano alla formattazione delle stringhe:

  • I commenti sono consentiti tramite la sintassi XML standard.

  • Lo spazio vuoto iniziale e finale è consentito per scopi di leggibilità ma viene rimosso dal valore del parametro.

  • Le nuove linee all'interno di un valore vengono convertite in spazi.

  • Un'intestazione XML del modulo <? ?> è consentita, ma il telefono la ignora.

  • Per immettere caratteri speciali, utilizzare caratteri di escape XML di base, come mostrato nella tabella riportata di seguito.

    Carattere speciale

    Sequenza di escape XML

    & (e commerciale)

    &

    < (minore di)

    <

    > (maggiore di)

    >

    ' (apostrofo)

    '

    " (virgoletta doppia)

    "

    Nell'esempio seguente, i caratteri di escape vengono immessi per rappresentare i simboli maggiore di e minore di simboli richiesti in una regola di piano di numerazione. Questo esempio definisce un piano di chiamata hotline informazioni che imposta il parametro <Dial_Plan_1_> (Accesso amministratore > avanzato > Voce > Ext (n)) uguale a (S0 ).

     <flat-profile> <Dial_Plan_1_> (S0 ) Plan_1_> </flat-profile>
    ial_

  • Caratteri numerici di escape, utilizzando valori decimali ed esadecimali (s.a. ( e .), sono tradotti.

  • Il firmware del telefono supporta solo i caratteri ASCII.

Compressione e crittografia di profili Open (XML)

Il profilo di configurazione aperto può essere compresso per ridurre il carico di rete sul server di provisioning. Il profilo può anche essere crittografato per proteggere le informazioni riservate. La compressione non è necessaria, ma deve precedere la crittografia.

Compressione profilo Open

Il metodo di compressione supportato è l'algoritmo di deflazione gzip (RFC1951). L'utilità gzip e la libreria di compressione che implementa lo stesso algoritmo (zlib) sono disponibili dai siti Internet.

Per identificare la compressione, il telefono prevede che il file compresso contenga un'intestazione compatibile gzip. La chiamata dell'utilità gzip sul profilo Open originale genera l'intestazione. Il telefono controlla l'intestazione del file scaricato per determinare il formato del file.

Ad esempio, se profile.xml è un profilo valido, viene accettato anche il file profile.xml.gz . Uno dei seguenti comandi può generare questo tipo di profilo:

  • >gzip profile.xml

    Sostituisce il file originale con il file compresso.

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

    Lascia il file originale al suo posto e produce un nuovo file compresso.

Crittografia profilo Open

La crittografia a chiave simmetrica può essere utilizzata per crittografare un profilo di configurazione aperto, indipendentemente dalla compressione del file. La compressione, se applicata, deve essere applicata prima della crittografia.

Il server di provisioning utilizza HTTPS per gestire il provisioning iniziale del telefono dopo la distribuzione. La pre-crittografia dei profili di configurazione non in linea consente l'uso di HTTP per la successiva risincronizzazione dei profili. In questo modo si riduce il carico sul server HTTPS nelle distribuzioni su larga scala.

Il telefono supporta due metodi di crittografia per file di configurazione:

  • Crittografia AES-256-CBC

  • Crittografia dei contenuti HTTP basata su RFC 8188 con cifratura AES-128-GCM

Il provisioning nell'unità della chiave o dell'IKM (Input Keying Material) deve essere effettuato in precedenza. Il bootstrap della chiave segreta può essere eseguito in modo sicuro utilizzando HTTPS.

Il nome del file di configurazione non richiede un formato specifico, ma un nome file che termina con l'estensione .cfg solitamente indica un profilo di configurazione.

Crittografia AES-256-CBC

Il telefono supporta la crittografia AES-256-CBC per file di configurazione.

Lo strumento di crittografia OpenSSL, disponibile per il download da vari siti Internet, può eseguire la crittografia. Il supporto per la crittografia AES a 256 bit potrebbe richiedere la ricompilazione dello strumento per abilitare il codice AES. Il firmware è stato testato rispetto alla versione openssl-1.1.1d.

Per un file crittografato, il profilo prevede che il file abbia lo stesso formato generato dal seguente comando:

 # chiave di crittografia di esempio = SecretPhrase openssl enc –e –aes-256-cbc –k SecretPhrase –in profile.xml –out profile.cfg # invocazione analoga per un file xml compresso openssl enc –e –aes-256-cbc –k SecretPhrase –in profile.xml.gz –out profile.cfg

Una -k minuscola precede la chiave segreta, che può essere una frase di testo normale e che viene utilizzata per generare un salt casuale a 64 bit. Con il segreto specificato dall'argomento -k, lo strumento di crittografia richiama un vettore casuale a 128 bit iniziale e l'effettiva chiave di crittografia a 256 bit.

Quando questa forma di crittografia è utilizzata su un profilo di configurazione, il telefono deve essere informato del valore della chiave segreta per decrittografare il file. Questo valore viene specificato come qualificatore nell'URL del profilo. La sintassi è la seguente, utilizzando un URL esplicito:

 [--chiave “SecretPhrase ”] http://prov.telco.com/path/profile.cfg

Questo valore viene programmato utilizzando uno dei parametri Profile_Rule .

Espansione macro

Prima di essere valutati, i diversi parametri di provisioning sono sottoposti a espansione macro interna. Questo passaggio di pre-valutazione fornisce maggiore flessibilità nel controllo delle attività di risincronizzazione e aggiornamento del telefono.

Questi gruppi di parametri sono sottoposti a espansione macro prima della valutazione:

  • esync_rigger_*

  • Regola Profile_*

  • Messaggioog_xxx_

  • Regola pgrade_U

In determinate condizioni, anche alcuni parametri per scopi generici (GPP_*) sono sottoposti a espansione macro, come indicato esplicitamente nella sezione Argomenti di risincronizzazione opzionali seguente.

Durante l'espansione macro, il contenuto delle variabili denominate sostituisce espressioni della forma $NAME e $(NAME). Queste variabili includono parametri generici, diversi identificatori di prodotto, alcuni timer di evento e valori dello stato di provisioning. Per un elenco completo, vedere Variabili di espansione macro in Parametri di provisioning.

Nell'esempio seguente, l'espressione $(MAU) viene utilizzata per inserire l'indirizzo MAC 000E08012345.

L'amministratore inserisce: $(MAU)config.cfg

L'espansione macro risultante per un dispositivo con indirizzo MAC 000E08012345 è la seguente: 000E08012345config.cfg

Se un nome macro non viene riconosciuto, rimane non espanso. Ad esempio, il nome STRANGE non è riconosciuto come nome macro valido, mentre MAU è riconosciuto come nome macro valido.

L'amministratore inserisce: $STRANGE$MAU.cfg

L'espansione macro risultante per un dispositivo con indirizzo MAC 000E08012345 è: $STRANGE000E08012345.cfg

L'espansione macro non viene applicata in modo ricorsivo. Ad esempio, $$MAU" si espande in $MAU" ($$ viene espanso) e non determina l'indirizzo MAC.

Il contenuto dei parametri per scopi speciali, da GPP_SA a GPP_SD, è associato alle espressioni macro da $SA a $SD. Questi parametri sono solo macro estese come argomento delle opzioni --key , --uid e --pwd in un URL di risincronizzazione.

Espressioni condizionali

Le espressioni condizionali possono attivare eventi di risincronizzazione e selezionare da URL alternativi per le operazioni di risincronizzazione e aggiornamento.

Le espressioni condizionali consistono in un elenco di confronti, separati dall'operatore e . Tutti i confronti devono essere soddisfatti affinché la condizione sia vera.

Ogni confronto può riguardare uno dei seguenti tre tipi di letterali:

  • Valori interi

  • Numeri di versione software o hardware

  • Stringhe con virgolette doppie

Numeri di versione

La versione software per Cisco Video Phone 8875 utilizza questo formato (dove BN è il numero di build):

PHONEOSaaaa.1-0-1-0001-BN

dove yyyy indica il modello o la serie del telefono; 1 è la versione principale; 0 è la versione secondaria; 1-0001 è la versione micro e BN è il numero di build.

La stringa di confronto deve utilizzare lo stesso formato. In caso contrario, si verificherà un errore di analisi formato.

Durante il confronto della versione del software, la versione principale, la versione secondaria e la versione micro vengono confrontate in sequenza e le cifre più a sinistra hanno la precedenza sulle ultime. Se i numeri di versione sono identici, il numero di build viene confrontato.

Esempi di numero di versione valido

phoneos-8875.1-0-1-0001-19

Confronto

Le stringhe tra virgolette possono essere confrontate per uguaglianza o disuguaglianza. Numeri di versione e numeri interi possono anche essere confrontati in modo aritmetico. Gli operatori di confronto possono essere espressi come simboli o come acronimi. Gli acronimi sono pratici per esprimere la condizione in un profilo in formato Open.

Operatore

Sintassi alternativa

Descrizione

Applicabile a numeri interi e operandi della versione

Applicabile a operandi in stringhe tra virgolette

=

eq

uguale a

Sì

Sì

!=

ne

diverso da

Sì

Sì

<

lt

è minore di

Sì

No

<=

le

è minore o uguale a

Sì

No

>

gt

è maggiore di

Sì

No

>=

ge

è maggiore o uguale a

Sì

No

E

E

Sì

Sì

È importante racchiudere variabili macro tra virgolette doppie in cui si attende una stringa letterale. Non effettuare questa operazione quando è previsto un numero o un numero di versione.

Quando utilizzate nel contesto dei parametri Profile_Rule* e Upgrade_Rule, le espressioni condizionali devono essere racchiuse nella sintassi "(expr)?" come in questo esempio di regola di aggiornamento. Ricorda di sostituire BN con il numero di build del carico del firmware a cui eseguire l'aggiornamento.

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

Non utilizzare la sintassi precedente con le parentesi per configurare i parametri Resync_Trigger_*.

Sintassi dell'URL

Utilizzare la sintassi dell'URL standard per specificare la modalità di recupero dei file di configurazione e dei carichi del firmware rispettivamente nei parametri Profile_Rule* e Upgrade_Rule. La sintassi è la seguente:

[ schema:// ] [ server [:porta]] percorso file

Dove scheme è uno dei seguenti valori:

  • tftp

  • http

  • https

Se scheme è omesso, viene utilizzato il protocollo tftp. Il server può essere un nome host riconosciuto da DNS o un indirizzo IP numerico. La porta è il numero di porta di destinazione UDP o TCP. Il percorso file deve iniziare con la directory radice (/); deve essere un percorso assoluto.

Se il server risulta mancante, viene utilizzato il server tftp specificato tramite DHCP (opzione 66).

Per le regole di aggiornamento, è necessario specificare il server.

Se la porta non è presente, viene utilizzata la porta standard per lo schema specificato. Tftp utilizza la porta UDP 69, http utilizza la porta TCP 80, https utilizza la porta TCP 443.

Deve essere presente un percorso file. Non deve fare riferimento necessariamente a un file statico, ma può indicare contenuto dinamico ottenuto tramite CGI.

L'espansione macro si applica all'interno degli URL. Di seguito sono riportati esempi di URL validi:

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

Se si utilizza l'opzione DHCP 66, le regole di aggiornamento non supportano la sintassi vuota. È applicabile solo per Regola profilo*.

Crittografia dei contenuti HTTP basata su RFC 8188

Il telefono supporta la crittografia dei contenuti HTTP basata su RFC 8188 con cifratura AES-128-GCM per i file di configurazione. Con questo metodo di crittografia, qualsiasi entità può leggere le intestazioni dei messaggi HTTP. Tuttavia, solo le entità che conoscono l'IKM (Input Keying Material) possono leggere il payload. Se il telefono è predisposto con l'IKM, il telefono e il server di provisioning possono scambiare file di configurazione in modo sicuro e consentire agli elementi di rete di terze parti di utilizzare le intestazioni dei messaggi per scopi di analisi e monitoraggio.

Il parametro di configurazione XML IKM_HTTP_Encrypt_Content contiene l'IKM sul telefono. Per motivi di sicurezza, questo parametro non è accessibile nella pagina Web di amministrazione del telefono. Inoltre non è visibile nel file di configurazione del telefono, accessibile dall'indirizzo IP del telefono o dai report di configurazione del telefono inviati al server di provisioning.

Se si desidera utilizzare la crittografia basata su RFC 8188, verificare quanto segue:

  • Eseguire il provisioning del telefono con l'IKM specificando l'IKM con il parametro XML IKM_HTTP_Encrypt_Content nel file di configurazione inviato dal server di provisioning al telefono.

  • Se la crittografia viene applicata ai file di configurazione inviati dal server di provisioning al telefono, assicurarsi che l'intestazione HTTP Content-Encoding nel file di configurazione sia aes gcm.

    In assenza di questa intestazione, il metodo AES-256-CBC ha la precedenza. Il telefono applica la decrittografia AES-256-CBC se è presente una chiave AES-256-CBC in una regola profilo, indipendentemente dall'IKM.

  • Se si desidera che il telefono applichi la crittografia ai report di configurazione che invia al server di provisioning, assicurarsi che nella regola di report non sia specificata la chiave AES-256-CBC.

Argomenti di risincronizzazione opzionali

Gli argomenti opzionali, la chiave, uid e pwd possono precedere gli URL inseriti nei parametri Profile_Rule* , collettivamente racchiusi da parentesi quadre.

tasto

L'opzione --chiave indica al telefono che il file di configurazione ricevuto dal server di provisioning è crittografato con crittografia AES-256-CBC, a meno che l'intestazione Codifica contenuto nel file non indichi la crittografia aes gcm . La chiave stessa è specificata come una stringa che segue il termine --key. Facoltativamente, la chiave può essere racchiusa tra virgolette ("). Il telefono utilizza il tasto per decrittografare il file di configurazione.

Esempi di utilizzo
 [--key VerySecretValue] [--key "la mia frase segreta"] [--key a37d2fb9055c1d04883a0745eb0917a4]

Gli argomenti tra parentesi sono macro espansi. I parametri per scopi speciali, da GPP_SA a GPP_SD, sono macro espansi in variabili macro, da $SA a $SD, solo quando vengono utilizzati come argomenti dell'opzione chiave. Vedere i seguenti esempi:

[--chiave $SC] [--chiave "$SD"]

Nei profili in formato Open, l'argomento per --key deve essere uguale all'argomento per l'opzione -k assegnata a openssl.

uid e pwd

È possibile utilizzare le opzioni uid e pwd per specificare l'ID utente e la password che verranno inviati in risposta a problemi di autenticazione di base e digest HTTP quando viene richiesto l'URL specificato. Gli argomenti tra parentesi sono macro espansi. I parametri per scopi speciali, da GPP_SA a GPP_SD, sono macro espansi in variabili macro, da $SA a $SD, solo quando vengono utilizzati come argomenti dell'opzione chiave. Vedere i seguenti esempi:

GPP_SA = GPP_SB = PasswordSecret

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

si espanderebbe in:

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

Tipi di dati

Questi tipi di dati vengono utilizzati con parametri di configurazione profilo:

  • {a,b,c,…}—Scelta tra a, b, c, …

  • Bool: valore booleano "sì" o "no".

  • CadScript: un miniscript che specifica i parametri di cadenza di un segnale. Fino a 127 caratteri.

    Sintassi: S1[;S2], dove:

    • Si=Di(oni,1/offi,1[,oni,2/offi,2[,oni,3/offi,3[,oni,4/offi,4[,oni,5/offi,5[,oni,6/offi,6]]]]]) noto come sezione.

    • oni,j e offi,j sono durata attivato/disattivato in secondi di un segmento. i = 1 o 2 e j = da 1 a 6.

    • Di è la durata totale della sezione in secondi.

    Tutte le durate possono avere fino a tre posizioni decimali per fornire una risoluzione di 1  ms. Il carattere jolly "*" indica una durata infinita. I segmenti all'interno di una sezione vengono riprodotti in ordine e ripetuti fino a quando non viene riprodotta la durata totale.

    Esempio 1:

     60(2/4) Numero di sezioni di cadenza = 1 Sezione di cadenza 1: Lunghezza sezione = 60 s Numero di segmenti = 1 Segmento 1: On=2 s, Off=4 s Lunghezza totale suoneria = 60 s

    Esempio 2. Suoneria differenziata (breve,breve,breve,lungo):

     60(.2/.2,.2/.2,.2/.2,1/4) Numero di sezioni di cadenza = 1 cadenza sezione 1: Lunghezza sezione = 60s Numero di segmenti = 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,0 s, Off=4,0 s Lunghezza totale suoneria = 60 s

  • DialPlanScript: sintassi dello script utilizzata per specificare i piani di numerazione della linea 1 e della linea 2.

  • Fluttuante: un valore in virgola mobile con un massimo di n posizioni decimali.

  • FQDN: nome di dominio completo. Può contenere fino a 63 caratteri. Di seguito sono riportati alcuni esempi:

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

    • sip.Cisco.com o 109.12.14.12

  • FreqScript: un miniscript che specifica i parametri di frequenza e di livello di un segnale. Contiene fino a 127 caratteri.

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

    • F1–F6 sono frequenza in Hz (solo numeri interi senza segno).

    • L1–L6 sono i corrispondenti livelli in dBm (con un massimo di una posizione decimale).

    Gli spazi vuoti prima e dopo la virgola sono consentiti ma non consigliati.

    Esempio 1. Segnale di chiamata in attesa:

     440@-10 Numero di frequenze = 1 Frequenza 1 = 440 Hz a –10 dBm

    Esempio 2: segnale di linea:

     350@-19.440@-19 Numero di frequenze = 2 Frequenza 1 = 350 Hz a –19 dBm Frequenza 2 = 440 Hz a –19 dBm

  • IP: indirizzo IPv4 valido sotto forma di x.x.x.x, dove x è compreso tra 0 e 255. Esempio: 10.1.2.100.

  • ID utente: l'ID utente viene visualizzato in un URL; fino a 63 caratteri.

  • Telefono: una stringa di numero di telefono, ad esempio, 14081234567 *69, *72, 345678; o un URL generico, ad esempio 1234@10.10.10.100:5068 o jsmith@Cisco.com. La stringa può contenere fino a 39 caratteri.

  • PhTmplt: un modello di numero di telefono. Ogni modello può contenere uno o più schemi che sono separati da una virgola (,). Lo spazio vuoto all'inizio di ogni criterio viene ignorato. "?" e "*" rappresentano i caratteri jolly. Per rappresentare letteralmente, utilizzare %xx. For example, %2a rappresenta *. Il modello può contenere fino a 39 caratteri. Esempi: "1408*, 1510*", "1408123????, 555?1.".

  • Porta: il numero di porta TCP/UDP (0-65535). Può essere specificato in formato decimale o esadecimale.

  • ProvisioningRuleSyntax: sintassi di scripting utilizzata per definire le regole di risincronizzazione della configurazione e di aggiornamento del firmware.

  • PwrLevel: livello di potenza espresso in dBm con una posizione decimale, ad esempio –13,5 o 1,5 (dBm).

  • RscTmplt: un modello di codice di stato risposta SIP, ad esempio "404, 5*", "61?", "407, 408, 487, 481". Può contenere fino a un massimo di 39 caratteri.

  • Sig: valore n-bit firmato. Può essere specificato in formato decimale o esadecimale. Un segno "-" deve precedere i valori negativi. Un segno + prima di valori positivi è opzionale.

  • Codici asterisco: codice di attivazione per un servizio supplementare, ad esempio *69. Il codice può contenere fino a 7 caratteri.

  • Str: stringa generica con un massimo di n caratteri non riservati.

  • Tempo: durata in secondi, con un massimo di n posizioni decimali. Le posizioni decimali aggiuntive vengono ignorate.

  • ToneScript: un miniscript che specifica i parametri di frequenza, livello e cadenza di un segnale di chiamata in corso. Lo script può contenere fino a 127 caratteri.

    Sintassi: FreqScript;Z1[;Z2].

    La sezione Z1 è simile alla sezione S1 in un CadScript, tranne per il fatto che ciascun segmento on/off è seguito da un parametro di componenti della frequenza: Z1 = D1(oni,1/offi,1/fi,1[,oni,2/offi,2/fi,2 [,oni,3/offi,3/fi,3 [,oni,4/offi,4/fi,4 [,oni,5/offi,5/fi,5 [,oni,6/offi,6/fi,6]]]]]) dove:

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

    • 1 < nk < 6 specifica i componenti della frequenza nel FreqScript utilizzati in tale segmento.

    Se in un segmento viene utilizzato più di un componente di frequenza, i componenti vengono sommati insieme.

    Esempio 1. Segnale di linea:

     350@-19,440@-19;10(*/0/1+2) Numero di frequenze = 2 Frequenza 1 = 350 Hz a –19 dBm Frequenza 2 = 440 Hz a –19 dBm Numero di sezioni cadenza = 1 Cadenza Sezione 1: Sezione Lunghezza = 10 s Numero di segmenti = 1 Segmento 1: On=per sempre, con frequenze 1 e 2 Lunghezza totale del tono = 10s

    Esempio 2 - Segnale acustico intermittente:

     350@-19,440@-19;2(.1/.1/1+2);10(*/0/1+2) Numero di frequenze = 2 Frequenza 1 = 350 Hz a –19 dBm Frequenza 2 = 440 Hz a –19 dBm Numero di sezioni cadenza = 2 Cadenza sezione 1: Lunghezza sezione = 2s Numero di segmenti = 1 Segmento 1: On=0,1 s, Off=0,1 s con frequenze 1 e 2 cadenza Sezione 2: Sezione Lunghezza = 10 s Numero di segmenti = 1 Segmento 1: On=per sempre, con frequenze 1 e 2 Lunghezza totale del tono = 12s

  • UNS: valore n-bit non firmato, dove n = 8, 16 o 32. Può essere specificato in formato decimale o esadecimale, ad esempio 12 o 0x18, a condizione che il valore possa rientrare in n bit.

Teneteli sotto considerazione:

  • rappresenta un nome del parametro di configurazione. In un profilo, il tag corrispondente viene formato sostituendo lo spazio con un carattere di sottolineatura "_", ad esempio Par_Nome.
  • Un campo valore predefinito vuoto implica una stringa vuota < “” >.
  • Il telefono continua a utilizzare gli ultimi valori configurati per i tag che non sono presenti in un determinato profilo.
  • I modelli vengono confrontati nell'ordine specificato. Viene selezionata la prima corrispondenza, non la più vicina. Il nome del parametro deve corrispondere esattamente.
  • Se in un profilo viene specificata più di una definizione per un parametro, l'ultima in tale definizione nel file è quella che ha effetto nel telefono.
  • Una specifica del parametro con un valore di parametro vuoto forza il parametro al suo valore predefinito. Per specificare una stringa vuota, invece, utilizzare una stringa vuota "" come valore del parametro.