Configura le impostazioni del profilo per i telefoni della serie 9800 e 8875 (BroadWorks)

Configura il suo telefono per la risincronizzazione del profilo

Risincronizza il profilo del telefono tramite TFTP

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

1	In un ambiente LAN, colleghi il computer e il telefono a un hub, switch o router di piccole dimensioni.
2	Sul computer, installi e attivi un server TFTP.
3	Usa un editor di testo per creare un profilo di configurazione. Per verificare se il profilo è stato assegnato al suo telefono in un secondo momento, può impostare alcuni valori come indicatori. Ad esempio, imposta il valore per GPP_A su 12345678 come mostrato nell'esempio seguente: `<flat-profile>  <GPP_A> 12345678  </GPP_A> </flat-profile>`
4	Salva il file di configurazione XML nella directory principale del server TFTP. Può verificare che il server TFTP sia configurato correttamente: richieda il file del profilo di configurazione utilizzando un client TFTP diverso dal telefono. Preferibilmente, utilizzi un client TFTP in esecuzione su un host separato dal server di provisioning.
5	Nel browser web del suo computer, apra la pagina web di amministrazione. Ad esempio, supponiamo che l'indirizzo IP del telefono sia 192.168.1.100, apra il seguente URL nel suo browser web: `http://192.168.1.100/admin/advanced`
6	Seleziona la scheda Voice > Provisioning e controlla i valori dei parametri generici da GPP_A a GPP_P. Questi dovrebbero essere vuoti.
7	Risincronizzi il telefono di prova con il profilo di configurazione da Lei creato aprendo l'URL di risincronizzazione in un browser web. Esempio: Se l'indirizzo IP del server TFTP è 192.168.1.200, il comando dovrebbe 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. Il telefono analizza quindi il file scaricato e aggiorna il parametro GPP_A con il valore 12345678.
8	Verifichi che il parametro sia stato aggiornato correttamente. Aggiorna la pagina web di amministrazione e vai su Voice > Provisioning. Il parametro GPP_A dovrebbe ora contenere il valore 12345678.

Fornire un profilo specifico per telefono su un server TFTP

1	Ottenga l'indirizzo MAC del telefono dall'etichetta del prodotto. (L'indirizzo MAC è il numero, che utilizza numeri e cifre esadecimali minuscole, ad esempio 000e08aabbcc.
2	Rinomini il suo file di configurazione in `CP-xxxx macaddress.cfg` (sostituendo `xxxx` con il numero del modello e l'`indirizzo macaddress con l'indirizzo` MAC del telefono). Esempio: `CP-8875 000e08aabbcc.cfg`
3	Sposta il nuovo file nella directory principale virtuale del server TFTP.
4	Accedere alla pagina web di amministrazione del telefono.
5	Seleziona Voice > Provisioning.
6	Inserisca il percorso del file del profilo nel campo Regola del profilo. Esempio: supponiamo 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	Faccia clic su Invia tutte le modifiche. Ciò causa un riavvio e una risincronizzazione immediati. Alla successiva risincronizzazione, il telefono recupera il nuovo file espandendo l'espressione macro $MA nel suo indirizzo MAC.

Risincronizza il profilo del telefono con HTTP GET

1	Installi un server HTTP sul computer locale o su un altro host accessibile. Il server Apache open source può essere scaricato da Internet.
2	Carichi 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, apra il profilo con un browser web.
4	Modifichi la Profile_Rule del telefono di prova in modo che punti al server HTTP anziché al server TFTP, in modo da scaricarne periodicamente il profilo. Ad esempio, supponendo che il server HTTP sia 192.168.1.300 e il nome del file del profilo sia basic.txt, immetta il seguente valore: `<Profile_Rule> http://192.168.1.200/basic.txt </Profile_Rule>`
5	Faccia clic su Invia tutte le modifiche. Ciò causa un riavvio e una risincronizzazione immediati.
6	Osservi i messaggi syslog inviati dal telefono. La risincronizzazione periodica dovrebbe ora consistere nell'ottenere il profilo dal server HTTP.
7	Nei log del server HTTP, osservi come vengono visualizzate le informazioni che identificano il telefono di prova nel registro degli user agent. Queste informazioni devono includere il produttore, il nome del prodotto, la versione attuale del firmware e il numero di serie.

Risincronizza automaticamente il profilo del telefono

Un dispositivo può risincronizzarsi periodicamente con il server di provisioning per garantire che tutte le modifiche al profilo apportate sul server vengano propagate al dispositivo endpoint (anziché inviare una richiesta di risincronizzazione esplicita all'endpoint).

Per far sì che il telefono si risincronizzi periodicamente con un server, l'URL del profilo di configurazione viene definito utilizzando il parametro Profile_Rule e un periodo di risincronizzazione viene definito utilizzando il parametro Resync_Periodic.

1	Accedere alla pagina web di amministrazione del telefono.
2	Seleziona Voice > Provisioning.
3	Definire il parametro Profile_Rule. Questo esempio presuppone un indirizzo IP del server TFTP 192.168.1.200.
4	Nel campo Resync Periodic, inserisca un valore piccolo per il test, ad esempio 30 secondi.
5	Faccia 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	Osservi i messaggi risultanti nella traccia syslog.
7	Si assicuri che il campo Resync On Reset sia impostato su Sì. `<Resync_On_Reset>Yes</Resync_On_Reset>`
8	Spegnere e riaccendere il telefono per forzarne la risincronizzazione con il server di provisioning. Se l'operazione di risincronizzazione fallisce per qualsiasi motivo, ad esempio se il server non risponde, l'unità attende (per il numero di secondi configurato in Resync Error Retry Delay) prima di tentare nuovamente la risincronizzazione. Se Resync Error Retry Delay è zero, il telefono non tenta di risincronizzarsi dopo un tentativo di risincronizzazione fallito.
9	(Facoltativo) Imposta il valore del campo Resync Error Retry Delay su un numero piccolo, ad esempio 30. `<Resync_Error_Retry_Delay>30</Resync_Error_Retry_Delay>`
10	Disattivi il server TFTP e osservi i risultati nell'output del syslog.

Parametri di risincronizzazione del profilo

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

Tabella 1. Parametri di risincronizzazione del profilo
Parametro	Descrizione
Abilitazione della disposizione	Consente o nega le azioni di risincronizzazione del profilo di configurazione. Nel file di configurazione del telefono (cfg.xml) con XML, inserisca una stringa in questo formato: `<Provision_Enable ua="na">Sì</Provision_Enable>` Nella pagina web del telefono, imposti questo campo su Sì per consentire le azioni di risincronizzazione o No per bloccare le azioni di risincronizzazione. Predefinito: Sì
Risincronizzazione 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, inserisca una stringa in questo formato: `<Resync_On_Reset ua="na">Sì</Resync_On_Reset>` Nella pagina web del telefono, imposti questo campo su Sì per consentire la risincronizzazione all'accensione o al ripristino, o No per bloccare la risincronizzazione all'accensione o al ripristino. Predefinito: Sì
Ritardo casuale di risincronizzazione	Evita il sovraccarico del server di provisioning quando un numero elevato di dispositivi si accende contemporaneamente e tenta la configurazione iniziale. Questo ritardo è effettivo solo nel tentativo di configurazione iniziale, dopo l'accensione o il ripristino del dispositivo. Il parametro è l'intervallo di tempo massimo che il dispositivo attende prima di entrare in contatto con il server di provisioning. Il ritardo effettivo è un numero pseudo-casuale compreso tra 0 e questo valore. Questo parametro è espresso in unità di 20 secondi. Il valore valido è compreso tra 0 e 65535. Nel file di configurazione del telefono (cfg.xml) con XML, inserisca una stringa in questo formato: `<Resync_Random_Delay ua="na">2</Resync_Random_Delay>` Nella pagina web del telefono, specifichi il numero di unità (20 secondi) affinché il telefono ritardi la risincronizzazione dopo l'accensione o il ripristino. Il valore predefinito è 2 (40 secondi).
Risincronizza con (HHmm)	L'ora (hhmm) in cui il telefono si risincronizza con il server di provisioning. Il valore di questo campo deve essere un numero di 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, inserisca una stringa in questo formato: `<Resync_At__HHmm_ ua="na">0959</Resync_At__HHmm_>` Nella pagina web del telefono, specifichi l'ora in formato HHMM di 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 in caso di ritardo casuale	Evita il sovraccarico del server di provisioning quando un numero elevato di dispositivi si accende contemporaneamente. Per evitare di inondare le richieste di risincronizzazione al server da più telefoni, il telefono si risincronizza nell'intervallo tra ore e minuti e ore e minuti più il ritardo casuale (hhmm, hhmm+random_delay). Ad esempio, se il ritardo casuale = (Resync At Random Delay + 30) /60 minuti, il valore di input in secondi viene convertito in minuti, arrotondato al minuto successivo per calcolare l'intervallo random_delay finale. Nel file di configurazione del telefono (cfg.xml) con XML, inserisca una stringa in questo formato: `<Resync_At_Random_Delay ua="na">600</Resync_At_Random_Delay>` Nella pagina web del telefono, specifichi il periodo di tempo in secondi. Il valore valido è compreso tra 600 e 65535. Se il valore è inferiore a 600, il ritardo casuale interno è compreso tra 0 e 600. Il valore predefinito è 600 secondi (10 minuti).
Risincronizzazione periodica	L'intervallo di tempo tra la risincronizzazione periodica con il server di provisioning. Il timer di risincronizzazione associato è attivo solo dopo la prima sincronizzazione riuscita con il server. I formati validi sono i seguenti: Un numero intero Esempio: un input di `3000` indica che la prossima risincronizzazione avviene tra 3000 secondi. Numeri interi multipli Esempio: un input di `600.1200.300` indica che la prima risincronizzazione avviene in 600 secondi, la seconda risincronizzazione avviene in 1200 secondi dopo la prima e la terza risincronizzazione avviene in 300 secondi dopo la seconda. Un intervallo di tempo Ad esempio, un input di `2400+30` indica che la risincronizzazione successiva avviene tra 2400 e 2430 secondi dopo una risincronizzazione riuscita. Nel file di configurazione del telefono (cfg.xml) con XML, inserisca una stringa in questo formato: `<Resync_Periodic ua="na">3600</Resync_Periodic>` Nella pagina web del telefono, specifichi il periodo di tempo in secondi. Imposta questo parametro su zero per disabilitare la risincronizzazione periodica. Il valore predefinito è 3600 secondi.
Errore di risincronizzazione Ritardo nel tentativo	Se un'operazione di risincronizzazione non riesce perché il telefono non è stato in grado di recuperare un profilo dal server, o il file scaricato è danneggiato, o si verifica un errore interno, il telefono tenta di risincronizzare nuovamente 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 avviene tra 300 secondi. Numeri interi multipli Esempio: un input di `600.1200.300` indica che il primo tentativo avviene in 600 secondi dopo l'errore, il secondo tentativo avviene in 1200 secondi dopo il fallimento del primo tentativo e il terzo tentativo si verifica in 300 secondi dopo il fallimento del secondo tentativo. Un intervallo di tempo Ad esempio, un input di `2400+30` indica che il tentativo successivo avviene tra 2400 e 2430 secondi dopo un errore di risincronizzazione. Se il ritardo è impostato su 0, il dispositivo non tenta di risincronizzare nuovamente dopo un tentativo di risincronizzazione fallito. Nel file di configurazione del telefono (cfg.xml) con XML, inserisca 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, specifichi il periodo di tempo in secondi. Predefinito: 60.120,240,480,960,1920,3840,7680,15360,30720,61440,86400
Ritardo di risincronizzazione forzata	Ritardo massimo (in secondi) di attesa del telefono prima di eseguire una risincronizzazione. Il dispositivo non si risincronizza mentre una delle sue linee telefoniche è attiva. Poiché una risincronizzazione può richiedere diversi secondi, è consigliabile attendere che il dispositivo sia rimasto inattivo per un lungo periodo prima di risincronizzare. Ciò consente a un utente di effettuare chiamate in successione senza interruzioni. Il dispositivo ha un timer che inizia il conto alla rovescia quando tutte le linee diventano inattive. Questo parametro è il valore iniziale del contatore. Gli eventi di risincronizzazione vengono ritardati fino a quando questo contatore non scende a zero. Il valore valido è compreso tra 0 e 65535. Nel file di configurazione del telefono (cfg.xml) con XML, inserisca una stringa in questo formato: `<Forced_Resync_Delay ua="na">14400</Forced_Resync_Delay>` Nella pagina web del telefono, specifichi il periodo di tempo in secondi. Il valore predefinito è 14.400 secondi.
Risincronizzazione da SIP	Controlla le richieste di operazioni di risincronizzazione tramite un evento SIP NOTIFY inviato dal server proxy del fornitore di servizi al telefono. Se abilitato, il proxy può richiedere una risincronizzazione inviando un messaggio SIP NOTIFY contenente l'intestazione Event: resync al dispositivo. Nel file di configurazione del telefono (cfg.xml) con XML, inserisca una stringa in questo formato: `<Resync_From_SIP ua="na">Sì</Resync_From_SIP>` Nella pagina web del telefono, selezioni Sì per abilitare questa funzione o No per disabilitarla. Predefinito: Sì
Risincronizzazione dopo il tentativo di aggiornamento	Abilita o disabilita 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, inserisca una stringa in questo formato: `<Resync_After_Upgrade_Attempt ua="na">Sì</Resync_After_Upgrade_Attempt>` Nella pagina web del telefono, selezioni Sì per attivare la risincronizzazione dopo un aggiornamento del firmware o No per non risincronizzare. Predefinito: Sì
Trigger di risincronizzazione 1 Trigger di risincronizzazione 2	Se l'equazione logica in questi parametri restituisce FALSE, la risincronizzazione non viene attivata anche quando Resync On Reset è impostato su TRUE. Solo la risincronizzazione tramite URL di azione diretta e notifica SIP ignora questi trigger di risincronizzazione. I parametri possono essere programmati con un'espressione condizionale che subisce un'espansione macro. Per le espansioni macro valide, vedere Variabili di espansione macro in Parametri di provisioning. Nel file di configurazione del telefono (cfg.xml) con XML, inserisca una stringa in questo formato: `<Resync_Trigger_1 ua="na">$UPGTMR get 300 e $PRVTMR get 600</Resync_Trigger_1>` `<Resync_Trigger_2 ua="na"/>` Nella pagina web del telefono, specifichi i trigger. Impostazione predefinita: vuoto
Risincronizzazione configurabile dall'utente	Consente a un utente di risincronizzare il telefono dal menu dello schermo del telefono. Se impostato su Sì, un utente può risincronizzare la configurazione del telefono inserendo la regola del profilo dal telefono. Se impostato su No, il parametro della regola del profilo non viene visualizzato nel menu dello schermo del telefono. Nel file di configurazione del telefono (cfg.xml) con XML, inserisca una stringa in questo formato: `<User_Configurable_Resync ua="na">Sì</User_Configurable_Resync>` Nella pagina web del telefono, selezioni Sì per mostrare il parametro Regola del profilo nel menu del telefono o selezioni No per nascondere questo parametro. Predefinito: Sì
La risincronizzazione non riesce su FNF	Una risincronizzazione è in genere considerata non riuscita se un profilo richiesto non viene ricevuto dal server. Questo parametro sovrascrive questo comportamento. Se impostato su No, il dispositivo accetta una risposta di `file non trovata` dal server come risincronizzazione riuscita. Nel file di configurazione del telefono (cfg.xml) con XML, inserisca una stringa in questo formato: `<Resync_Fails_On_FNF ua="na">Sì</Resync_Fails_On_FNF>` Nella pagina web del telefono`, selezioni Sì per accettare una risposta a un file non trovato come risincronizzazione non riuscita, oppure selezioni No per accettare una risposta con un file non trovato come risincronizzazione riuscita.` Predefinito: Sì
Tipo di autenticazione del profilo	Specifica le credenziali da utilizzare per l'autenticazione dell'account del profilo. Le opzioni disponibili sono: Disabilitato: disabilita la funzionalità dell'account del profilo. Quando questa funzione è disabilitata, il menu di configurazione dell'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: Quando il tipo di autenticazione XSI per il telefono è impostato su Credenziali di accesso, vengono utilizzate le credenziali di accesso XSI. Quando il tipo di autenticazione XSI per il telefono è impostato su Credenziali SIP, vengono utilizzate le credenziali SIP XSI. Nel file di configurazione del telefono (cfg.xml) con XML, inserisca una stringa in questo formato: `<Profile_Authentication_Type ua="na">Autenticazione HTTP di base</Profile_Authentication_Type>` Nella pagina web del telefono, selezioni un'opzione dall'elenco per consentire al telefono di autenticare la risincronizzazione del profilo. Impostazione predefinita: autenticazione HTTP di base Per ulteriori informazioni, vedere Specificare il tipo di autenticazione del profilo in Specificare il telefono per la risincronizzazione del profilo.
Regola del profilo Regola B del profilo Regola C del profilo Regola D del profilo	Ogni regola del profilo informa il telefono di una fonte da cui ottenere un profilo (file di configurazione). Durante ogni operazione di risincronizzazione, il telefono applica tutti i profili in sequenza. `Se sta applicando la crittografia AES-256-CBC ai file di configurazione, specifichi la chiave di crittografia con la parola chiave --key come segue:` `[--chiave]` <encryption key> Può racchiudere la chiave di crittografia tra virgolette doppie («) facoltativamente. Nel file di configurazione del telefono (cfg.xml) con XML, inserisca 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, specifichi la regola del profilo. Predefinito: `/$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

Fornitura tramite Cisco XML

Può effettuare il provisioning dei telefoni tramite le funzioni Cisco XML.

Può inviare un oggetto XML al telefono tramite un pacchetto SIP Notify o un HTTP Post all'interfaccia CGI del telefono: http://PhoneIPAddress/CGI/Execute.

Il CP-xxxx-3PCC estende la funzionalità 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 espansione macro

Le sottodirectory con più profili sul server forniscono un metodo conveniente per gestire un gran numero 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 per nome, il telefono esegue una ricerca DNS per risolvere il nome.
Una porta server non standard specificata nell'URL utilizzando la sintassi standard:port dopo il nome del server.
La sottodirectory della directory principale virtuale del server in cui è archiviato il profilo, specificata utilizzando la notazione URL standard e gestita mediante l'espansione delle macro.

Ad esempio, la seguente Profile_Rule richiede il file del 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_Rule> tftp://prov.telco.com:6900/cisco/config/$PN.cfg </Profile_Rule>

Un profilo per ogni telefono può essere identificato in un parametro generico, il cui valore fa riferimento a una regola di profilo comune utilizzando l'espansione delle macro.

Ad esempio, supponga che GPP_B sia definito come Dj6Lmp23Q.

La Profile_Rule ha il valore:


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

Quando il dispositivo si risincronizza e le macro vengono espanse, il telefono con un indirizzo MAC 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

Specificare il tipo di autenticazione del profilo

L'autenticazione del profilo consente agli utenti telefonici di risincronizzare il profilo di provisioning sul telefono. Le informazioni di autenticazione sono necessarie mentre 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. Quando abilita questa funzione, sul telefono viene visualizzata la schermata di configurazione dell'account Profilo per le seguenti situazioni:

Quando l'errore di autenticazione HTTP o HTTPs 401 si verifica durante il primo provisioning dopo il riavvio del telefono
Quando il nome utente e la password dell'account del profilo sono vuoti
Quando non ci sono nome utente e password nella Regola del profilo

Se la schermata di configurazione dell'account Profile viene persa o ignorata, l'utente può accedere alla schermata di configurazione anche tramite il menu dello schermo del telefono o il softkey Configurazione, che viene visualizzato solo quando non è registrata alcuna linea sul telefono.

Quando disabilita la funzione, la schermata di configurazione dell'account Profilo non viene visualizzata sul telefono.

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

Quando fornisce un URL corretto nel campo Regola del profilo senza nome utente e password, il telefono richiede l'autenticazione o un digest per risincronizzare il profilo. Con l'account del profilo corretto, i passaggi di autenticazione. Con un account di profilo errato, l'autenticazione non riesce.
Quando fornisce un URL corretto nel campo Regola del profilo con nome utente e password corretti, il telefono richiede l'autenticazione o un digest per risincronizzare il profilo. L'account del profilo non viene utilizzato per la risincronizzazione del telefono. L'accesso è avvenuto con successo.
Quando fornisce un URL corretto nel campo Regola del profilo con un nome utente e una password errati, il telefono richiede l'autenticazione o un digest per risincronizzare il profilo. L'account del profilo non viene utilizzato per la risincronizzazione del telefono. L'accesso non riesce sempre.
Quando fornisce un URL errato nel campo Regola del profilo, l'accesso ha sempre esito negativo.

Può anche configurare i parametri nel file di configurazione del telefono con codice XML (cfg.xml).

Può specificare il tipo di autenticazione del profilo dalla pagina web di amministrazione del telefono.

1	Accedere alla pagina web di amministrazione del telefono.
2	Seleziona Voice > Provisioning.
3	Nella sezione Profilo di configurazione, imposta il parametro Profile Authentication Type per specificare le credenziali da utilizzare per l'autenticazione dell'account del profilo. Può configurare questo parametro nel file XML di configurazione del telefono (cfg.xml) inserendo una stringa in questo formato: `<Profile_Authentication_Type ua="na">Disabled</Profile_Authentication_Type>` Opzioni: Disabilitato: disabilita la funzione dell'account del profilo. Quando questa funzione è disabilitata, il menu di configurazione dell'account del 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: Quando il tipo di autenticazione XSI per il telefono è impostato su Credenziali di accesso, vengono utilizzate le credenziali di accesso XSI. Quando il tipo di autenticazione XSI per il telefono è impostato su Credenziali SIP, vengono utilizzate le credenziali SIP XSI. Impostazione predefinita: autenticazione HTTP di base
4	Faccia clic su Invia tutte le modifiche.

Applica manualmente un profilo al suo telefono

Scarichi il file di configurazione sul telefono da un server TFTP

Completi questi passaggi per scaricare il file di configurazione in un'applicazione server TFTP sul suo PC.

1	Colleghi il suo 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 del TFTP.
3	In un browser web, inserisca l'indirizzo IP della LAN del telefono, l'indirizzo IP del computer, il nome del file e le credenziali di accesso. Usa questo 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`

Scarica il file di configurazione sul telefono con cURL

Completi questi passaggi per scaricare la configurazione sul telefono utilizzando cURL. Questo strumento da riga di comando viene utilizzato per trasferire dati con una sintassi URL. Per scaricare cURL, visiti:

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

Le consigliamo di non usare cURL per inviare la configurazione sul telefono perché il nome utente e la password potrebbero essere acquisiti durante l'utilizzo di cURL.

1	Colleghi il suo computer alla porta LAN del telefono.
2	Scarichi il file di configurazione sul telefono inserendo il seguente comando cURL: `curl –d @my_config.xml “http://192.168.15.1/admin/config.xml&xuser=admin&xpassword=admin”`

Riferimenti per la configurazione del profilo

Il telefono accetta configurazioni in formato XML.

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

Formati del profilo di configurazione

Il profilo di configurazione definisce i valori dei parametri per il telefono.

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

È supportato solo il set di caratteri UTF-8. Se modifica il profilo in un editor, non cambi il formato di codifica; in caso contrario, il telefono non può riconoscere il file.

Ogni telefono ha un set di funzionalità diverso e quindi un diverso set di parametri.

Aprire il formato del profilo

Il profilo in formato aperto è un file di testo con sintassi simile a XML in una gerarchia di elementi, con attributi e valori degli elementi. Questo formato Le consente di utilizzare 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 compilazione come oggetto binario.

Il telefono può accettare i formati di configurazione generati dagli strumenti standard. Questa funzionalità facilita lo sviluppo di software per 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 invia il file di configurazione XML al telefono tramite un canale protetto da TLS. Facoltativamente, il file può essere compresso utilizzando l'algoritmo gzip deflate (RFC1951).

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

Crittografia AES-256-CBC
Crittografia dei contenuti HTTP basata su RFC-8188 con crittografia AES-128-GCM

Un file di configurazione può includere questi componenti:

Tag degli elementi
Attributi
Parametri
Funzionalità di formattazione
commenti XML

Esempio: Aprire il formato del profilo


<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 <flat-profile>tag element racchiude tutti gli elementi dei parametri riconosciuti dal telefono.

Proprietà dei tag dell'elemento

Tenga a mente le seguenti regole quando crea o aggiorna il file di configurazione.

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 delle restrizioni relative ai nomi degli elementi XML. Ad esempio, caratteri di sottolineatura (_) nel file di configurazione XML anziché spazi nell'interfaccia utente Web.

<flat-profile>Il telefono riconosce gli elementi con i nomi dei 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, sostituisca un carattere di sottolineatura per ogni spazio o i caratteri speciali [,], (,) o/.

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

Il nome di ogni elemento deve essere univoco. Nell'interfaccia utente Web del telefono, gli stessi campi possono essere visualizzati su più pagine Web, come le pagine Linea, Utente ed Estensione. Aggiungere [n] al nome dell'elemento per indicare il numero mostrato nella scheda della pagina.

Esempio: l'<Dial_Plan_1_>elemento rappresenta il Dial Plan per la linea 1.

Ogni tag dell'elemento di apertura deve avere un tag dell'elemento di chiusura corrispondente. 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 degli elementi fanno distinzione tra maiuscole e minuscole.

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

<Profile_Rule_B />

Un tag elemento vuoto può essere usato per impedire la sovrascrittura di qualsiasi valore fornito dall'utente durante un'operazione di risincronizzazione. Nel seguente esempio, le impostazioni di chiamata rapida dell'utente sono 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>

Usa un valore vuoto per impostare il parametro corrispondente su una stringa vuota. Inserisca 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> </GPP_A> </flat-profile>

I nomi degli elementi non riconosciuti vengono ignorati.

Proprietà dei parametri

Queste proprietà si applicano ai parametri:
Tutti i parametri non specificati da un profilo rimangono invariati nel telefono.
I parametri non riconosciuti vengono ignorati.
Se il profilo Open format contiene più occorrenze dello stesso tag parametro, l'ultima di queste occorrenze sovrascrive quelle precedenti. Per evitare la sovrascrittura involontaria dei valori di configurazione di un parametro, consigliamo che ogni 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 di quest'ultimo profilo ha la precedenza.

Formati di stringhe

Queste proprietà si applicano alla formattazione delle stringhe:
I commenti sono consentiti tramite la sintassi XML standard.

Gli spazi bianchi iniziali e finali sono consentiti per la leggibilità ma vengono rimossi dal valore del parametro.
Le nuove righe all'interno di un valore vengono convertite in spazi.
Un'intestazione XML del modulo <? ? > è consentito, ma il telefono lo ignora.
Per inserire caratteri speciali, usi gli escape di caratteri XML di base, come mostrato nella tabella seguente.
Carattere speciale
Sequenza di escape XML
& (e commerciale)
&
< (inferiore a)
<
> (maggiore di)
>
'(apostrofo)
'
» (virgolette doppie)
«
Nell'esempio seguente, vengono inseriti caratteri di escape per rappresentare i simboli maggiore e minore di che sono richiesti in una regola del piano di chiamata. Questo esempio definisce un piano di chiamata della hotline informativa che imposta il <Dial_Plan_1_>parametro (Admin Login > advanced > Voice > Ext (n)) uguale a (S0 <:18005551212>).
<flat-profile> <Dial_Plan_1_> (S0 <:18005551212>) </Dial_Plan_1_> </flat-profile>
Gli escape di caratteri numerici, che utilizzano valori decimali ed esadecimali (s.a. (e.), vengono tradotti.
Il firmware del telefono supporta solo caratteri ASCII.

Carattere speciale	Sequenza di escape XML
& (e commerciale)	&
< (inferiore a)	<
> (maggiore di)	>
'(apostrofo)	'
» (virgolette doppie)	«

Compressione del profilo aperto

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

Per identificare la compressione, il telefono si aspetta che il file compresso contenga un'intestazione compatibile con gzip. L'invocazione 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 un file compresso.

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

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

Crittografia a profilo aperto

La crittografia a chiave simmetrica può essere utilizzata per crittografare un profilo di configurazione aperto, indipendentemente dal fatto che il file sia compresso o meno. 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 precrittografia dei profili di configurazione offline consente l'uso di HTTP per risincronizzare successivamente i profili. Questo riduce il carico sul server HTTPS nelle implementazioni su larga scala.

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

Crittografia AES-256-CBC

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

La chiave o l'Input Keying Material (IKM) devono essere predisposti nell'unità in un momento precedente. 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 di 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 i 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 può richiedere la ricompilazione dello strumento per abilitare il codice AES. Il firmware è stato testato con la versione openssl-1.1.1d.

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

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

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

Quando questa forma di crittografia viene utilizzata su un profilo di configurazione, il telefono deve essere informato del valore della chiave segreta per decrittografare il file. Questo valore è specificato come qualificatore nell'URL del profilo. 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.

Diversi parametri di provisioning vengono sottoposti a macro espansione interna prima di essere valutati. Questa fase di valutazione preliminare offre una maggiore flessibilità nel controllo delle attività di risincronizzazione e aggiornamento del telefono.

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

Trigger di risincronizzazione_*

Regola del profilo*

log_XXX_msg

Regola_di aggiornamento

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

Durante l'espansione delle macro, il contenuto delle variabili denominate sostituisce le espressioni nel formato $NAME e $ (NAME). Queste variabili includono parametri generici, diversi identificatori di prodotto, determinati timer di eventi 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 è: 000E08012345config.cfg

Se il nome di una 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 delle macro non viene applicata in modo ricorsivo. Ad esempio, $$MAU» si espande in $MAU» (il $$ viene espanso) e non risulta nell'indirizzo MAC.

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

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

Le espressioni condizionali sono costituite da un elenco di confronti, separati dall'operatore and. Tutti i confronti devono essere soddisfatti perché la condizione sia vera.

Ogni confronto può riferirsi a uno dei tre tipi letterali seguenti:

Valori interi

Numeri di versione del software o dell'hardware

Stringhe con virgolette doppie

Numeri di versione

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

TELEFONI yyyy. 1-0-1-0001 - BN

dove yyyy indica il modello o la serie di 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. Altrimenti, si verifica un errore di analisi del formato.

Quando si confronta la 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 su queste ultime. Quando i numeri di versione sono identici, viene confrontato il numero di build.

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. I numeri interi e i numeri di versione possono essere confrontati anche aritmeticamente. Gli operatori di confronto possono essere espressi come simboli o acronimi. Gli acronimi sono utili per esprimere la condizione in un profilo in formato aperto.

Operatore

Sintassi alternativa

Descrizione

Applicabile agli operandi interi e di versione

Applicabile agli operandi di stringa tra virgolette

=

eq

pari a

Sì

Sì

!=

ne

non uguale a

Sì

Sì

<

lt

meno di

Sì

No

<=

le

minore o uguale a

Sì

No

>

gt

maggiore di

Sì

No

>=

età

maggiore o uguale a

Sì

No

AND

e

Sì

Sì

È importante racchiudere le variabili macro tra virgolette doppie dove è prevista una stringa letterale. Non lo faccia dove è previsto un numero o un numero di versione.

Se 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. Si ricordi di sostituire BN con il numero di build del suo firmware caricato 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 usi la sintassi precedente tra parentesi per configurare i parametri Resync_Trigger_*.

Operatore	Sintassi alternativa	Descrizione	Applicabile agli operandi interi e di versione	Applicabile agli operandi di stringa tra virgolette
=	eq	pari a	Sì	Sì
!=	ne	non uguale a	Sì	Sì
<	lt	meno di	Sì	No
<=	le	minore o uguale a	Sì	No
>	gt	maggiore di	Sì	No
>=	età	maggiore o uguale a	Sì	No
AND		e	Sì	Sì

Usa la sintassi URL standard per specificare come recuperare i file di configurazione e i carichi del firmware nei parametri Profile_Rule* e Upgrade_Rule, rispettivamente. La sintassi è la seguente:

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

Dove schema è uno di questi valori:

tftp

http

https

Se lo schema viene omesso, si presume tftp. Il server può essere un nome host riconosciuto dal DNS o un indirizzo IP numerico. La porta è il numero di porta UDP o TCP di destinazione. Il percorso del file deve iniziare con la directory principale (/); deve essere un percorso assoluto.

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

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

Se manca una porta, 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 di file. Non deve necessariamente riferirsi a un file statico, ma può indicare contenuti dinamici ottenuti tramite CGI.

L'espansione delle 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

Quando si utilizza l'opzione DHCP 66, la sintassi vuota non è supportata dalle regole di aggiornamento. È applicabile solo per la regola del profilo*.

Crittografia dei contenuti HTTP basata su RFC 8188

Il telefono supporta la crittografia dei contenuti HTTP basata su RFC 8188 con crittografia 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'Input Keying Material (IKM) possono leggere il payload. Quando il telefono è dotato dell'IKM, il telefono e il server di provisioning possono scambiarsi file di configurazione in modo sicuro, consentendo al contempo agli elementi di rete di terze parti di utilizzare le intestazioni dei messaggi per scopi analitici e di 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, a cui può accedere dall'indirizzo IP del telefono o dai report di configurazione del telefono inviati al server di provisioning.

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

Fornire al telefono 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 questa crittografia viene applicata ai file di configurazione inviati dal server di provisioning al telefono, si assicuri che l'intestazione HTTP Content-Encoding nel file di configurazione sia aes128gcm.

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

Se desidera che il telefono applichi questa crittografia ai report di configurazione che invia al server di provisioning, si assicuri che non sia specificata alcuna chiave AES-256-CBC nella regola del rapporto.

Argomenti di risincronizzazione opzionali

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

chiave
uid e pwd

L'opzione --key indica al telefono che il file di configurazione che riceve dal server di provisioning è crittografato con crittografia AES-256-CBC, a meno che l'intestazione Content-Encoding nel file non indichi la crittografia aes128gcm. La chiave stessa è specificata come stringa dopo il termine --key. La chiave può essere racchiusa tra virgolette doppie («) facoltativamente. Il telefono utilizza la chiave per decrittografare il file di configurazione.

Esempi di utilizzo

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

Gli argomenti opzionali tra parentesi sono espansi tramite macro. I parametri per scopi speciali, da GPP_SA a GPP_SD, vengono espansi macro in variabili macro, da $SA a $SD, solo quando vengono utilizzati come argomenti delle opzioni chiave. Guarda questi esempi:

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

Nei profili in formato aperto, l'argomento --key deve essere lo stesso dell'argomento dell'opzione -k fornita a openssl.

Le opzioni uid e pwd possono essere utilizzate per specificare l'ID utente e la password che verranno inviati in risposta alle sfide di autenticazione HTTP Basic e Digest quando viene richiesto l'URL specificato. Gli argomenti opzionali tra parentesi sono espansi tramite macro. I parametri per scopi speciali, da GPP_SA a GPP_SD, vengono espansi macro in variabili macro, da $SA a $SD, solo quando vengono utilizzati come argomenti delle opzioni chiave. Guarda questi esempi:

GPP_SA = MyUserID GPP_SB = MySecretPassword

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

si espanderebbe quindi fino a:

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

Tipi di dati

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

{a, b, c,...} —Una 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: S ₁ [; S ₂], dove:

_{_{_{_{S _i =D _i (on _{i,1 /off i,1} [, on _{i,2 /off i,2} _{[, on i,3} /off _{i,3 [, on i,4} /off _i,3 [, on i,4 /off _i,4 _{[, on i,6} /off _i,6]]]]]) ed è nota come sezione.}}}}

on _{i, j} e off _{i, j} sono la durata dell'accensione/spegnimento in secondi di un segmento. i = 1 o 2 e j = da 1 a 6.

D _i è la durata totale della sezione in secondi.

Tutte le durate possono avere fino a tre cifre 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 alla durata totale.

Esempio 1:

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

Esempio 2: anello distintivo (corto, corto, corto, lungo):

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

DialPlanScript: sintassi di script utilizzata per specificare i dial plan della riga 1 e della riga 2.

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

FQDN: nome di dominio completo. Può contenere fino a 63 caratteri. Gli esempi sono i seguenti:
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 livello di un tono. Contiene fino a 127 caratteri.

Sintassi: F ₁ @L ₁ [, F ₂ @L ₂ [, F ₃ @L ₃ [, F ₄ @L ₄ [, F ₅ @L ₅ [, F ₆ @L ₆]]]]], dove:

F ₁ —F ₆ sono frequenze in Hz (solo numeri interi senza segno).

L ₁ —L ₆ sono i livelli corrispondenti in dBm (con un massimo di una cifra decimale).

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

Esempio 1: tono di avviso di chiamata:

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

Esempio 2: Tono di linea:

350@-19,440@-19 Number of Frequencies = 2 Frequency 1 = 350 Hz at –19 dBm Frequency 2 = 440 Hz at –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: ID utente come appare 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ù motivi separati da una virgola (,). Lo spazio bianco all'inizio di ogni schema viene ignorato. «?» e «*» rappresentano caratteri jolly. Per rappresentare letteralmente, usi %xx. Ad esempio, %2a rappresenta *. Il modello può contenere fino a 39 caratteri. Esempi: «1408*, 1510*», «1408123???? , 555? 1.».

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

ProvisioningRulesyntax: sintassi di script utilizzata per definire le regole di risincronizzazione della configurazione e aggiornamento del firmware.

PWRLevel: livello di potenza espresso in dBm con una cifra decimale, ad esempio -13,5 o 1,5 (dBm).

RSCTMPLT—Un modello di codice di stato della risposta SIP, ad esempio «404, 5*», «61?» , «407, 408, 487, 481». Può contenere fino a 39 caratteri.

<n>Sig.—Valore in bit con segno. Può essere specificato in formato decimale o esadecimale. Un segno «-» deve precedere i valori negativi. Il segno + prima dei valori positivi è facoltativo.

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

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

<n>Tempo: durata in secondi, con un massimo di n cifre decimali. Le cifre decimali extra specificate vengono ignorate.

ToneScript: un miniscript che specifica i parametri di frequenza, livello e cadenza di un tono di avanzamento della chiamata. Lo script può contenere fino a 127 caratteri.

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

_{_{_{_{_{_{_{_{_{_{La sezione Z ₁ è simile alla sezione S ₁ in uno script CAD, tranne per il fatto che ogni segmento on/off è seguito da un parametro di componenti di frequenza: Z _{1 = D 1 (on i,1 /off i,1 /f i,1} _{[, on i,2 /off i,2} /f _{i,2 [, on _i,3 /off _{i,3 /f i,3} [, on i,4} _{/off _{i,4 /f i,4} [, su _i,5 /disattivato i,5 /f i,5 [, su i,6} /disattivato _i,6 /f}}}}}}}}}} _i,6]]]]]) dove:

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

1 < n _k < 6 specifica i componenti di frequenza nel FreqScript utilizzati in quel segmento.

Se in un segmento viene utilizzata più di una componente di frequenza, le componenti vengono sommate.

Esempio 1: Tono di linea:

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

Esempio 2: tono balbuziente:

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

Uns<n>: valore n-bit senza segno, dove n = 8, 16 o 32. Può essere specificato in formato decimale o esadecimale, ad esempio 12 o 0x18, purché il valore possa rientrare in n bit.

Li tenga in considerazione:

<Par Name>rappresenta il nome di un parametro di configurazione. In un profilo, il tag corrispondente viene formato sostituendo lo spazio con un carattere di sottolineatura «_», ad esempio Par_Name.
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 indicato. Viene selezionata la prima partita, non la più vicina. Il nome del parametro deve corrispondere esattamente.
Se in un profilo viene fornita più di una definizione per un parametro, l'ultima definizione di questo tipo nel file è quella che ha effetto nel telefono.
Una specifica di parametro con un valore di parametro vuoto obbliga il parametro a tornare al valore predefinito. Per specificare invece una stringa vuota, usi la stringa vuota «» come valore del parametro.

Cisco AI Assistant

Grazie per il feedback.