Konfigurer telefonen for resynkronisering av profiler

Telefonen støtter flere nettverksprotokoller for henting av konfigurasjonsprofiler. Den mest grunnleggende profiloverføringsprotokollen er TFTP (RFC1350). TFTP brukes i stor grad til klargjøring av nettverksenheter i private LAN-nettverk. Selv om det ikke anbefales for distribusjon av eksterne endepunkter over Internett, kan TFTP være praktisk for distribusjon i små organisasjoner, for intern forhåndsklargjøring og for utvikling og testing. I prosedyren nedenfor endres en profil etter nedlasting av en fil fra en TFTP-server.

1

I et LAN-miljø kobler du datamaskinen og telefonen til en hub, svitsj eller en liten ruter.

2

Installer og aktiver en TFTP-server på datamaskinen.

3

Bruk et tekstredigeringsprogram til å opprette en konfigurasjonsprofil.

Hvis du vil kontrollere om profilen er klargjort til telefonen din senere, kan du angi noen av verdiene som merker. Sett for eksempel verdien for GPP_A til 12345678 som vist i følgende eksempel:
 <flat-profile>   <GPP_A> 12345678   A> </flat-profile> 
_
4

Lagre XML-konfigurasjonsfilen i rotkatalogen på TFTP-serveren.

Du kan kontrollere at TFTP-serveren er riktig konfigurert: be om konfigurasjonsprofilfilen ved hjelp av en annen TFTP-klient enn telefonen. Bruk helst en TFTP-klient som kjører på en annen vert enn klargjøringsserveren.

5

Åpne administrasjonsnettsiden i nettleseren på datamaskinen. Forutsett for eksempel at IP-adressen til telefonen er 192.168.1.100, åpne følgende URL i nettleseren din:


http://192.168.1.100/admin/advanced

6

Velg fanen Tale > Klargjøring , og inspiser verdiene for de generelle parametrene GPP_A til GPP_P. Disse må være tomme.

7

Resynkroniser testtelefonen med konfigurasjonsprofilen du opprettet ved å åpne resynkroniserings-URL-adressen i en nettleser.

Eksempel:

Hvis IP-adressen til TFTP-serveren er 192.168.1.200, skal kommandoen være lik følgende eksempel:


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

Når telefonen mottar denne kommandoen, ber enheten på adressen 192.168.1.100 om konfigurasjonsprofilfilen basic.txt fra TFTP-serveren på IP-adressen 192.168.1.200. Telefonen analyserer deretter den nedlastede filen og oppdaterer parameteren GPP_A med verdien 12345678.

8

Kontroller at parameteren ble oppdatert riktig. Oppdater administrasjonsnettsiden, og gå til Tale > Klargjøring.

GPP_A-parameteren skal nå inneholde verdien 12345678.

1

Hent telefonens MAC-adresse fra produktetiketten. (MAC-adressen er nummeret, ved hjelp av tall og heksadesimale sifre med små bokstaver, for eksempel 000e08aabbcc.

2

Gi konfigurasjonsfilen nytt navn til CP-xxxx macaddress.cfg (erstatt xxxx med modellnummeret og macaddress med telefonens MAC-adresse).

Eksempel:

CP-8875 000e08aabbcc.cfg

3

Flytt den nye filen til TFTP-serverens virtuelle rotkatalog.

4

Gå inn på telefonens administrasjonsnettside.

5

Velg Tale  > Klargjøring.

6

Skriv inn banen til profilfilen i feltet Profilregel .

Eksempel: Forutsett at IP-adressen til TFTP-serveren er 192.168.1.200 og profilfilnavnet er

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

Klikk på Send inn alle endringer. Dette fører til umiddelbar omstart og resynkronisering.

Når den neste resynkroniseringen skjer, henter telefonen den nye filen ved å utvide $MA-makrouttrykket i sin MAC-adresse.

1

Installer en HTTP-server på den lokale datamaskinen eller en annen tilgjengelig vert.

Apache-serveren med åpen kildekode kan lastes ned fra internett.

2

Last opp konfigurasjonsprofilfilen til den virtuelle rotkatalogen til den installerte serveren.

3

For å bekrefte riktig serverinstallasjon og tilgang til profilfilen åpner du profilen med en nettleser.

4

Endre testtelefonens Profile_Rule slik at den peker til HTTP-serveren i stedet for TFTP-serveren, slik at profilen kan lastes ned regelmessig.

Forutsett for eksempel at HTTP-serveren er på 192.168.1.300 og profilfilnavnet er basic.txt, angi følgende verdi:

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

Klikk på Send inn alle endringer. Dette fører til umiddelbar omstart og resynkronisering.

6

Se syslog-meldingene som telefonen sender. Den periodiske resynkroniseringen skal nå hente profilen fra HTTP-serveren.

7

I HTTP-serverloggene kan du se hvordan informasjon som identifiserer testtelefonen vises i loggen til brukeragenter.

Denne informasjonen skal inkludere produsent, produktnavn, gjeldende fastvareversjon og serienummer.

En enhet kan resynkronisere regelmessig til klargjøringsserveren for å sikre at eventuelle profilendringer som gjøres på serveren, overføres til endepunktenheten (i motsetning til å sende en eksplisitt resynkroniseringsforespørsel til endepunktet).

For å få telefonen til å resynkronisere regelmessig med en server, defineres en konfigurasjonsprofil-URL ved hjelp av parameteren Profile_Rule, og en resynkroniseringsperiode defineres ved hjelp av parameteren Resync_Periodic.

1

Gå inn på telefonens administrasjonsnettside.

2

Velg Tale  > Klargjøring.

3

Definer parameteren Profile_Rule. Dette eksemplet forutsetter en IP-adresse på 192.168.1.200 for TFTP-serveren.

4

I feltet Resync Periodic skriver du inn en liten verdi for testing, for eksempel 30 sekunder.

5

Klikk på Send inn alle endringer.

Med de nye parameterinnstillingene resynkroniserer telefonen to ganger i minuttet med konfigurasjonsfilen som URL-adressen angir.

6

Se de resulterende meldingene i syslog-sporing.

7

Kontroller at feltet Resync On Reset er satt til Yes.

 <Resync_On_Reset>JaOn_Reset> 
esync_
8

Slå telefonen på for å tvinge den til å resynkronisere med klargjøringsserveren.

Hvis resynkroniseringsoperasjonen av en eller annen grunn mislykkes, for eksempel hvis serveren ikke svarer, venter enheten (i antallet sekunder som er konfigurert i Resynkroniseringsfeil Retry Delay) før den prøver å resynkronisere på nytt. Hvis Resynkroniseringsfeil Retry Delay er null, prøver ikke telefonen å resynkronisere etter et mislykket resynkroniseringsforsøk.

9

(Valgfritt) Sett verdien i feltet Resync Error Retry Delay til et lite tall, for eksempel 30.

 <Resync_Error_Retry_Delay>30Error_Retry_Delay> 
esync_
10

Deaktiver TFTP-serveren, og se resultatene i syslog-utdataene.

Tabellen nedenfor definerer funksjon og bruk av parametrene for resynkronisering av profiler i delen Konfigurasjonsprofil under fanen Tale > Klargjøring på telefonnettsiden. Den definerer også syntaksen til strengen som legges til i telefonkonfigurasjonsfilen (cfg.xml) med XML-kode for å konfigurere en parameter.

Tabell 1. Parametre for resynkronisering av profiler

Parameter

Beskrivelse

Klargjøring Aktiver

Tillater eller nekter resynkroniseringshandlinger for konfigurasjonsprofiler.

  • Skriv inn en streng i dette formatet i telefonkonfigurasjonsfilen (cfg.xml) med XML:

    <Provision_Aktiver ua="na">JaAktiver>rovision_
  • På telefonnettsiden angir du dette feltet til Ja for å tillate resynkroniseringshandlinger, eller Nei for å blokkere resynkroniseringshandlinger.

Standard: Ja

Resynkronisering ved tilbakestilling

Angir om telefonen resynkroniserer konfigurasjoner med klargjøringsserveren etter oppstart og etter hvert oppgraderingsforsøk.

  • Skriv inn en streng i dette formatet i telefonkonfigurasjonsfilen (cfg.xml) med XML:

    <Resync_On_Reset ua="na">JaOn_Reset>esync_
  • På telefonnettsiden angir du dette feltet til Ja for å tillate resynkronisering ved oppstart eller tilbakestilling, eller Nei for å blokkere resynkronisering ved oppstart eller tilbakestilling.

Standard: Ja

Resynkronisering tilfeldig forsinkelse

Hindrer overbelastning av klargjøringsserveren når et stort antall enheter slås på samtidig og prøver å konfigurere innledende enheter. Denne forsinkelsen trer bare i kraft ved det første konfigurasjonsforsøket, etter at enheten slås på eller tilbakestilles.

Parameteren er det maksimale tidsintervallet enheten venter før det blir kontakt med klargjøringsserveren. Den faktiske forsinkelsen er et pseudo-tilfeldig tall mellom 0 og denne verdien.

Denne parameteren er i enheter på 20 sekunder.

De gyldige verdiene varierer mellom 0 og 65535.

  • Skriv inn en streng i dette formatet i telefonkonfigurasjonsfilen (cfg.xml) med XML:

    <Resync_Random_Delay ua="na">2Random_Delay>esync_
  • På telefonens webgrensesnitt angir du antall enheter (20 sekunder) som telefonen skal bruke for å forsinke resynkroniseringen etter at den er slått på eller tilbakestilt.

Standardverdien er 2 (40 sekunder).

Resynkroniser ved (TTmm)

Tidspunktet (TTmm) da telefonen resynkroniserer med klargjøringsserveren.

Verdien i dette feltet må være et firesifret tall mellom 0000 og 2400 for å angi klokkeslettet i formatet TTmm. 0959 angir for eksempel 09:59.

  • Skriv inn en streng i dette formatet i telefonkonfigurasjonsfilen (cfg.xml) med XML:

    <Resync_At__HHmm_ ua="na">0959At__HHmm_>esync_
  • På telefonens webgrensesnitt angir du tidspunktet i HHMM-format for at telefonen skal starte resynkroniseringen.

Standardverdien er tom. Hvis verdien er ugyldig, ignoreres parameteren. Hvis denne parameteren angis med en gyldig verdi, ignoreres parameteren Resync Periodic.

Resynkronisering ved tilfeldig forsinkelse

Hindrer overbelastning av klargjøringsserveren når et stort antall enheter slås på samtidig.

For å unngå oversvømmelse av resynkroniseringsforespørsler til serveren fra flere telefoner, resynkroniserer telefonen mellom timer og minutter, og timer og minutter pluss den tilfeldige forsinkelsen (hhmm, hhmm+random_delay). Hvis for eksempel den tilfeldige forsinkelsen = (Resync At Random Delay + 30)/60 minutter, konverteres inndataverdien i sekunder til minutter og avrundes opp til neste minutt for å beregne det endelige random_delay intervallet.

  • Skriv inn en streng i dette formatet i telefonkonfigurasjonsfilen (cfg.xml) med XML:

    <Resync_At_Random_Delay ua="na">600At_Random_Delay>esync_
  • På telefonens webgrensesnitt angir du tidsperioden i sekunder.

De gyldige verdiene varierer mellom 600 og 65535.

Hvis verdien er mindre enn 600, er den tilfeldige forsinkelsen mellom 0 og 600.

Standardverdien er 600 sekunder (10 minutter).

Resynkronisering periodisk

Tidsintervallet mellom regelmessig resynkronisering med klargjøringsserveren. Den tilknyttede resynkroniseringstidtakeren er bare aktiv etter den første vellykkede synkroniseringen med serveren.

Gyldige formater er som følger:

  • Et heltall

    Eksempel: Inndata på 3000 indikerer at den neste resynkroniseringen finner sted om 3000 sekunder.

  • Flere heltall

    Eksempel: En inndata på 600 1200 300 indikerer at den første resynkroniseringen finner sted om 600 sekunder, den andre resynkroniseringen finner sted om 1200 sekunder etter den første, og den tredje resynkroniseringen finner sted om 300 sekunder etter den andre.

  • Et tidsintervall

    Eksempel: 2400+30 indikerer at neste resynkronisering finner sted mellom 2400 og 2430 sekunder etter en vellykket resynkronisering.

  • Skriv inn en streng i dette formatet i telefonkonfigurasjonsfilen (cfg.xml) med XML:

    <Resync_Periodic ua="na">3600Periodic>esync_
  • På telefonens webgrensesnitt angir du tidsperioden i sekunder.

Sett denne parameteren til null for å deaktivere periodisk resynkronisering.

Standardverdien er 3600 sekunder.

Resynkroniseringsfeil, forsinkelse av nytt forsøk

Hvis en resynkroniseringsoperasjon mislykkes fordi telefonen ikke kunne hente en profil fra serveren, eller fordi den nedlastede filen er skadet, eller det oppstår en intern feil, prøver telefonen å resynkronisere på nytt etter en tid som er angitt i sekunder.

Gyldige formater er som følger:

  • Et heltall

    Eksempel: Inndata på 300 indikerer at det neste forsøket på resynkronisering finner sted om 300 sekunder.

  • Flere heltall

    Eksempel: En inndata på 600 1200 300 indikerer at det første forsøket finner sted 600 sekunder etter feilen, det andre forsøket finner sted 1200 sekunder etter feilen av det første forsøket, og det tredje forsøket finner sted 300 sekunder etter feilen av det andre forsøket.

  • Et tidsintervall

    Eksempel: 2400+30 indikerer at det neste nye forsøket finner sted mellom 2400 og 2430 sekunder etter en resynkroniseringsfeil.

Hvis forsinkelsen er satt til 0, prøver ikke enheten å resynkronisere på nytt etter et mislykket resynkroniseringsforsøk.

  • Skriv inn en streng i dette formatet i telefonkonfigurasjonsfilen (cfg.xml) med XML:

    <Resync_Error_Retry_Delay ua="na">60,120,240,480,960,1920,3840,7680,15360,30720,61440,86400Error_Retry_Delay>esync_
  • På telefonens webgrensesnitt angir du tidsperioden i sekunder.

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

Tvungen resynkroniseringsforsinkelse

Maksimal forsinkelse (i sekunder) telefonen venter før den utfører en resynkronisering.

Enheten resynkroniserer ikke mens en av telefonlinjene er aktiv. Siden en resynkronisering kan ta flere sekunder, er det ønskelig å vente til enheten har vært inaktiv i en lengre periode før resynkroniseringen. Dette gjør det mulig for en bruker å foreta anrop etter hverandre uten avbrudd.

Enheten har en tidtaker som begynner å telle ned når alle linjene blir inaktive. Denne parameteren er den første verdien til telleren. Resynkroniseringshendelser utsettes til denne telleren reduseres til null.

De gyldige verdiene varierer mellom 0 og 65535.

  • Skriv inn en streng i dette formatet i telefonkonfigurasjonsfilen (cfg.xml) med XML:

    <Forced_Resync_Delay ua="na">14400Resync_Delay>orced_
  • På telefonens webgrensesnitt angir du tidsperioden i sekunder.

Standardverdien er 14 400 sekunder.

Resynkronisering fra SIP

Kontrollerer forespørsler om resynkroniseringsoperasjoner via en SIP-varslingshendelse som sendes fra tjenesteleverandørens proxy-server til telefonen. Hvis aktivert, kan proxyen be om resynkronisering ved å sende en SIP-varslingsmelding som inneholder hendelsen: resynkronisering av toppteksten til enheten.

  • Skriv inn en streng i dette formatet i telefonkonfigurasjonsfilen (cfg.xml) med XML:

    <Resync_From_SIP ua="na">JaFrom_SIP>esync_
  • På telefonnettsiden velger du Ja for å aktivere denne funksjonen, eller Nei for å deaktivere den.

Standard: Ja

Resynkronisering etter oppgraderingsforsøk

Aktiverer eller deaktiverer resynkronisering etter en oppgradering. Hvis Ja er valgt, utløses synkronisering etter en fastvareoppgradering.

  • Skriv inn en streng i dette formatet i telefonkonfigurasjonsfilen (cfg.xml) med XML:

    <Resync_After_Upgrade_Forsøk ua="na">JaAfter_Upgrade_Forsøk>esync_
  • På telefonnettsiden velger du Ja for å utløse resynkronisering etter en fastvareoppgradering, eller Nei for ikke å resynkronisere.

Standard: Ja

Resynkroniseringsutløser 1

Resynkroniseringsutløser 2

Hvis den logiske ligningen i disse parameterne evalueres til USANN, utløses ikke resynkronisering selv når Resync On Reset er satt til TRUE. Bare resynkroniseringen via URL-adressen for direktehandling og SIP-varselet ignorerer disse resynkroniseringsutløsningene.

Parameterne kan programmeres med et betingelsesuttrykk som gjennomgår makroutvidelse. For gyldige makroutvidelser, se Makroutvidelsesvariabler under Klargjøringsparametere.

  • Skriv inn en streng i dette formatet i telefonkonfigurasjonsfilen (cfg.xml) med XML:

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

    <Resync_Trigger_2 ua="na"/>

  • På telefonens nettside angir du utløsningene.

Standard: Blank

Brukerkonfigurerbar resynkronisering

Tillater at en bruker resynkroniserer telefonen fra telefonskjermmenyen. Når den er satt til Ja, kan en bruker resynkronisere telefonkonfigurasjonen ved å angi profilregelen fra telefonen. Når den er satt til Nei, vises ikke parameteren Profilregel på menyen på telefonskjermen.

  • Skriv inn en streng i dette formatet i telefonkonfigurasjonsfilen (cfg.xml) med XML:

    <User_Configurable_Resync ua="na">JaConfigurable_Resync>ser_

  • På telefonnettsiden velger du Ja for å vise parameteren Profilregel på telefonmenyen, eller velger Nei for å skjule denne parameteren.

Standard: Ja

Resynkronisering mislykkes på FNF

En resynkronisering anses vanligvis som mislykket hvis en forespurt profil ikke mottas fra serveren. Denne parameteren overstyrer denne atferden. Når enheten er satt til Nei, godtar den et fil-ikke-funnet svar fra serveren som en vellykket resynkronisering.

  • Skriv inn en streng i dette formatet i telefonkonfigurasjonsfilen (cfg.xml) med XML:

    <Resync_Fails_On_FNF ua="na">JaFails_On_FNF>esync_
  • På telefonnettsiden velger du Ja for å ta et fil-ikke-funnet -svar som en mislykket resynkronisering, eller velger Nei for å ta et fil-ikke-funnet -svar som en vellykket resynkronisering.

Standard: Ja

Type profilgodkjenning

Angir legitimasjonen som skal brukes til autentisering av profilkontoer. Følgende alternativer er tilgjengelige:

  • Deaktivert: Deaktiverer profilkontofunksjonen. Når denne funksjonen er deaktivert, vises ikke menyen Oppsett av profilkonto på telefonskjermen.

  • Grunnleggende HTTP-godkjenning: HTTP-påloggingsinformasjonen brukes til å godkjenne profilkontoen.

  • XSI-autentisering: XSI-påloggingsinformasjon eller XSI SIP-påloggingsinformasjon brukes til å godkjenne profilkontoen. Godkjenningslegitimasjonen avhenger av telefonens XSI-godkjenningstype :

    • Når XSI-godkjenningstype for telefonen er satt til Påloggingsinformasjon, brukes XSI-påloggingsinformasjonen.

    • Når XSI-godkjenningstype for telefonen er satt til SIP-legitimasjon, brukes XSI SIP-legitimasjonen.

  • Skriv inn en streng i dette formatet i telefonkonfigurasjonsfilen (cfg.xml) med XML:

    <Profile_Authentication_Type ua="na">Grunnleggende http-autentiseringAuthentication_Type>rofile_
  • På telefonens webgrensesnitt velger du et alternativ fra listen for at telefonen skal godkjenne resynkronisering av profiler.

Standard: Grunnleggende HTTP-godkjenning

Hvis du vil ha mer informasjon, kan du se Angi profilgodkjenningstype under Angi telefonen for resynkronisering av profiler.

Profilregel

Profilregel B

Profilregel C

Profilregel D

Hver profilregel informerer telefonen om en kilde som den kan hente en profil fra (konfigurasjonsfil). Ved hver resynkronisering tar telefonen i bruk alle profiler i rekkefølge.

Hvis du bruker AES-256-CBC-kryptering på konfigurasjonsfilene, angir du krypteringsnøkkelen med --key -nøkkelordet som følger:

[--nøkkel ]

Krypteringsnøkkelen kan eventuelt plasseres i doble anførselstegn (").

  • Skriv inn en streng i dette formatet i telefonkonfigurasjonsfilen (cfg.xml) med XML:

    <Profile_Rule ua="na">/$PSN.xmlRule>rofile_

    <Profile_Rule_B ua="na"/>

    <Profile_Rule_C ua="na"/>

    <Profile_Rule_D ua="na"/>

  • På telefonens nettside angir du profilregelen.

Standard: /$PSN.xml

Alternativ for bruk av DHCP

DHCP-alternativer, avgrenset med komma, brukes til å hente fastvare og profiler.

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

DHCPv6-opsjon for bruk

DHCP-alternativer, avgrenset med komma, brukes til å hente fastvare og profiler.

Standard: 17,160,159

Du kan klargjøre telefoner gjennom Cisco XML-funksjoner.

Du kan sende et XML-objekt til telefonen via en SIP-varslingspakke eller en HTTP Post til telefonens CGI-grensesnitt: http://PhoneIPAddress/CGI/Execute.

CP-xxxx-3PCC utvider Cisco XML-funksjonen til å støtte klargjøring via et XML-objekt:

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

Etter at telefonen har mottatt XML-objektet, laster den ned klargjøringsfilen fra [profile-rule]. Denne regelen bruker makroer til å forenkle utviklingen av programmet for XML-tjenester.

Underkataloger med flere profiler på serveren gir en praktisk metode for å administrere et stort antall distribuerte enheter. Profil-URL-adressen kan inneholde:

  • Et klargjøringsservernavn eller en eksplisitt IP-adresse. Hvis profilen identifiserer klargjøringsserveren etter navn, utfører telefonen et DNS-oppslag for å løse navnet.

  • En ikke-standard serverport som angis i URL-adressen ved hjelp av standardsyntaksen :port etter servernavnet.

  • Underkatalogen til serverens virtuelle rotkatalog der profilen er lagret, spesifisert ved hjelp av standard URL-notering og administrert ved makroutvidelse.

Følgende Profile_Regel ber for eksempel om profilfilen ($PN.cfg), i serverunderkatalogen /cisco/config, fra TFTP-serveren som kjører på verten prov.telco.com og lytter etter en tilkobling på port 6900:

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

En profil for hver telefon kan identifiseres i en generell parameter, med verdien referert i en felles profilregel ved hjelp av makroutvidelse.

Anta for eksempel at GPP_B er definert som Dj6Lmp23Q.

Profile_Regelen har verdien:

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

Når enheten resynkroniserer og makroene utvides, ber telefonen med en MAC-adresse på 000e08012345 om profilen med navnet som inneholder enhetens MAC-adresse på følgende URL:

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

Profilgodkjenning gjør det mulig for telefonbrukere å resynkronisere klargjøringsprofilen til telefonen. Godkjenningsinformasjon kreves mens telefonen prøver å resynkronisere og laste ned konfigurasjonsfilen for første gang og får en HTTP- eller HTTPS 401-godkjenningsfeil. Når du aktiverer denne funksjonen, vises skjermbildet Profilkontooppsett på telefonen i følgende situasjoner:

  • Når HTTP- eller HTTPs 401-godkjenningsfeilen oppstår under førstegangs klargjøring etter at telefonen har startet på nytt

  • Når brukernavnet og passordet for profilkontoen er tomt

  • Når det ikke er noe brukernavn og passord i profilregelen

Hvis skjermen Oppsett av profilkonto går glipp av eller ignoreres, kan brukeren også få tilgang til skjermen for oppsett via menyen på telefonskjermen, eller Oppsett -funksjonstasten, som bare vises når ingen linje på telefonen er registrert.

Når du deaktiverer funksjonen, vises ikke skjermbildet Profilkontooppsett på telefonen.

Brukernavnet og passordet i feltet Profilregel har høyere prioritet enn profilkontoen.

  • Når du oppgir riktig URL i Profilregel -feltet uten brukernavn og passord, krever telefonen godkjenning eller sammendrag for å resynkronisere profilen. Med riktig profilkonto passeres autentisering. Med feil profilkonto mislykkes autentiseringen.

  • Når du oppgir riktig URL i feltet Profilregel med riktig brukernavn og passord, krever telefonen godkjenning eller sammendrag for å resynkronisere profilen. Profilkontoen brukes ikke til resynkronisering av telefonen. Påloggingen var vellykket.

  • Når du oppgir riktig URL i feltet Profilregel med feil brukernavn og passord, krever telefonen godkjenning eller sammendrag for å resynkronisere profilen. Profilkontoen brukes ikke til resynkronisering av telefonen. Pålogging mislykkes alltid.

  • Når du oppgir feil URL i feltet Profilregel , mislykkes pålogging alltid.

Du kan også konfigurere parameterne i telefonkonfigurasjonsfilen med XML-kode (cfg.xml).

Du kan angi profilgodkjenningstypen fra telefonens administrasjonsnettside.

1

Gå inn på telefonens administrasjonsnettside.

2

Velg Tale > Klargjøring.

3

I delen Konfigurasjonsprofil angir du parameteren Profilautentiseringstype for å angi legitimasjonen som skal brukes for autentisering av profilkontoer.

Du kan konfigurere denne parameteren i XML-filen for telefonkonfigurasjon (cfg.xml) ved å skrive inn en streng i dette formatet:

<Profile_Authentication_Type ua="na">DeaktivertAuthentication_Type>
rofile_

Alternativer:

  • Deaktivert: Deaktiverer profilkontofunksjonen. Når denne funksjonen er deaktivert, vises ikke menyen Oppsett av profilkonto på telefonskjermen.

  • Grunnleggende HTTP-godkjenning: HTTP-påloggingsinformasjonen brukes til å godkjenne profilkontoen.

  • XSI-autentisering: XSI-påloggingsinformasjon eller XSI SIP-påloggingsinformasjon brukes til å godkjenne profilkontoen. Godkjenningslegitimasjonen avhenger av telefonens XSI-godkjenningstype:

    Når XSI-godkjenningstype for telefonen er satt til Påloggingsinformasjon, brukes XSI-påloggingsinformasjonen.

    Når XSI-godkjenningstype for telefonen er satt til SIP-legitimasjon, brukes XSI SIP-legitimasjonen.

Standard: Grunnleggende HTTP-godkjenning

4

Klikk på Send inn alle endringer.

Bruk en profil manuelt på telefonen

Fullfør disse trinnene for å laste ned konfigurasjonsfilen til et TFTP-serverprogram på datamaskinen din.

1

Koble datamaskinen til telefonens LAN-port.

2

Kjør et TFTP-serverprogram på datamaskinen, og kontroller at konfigurasjonsfilen er tilgjengelig i TFTP-rotkatalogen.

3

I en nettleser skriver du inn telefonens LAN-IP-adresse, datamaskinens IP-adresse, filnavnet og påloggingsinformasjonen. Bruk dette formatet:

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

Eksempel:

http://192.168.15.1/admin/resync?tftp://192.168.15.100/my_config.xml&xuser=admin&xpassword=admin

Fullfør disse trinnene for å laste ned konfigurasjonen til telefonen ved hjelp av cURL. Dette kommandolinjeverktøyet brukes til å overføre data med en URL-syntaks. For å laste ned cURL går du til:

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

Vi anbefaler at du ikke bruker cURL til å legge ut konfigurasjonen til telefonen, fordi brukernavnet og passordet kan bli registrert mens du bruker cURL.

1

Koble datamaskinen til telefonens LAN-port.

2

Last ned konfigurasjonsfilen til telefonen ved å skrive inn følgende cURL-kommando:

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

Profilkonfigurasjon

Telefonen godtar konfigurasjoner i XML-format.

Eksemplene i denne delen bruker konfigurasjonsprofiler med XML-syntaks.

Konfigurasjonsprofilen definerer parameterverdiene for telefonen.

XML-formatet for konfigurasjonsprofiler bruker standard XML-redigeringsverktøy til å kompilere parametere og verdier.

Bare UTF-8-tegnsettet støttes. Hvis du endrer profilen i et redigeringsprogram, må du ikke endre kodingsformatet, ellers gjenkjenner ikke telefonen filen.

Hver telefon har et annet funksjonssett og derfor et annet sett med parametere.

Åpent profilformat

Profilen i åpent format er en tekstfil med XML-lignende syntaks i et hierarki av elementer, med elementattributter og -verdier. Dette formatet lar deg bruke standardverktøy til å opprette konfigurasjonsfilen. En XML-konfigurasjonsfil kan sendes fra klargjøringsserveren til telefonen under en resynkroniseringsoperasjon, uten kompilering som et binært objekt.

Telefonen kan godta konfigurasjonsformater generert av standardverktøy. Denne funksjonen forenkler utviklingen av klargjøringsserverprogramvare som genererer konfigurasjonsprofiler fra eksisterende databaser.

Klargjøringsserveren leverer XML-konfigurasjonsfilen til telefonen via en TLS-sikret kanal for å beskytte konfidensiell informasjon i konfigurasjonsprofilen. Filen kan eventuelt komprimeres ved hjelp av deflate-algoritmen gzip (RFC1951).

Filen kan krypteres med en av disse krypteringsmetodene:

  • AES-256-CBC-kryptering

  • RFC-8188-basert kryptering av HTTP-innhold med AES-128-GCM-kryptering

En konfigurasjonsfil kan inneholde følgende komponenter:

  • Elementkoder

  • Attributter

  • Parametre

  • Formateringsfunksjoner

  • XML-kommentarer

Eksempel: Åpent profilformat

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

Elementkoden inneholder alle parameterelementer som telefonen gjenkjenner.

Egenskaper for elementkode

Husk følgende regler når du oppretter eller oppdaterer konfigurasjonsfilen.

  • XML klargjøringsformatet og nettbrukergrensesnittet tillater konfigurasjon av de samme innstillingene. XML-kodenavnene og feltnavnene i nettbrukergrensesnittet er like, men varierer på grunn av begrensninger i XML-elementnavn. For eksempel understreker ( _ ) i XML-konfigurasjonsfilen i stedet for mellomrom i nettgrensesnittet.

  • Telefonen gjenkjenner elementer med riktige parameternavn som er innkapslet i det spesielle elementet .

  • Elementnavn er omsluttet i hakeparenteser.

  • De fleste elementnavnene ligner på feltnavnene på telefonens nettgrensesnitt, med følgende endringer:

    • Elementnavn kan ikke inneholde mellomrom eller spesialtegn. Hvis du vil utlede elementnavnet fra nettfeltnavnet, erstatter du en understreking for hvert mellomrom eller spesialtegnene [, ], (, ), eller /.

      Eksempel: <Resync_On_Reset>-elementet representerer feltet Resync On Reset .

    • Hvert elementnavn må være unikt. I telefonens nettgrensesnitt kan de samme feltene vises på flere nettsider, for eksempel sidene Linje, Bruker og Internnummer. Legg til [n] i elementnavnet for å angi nummeret som vises i sidefanen.

      Eksempel:<Dial_Plan_1_> -elementet representerer ringeplanen for linje 1.

  • Hver åpningselement må ha en tilsvarende åpningselement. For eksempel:

      <Resync_On_Reset> Ja On_Reset> <Resync_Periodisk> 7200 Periodisk> <Profile_Rule>tftp://prov.telco.com:esync_esync_ 6900/cisco/config/CP_xxxx_MPP.cfg Rule>  
    rofile_
  • Elementmerker skiller mellom store og små bokstaver.

  • Tomme elementkoder er tillatt og vil bli tolket som å konfigurere verdien til å være tom. Sett inn åpningselementkoden uten tilsvarende elementkode, og sett inn et mellomrom og en skråstrek før lukkeholderen (>). I dette eksemplet er profilregel B tom:

     <Profile_Rule_B /> 
  • En tom elementkode kan brukes for å hindre overskriving av brukeroppgitte verdier under en resynkroniseringsoperasjon. I eksemplet nedenfor er brukerens kortnummerinnstillinger uendret:

    <flatprofil> <Speed_dial_2_Navn ua="rw"/> <Speed_dial_2_Nummer ua="rw"/> <Speed_dial_3_Navn ua="rw"/> <Speed_dial_3_Nummer ua="rw"/> <Speed_dial_4_Navn ua="rw"/> <Speed_dial_4_Nummer ua="rw"/> <Speed_dial_5_Navn ua="rw"/> <Speed_dial_5_Nummer ua="rw"/> <Speed_dial_6_Navn ua="rw"/> <Speed_dial_6_Nummer ua="rw"/> <Speed_dial_7_Navn ua="rw"/> <Speed_dial_7_Nummer ua="rw"/> <Speed_dial_8_Navn ua="rw"/> <Speed_dial_8_Nummer ua="rw"/> <Speed_dial_9_Navn ua="rw"/> <Speed_dial_9_Nummer ua="rw"/> </flat-profile> 
  • Bruk en tom verdi for å sette den tilsvarende parameteren til en tom streng. Angi et åpnings- og lukkingselement uten at det er noen verdi mellom dem. I eksemplet nedenfor er parameteren GPP_A satt til en tom streng.

     <flat-profile> <GPP_A>   A> </flat-profile> 
    _
  • Elementnavn som ikke gjenkjennes, ignoreres.

Parameteregenskaper

Disse egenskapene gjelder for parameterne:

  • Parametere som ikke angis av en profil, forblir uendret i telefonen.

  • Parametre som ikke gjenkjennes, ignoreres.

  • Hvis profilen i åpent format inneholder flere forekomster av samme parameterkode, overstyrer den siste forekomsten alle tidligere forekomster. For å unngå utilsiktet overstyring av konfigurasjonsverdier for en parameter, anbefaler vi at hver profil angir maksimalt én forekomst av en parameter.

  • Den siste profilen som er behandlet, har forrang. Hvis flere profiler angir den samme konfigurasjonsparameteren, får verdien til den sistnevnte profilen forrang.

Strengformater

Disse egenskapene gjelder formatering av strengene:

  • Kommentarer er tillatt via standard XML-syntaks.

  • Innledende og etterfølgende mellomrom er tillatt for lesbarhet, men fjernes fra parameterverdien.

  • Nye linjer innenfor en verdi konverteres til mellomrom.

  • Et XML-hode av skjemaet <? ?> er tillatt, men telefonen ignorerer det.

  • Hvis du vil angi spesialtegn, bruker du grunnleggende XML-tegn som vist i tabellen nedenfor.

    Spesialtegn

    XML-escape-sekvens

    & (ampersand)

    &

    < (mindre enn)

    <

    > (større enn)

    >

    (apostrof)

    '

    ” (dobbelt anførselstegn)

    "

    I eksemplet nedenfor angis tegn for å representere større enn og mindre enn symboler som kreves i en oppringingsplanregel. Dette eksemplet definerer en hotline-ringeplan for informasjon som angir parameteren <Dial_Plan_1_> (Administratorpålogging > avansert > Tale > Internnummer (n)) lik (S0 ).

     <flat-profile> <Dial_Plan_1_> (S0 ) Plan_1_> </flat-profile>
    ial_
  • Numeriske escapement ved hjelp av desimale og heksadesimale verdier (s.a. ( og .), oversettes.

  • Telefonens fastvare støtter bare ASCII-tegn.

Den åpne konfigurasjonsprofilen kan komprimeres for å redusere nettverksbelastningen på klargjøringsserveren. Profilen kan også krypteres for å beskytte konfidensiell informasjon. Komprimering er ikke nødvendig, men må skje før kryptering.

Komprimering av åpen profil

Den støttede komprimeringsmetoden er gzip-deflate-algoritmen (RFC1951). Gzip-verktøyet og komprimeringsbiblioteket som implementerer den samme algoritmen (zlib) er tilgjengelige fra Internett-nettsteder.

For å identifisere komprimering forventer telefonen at den komprimerte filen inneholder et gzip-kompatibelt topptekst. Bruk av gzip-verktøyet på den opprinnelige åpne profilen genererer toppteksten. Telefonen undersøker det nedlastede filhodet for å bestemme filformatet.

Hvis profile.xml for eksempel er en gyldig profil, godtas filen profile.xml.gz også. Én av følgende kommandoer kan generere denne profiltypen:

  • >gzip profile.xml

    Erstatter den opprinnelige filen med en komprimert fil.

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

    Lar den opprinnelige filen være på plass og produserer en ny komprimert fil.

Kryptering av åpne profiler

Symmetrisk nøkkelkryptering kan brukes til å kryptere en åpen konfigurasjonsprofil, uansett om filen er komprimert eller ikke. Komprimering må brukes før kryptering, hvis den brukes.

Klargjøringsserveren bruker HTTPS til å håndtere den første klargjøringen av telefonen etter distribusjon. Frakoblet forhåndskryptering av konfigurasjonsprofiler gjør det mulig å bruke HTTP til resynkronisering av profiler. Dette reduserer belastningen på HTTPS-serveren ved store distribusjoner.

Telefonen støtter to krypteringsmetoder for konfigurasjonsfiler:

  • AES-256-CBC-kryptering

  • RFC 8188-basert kryptering av HTTP-innhold med AES-128-GCM-kryptering

Nøkkelen eller nøkkelmaterialet (IKM) må være forhåndsklargjort på enheten. Oppstart av den hemmelige nøkkelen kan gjøres sikkert ved hjelp av HTTPS.

Navnet på konfigurasjonsfilen krever ikke et bestemt format, men et filnavn som slutter med .cfg -filtypen angir vanligvis en konfigurasjonsprofil.

AES-256-CBC-kryptering

Telefonen støtter AES-256-CBC-kryptering for konfigurasjonsfiler.

OpenSSL-krypteringsverktøyet, som er tilgjengelig for nedlasting fra forskjellige Internett-nettsteder, kan utføre krypteringen. Støtte for 256-biters AES-kryptering kan kreve omkompilering av verktøyet for å aktivere AES-koden. Fastvaren er testet mot versjon openssl-1.1.1d.

Når det gjelder en kryptert fil, forventer profilen at filen har samme format som generert av følgende kommando:

 # eksempel krypteringsnøkkel = SecretPhrase ⦅_bpt_16⦆ openssl enc –e –aes-256-cbc –k SecretPhrase ⦅_bpt_16⦆ –in profile.xml –out profile.cfg # analog påkalling for en komprimert xml-fil openssl enc –e –aes-256-cbc –k SecretPhrase ⦅_bpt_16⦆ –in profile.xml.gz –out profile.cfg 

En liten -k går foran den hemmelige nøkkelen, som kan være en hvilken som helst frase i ren tekst, og som brukes til å generere et tilfeldig 64-biters salt. Med hemmeligheten angitt av argumentet -k, henter krypteringsverktøyet en tilfeldig 128-biters initial vektor og den faktiske 256-biters krypteringsnøkkelen.

Når denne formen for kryptering brukes på en konfigurasjonsprofil, må telefonen informeres om den hemmelige nøkkelverdien for å dekryptere filen. Denne verdien angis som en kvalifikator i profil-URL-adressen. Syntaksen er som følger, ved bruk av en eksplisitt URL:

 [--nøkkelen «SecretPhrase114»] http://prov.telco.com/path/profile.cfg 

Denne verdien programmeres ved hjelp av en av Profile_Rule -parametrene.

Makroutvidelse

Flere klargjøringsparametre gjennomgår makroutvidelse internt før de blir evaluert. Dette forhåndsevalueringstrinnet gir større fleksibilitet ved å kontrollere resynkroniserings- og oppgraderingsaktiviteter på telefonen.

Disse parametergruppene gjennomgår makroutvidelse før evaluering:

  • Resync_Trigger_*

  • Profile_Regel*

  • Log_xxx_Msg

  • Upgrade_regel

Under visse forhold gjennomgår noen generelle parametre (GPP_*) også makroutvidelse, som eksplisitt angitt i delen Valgfrie resynkroniseringsargumenter nedenfor.

Under makroutvidelse erstatter innholdet i de navngitte variablene uttrykk i skjemaet $NAME og $(NAME). Disse variablene inkluderer generelle parametre, flere produkt-identifikatorer, visse hendelsestidtakere og klargjøringstilstandsverdier. Hvis du vil ha en fullstendig liste, kan du se Makroutvidelsesvariabler under Klargjøringsparametere.

I eksemplet nedenfor brukes uttrykket $(MAU) til å sette inn MAC-adressen 000E08012345.

Administratoren skriver inn: $(MAU)config.cfg

Den resulterende makroutvidelsen for en enhet med MAC-adresse 000E08012345 er: 000E08012345config.cfg

Hvis et makronavn ikke gjenkjennes, forblir det uutvidet. For eksempel gjenkjennes ikke navnet STRANGE som et gyldig makronavn, mens MAU gjenkjennes som et gyldig makronavn.

Administratoren skriver: $STRANGE$MAU.cfg

Den resulterende makroutvidelsen for en enhet med MAC-adresse 000E08012345 er: $STRANGE114E08012345.cfg

Makroutvidelse brukes ikke rekursivt. For eksempel utvides $$MAU” til $$MAU” ($$ utvides), og resulterer ikke i MAC-adressen.

Innholdet i spesialparametrene, GPP_SA til GPP_SD, tilordnes til makrouttrykkene $SA til $SD. Disse parameterne makroutvides bare som argument for alternativene --key , --uid og --pwd i en resynkroniserings-URL-adresse.

Betingelsesuttrykk

Betingelsesuttrykk kan utløse resynkroniseringshendelser og velge blant alternative URL-adresser for resynkroniserings- og oppgraderingsoperasjoner.

Betingelsesuttrykk består av en liste over sammenligninger, atskilt av og operatør. Alle sammenligninger må oppfylles for at betingelsen skal være sann.

Hver sammenligning kan relateres til én av følgende tre typer litteraler:

  • Heltallsverdier

  • versjonsnumre for programvare eller maskinvare

  • Strenger med doble anførselstegn

Versjonsnumre

Programvareversjonen for Cisco Video Phone 8875 bruker dette formatet (der BN er byggnummeret):

PHONEOSåååå.1-0-1-0001-BN

der åååå angir telefonmodellen eller -serien; 1 er hovedversjonen; 0 er den mindre versjonen; 1-0001 er mikroversjonen; og BN er byggenummeret.

Sammenligningsstrengen må bruke samme format. Ellers vil det oppstå en formatanalysefeil.

Når man sammenligner programvareversjonen, sammenlignes hovedversjonen, mindre versjonen og mikroversjonen i rekkefølge, og sifrene lengst til venstre har forrang frem for de siste. Når versjonsnumrene er identiske, sammenlignes versjonsnummeret.

Eksempler på gyldig versjonsnummer

phoneos-8875.1-0-1-0001-19

Sammenligning

Sitatstrenger kan sammenlignes for likestilling eller ulikhet. Heltall og versjonsnumre kan også sammenlignes aritmetisk. Sammenligningsoperatorene kan uttrykkes som symboler eller akronymer. Akronymer er praktiske for å uttrykke betingelsen i en profil i åpent format.

Operatør

Alternativ syntaks

Beskrivelse

Gjelder for heltall og versjonsoperander

Gjelder for serieoperander med anførselstegn

=

eq

tilsvarer

Ja

Ja

!=

til

ikke lik

Ja

Ja

<

lt

mindre enn

Ja

Nei

<=

til

mindre enn eller lik

Ja

Nei

>

gt

større enn

Ja

Nei

>=

til

større enn eller lik

Ja

Nei

og

og

Ja

Ja

Det er viktig å inkludere makrovariabler i doble anførselstegn der en strenglitteral forventes. Ikke gjør det der det forventes et nummer eller versjonsnummer.

Når de brukes i forbindelse med parametrene Profile_Rule* og Upgrade_-regel, må betingelsesuttrykk inneholdes i syntaksen «(expr)?» som i dette eksemplet med oppgraderingsregel. Husk å erstatte BN med byggnummeret til fastvareinnlastingen du vil oppgradere til.

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

Ikke bruk den foregående syntaksen med parenteser til å konfigurere Resync_Trigger_*-parametrene.

URL-syntaks

Bruk standard URL-syntaksen til å angi hvordan konfigurasjonsfiler og fastvarebelastninger skal hentes i parametrene for henholdsvis Profile_Rule* og Upgrade_-regel. Syntaksen er som følger:

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

Der skjemaet er en av disse verdiene:

  • tftp

  • http

  • https

Hvis oppsett utelates, antas tftp. Serveren kan være et DNS-gjenkjennelig vertsnavn eller en numerisk IP-adresse. Porten er destinasjonens UDP- eller TCP-portnummer. Filbanen må begynne med rotkatalogen (/); det må være en absolutt bane.

Hvis serveren mangler, brukes tftp-serveren spesifisert gjennom DHCP (alternativ 66).

For oppgraderingsregler må serveren angis.

Hvis port mangler, brukes standardporten for det angitte skjemaet. Tftp bruker UDP-port 69, http bruker TCP-port 80, https bruker TCP-port 443.

Det må finnes en filbane. Den trenger ikke nødvendigvis referere til en statisk fil, men kan indikere dynamisk innhold som er hentet gjennom CGI.

Makroutvidelse gjelder i URL-adresser. Følgende er eksempler på gyldige URL-adresser:

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

Når du bruker DHCP-alternativ 66, støttes ikke tom syntaks av oppgraderingsregler. Den gjelder bare for Profile Rule*.

RFC 8188-basert kryptering av HTTP-innhold

Telefonen støtter RFC 8188-basert kryptering av HTTP-innhold med AES-128-GCM-kryptering for konfigurasjonsfiler. Med denne krypteringsmetoden kan alle enheter lese HTTP-meldingshodene. Men bare enhetene som kjenner til nøkkelmaterialet (IKM), kan lese nyttelasten. Når telefonen klargjøres med IKM, kan telefonen og klargjøringsserveren utveksle konfigurasjonsfiler på en sikker måte, samtidig som tredjeparts nettverkselementer kan bruke meldingshodene til analyse og overvåking.

XML-konfigurasjonsparameteren IKM_HTTP_Encrypt_Content holder IKM på telefonen. Av sikkerhetsgrunner er ikke denne parameteren tilgjengelig på telefonens administrasjonsnettside. Den er heller ikke synlig i telefonens konfigurasjonsfil, som du får tilgang til fra telefonens IP-adresse eller fra telefonens konfigurasjonsrapporter som sendes til klargjøringsserveren.

Hvis du vil bruke RFC 8188-basert kryptering, må du sørge for følgende:

  • Klargjør telefonen med IKM ved å angi IKM med XML-parameteren IKM_HTTP_Encrypt_Content i konfigurasjonsfilen som sendes fra klargjøringsserveren til telefonen.

  • Hvis denne krypteringen brukes på konfigurasjonsfilene som sendes fra klargjøringsserveren til telefonen, må du kontrollere at Content-Encoding HTTP-toppteksten i konfigurasjonsfilen har aes114gcm.

    I fravær av dette toppteksten får AES-256-CBC-metoden forrang. Telefonen bruker AES-256-CBC-dekryptering hvis det finnes en AES-256-CBC-nøkkel i en profilregel, uavhengig av IKM.

  • Hvis du vil at telefonen skal bruke denne krypteringen på konfigurasjonsrapportene den sender til klargjøringsserveren, må du kontrollere at det ikke er angitt en AES-256-CBC-nøkkel i rapportregelen.

Valgfrie resynkroniseringsargumenter

Valgfrie argumenter, key, uid og pwd, kan gå foran URL-adressene som angis i Profile_Rule* -parametrene, samlet omsluttet av hakeparenteser.

nøkkel

Alternativet --key forteller telefonen at konfigurasjonsfilen som den mottar fra klargjøringsserveren, er kryptert med AES-256-CBC-kryptering, med mindre toppteksten Content-Encoding i filen angir aes114gcm -kryptering. Selve nøkkelen angis som en streng etter ordet --key. Nøkkelen kan eventuelt settes inn i doble anførselstegn ("). Telefonen bruker nøkkelen til å dekryptere konfigurasjonsfilen.

Brukseksempler
 [--key VerySecretValue] [--key “min hemmelige frase”] [--key a37d2fb9055c1d04883a0745eb0917a4] 

Valgfrie argumenter i parentes er makroutvidet. Spesialparametere, GPP_SA til GPP_SD, makroutvides til makrovariabler, fra $SA til $SD, bare når de brukes som nøkkelalternativargumenter. Se disse eksemplene:

[--nøkkel $SC] [--nøkkel “$SD”] 

I profiler i åpent format må argumentet til --key være det samme som argumentet til alternativet -k som gis til openssl.

uid og pwd

Alternativene uid og pwd kan brukes til å angi bruker-ID og passord som skal sendes som svar på HTTP Basic- og Digest-godkjenningsutfordringer når den angitte URL-adressen blir bedt om. Valgfrie argumenter i parentes er makroutvidet. Spesialparametere, GPP_SA til GPP_SD, makroutvides til makrovariabler, fra $SA til $SD, bare når de brukes som nøkkelalternativargumenter. Se disse eksemplene:

GPP_SA = MyUserID GPP_SB = MySecretPassword 

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

utvides til:

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

Disse datatypene brukes med konfigurasjonsprofilparametere:

  • {a,b,c,…} – Et valg mellom a, b, c, …

  • Bool – boolsk verdi av enten "ja" eller "nei".

  • CadScript – Et miniscript som angir frekvensparametrene for et signal. Opptil 127 tegn.

    Syntaks: S1[;S2], der:

    • 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]]]]) og er kjent som en seksjon.

    • i,j og avi,j er på/av-varigheten i sekunder av et segment. i = 1 eller 2, og j = 1 til 6.

    • Di er den totale varigheten av delen i sekunder.

    Alle varigheter kan ha opptil tre desimalplasser for å gi 1 ms oppløsning. Jokertegnet "*" står for ubegrenset varighet. Segmentene i en seksjon spilles i rekkefølge og gjentas til den totale varigheten spilles.

    Eksempel 1:

     60 (2/4) Antall frekvensavdelinger = 1 frekvensavdeling 1: Seksjonslengde = 60 s Antall segmenter = 1 segment 1: På=2 s, Av=4 s Total ringlengde = 60 s 

    Eksempel 2 – Karakteristisk ring (kort, kort, kort, lang):

     60(.2/.2,.2/.2,.2/.2,1/4) Antall frekvensavdelinger = 1 frekvensavdeling 1: Seksjonslengde = 60 s Antall segmenter = 4 segment 1: På=0,2 s, Av=0,2 s Segment 2: På=0,2 s, Av=0,2 s Segment 3: På=0,2 s, Av=0,2 s Segment 4: På=1,0 sek, AV=4,0 sek, total ringlengde = 60 sek 
  • DialPlanScript – skriptsyntaks som brukes til å angi oppringingsplaner for linje 1 og linje 2.

  • Flyte – En flytende punktverdi med opptil n desimalplasser.

  • FQDN – fullt kvalifisert domenenavn. Kan inneholde opptil 63 tegn. Eksempler er som følger:

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

    • sip.Cisco.com eller 109.12.14.12

  • FreqScript – Et miniscript som angir frekvens- og nivåparametere for en tone. Inneholder opptil 127 tegn.

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

    • F1–F6 er frekvens i Hz (bare usignerte heltall).

    • L1–L6 er tilsvarende nivåer i dBm (med opptil én desimalplass).

    Mellomrom før og etter kommaet er tillatt, men anbefales ikke.

    Eksempel 1 – Samtale venter-tone:

     440@-10 Antall frekvenser = 1 Frekvens 1 = 440 Hz ved –10 dBm 

    Eksempel 2 – summetone:

     350@-19,440@-19 Antall frekvenser = 2 Frekvens 1 = 350 Hz ved –19 dBm Frekvens 2 = 440 Hz ved –19 dBm 
  • IP – Gyldig IPv4-adresse i form av x.x.x.x, hvor x er mellom 0 og 255. Eksempel: 10.1.2.100.

  • UserID – bruker-ID slik den vises i en URL-adresse; opptil 63 tegn.

  • Telefon – En telefonnummerstreng, for eksempel 14081234567, *69, *72, 345678; eller en generell URL, for eksempel 1234@10.10.10.100:5068 eller jsmith@Cisco.com. Strengen kan inneholde opptil 39 tegn.

  • PhTmplt – En telefonnummermal. Hver mal kan inneholde ett eller flere mønstre som er atskilt med komma (,). Mellomrom i begynnelsen av hvert mønster ignoreres. "?" og "*" representerer jokertegn. For å representere bokstavelig talt, bruk %xx. For example, %2a representerer *. Malen kan inneholde opptil 39 tegn. Eksempler: «1408*, 1510*», «1408123????, 555?1.».

  • Port – TCP/UDP-portnummer (0-65535). Kan angis i desimalformat eller heksadesimal format.

  • ProvisioningRuleSyntax – skriptsyntaks som brukes til å definere regler for resynkronisering av konfigurasjon og oppgradering av fastvare.

  • PwrLevel – Effektnivå uttrykt i dBm med ett desimalsted, for eksempel –13,5 eller 1,5 (dBm).

  • RscTmplt – En mal for SIP-svarstatuskode, for eksempel "404, 5*", "61?", "407, 408, 487, 481". Kan inneholde opptil 39 tegn.

  • Sig – Signert n-bit-verdi. Kan angis i desimalformat eller heksadesimal format. Et "-"-tegn må være foran negative verdier. Et +-tegn før positive verdier er valgfritt.

  • Stjernekoder – aktiveringskode for en tilleggstjeneste, for eksempel *69. Koden kan inneholde opptil 7 tegn.

  • Str – En generisk streng med opptil n ikke-reserverte tegn.

  • Tid – Tidsvarighet i sekunder, med opptil n desimalplasser. Ekstra spesifiserte desimalplasser ignoreres.

  • ToneScript – Et miniscript som angir frekvens-, nivå- og kadensparametrene for en samtale fremdriftstone. Skript kan inneholde opptil 127 tegn.

    Syntaks: FreqScript;Z1[;Z2].

    Seksjonen Z1 ligner seksjonen S1 i et CadScript, bortsett fra at hvert på/av-segment etterfølges av en frekvenskomponentparameter: 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]]]]]) der:

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

    • 1 < nk < 6 angir frekvenskomponentene i FreqScript som brukes i det segmentet.

    Hvis det brukes mer enn én frekvenskomponent i et segment, summeres komponentene sammen.

    Eksempel 1 – Summetone:

     350@-19,440@-19;10(*/0/1+2) Antall frekvenser = 2 Frekvens 1 = 350 Hz ved –19 dBm Frekvens 2 = 440 Hz ved –19 dBm Antall frekvens seksjoner = 1 frekvens seksjon 1: Seksjonslengde = 10 s Antall segmenter = 1 segment 1: På=for alltid, med frekvens 1 og 2 Total tonelengde = 10 s 

    Eksempel 2 – Oppstykket tone:

     350@-19,440@-19;2(.1/.1/1+2);10(*/0/1+2) Antall frekvenser = 2 Frekvens 1 = 350 Hz ved –19 dBm Frekvens 2 = 440 Hz ved –19 dBm Antall frekvenser = 2 Frekvens avsnitt 1: Seksjonslengde = 2s Antall segmenter = 1 segment 1: On=0,1 s, Off=0,1 s med frekvens 1 og 2 Frekvens avsnitt 2: Seksjonslengde = 10 s Antall segmenter = 1 segment 1: På=for alltid, med frekvens 1 og 2 Total tonelengde = 12 s 
  • Uns – Usignert n-bit-verdi, hvor n = 8, 16 eller 32. Den kan angis i desimalformat eller heksadesimal format, for eksempel 12 eller 0x18, så lenge verdien kan passe inn i n biter.

Ta hensyn til disse:

  • representerer et konfigurasjonsparameternavn. I en profil dannes den tilsvarende koden ved å erstatte mellomrommet med en understreking «_», for eksempel Par_Name.
  • Et tomt standardverdifelt innebærer en tom streng < “” >.
  • Telefonen fortsetter å bruke de siste konfigurerte verdiene for koder som ikke finnes i en gitt profil.
  • Maler sammenlignes i den angitte rekkefølgen. Den første, ikke den nærmeste, treff velges. Parameternavnet må samsvare nøyaktig.
  • Hvis det gis mer enn én definisjon for en parameter i en profil, er den siste definisjonen i filen den som trer i kraft i telefonen.
  • En parameterspesifikasjon med en tom parameterverdi tvinger parameteren tilbake til standardverdien. Hvis du vil angi en tom streng i stedet, bruker du den tomme strengen "" som parameterverdi.