Configurazione del telefono per la risincronizzazione del profilo

Risincronizzazione del profilo del telefono su TFTP

Il telefono supporta più protocolli di rete per il ripristino dei profili di configurazione. Il protocollo di trasferimento del profilo di base è TFTP (RFC1350). TFTP è molto utilizzato per il provisioning di dispositivi di rete all'interno di reti LAN private. Anche se non è consigliato per la distribuzione di endpoint remoti su Internet, TFTP può essere utile per la distribuzione all'interno di aziende di piccole dimensioni, per il preprovisioning interno e per lo sviluppo e i test. Nella seguente procedura, un profilo è stato 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, switch o router piccolo.

2

Sul computer installare e attivare un server TFTP.

3

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

Per verificare se è stato eseguito il provisioning del profilo sul telefono in un secondo momento, è possibile impostare alcuni valori come contrassegni. Ad esempio, impostare il valore per GPP_A su 12345678 come illustrato nell'esempio seguente:
<flat-profile>
  <GPP_A> 12345678
  </GPP_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. Di preferenza, 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, supponendo che l'indirizzo IP del telefono sia 192.168.1.100, aprire il seguente URL nel browser Web:

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 sul profilo di configurazione creato aprendo l'URL di risincronizzazione in una finestra del 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 del profilo di configurazione basic.txt dal server TFTP all'indirizzo IP 192.168.1.200. Quindi il telefono analizza il file scaricato e aggiorna il parametro GPP_A con il valore 12345678.

8

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

A questo punto il parametro GPP_A 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 i numeri e le cifre esadecimali minuscole, ad esempio 000e08aabbcc).

2

Rinominare il file di configurazione in CP-xxxx macaddress.cfg (sostituendo xxxx con il numero di modello emacaddress 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 del profilo nel campo Profile Rule (Regola profilo).

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

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

Fare clic su Submit All Changes. Ciò causa un immediato riavvio e risincronizzazione.

Quando si verifica la successiva risincronizzazione, il telefono ripristina 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 del 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 Profile_Rule del telefono del test per indicare il server HTTP al posto del server TFTP, in modo da scaricare periodicamente il profilo.

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

<Profile_Rule>http://192.168.1.200/basic.txt</Profile_Rule>
5

Fare clic su Submit All Changes. Ciò causa un immediato riavvio e risincronizzazione.

6

Osservare i messaggi syslog inviati dal telefono. Adesso le risincronizzazioni periodiche 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 vengono 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 uguale a 192.168.1.200.

4

Nel campo Resync Periodic, immettere un valore piccolo per il test, come ad esempio 30 secondi.

5

Fare clic su Submit All Changes.

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

6

Osservare i messaggi risultanti nella traccia syslog.

7

Assicurarsi che il campo Resync On Reset sia impostato su Yes.

<Resync_On_Reset>Yes</Resync_On_Reset>
8

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

Se l'operazione di risincronizzazione ha esito negativo per qualsiasi motivo, come ad esempio se il server non risponde, l'unità attende (per il numero di secondi configurato in Resync Error Retry Delay) prima che tenti nuovamente la risincronizzazione. Se Ritardo nuovo tentativo da errore sincronizzazione è zero, il telefono non tenta di risincronizzarsi dopo un tentativo di risincronizzazione non riuscito.

9

(Facoltativo) Impostare il valore del campo Resync Error Retry Delay su un numero piccolo, come ad esempio 30.

<Resync_Error_Retry_Delay>30</Resync_Error_Retry_Delay>
10

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

Parametri per la risincronizzazione del profilo

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

Tabella 1. Parametri per la risincronizzazione del profilo

Parametro

Descrizione

Provision Enable

Consente di autorizzare o negare azioni di risincronizzazione del profilo.

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

    <Provision_Enable ua="na">Yes</Provision_Enable>

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

Impostazione predefinita: Yes

Resync On Reset

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 con XML (cfg.xml), immettere una stringa in questo formato:

    <Resync_On_Reset ua="na">Yes</Resync_On_Reset>

  • Nella pagina Web del telefono, impostare questo campo su Yes per consentire la risincronizzazione all'accensione o su No per bloccarla.

Impostazione predefinita: Yes

Resync Random Delay

Impedisce un sovraccarico del server di provisioning quando un numero elevato di dispositivi si accende contemporaneamente e viene seguito un tentativo di 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 con XML (cfg.xml), immettere una stringa in questo formato:

    <Resync_Random_Delay ua="na">2</Resync_Random_Delay>

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

Resync At (HHmm)

L'ora (HHmm) in cui il dispositivo esegue la risincronizzazione 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 con XML (cfg.xml), immettere una stringa in questo formato:

    <Resync_At__HHmm_ ua="na">0959</Resync_At__HHmm_>

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

Resync At Random Delay

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'intervallo finale random_delay.

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

    <Resync_At_Random_Delay ua="na">600</Resync_At_Random_Delay>

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

Resync Periodic

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 numero 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 eseguita correttamente.

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

    <Resync_Periodic ua="na">3600</Resync_Periodic>

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

Resync Error Retry Delay

Se un'operazione di risincronizzazione non viene completata perché il telefono non è stato in grado di ripristinare 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 numero intero

    Esempio: un input di 300 indica che il successivo tentativo di risincronizzazione si verifica in 300 secondi.

  • Più numeri interi

    Esempio: un input di 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 con XML (cfg.xml), immettere una stringa in questo formato:

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

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

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

Forced Resync Delay

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 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 con XML (cfg.xml), immettere una stringa in questo formato:

    <Forced_Resync_Delay ua="na">14400</Forced_Resync_Delay>

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

Il valore predefinito è 14,400 secondi.

Resync From SIP

Questo parametro consente di controllare 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: risincronizzazione dell'intestazione al dispositivo.

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

    <Resync_From_SIP ua="na">Yes</Resync_From_SIP>

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

Impostazione predefinita: Yes

Resync After Upgrade Attempt

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

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

    <Resync_After_Upgrade_Attempt ua="na">Yes</Resync_After_Upgrade_Attempt>

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

Impostazione predefinita: Yes

Resync Trigger 1

Resync Trigger 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 attivazione del trigger vengono ignorate solo dalla sincronizzazione tramite URL di azione diretta e notifica SIP.

È possibile programmare i parametri con un'espressione condizionale che viene sottoposta a espansione macro. Per le espansioni macro valide, vedere Variabili di espansione macro in Parametri di provisioning.

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

    <Resync_Trigger_1 ua="na">$UPGTMR gt 300 and $PRVTMR ge 600</Resync_Trigger_1>

    <Resync_Trigger_2 ua="na"/>

  • Nella pagina Web del telefono, specificare le attivazioni.

Impostazione predefinita: vuoto

User Configurable Resync

Consente a un utente di risincronizzare il telefono dal relativo schermo. Se è impostato su Sì, 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 con XML (cfg.xml), immettere una stringa in questo formato:

    <User_Configurable_Resync ua="na">Yes</User_Configurable_Resync>

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

Impostazione predefinita: Yes

Resync Fails On FNF

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

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

    <Resync_Fails_On_FNF ua="na">Yes</Resync_Fails_On_FNF>

  • Nella pagina Web del telefono, selezionare Yes per considerare una risposta file-not-found come una risincronizzazione non riuscita oppure selezionare No per considerare una risposta file-not-found come una sincronizzazione con esito positivo.

Impostazione predefinita: Yes

Profile Authentication Type

Consente di specificare le credenziali da utilizzare per l'autenticazione dell'account del profilo. Di seguito vengono riportate le opzioni disponibili:

  • Disabled: consente di disabilitare la funzione di profilo dell'account. Se si disabilita la funzione, il menu Impostazione account profilo non viene visualizzato sullo schermo del telefono.

  • Basic HTTP Authentication: le credenziali di accesso HTTP vengono utilizzate per autenticare l'account del profilo.

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

    • Se il campo XSI Authentication Type del telefono è impostato su Login Credentials, vengono utilizzate le credenziali di accesso XSI.

    • Se il campo XSI Authentication Type del telefono è impostato su SIP Credentials, vengono utilizzate le credenziali SIP XSI.

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

    <Profile_Authentication_Type ua="na">Basic Http Authentication</Profile_Authentication_Type>

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

Impostazione predefinita: Basic HTTP Authentication

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

Profile Rule

Profile Rule B

Profile Rule C

Profile Rule D

Ogni regola profilo indicante 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:

[--key <encryption key>]

Se lo si desidera, è possibile racchiudere la chiave di crittografia tra virgolette (").

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

    <Profile_Rule ua="na">/$PSN.xml</Profile_Rule>

    <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

DHCP Option To Use

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

Impostazione predefinita: 66,160,159,150,60,43,125

DHCPv6 Option To Use

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

Impostazione predefinita: 17,160,159

Provisioning tramite Cisco XML

È possibile eseguire il provisioning di 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 funzionalità di Cisco XML per supportare il provisioning tramite un oggetto XML:

<CP-xxxx-3PCCExecute> <ExecuteItem URL=Resync:[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 l'espansione macro

Sottodirectory con più profili sul server forniscono un pratico metodo per la gestione di 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 specificato nell'URL utilizzando la sintassi standard :port dopo il nome del server.

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

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

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

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

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

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

Definizione del 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 se durante il tentativo di risincronizzare e scaricare il file di configurazione viene generato per la prima volta 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 l'utente perde o ignora la schermata Impostazione account profilo, può accedere alla schermata di configurazione anche tramite il menu dello schermo del telefono oppure tramite il softkeyImposta che viene visualizzato solo se sul telefono non è registrata alcuna linea.

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

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

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

  • Se si inserisce un URL corretto nel campo Profile Rule con nome utente e password corretti, il telefono richiede l'autenticazione o il digest per risincronizzare il profilo. L'account profilo non viene utilizzato per la risincronizzazione del telefono. La procedura di accesso ha esisto positivo.

  • Se si inserisce un URL corretto nel campo Profile Rule 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. La procedura di accesso ha esisto negativo.

  • Se si fornisce un URL errato nel campo Profile Rule, la procedura di 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 Configuration Profile, impostare il parametro Profile Authentication Type per specificare le credenziali da utilizzare per l'autenticazione dell'account del 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">Disabled</Profile_Authentication_Type>

Opzioni:

  • Disabled: disabilita la funzione di account del profilo. Con questa funzione disabilitata, il menu Profile account setupnon viene visualizzato sullo schermo del telefono.

  • Basic HTTP Authentication: le credenziali di accesso HTTP vengono utilizzate per autenticare l'account del profilo.

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

    Se il campo XSI Authentication Type del telefono è impostato su Login Credentials, vengono utilizzate le credenziali di accesso XSI.

    Se il campo XSI Authentication Type del telefono è impostato su SIP Credentials, vengono utilizzate le credenziali SIP XSI.

Impostazione predefinita: Basic HTTP Authentication

4

Fare clic su Submit All Changes.

Applicazione manuale di un profilo al telefono

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

Seguire queste fasi per scaricare il file di configurazione di un'applicazione su un 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 il seguente formato:

http://<WAN_IP_Address>/admin/resync?tftp://<PC_IP_Address>/<file_name>&xuser=admin&xpassword=<password>

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

Per scaricare la configurazione del telefono utilizzando cURL, procedere nel seguente modo. Questo strumento a riga di comando è utilizzato per il trasferimento dei dati con una sintassi URL. Per scaricare cURL, visitare:

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


 

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

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 configurazione in formato XML.

Negli esempi riportati in questa sezione vengono utilizzati i profili di configurazione con la sintassi XML.

Formati dei profili di configurazione

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

Il formato XM profilo di configurazione utilizza gli strumenti di modifica 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 modello di telefono dispone di un insieme di funzioni diverse e pertanto una serie di parametri diversa.

Formato profilo Open

Il profilo in formato Open è un file di testo con sintassi simile a XML che contiene una gerarchia di elementi e i relativi attributi e valori. Questo formato consente di utilizzare gli strumenti standard per creare il file di configurazione. Un file di configurazione XML può essere inviato dal server di provisioning al telefono durante un'operazione di risincronizzazione, senza la compilazione come oggetto binario.

Il telefono può accettare formati di configurazione che generano gli 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 lo si desidera, il file può essere compresso utilizzando l'algoritmo DEFLATE 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 codifica AES-128-GCM

Un file di configurazione può includere i seguenti componenti:

  • Tag elementi

  • Attributi

  • Parametri

  • Funzioni di formattazione

  • Commenti XML

Esempio: formato di profilo aperto

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

Il tag elemento <flat-profile> racchiude tutti gli elementi di parametro riconosciuti dal telefono.

Proprietà di tag elemento

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

  • 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 dell'elemento XML. Ad esempio, i trattini bassi ( _ ) nel file di configurazione XML al posto degli spazi nell'interfaccia Web.

  • Il telefono riconosce gli elementi con nomi del parametro corretti incapsulato nell'elemento speciale <flat-profile>.

  • I nomi degli elementi sono immessi tra parentesi angolari.

  • La maggior parte dei nomi degli elementi è simile ai nomi dei campi dell'interfaccia utente Web del telefono, con le seguenti modifiche:

    • I nomi degli elementi potrebbe non includere spazi o caratteri speciali. Per ricavare il nome dell'elemento dal nome del campo Web, sostituire ogni spazio o i caratteri speciali con un trattino basso [, ], (, ) o /.

      Esempio: l'elemento <Resync_On_Reset> rappresenta il campo Resync On Reset dopo la reimpostazione.

    • Il nome di ogni elemento deve essere univoco. Nell'interfaccia Web del telefono gli stessi campi possono comparire 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 composizione per la linea 1.

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

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

  • I tag elemento fanno differenza tra maiuscole e minuscole.

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

    <Profile_Rule_B />

  • È possibile utilizzare un tag elemento vuoto per evitare di sovrascrivere i valori forniti dall'utente durante un'operazione di risincronizzazione. Nell'esempio seguente, le impostazioni di chiamata rapida utente restano invariate:

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

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

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

  • I nomi di elemento non riconosciuti vengono ignorati.

Proprietà parametri

Queste proprietà sono valide per i parametri:

  • Tutti i parametri non specificati da un profilo restano 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 quelle precedenti. Per evitare la sostituzione accidentale dei valori di configurazione per un parametro, ciascun profilo deve specificare 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 della stringa

Le seguenti proprietà si applicano alla formattazione delle stringhe:

  • Sono consentiti commenti tramite la sintassi XML standard.

    <!-- My comment is typed here -->

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

  • Le nuove righe 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 illustrato nella tabella riportata di seguito.

    Carattere speciale

    Sequenza di escape XML

    & (e commerciale)

    &amp;

    < (minore di)

    &lt;

    > (maggiore di)

    &gt;

    ' (apostrofo)

    &apos;

    " (virgolette doppie)

    &quot;

    Nell'esempio seguente, i caratteri di escape sono immessi per rappresentare i simboli maggiore di e minore di simboli necessari in una regola di piano di numerazione. Questo esempio definisce un piano di numerazione hotline informazioni che consente di impostare il parametro Admin Login (Accesso amministratore) > Advanced (Avanzate) > Voce > Ext (n) (Int. n.)) uguale a (S0 <:18005551212>).

    <flat-profile> <Dial_Plan_1_> (S0 &lt;:18005551212&gt;) </Dial_Plan_1_></flat-profile>

  • Gli escape dei caratteri numerici, che utilizzano valori decimali ed esadecimali (s.a. &#40; e &#x2e;) vengono tradotti.

  • Il firmware del telefono supporta solo i caratteri ASCII.

Compressione e crittografia di un profilo Open (XML)

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

Compressione di un profilo Open

Il metodo di compressione supportato è l'algoritmo di deflazione gzip (RFC1951). L'utilità gzip e l'archivio di compressione, che implementa lo stesso algoritmo (zlib), sono disponibili da 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, anche il file profile.xml.gz viene accettato. Entrambi i seguenti comandi possono 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 il nuovo file compresso.

Crittografia di 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 la distribuzione iniziale del telefono dopo la distribuzione. La pre-crittografia dei profili di configurazione non in linea consente l'utilizzo di HTTP per la successiva risincronizzazione dei profili. In questo modo viene ridotto 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 codifica 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 protetto tramite HTTPS.

Il nome del file di configurazione non richiede un formato specifico, ma un nome file che termina con l'estensione .cfg normalmente 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 diversi 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 il file abbia lo stesso formato in maniera analoga a quello generato dal seguente comando:

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

Una -k minuscola precede la chiave segreta, la quale può essere una frase di testo vuota utilizzata per generare un salt a 64 bit casuale. Con la chiave segreta specificata dall'argomento -k, lo strumento di crittografia richiama un vettore casuale a 128 bit iniziale e la corrente chiave di crittografia a 256 bit.

Quando la suddetta forma di crittografia è impiegata in un profilo di configurazione, è necessario che il telefono riceva un valore chiave per decriptare il file. Questo valore è specificato come qualificatore nel profilo URL. La sintassi è la seguente, utilizzando un URL esplicito:

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

Questo valore è 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:

  • Resync_Trigger_*

  • Profile_Rule*

  • Log_xxx_Msg

  • Upgrade_Rule

In determinate condizioni, anche alcuni parametri generici (GPP_*) subiscono un'espansione macro, come esplicitamente indicato nella sezione Argomenti di risincronizzazione facoltativi di seguito.

Durante l'espansione macro, il contenuto di 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 diprovisioning.

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

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

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

Se un nome macro non viene riconosciuto, rimane compresso senza essere esteso. Ad esempio, il nome STRANGE non è riconosciuto come nome macro valido, mentre MAU è riconosciuto come nome macro valido.

L'amministratore immette: $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 estende in $MAU" ($$ viene espanso) e non si ottiene l'indirizzo MAC.

Il contenuto dei parametri per scopi speciali, GPP_SA tramite GPP_SD, è associato alle espressioni di macro $SA tramite $SD. I parametri riportati di seguito sono solo con macro estesa come argomento --key, le opzioni --uid e --pwd in un URL risincronizzato.

Espressioni condizionali

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

Le espressioni condizionali sono composte da un elenco di confronti, separati da e operatore. Tutti i confronti devono essere soddisfatti affinché la condizione sia true.

Ogni confronto può essere correlato a uno dei seguenti tre tipi di letterali:

  • Valori interi

  • Numeri di versione hardware o software

  • Stringhe con virgolette doppie

Numeri di versione

La versione del software del videotelefono Cisco 8875 utilizza questo formato (dove BN è il numero di build):

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

Esempio 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 inoltre essere confrontati in maniera aritmetica. 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

non uguale a

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 ove si attende una stringa letterale. Non eseguire tale azione quando si attende un numero o un numero di versione.

Quando utilizzate nel contesto di parametri Profile_Rule* e Upgrade_Rule, le espressioni condizionali devono essere racchiuse tra la sintassi "(expr)?" come in questo esempio di regola di aggiornamento. Ricordarsi di sostituire BN con il numero di build del carico del firmware da aggiornare.

($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 tra parentesi per configurare i parametri Resync_Trigger_*.

Sintassi URL

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

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

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 una directory principale (/); deve essere un percorso assoluto.

Se server è assente, viene usato il sever tftp specificato tramite DHCP (opzione 66).


 

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

Se port è assente, viene usata 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. I seguenti sono 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 è configurato 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 conserva l'IKM sul telefono. Per motivi di sicurezza, questo parametro non è accessibile dalla 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:

  • Effettuare 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 HTTPContent-Encoding presente nel file di configurazione sia aes128gcm.

    In assenza di questa intestazione, il metodo AES-256-CBC ha la precedenza. Il telefono si applica la decrittografia 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 stata specificata la chiave AES-256-CBC.

Argomenti di risincronizzazione opzionali

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

key

L'opzione --key indica al telefono che il file di configurazione ricevuto dal server di provisioning è crittografato con crittografia AES-256-CBC, a meno che nell'intestazione Content-Encoding del file sia indicata la crittografia aes128gcm . La chiave stessa è specificata come una stringa che segue il termine --key. Se lo si desidera, è possibile racchiudere la chiave di crittografia tra virgolette ("). Il telefono utilizza il tasto per la decrittografia del file di configurazione.

Esempi d'uso
[--key VerySecretValue][--key “my secret phrase”][--key a37d2fb9055c1d04883a0745eb0917a4]

Gli argomenti tra parentesi presentano macro estese. I parametri con scopo speciale, da GPP_SA a GPP_SD, sono macro espandibili in variabili macro, da $SA a $SD, solo quando vengono utilizzati come argomenti dell'opzione chiave. Vedere i seguenti esempi:

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

Nei profili di formato Open, l'argomento per --key deve essere uguale a quello 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 presentano macro estese. I parametri con scopo speciale, da GPP_SA a GPP_SD, sono macro espandibili in variabili macro, da $SA a $SD, solo quando vengono utilizzati come argomenti dell'opzione chiave. Vedere i seguenti esempi:

GPP_SA = MyUserID GPP_SB = MySecretPassword

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

si estende quindi 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,…}: a scelta tra a, b, c, …

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

  • CadScript: un miniscript che consente di specificare 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 Cadenza Sezione 1: Lunghezza sezione = 60 s Numero di segmenti = 1 Segmento 1: On=2s, Off=4s Lunghezza totale anello = 60s

    Example 2—Distinctive ring (short,short,short,long):

     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.0s, Off=4.0s Lunghezza totale anello = 60s

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

  • Float<n>: un valore con massimo n decimali in virgola mobile.

  • 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 un massimo di 127 caratteri al massimo.

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

    • F1-F6 sono frequenze in Hz (solo numeri interi senza segni).

    • 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 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 un massimo di 39 caratteri.

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

  • Porta: il numero di porta TCP/UDP (0-65535). È possibile specificare in formato decimale o esadecimale.

  • ProvisioningRuleSyntax: script sintassi utilizzata per definire le regole di risincronizzazione di 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, come ad esempio "404, 5*", "61?", "407, 408, 487, 481". Può contenere un massimo di 39 caratteri.

  • Sig<n>: valore di n bit di stato di accesso effettuato. È possibile specificare in formato decimale o esadecimale. Un simbolo "-" deve precedere i valori negativi. Un simbolo + prima di valori positivi è facoltativo.

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

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

  • Time<n>: tempo di durata in secondi, con fino a n posizioni decimali. I punti decimali addizionali vengono ignorati.

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

    Syntax: FreqScript;Z1[;Z2].

    La sezione Z1 è simile alla sezione S1 in un CadScript, fatta eccezione per il fatto che ogni 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 questo segmento.

    Se più di un componente frequenza viene utilizzato in un segmento, 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 di cadenza = 1 Cadenza Sezione 1: Lunghezza sezione = 10 s Numero di segmenti = 1 Segmento 1: On=per sempre, con Frequenze 1 e 2 Lunghezza tono totale = 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 di cadenza = 2 Cadenza Sezione 1: Lunghezza sezione = 2s Numero di segmenti = 1 Segmento 1: On=0.1s, Off=0.1s con frequenza 1 e 2 Cadenza Sezione 2: Lunghezza sezione = 10s Numero di segmenti = 1 Segmento 1: On=per sempre, con frequenze 1 e 2 Lunghezza tono totale = 12s

  • Uns<n>: valore di n bit senza segno, dove n = 8, 16 o 32. È possibile specificare in formato decimale o esadecimale, ad esempio 12 o 0x18, a condizione che il valore possa essere contenuto in n bit.


 

Tenere presente quanto segue:

  • <Par Name> rappresenta il nome di un parametro di configurazione. In un profilo, il tag corrispondente è formato sostituendo lo spazio con un carattere con trattini bassi "_", come ad esempio Par_Name.
  • Un campo di valore predefinito vuoto indica 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 e non la più vicina. Il nome del parametro deve corrispondere esattamente.
  • Se viene assegnata a un profilo 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.