Konfigurer din telefon til profilgensynkronisering

Synkroniser telefonprofilen igen via TFTP

Telefonen understøtter flere netværksprotokoller til hentning af konfigurationsprofiler. Den mest grundlæggende profiloverførselsprotokol er TFTP (RFC1350). TFTP bruges i vid udstrækning til klargøring af netværksenheder inden for private LAN-netværk. Selvom det ikke anbefales til installation af eksterne slutpunkter på tværs af internettet, kan TFTP være praktisk til installation i små organisationer, til forhåndsklargøring internt og til udvikling og test. I følgende procedure ændres en profil, efter at en fil er downloadet fra en TFTP-server.

1

I et LAN-miljø skal du tilslutte din computer og telefon til en hub, switch eller lille router.

2

Installer og aktivér en TFTP-server på computeren.

3

Brug et tekstredigeringsprogram til at oprette en konfigurationsprofil.

For at kontrollere, om profilen er blevet klargjort til din telefon senere, kan du indstille nogle af værdierne som mærker. Indstil f.eks. værdien for GPP_A til 12345678 som vist i følgende eksempel:
 <flat-profile>   <GPP_A> 12345678   A> </flat-profile>
_
4

Gem XML-konfigurationsfilen i rodmappen på TFTP-serveren.

Du kan bekræfte, at TFTP-serveren er konfigureret korrekt: anmod om konfigurationsprofilfilen ved at bruge en anden TFTP-klient end telefonen. Brug helst en TFTP-klient, der kører på en separat vært fra klargøringsserveren.

5

Åbn administrationswebsiden i webbrowseren på din computer. Hvis du f.eks. antager, at telefonens IP-adresse er 192.168.1.100, skal du åbne følgende URL-adresse i din webbrowser:


http://192.168.1.100/admin/advanced
6

Vælg fanen Stemme > Klargøring , og kontrollér værdierne for parametrene for generelle formål GPP_A til og med GPP_P. Disse skal være tomme.

7

Gensynkroniser testtelefonen til den konfigurationsprofil, du har oprettet ved at åbne URL-adressen til gensynkronisering i en webbrowser.

Eksempel:

Hvis IP-adressen på TFTP-serveren er 192.168.1.200, skal kommandoen svare til følgende eksempel:


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

Når telefonen modtager denne kommando, anmoder enheden på adressen 192.168.1.100 om konfigurationsprofilfilen basic.txt fra TFTP-serveren på IP-adresse 192.168.1.200. Telefonen parser derefter den downloadede fil og opdaterer parameteren GPP_A med værdien 12345678.

8

Bekræft, at parameteren blev opdateret korrekt. Genindlæs administrationswebsiden, og gå til Stemme > Klargøring.

GPP_A-parameteren skal nu indeholde værdien 12345678.

Klargør en telefonspecifik profil på en TFTP-server
1

Få telefonens MAC-adresse fra produktets etiket. (MAC-adressen er nummeret ved hjælp af tal og hexcifre med små bogstaver, f.eks. 000e08aabbcc.

2

Omdøb din konfigurationsfil til CP-xxxx macaddress.cfg (erstat xxxx med modelnummeret og macaddress med telefonens MAC-adresse).

Eksempel:

CP-8875 000e08aabbcc.cfg

3

Flyt den nye fil til den virtuelle rodmappe på TFTP-serveren.

4

Gå til telefonens administrationswebside.

5

Vælg Stemme  > Klargøring.

6

Indtast stien til profilfilen i feltet Profilregel .

Eksempel: Antag, at TFTP-serverens IP-adresse er 192.168.1.200, og profilfilnavnet er 

 <Profile_Regel> tftp://192.168.1.200/CP-8875$MA.cfg Regel>
rofile_
7

Klik på Indsend alle ændringer. Dette medfører en øjeblikkelig genstart og gensynkronisering.

Når den næste gensynkronisering sker, henter telefonen den nye fil ved at udvide $MA-makroudtrykket til dens MAC-adresse.

Synkroniser telefonprofilen igen med HTTP GET
1

Installer en HTTP-server på den lokale computer eller en anden tilgængelig vært.

Apache-serveren, der er open source, kan downloades fra internettet.

2

Overfør konfigurationsprofilfilen til den virtuelle rodmappe på den installerede server.

3

Hvis du vil kontrollere korrekt serverinstallation og få adgang til profilfilen, skal du åbne profilen med en webbrowser.

4

Rediger testtelefonens Profile_-regel for at pege på HTTP-serveren i stedet for TFTP-serveren, så dens profil downloades regelmæssigt.

Hvis du f.eks. antager, at HTTP-serveren er 192.168.1.300, og profilfilnavnet er basic.txt, skal du angive følgende værdi:

<Profile_regel> http://192.168.1.200/basic.txt regel>
rofile_
5

Klik på Indsend alle ændringer. Dette medfører en øjeblikkelig genstart og gensynkronisering.

6

Se de syslog-meddelelser, som telefonen sender. De periodiske gensynkroniseringer skal nu hente profilen fra HTTP-serveren.

7

I HTTP-serverlogfilerne skal du se, hvordan oplysninger, der identificerer testtelefonen, vises i loggen for brugeragenter.

Disse oplysninger skal omfatte producenten, produktnavnet, den aktuelle firmwareversion og serienummeret.

Synkroniser telefonprofilen automatisk igen

En enhed kan periodisk gensynkronisere med klargøringsserveren for at sikre, at eventuelle profilændringer, der er foretaget på serveren, overføres til slutpunktsenheden (i modsætning til at sende en eksplicit anmodning om gensynkronisering til slutpunktet).

For at få telefonen til periodisk at gensynkronisere med en server defineres en konfigurationsprofil-URL ved hjælp af parameteren Profile_-regel, og en gensynkroniseringsperiode defineres ved hjælp af parameteren Resync_periodisk.

1

Gå til telefonens administrationswebside.

2

Vælg Stemme  > Klargøring.

3

Definer parameteren Profile_-regel. Dette eksempel antager en IP-adresse på TFTP-server på 192.168.1.200.

4

I feltet Gensynkroniser periodisk skal du indtaste en lille værdi for test, såsom 30 sekunder.

5

Klik på Indsend alle ændringer.

Med de nye parameterindstillinger gensynkroniserer telefonen to gange i minuttet til den konfigurationsfil, som URL-adressen angiver.

6

Se de resulterende meddelelser i syslog-sporet.

7

Sørg for, at feltet Gensynkroniser ved nulstilling er indstillet til Ja.

 <Resync_On_Reset>JaOn_Reset>
esync_
8

Tænd og sluk telefonen for at tvinge den til at gensynkronisere med klargøringsserveren.

Hvis gensynkroniseringshandlingen af en eller anden grund mislykkes, f.eks. hvis serveren ikke svarer, venter enheden (i det antal sekunder, der er konfigureret i Forsinkelse ved forsøg på gensynkroniseringsfejl), før den forsøger at synkronisere igen. Hvis Forsinkelse ved nyt forsøg på gensynkroniseringsfejl er nul, forsøger telefonen ikke at gensynkronisere efter et mislykket forsøg på gensynkronisering.

9

(Valgfri) Indstil værdien af feltet Forsinkelse ved nyt forsøg på gensynkronisering af fejl til et lille tal, såsom 30.

 <Resync_Error_Retry_Delay>30Error_Retry_Delay>
esync_
10

Deaktiver TFTP-serveren, og se resultaterne i syslog-output.

Parametre for gensynkronisering af profil

Følgende tabel definerer funktionen og brugen af parametre for gensynkronisering af profiler i afsnittet Konfigurationsprofil under fanen Stemme > Klargøring på telefonens webside. Den definerer også syntaksen for den streng, der tilføjes i telefonkonfigurationsfilen (cfg.xml) med XML-kode for at konfigurere en parameter.

Tabel 1. Parametre for gensynkronisering af profil

Parameter

Beskrivelse

Klargøring og aktivér

Tillader eller afviser gensynkroniseringshandlinger for konfigurationsprofil.

  • I telefonkonfigurationsfilen (cfg.xml) med XML skal du indtaste en streng i dette format:

    <Provision_Aktiver ua="na">JaAktiver>rovision_

  • På telefonens webside skal du indstille dette felt til Ja for at tillade gensynkroniseringshandlinger eller Nej for at blokere gensynkroniseringshandlinger.

Standard: Ja

Synkroniser igen ved nulstilling

Angiver, om telefonen gensynkroniserer konfigurationer med klargøringsserveren efter tænding og efter hvert opgraderingsforsøg.

  • I telefonkonfigurationsfilen (cfg.xml) med XML skal du indtaste en streng i dette format:

    <Resync_On_Reset ua="na">JaOn_Reset>esync_

  • På telefonens webside skal du indstille dette felt til Ja for at tillade gensynkronisering ved tænding eller nulstilling eller Nej for at blokere gensynkronisering ved tænding eller nulstilling.

Standard: Ja

Tilfældig forsinkelse ved gensynkronisering

Forhindrer en overbelastning af klargøringsserveren, når et stort antal enheder tændes samtidigt og forsøger den indledende konfiguration. Denne forsinkelse træder kun i kraft ved det første forsøg på konfiguration, efter at enheden er tændt eller nulstillet.

Parameteren er det maksimale tidsinterval, som enheden venter, før der oprettes kontakt til klargøringsserveren. Den faktiske forsinkelse er et pseudo-tilfældigt tal mellem 0 og denne værdi.

Denne parameter er i enheder på 20 sekunder.

Den gyldige værdi ligger mellem 0 og 65535.

  • I telefonkonfigurationsfilen (cfg.xml) med XML skal du indtaste en streng i dette format:

    <Resync_Random_Delay ua="na">2Random_Delay>esync_

  • På telefonens webside skal du angive antallet af enheder (20 sekunder), som telefonen skal forsinke gensynkroniseringen efter tænding eller nulstilling.

Standardværdien er 2 (40 sekunder).

Gensynkroniser ved (ttMm)

Tiden (TTmm), hvor telefonen gensynkroniseres med klargøringsserveren.

Værdien for dette felt skal være et firecifret tal fra 0000 til 2400 for at angive tiden i TTmm-format. For eksempel angiver 0959 09:59.

  • I telefonkonfigurationsfilen (cfg.xml) med XML skal du indtaste en streng i dette format:

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

  • På telefonens webside skal du angive tidspunktet i HHMM-format, hvor telefonen skal starte gensynkronisering.

Standardværdien er tom. Hvis værdien er ugyldig, ignoreres parameteren. Hvis denne parameter er indstillet med en gyldig værdi, ignoreres parameteren Gensynkroniser periodisk.

Gensynkroniser ved tilfældig forsinkelse

Forhindrer en overbelastning af klargøringsserveren, når et stort antal enheder tændes samtidigt.

For at undgå at oversvømme serveren med gensynkroniseringsanmodninger fra flere telefoner gensynkroniseres telefonen i intervallet mellem timer og minutter og timer og minutter plus den vilkårlige forsinkelse (hhmm, hhmm+random_delay). Hvis f.eks. den vilkårlige forsinkelse = (Gensynkroniser ved vilkårlig forsinkelse + 30)/60 minutter, konverteres inputværdien i sekunder til minutter og afrundes op til det næste minut for at beregne det endelige random_delay interval.

  • I telefonkonfigurationsfilen (cfg.xml) med XML skal du indtaste en streng i dette format:

    <Resync_At_Random_Delay ua="na">600At_Random_Delay>esync_

  • På telefonens webside skal du angive tidsperioden i sekunder.

Den gyldige værdi ligger mellem 600 og 65535.

Hvis værdien er mindre end 600, er den interne vilkårlige forsinkelse mellem 0 og 600.

Standardværdien er 600 sekunder (10 minutter).

Gensynkroniser periodisk

Tidsintervallet mellem periodisk gensynkronisering med klargøringsserveren. Den tilknyttede tidsindstilling for gensynkronisering er kun aktiv, efter den første vellykkede synkronisering med serveren.

De gyldige formater er som følger:

  • Et heltal

    Eksempel: Et input på 3000 angiver, at den næste gensynkronisering sker om 3000 sekunder.

  • Flere heltal

    Eksempel: Et input på 600.1200.300 angiver, at den første gensynkronisering sker om 600 sekunder, den anden gensynkronisering sker om 1200 sekunder efter den første, og den tredje gensynkronisering sker om 300 sekunder efter den anden.

  • Et tidsinterval

    Et input på 2400+30 angiver f.eks., at den næste gensynkronisering sker mellem 2400 og 2430 sekunder efter en vellykket gensynkronisering.

  • I telefonkonfigurationsfilen (cfg.xml) med XML skal du indtaste en streng i dette format:

    <Resync_Periodisk ua="na">3600Periodisk>esync_

  • På telefonens webside skal du angive tidsperioden i sekunder.

Indstil denne parameter til nul for at deaktivere periodisk gensynkronisering.

Standardværdien er 3600 sekunder.

Forsinkelse ved nyt forsøg på gensynkroniseringsfejl

Hvis en gensynkronisering mislykkes, fordi telefonen ikke kunne hente en profil fra serveren, eller den downloadede fil er beskadiget, eller der opstår en intern fejl, forsøger telefonen at synkronisere igen efter et tidsrum, der er angivet i sekunder.

De gyldige formater er som følger:

  • Et heltal

    Eksempel: Et input på 300 angiver, at det næste forsøg på gensynkronisering sker om 300 sekunder.

  • Flere heltal

    Eksempel: Et input på 600.1200.300 angiver, at det første forsøg sker 600 sekunder efter fejlen, det andet forsøg sker 1200 sekunder efter fejlen i det første forsøg, og det tredje forsøg sker 300 sekunder efter fejlen i det andet forsøg.

  • Et tidsinterval

    Et input på 2400+30 angiver f.eks., at det næste forsøg sker mellem 2400 og 2430 sekunder efter en gensynkroniseringsfejl.

Hvis forsinkelsen er indstillet til 0, forsøger enheden ikke at synkronisere igen efter et mislykket forsøg på gensynkronisering.

  • I telefonkonfigurationsfilen (cfg.xml) med XML skal du indtaste en streng i dette format:

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

  • På telefonens webside skal du angive tidsperioden i sekunder.

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

Forsinkelse i tvungen gensynkronisering

Maksimal forsinkelse (i sekunder), telefonen venter, før der udføres en gensynkronisering.

Enheden gensynkroniseres ikke, mens en af dens telefonlinjer er aktiv. Da en gensynkronisering kan tage flere sekunder, er det ønskeligt at vente, indtil enheden har været inaktiv i en længere periode, før du gensynkroniserer. Dette giver en bruger mulighed for at foretage opkald efter hinanden uden afbrydelser.

Enheden har en timer, der begynder at tælle ned, når alle dens linjer bliver inaktive. Denne parameter er den indledende værdi af tælleren. Gensynkroniseringshændelser forsinkes, indtil denne tæller falder til nul.

Den gyldige værdi ligger mellem 0 og 65535.

  • I telefonkonfigurationsfilen (cfg.xml) med XML skal du indtaste en streng i dette format:

    <Forced_Resync_Delay ua="na">14400Resync_Delay>orced_

  • På telefonens webside skal du angive tidsperioden i sekunder.

Standardværdien er 14.400 sekunder.

Gensynkroniser fra SIP

Styrer anmodninger om gensynkroniseringshandlinger via en SIP NOTIFY-hændelse, der sendes fra serviceudbyderens proxyserver til telefonen. Hvis indstillingen er aktiveret, kan proxyen anmode om en gensynkronisering ved at sende en SIP NOTIFY-meddelelse, der indeholder hændelsen: gensynkroniser header til enheden.

  • I telefonkonfigurationsfilen (cfg.xml) med XML skal du indtaste en streng i dette format:

    <Resync_From_SIP ua="na">JaFrom_SIP>esync_

  • På telefonens webside skal du vælge Ja for at aktivere denne funktion eller Nej for at afvise den.

Standard: Ja

Gensynkroniser efter forsøg på opgradering

Aktiverer eller deaktiverer gensynkroniseringshandlingen, når en opgradering har fundet sted. Hvis Ja er valgt, udløses synkronisering efter en firmwareopgradering.

  • I telefonkonfigurationsfilen (cfg.xml) med XML skal du indtaste en streng i dette format:

    <Resync_Etfter_Upgrade_Forsøg ua="na">JaEtfter_Upgrade_Forsøg>esync_

  • På telefonens webside skal du vælge Ja for at udløse gensynkronisering efter en firmwareopgradering eller Nej for ikke at gensynkronisere.

Standard: Ja

Gensynkroniseringsudløser 1

Gensynkroniseringsudløser 2

Hvis den logiske ligning i disse parametre evalueres til FALSK, udløses gensynkronisering ikke, selv når Gensynkroniser ved nulstilling er indstillet til SAND. Det er kun gensynkroniseringen via URL-adresse til direkte handling og SIP-besked, der ignorerer disse udløsere af gensynkronisering.

Parametrene kan programmeres med et betinget udtryk, der gennemgår en makroudvidelse. Se Makroudvidelsesvariabler under Klargøringsparametre for de gyldige makroudvidelser.

  • I telefonkonfigurationsfilen (cfg.xml) med XML skal du indtaste en streng i dette format:

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

    <Resync_Trigger_2 ua="na"/>

  • På telefonens webside skal du angive udløserne.

Standard: Tom

Brugerkonfigurerbar gensynkronisering

Giver en bruger mulighed for at gensynkronisere telefonen fra menuen på telefonskærmen. Når indstillingen er angivet til Ja, kan en bruger gensynkronisere telefonkonfigurationen ved at indtaste profilreglen fra telefonen. Når indstillingen er angivet til Nej, vises parameteren Profilregel ikke i telefonskærmmenuen.

  • I telefonkonfigurationsfilen (cfg.xml) med XML skal du indtaste en streng i dette format:

    <User_Configurable_Resync ua="na">JaConfigurable_Resync>ser_

  • På telefonens webside skal du vælge Ja for at vise parameteren Profilregel i telefonmenuen, eller vælge Nej for at skjule denne parameter.

Standard: Ja

Gensynkronisering mislykkes på FNF

En gensynkronisering anses typisk for at være mislykket, hvis en anmodet profil ikke modtages fra serveren. Denne parameter tilsidesætter denne adfærd. Når indstillingen er angivet til Nej, accepterer enheden et fil ikke fundet -svar fra serveren som en vellykket gensynkronisering.

  • I telefonkonfigurationsfilen (cfg.xml) med XML skal du indtaste en streng i dette format:

    <Resync_Fails_On_FNF ua="na">JaFails_On_FNF>esync_

  • På telefonens webside skal du vælge Ja for at tage et fil-ikke-fundet -svar som en mislykket gensynkronisering, eller vælge Nej for at tage et fil-ikke-fundet -svar som en vellykket gensynkronisering.

Standard: Ja

Profilgodkendelsestype

Angiver de legitimationsoplysninger, der skal bruges til godkendelse af profilkonto. De tilgængelige valgmuligheder er:

  • Deaktiveret: Deaktiverer profilkontofunktionen. Når denne funktion er deaktiveret, vises menuen Opsætning af profilkonto ikke på telefonskærmen.

  • Grundlæggende HTTP-godkendelse: HTTP-loginoplysningerne bruges til at godkende profilkontoen.

  • XSI-godkendelse: XSI-logonlegitimationsoplysninger eller XSI SIP-legitimationsoplysninger bruges til at godkende profilkontoen. Legitimationsoplysningerne til godkendelse afhænger af telefonens XSI-godkendelsestype :

    • Når telefonens XSI-godkendelsestype er indstillet til Logonlegitimationsoplysninger, bruges XSI-logonlegitimationsoplysningerne.

    • Når telefonens XSI-godkendelsestype er indstillet til SIP-legitimationsoplysninger, bruges XSI SIP-legitimationsoplysningerne.

  • I telefonkonfigurationsfilen (cfg.xml) med XML skal du indtaste en streng i dette format:

    <Profile_Authentication_Type ua="na">Grundlæggende Http-godkendelseAuthentication_Type>rofile_

  • På telefonens webside skal du vælge en valgmulighed på listen for telefonen til at godkende profilgensynkronisering.

Standard: Grundlæggende HTTP-godkendelse

Få flere oplysninger i Angiv profilgodkendelsestypen under Angiv telefonen til profilgensynkronisering.

Profilregel

Profilregel B

Profilregel C

Profilregel D

Hver profilregel informerer telefonen om en kilde, hvorfra der kan hentes en profil (konfigurationsfil). Under hver gensynkronisering anvender telefonen alle profiler i rækkefølge.

Hvis du anvender AES-256-CBC-kryptering til konfigurationsfilerne, skal du angive krypteringsnøglen med --key nøgleordet som følger:

[--nøgle ]

Du kan eventuelt omslutte krypteringsnøglen med dobbelte anførselstegn (").

  • I telefonkonfigurationsfilen (cfg.xml) med XML skal du indtaste en streng i dette format:

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

    <Profile_Rule_B ua="na"/>

    <Profile_Rule_C ua="na"/>

    <Profile_Rule_D ua="na"/>

  • På telefonens webside skal du angive profilreglen.

Standard: /$PSN.xml

DHCP-indstilling Der Skal Bruges

DHCP-indstillinger, adskilt af kommaer, bruges til at hente firmware og profiler.

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

DHCPv6-indstilling, der skal bruges

DHCP-indstillinger, adskilt af kommaer, bruges til at hente firmware og profiler.

Standard: 17,160,159

Klargøring via Cisco XML

Du kan klargøre telefoner via Cisco XML-funktioner.

Du kan sende et XML-objekt til telefonen via en SIP-beskedpakke eller en HTTP-post til telefonens CGI-grænseflade: http://PhoneIPAddress/CGI/Execute.

CP-xxxx-3PCC udvider Cisco XML-funktionen til at understøtte klargøring via et XML-objekt:

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

Når telefonen har modtaget XML-objektet, downloader den klargøringsfilen fra [profile-rule]. Denne regel bruger makroer til at forenkle udviklingen af XML-tjenesteprogrammet.

URL-opløsning med makroudvidelse

Undermapper med flere profiler på serveren giver en praktisk metode til administration af et stort antal installerede enheder. Profilens URL-adresse kan indeholde:

  • Et klargøringsservernavn eller en eksplicit IP-adresse. Hvis profilen identificerer klargøringsserveren efter navn, udfører telefonen et DNS-opslag for at fortolke navnet.

  • En ikke-standard serverport, der er angivet i URL-adressen ved at bruge standardsyntaksen :port efter servernavnet.

  • Undermappen til serverens virtuelle rodmappe, hvor profilen er gemt, angivet ved hjælp af standard-URL-notation og administreres ved makroudvidelse.

F.eks. anmoder følgende Profile_-regel om profilfilen ($PN.cfg) i serverundermappen /cisco/config fra den TFTP-server, der kører på værten prov.telco.com, der lytter efter en forbindelse på port 6900: 

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

En profil for hver telefon kan identificeres i en parameter til generelle formål, hvor der henvises til dens værdi i en fælles profilregel ved hjælp af makroudvidelse.

Antag f.eks., at GPP_B er defineret som Dj6Lmp23Q.

Profile_-reglen har værdien:

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

Når enheden gensynkroniseres, og makroerne udvides, anmoder telefonen med en MAC-adresse på 000e08012345 om profilen med det navn, der indeholder enhedens MAC-adresse, på følgende URL-adresse:

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

Profilgodkendelse giver telefonbrugere mulighed for at synkronisere klargøringsprofilen igen på telefonen. Der kræves godkendelsesoplysninger, mens telefonen forsøger at gensynkronisere og downloade konfigurationsfilen for første gang og får en HTTP- eller HTTPS 401-godkendelsesfejl. Når du aktiverer denne funktion, vises skærmen Konfiguration af profilkonto på telefonen i følgende situationer:

  • Når HTTP- eller HTTPs 401-godkendelsesfejlen opstår under første klargøring, efter telefonen genstarter

  • Når brugernavnet og adgangskoden til profilkontoen er tomme

  • Når der ikke er brugernavn og adgangskode i profilreglen

Hvis skærmen Opsætning af profilkonto går glip af eller ignoreres, kan brugeren også få adgang til opsætningsskærmen via menuen på telefonskærmen eller programtasten Opsætning , som kun vises, når der ikke er registreret nogen linje på telefonen.

Når du deaktiverer funktionen, vises skærmen Opsætning af profilkonto ikke på telefonen.

Brugernavnet og adgangskoden i feltet Profilregel har højere prioritet end profilkontoen.

  • Når du angiver en korrekt URL-adresse i feltet Profilregel uden et brugernavn og en adgangskode, kræver telefonen godkendelse eller digest for at gensynkronisere profilen. Med den korrekte profilkonto passerer godkendelsen. Med en forkert profilkonto mislykkes godkendelsen.

  • Når du angiver en korrekt URL-adresse i feltet Profilregel med et korrekt brugernavn og en korrekt adgangskode, kræver telefonen godkendelse eller digest for at gensynkronisere profilen. Profilkontoen bruges ikke til gensynkronisering af telefon. Login blev gennemført.

  • Når du angiver en korrekt URL-adresse i feltet Profilregel med et forkert brugernavn og en forkert adgangskode, kræver telefonen godkendelse eller digest for at gensynkronisere profilen. Profilkontoen bruges ikke til gensynkronisering af telefon. Login mislykkes altid.

  • Når du angiver en forkert URL-adresse i feltet Profilregel , mislykkes login altid.

Du kan også konfigurere parametrene i telefonkonfigurationsfilen med XML-kode (cfg.xml).

Du kan angive profilgodkendelsestypen fra telefonens administrationswebside.

1

Gå til telefonens administrationswebside.

2

Vælg Stemme > Klargøring.

3

I afsnittet Konfigurationsprofil skal du indstille parameteren Profilgodkendelsestype for at angive de legitimationsoplysninger, der skal bruges til godkendelse af profilkonto.

Du kan konfigurere denne parameter i telefonkonfigurations-XML-filen (cfg.xml) ved at angive en streng i dette format:

<Profile_Authentication_Type ua="na">DeaktiveretAuthentication_Type>
rofile_

Valgmuligheder:

  • Deaktiveret: Deaktiverer profilkontofunktionen. Når denne funktion er deaktiveret, vises menuen Opsætning af profilkonto ikke på telefonskærmen.

  • Grundlæggende HTTP-godkendelse: HTTP-loginoplysningerne bruges til at godkende profilkontoen.

  • XSI-godkendelse: XSI-logonlegitimationsoplysninger eller XSI SIP-legitimationsoplysninger bruges til at godkende profilkontoen. Legitimationsoplysningerne til godkendelse afhænger af telefonens XSI-godkendelsestype:

    Når telefonens XSI-godkendelsestype er indstillet til Logonlegitimationsoplysninger, bruges XSI-logonlegitimationsoplysningerne.

    Når telefonens XSI-godkendelsestype er indstillet til SIP-legitimationsoplysninger, bruges XSI SIP-legitimationsoplysningerne.

Standard: Grundlæggende HTTP-godkendelse

4

Klik på Indsend alle ændringer.

Anvend en profil manuelt på din telefon

Download konfigurationsfilen til telefonen fra en TFTP-server

Benyt følgende fremgangsmåde for at downloade konfigurationsfilen til et TFTP-serverprogram på din pc.

1

Tilslut computeren til telefonens LAN-port.

2

Kør et TFTP-serverprogram på computeren, og sørg for, at konfigurationsfilen er tilgængelig i TFTP-rodmappen.

3

I en webbrowser skal du angive telefonens LAN IP-adresse, computerens IP-adresse, filnavnet og loginoplysningerne. Brug dette format:

http://<WAN_IP_adresse>/admin/resync?tftp://<PC_IP_adresse>/<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
Download konfigurationsfilen til telefonen med cURL

Benyt følgende fremgangsmåde for at downloade konfigurationen til telefonen ved hjælp af cURL. Dette kommandolinjeværktøj bruges til at overføre data med en URL-syntaks. Hvis du vil downloade cURL, skal du gå til:

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

Vi anbefaler, at du ikke bruger cURL til at sende konfigurationen til telefonen, da brugernavnet og adgangskoden kan blive registreret, mens du bruger cURL.

1

Tilslut computeren til telefonens LAN-port.

2

Download konfigurationsfilen til telefonen ved at indtaste følgende cURL-kommando:

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

Konfigurationsprofiler

Telefonen accepterer konfigurationer i XML-format.

Eksemplerne i dette afsnit bruger konfigurationsprofiler med XML-syntaks.

Formater til konfigurationsprofiler

Konfigurationsprofilen definerer parameterværdierne for telefonen.

Konfigurationsprofilens XML-format bruger standard XML-oprettelsesværktøjer til at kompilere parametrene og værdierne.

Kun tegnsættet UTF-8 understøttes. Hvis du ændrer profilen i et redigeringsprogram, skal du ikke ændre kodningsformatet. Ellers kan telefonen ikke genkende filen.

Hver telefon har et forskelligt funktionssæt og derfor et forskelligt sæt parametre.

Åbn profilformat

Open format-profilen er en tekstfil med XML-lignende syntaks i et hierarki af elementer med elementattributter og værdier. Dette format gør det muligt at bruge standardværktøjer til at oprette konfigurationsfilen. En XML-konfigurationsfil kan sendes fra klargøringsserveren til telefonen under en gensynkronisering uden kompilering som et binært objekt.

Telefonen kan acceptere konfigurationsformater, som standardværktøjer genererer. Denne funktion letter udviklingen af backend-klargøringsserversoftware, der genererer konfigurationsprofiler fra eksisterende databaser.

For at beskytte fortrolige oplysninger i konfigurationsprofilen leverer klargøringsserveren XML-konfigurationsfilen til telefonen via en kanal, der er sikret af TLS. Filen kan eventuelt komprimeres ved hjælp af gzip-deflate-algoritmen (RFC1951).

Filen kan krypteres med en af disse krypteringsmetoder:

  • AES-256-CBC-kryptering

  • RFC-8188-baseret kryptering af HTTP-indhold med AES-128-GCM-kryptering

En konfigurationsfil kan indeholde disse komponenter:

  • Elementmærker

  • Attributter

  • Parametre

  • Formatering af funktioner

  • XML-kommentarer

Eksempel: Åbn 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_

elementtagget indeholder alle parameterelementer, som telefonen genkender.

Elementmærkeegenskaber

Husk følgende regler, når du opretter eller opdaterer konfigurationsfilen.

  • XML-klargøringsformatet og webbrugergrænsefladen tillader konfiguration af de samme indstillinger. XML-mærkenavne og feltnavnene i webbrugergrænsefladen er ens, men varierer på grund af begrænsninger af XML-elementnavne. Understregningstegn ( _ ) i XML-konfigurationsfilen i stedet for mellemrum i webbrugergrænsefladen.

  • Telefonen genkender elementer med korrekte parameternavne, der er indkapslet i det specielle element.

  • Elementnavne omsluttes i vinkelparenteser.

  • De fleste elementnavne svarer til feltnavnene i telefonens webbrugergrænseflade med følgende ændringer:

    • Elementnavne må ikke indeholde mellemrum eller specialtegn. Hvis du vil udlede elementnavnet fra webfeltnavnet, skal du erstatte et understregningstegn for hvert rum eller specialtegnene [, ], (, ), eller /.

      Eksempel: Elementet <Resync_On_Nulstil> repræsenterer feltet Gensynkronisering ved nulstilling .

    • Hvert elementnavn skal være entydigt. I telefonens webbrugergrænseflade kan de samme felter vises på flere websider, f.eks. siderne Linje, Bruger og Lokalnummer. Føj [n] til elementnavnet for at angive det nummer, der vises i sidefanen.

      Eksempel:<Dial_Plan_1_> elementet repræsenterer opkaldsplanen for linje 1.

  • Hvert åbningselmentmærke skal have et matchende afslutningselmentmærke. 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 Regel>
    rofile_

  • Der skelnes mellem store og små bogstaver i elementmærker.

  • Tomme elementtags er tilladte og vil blive fortolket, som om værdien konfigureres til at være tom. Angiv åbningselementkoden uden en tilsvarende elementkode, og indsæt et mellemrum og en skråstreg før det afsluttende vinkelbeslag (>). I dette eksempel er profilregel B tom:

     <Profile_Rule_B />

  • En tom elementkode kan bruges til at forhindre overskrivning af værdier, der er angivet af brugeren, under en gensynkronisering. I følgende eksempel er indstillingerne for brugerens hurtigopkald uændret:

    <fladprofil> <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>

  • Brug en tom værdi til at angive den tilsvarende parameter til en tom streng. Angiv et åbnings- og lukningselement uden nogen værdi mellem dem. I følgende eksempel er parameteren GPP_A indstillet til en tom streng.

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

  • Elementnavne, der ikke genkendes, ignoreres.

Parameteregenskaber

Disse egenskaber gælder for parametrene:

  • Alle parametre, der ikke er angivet af en profil, forbliver uændrede i telefonen.

  • Parametre, der ikke er genkendt, ignoreres.

  • Hvis profilen i Open-format indeholder flere forekomster af samme parametertag, tilsidesætter den sidste sådanne forekomst alle tidligere forekomster. For at undgå utilsigtet tilsidesættelse af konfigurationsværdier for en parameter anbefaler vi, at hver profil angiver mindst én forekomst af en parameter.

  • Den sidst behandlede profil har forrang. Hvis flere profiler angiver den samme konfigurationsparameter, har værdien af den sidstnævnte profil forrang.

Strengformater

Disse egenskaber gælder for formateringen af strengene:

  • Kommentarer er tilladt via standard-XML-syntaks.

  • Mellemrum før og efter er tilladt for at gøre det lettere at læse, men fjernes fra parameterværdien.

  • Nye linjer inden for en værdi konverteres til rum.

  • En XML-overskrift i formularen <? ?> er tilladt, men telefonen ignorerer den.

  • Hvis du vil angive specialtegn, skal du bruge grundlæggende XML-tegn-escapes, som vist i følgende tabel.

    Specialtegn

    XML-escape-sekvens

    & (ampersand)

    &

    < (mindre end)

    <

    > (større end)

    >

    Kategori: Apostrof

    '

    " (dobbelt citat)

    "

    I følgende eksempel indtastes tegn-escapes for at repræsentere symbolerne større end og mindre end, der kræves i en opkaldsplanregel. Dette eksempel definerer en opkaldsplan for oplysninger, der indstiller <Dial_Plan_1_>-parameteren (Administratorlogin > avanceret > Stemme > Lokalnummer (n)) lig med (S0 ).

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

  • Numeriske tegn undslipper ved hjælp af decimale og hexadecimale værdier (s.a. ( og .), er oversat.

  • Telefonens firmware understøtter kun ASCII-tegn.

Komprimering og kryptering af Open-profil (XML)

Open-konfigurationsprofilen kan komprimeres for at reducere netværksbelastningen på klargøringsserveren. Profilen kan også krypteres for at beskytte fortrolige oplysninger. Komprimering er ikke påkrævet, men det skal ske før kryptering.

Komprimering af Open-profil

Den understøttede komprimeringsmetode er gzip deflate-algoritmen (RFC1951). Hjælpeprogrammet gzip og komprimeringsbiblioteket, der implementerer den samme algoritme (zlib), er tilgængelige fra websteder på internettet.

For at identificere komprimering forventer telefonen, at den komprimerede fil indeholder en header, der er kompatibel med gzip. Aktivering af hjælpeprogrammet gzip på den oprindelige Open-profil genererer headeren. Telefonen undersøger den downloadede filheader for at bestemme filformatet.

Hvis profile.xml f.eks. er en gyldig profil, accepteres filen profile.xml.gz også. En af følgende kommandoer kan generere denne profiltype:

  • >gzip profile.xml

    Erstatter den oprindelige fil med en komprimeret fil.

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

    Efterlader den oprindelige fil på plads og producerer en ny komprimeret fil.

Kryptering af Open-profil

Symmetrisk nøglekryptering kan bruges til at kryptere en åben konfigurationsprofil, uanset om filen er komprimeret eller ej. Komprimering skal anvendes før kryptering, hvis den anvendes.

Klargøringsserveren bruger HTTPS til at håndtere den indledende klargøring af telefonen efter installation. Forhåndskryptering af konfigurationsprofiler offline gør det muligt at bruge HTTP til efterfølgende gensynkronisering af profiler. Dette reducerer belastningen på HTTPS-serveren ved store installationer.

Telefonen understøtter to metoder til kryptering af konfigurationsfiler:

  • AES-256-CBC-kryptering

  • RFC 8188-baseret kryptering af HTTP-indhold med AES-128-GCM-kryptering

Nøglen eller IKM (Input Keying Material) skal klargøres på et tidligere tidspunkt i enheden. Bootstrap af den hemmelige nøgle kan udføres sikkert ved hjælp af HTTPS.

Navnet på konfigurationsfilen kræver ikke et specifikt format, men et filnavn, der slutter med .cfg -forlængelsen, angiver normalt en konfigurationsprofil.

AES-256-CBC-kryptering

Telefonen understøtter AES-256-CBC-kryptering af konfigurationsfiler.

OpenSSL-krypteringsværktøjet, der kan downloades fra forskellige internetsider, kan udføre krypteringen. Understøttelse af 256-bit AES-kryptering kan kræve omkompilering af værktøjet for at aktivere AES-koden. Firmwaren er testet i forhold til version openssl-1.1.1d.

Når det gælder en krypteret fil, forventer profilen, at filen har det samme format, som genereres af følgende kommando:

 # eksempel krypteringsnøgle = SecretPhrase ｟_bpt_20｠ openssl enc –e –aes-256-cbc –k SecretPhrase ｟_bpt_20｠ –i profile.xml –out profile.cfg # analog påberåbelse af en komprimeret xml-fil openssl enc –e –aes-256-cbc –k SecretPhrase ｟_bpt_20｠ –i profile.xml.gz –out profile.cfg

Et -k med små bogstaver går forud for den hemmelige nøgle, som kan være enhver almindelig tekstsætning, og som bruges til at generere et vilkårligt 64-bit salt. Med den hemmelighed, der er angivet af -k-argumentet, afleder krypteringsværktøjet en vilkårlig 128-bit initial vektor og den faktiske 256-bit krypteringsnøgle.

Når denne form for kryptering bruges på en konfigurationsprofil, skal telefonen informeres om den hemmelige nøgleværdi for at dekryptere filen. Denne værdi er angivet som en kvalificerer i profilens URL-adresse. Syntaksen er som følger ved hjælp af en eksplicit URL-adresse:

 [--nøgle “SecretPhrase ｟_bpt_20｠”] http://prov.telco.com/path/profile.cfg

Denne værdi programmeres ved hjælp af en af Profile_regel -parametrene.

Makroudvidelse

Flere klargøringsparametre udsættes for en makroudvidelse internt, før de evalueres. Dette trin til forevaluering giver større fleksibilitet til at styre telefonens gensynkronisering og opgradering.

Disse parametergrupper gennemgår makroudvidelse før evaluering:

  • esync_Trigger_*

  • Profile_regel*

  • Log_xxx_Msg

  • Upgrade_-regel

Under visse betingelser gennemgår nogle parametre for generelle formål (GPP_*) også en makroudvidelse, som udtrykkeligt angivet i afsnittet Valgfri gensynkroniseringsargumenter nedenfor.

Under makroudvidelse erstatter indholdet af de navngivne variabler udtryk af formen $NAME og $(NAME). Disse variabler omfatter parametre for generelle formål, flere produkt-id'er, visse begivenhedstimer og værdier for klargøringstilstand. Se Makroudvidelsesvariabler under Klargøringsparametre for en komplet liste.

I følgende eksempel bruges udtrykket $(MAU) til at indsætte MAC-adressen 000E08012345.

Administratoren indtaster: $(MAU)config.cfg

Den resulterende makroudvidelse for en enhed med MAC-adresse 000E08012345 er: 000E08012345config.cfg

Hvis et makronavn ikke genkendes, forbliver det ikke udvidet. Navnet STRANGE genkendes f.eks. ikke som et gyldigt makronavn, mens MAU genkendes som et gyldigt makronavn.

Administratoren indtaster: $STRANGE$MAU.cfg

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

Makroudvidelse anvendes ikke rekursivt. $$MAU" udvides f.eks. til $MAU" ($$ udvides) og resulterer ikke i MAC-adressen.

Indholdet af parametrene for specielle formål, GPP_SA til og med GPP_SD, er knyttet til makroudtrykkene $SA til og med $SD. Disse parametre er kun makroudvidet som argumentet for valgmulighederne --key , --uid og --pwd i en URL-adresse til gensynkronisering.

Betingede udtryk

Betingede udtryk kan udløse gensynkroniseringshændelser og vælge mellem alternative URL-adresser til gensynkroniserings- og opgraderingshandlinger.

Betingede udtryk består af en liste over sammenligninger, adskilt af og operatøren. Alle sammenligninger skal være opfyldt, for at betingelsen kan være sand.

Hver sammenligning kan vedrøre en af følgende tre typer af literaler:

  • Heltalsværdier

  • Versionsnumre for software eller hardware

  • Dobbeltciterede strenge

Versionsnumre

Softwareversionen til Cisco Video Phone 8875 bruger dette format (hvor BN er build-nummeret):

TELEFONOSåååå.1-0-1-0001-BN

hvor åååå angiver telefonmodellen eller telefonserien, 1 er den større version, 0 er den mindre version, 1-0001 er mikroversionen, og BN er build-nummeret.

Sammenligningsstrengen skal bruge samme format. Ellers vil en formatparsfejl resultere i.

Når softwareversionen sammenlignes, sammenlignes den større, mindre og mikro-versionen i rækkefølge, og cifrene længst til venstre har forrang over de sidste. Når versionsnumrene er identiske, sammenlignes build-nummeret.

Eksempler på gyldigt versionsnummer

telefoner-8875.1-0-1-0001-19

Sammenligning

Citerede strenge kan sammenlignes for lighed eller ulighed. Heltal og versionsnumre kan også sammenlignes aritmetisk. Sammenligningsoperatørerne kan udtrykkes som symboler eller som akronymer. Akronymer er praktiske til at udtrykke betingelsen i en profil i Open-format.

Operatør

Alternativ syntaks

Beskrivelse

Gælder for heltal- og versionsoperander

Gælder for citerede strengoperander

=

eq

lig med

Ja

Ja

!=

ikke

ikke lig med

Ja

Ja

<

lt

mindre end

Ja

Nej

<=

den Europæiske Union

mindre end eller lig med

Ja

Nej

>

GT

større end

Ja

Nej

>=

læ

større end eller lig med

Ja

Nej

OG

og

Ja

Ja

Det er vigtigt at omslutte makrovariabler i dobbelte anførselstegn, hvor der forventes en strengliteral. Gør det ikke, hvor der forventes et nummer eller versionsnummer.

Når de bruges i forbindelse med parametrene Profile_Regel* og Upgrade_-regel, skal betingede udtryk omsluttes inden for syntaksen "(expr)?" som i dette eksempel på opgraderingsregel. Husk at udskifte BN med build-nummeret for din firmwareindlæsning, du skal opgradere til.

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

Brug ikke den foregående syntaks med parenteser til at konfigurere Resync_Trigger_*-parametrene.

URL-syntaks

Brug standard-URL-syntaksen til at angive, hvordan du henter konfigurationsfiler og firmwareindlæsninger henholdsvis i parametrene Profile_Regel* og Upgrade_-regel. Syntaksen er som følger:

[ skema:// ] [ server [:port]] filsti

Hvor skema er en af disse værdier:

  • tftp

  • http

  • https

Hvis skema udelades, antages tftp. Serveren kan være et DNS-genkendt værtsnavn eller en numerisk IP-adresse. Porten er destinations-UDP- eller TCP-portnummeret. Filstien skal begynde med rodmappen (/); det skal være en absolut sti.

Hvis server mangler, bruges den tftp-server, der er angivet via DHCP (indstilling 66).

Serveren skal angives for opgraderingsregler.

Hvis port mangler, bruges standardporten for det angivne skema. TFTP bruger UDP-port 69, http bruger TCP-port 80, https bruger TCP-port 443.

Der skal være en filsti. Den behøver ikke nødvendigvis henvise til en statisk fil, men kan angive dynamisk indhold, der opnås via CGI.

Makroudvidelse gælder 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 bruger DHCP-indstilling 66, understøttes den tomme syntaks ikke af opgraderingsreglerne. Det gælder kun for Profile Rule*.

RFC 8188-baseret kryptering af HTTP-indhold

Telefonen understøtter RFC 8188-baseret kryptering af HTTP-indhold med AES-128-GCM-kryptering af konfigurationsfiler. Med denne krypteringsmetode kan enhver enhed læse HTTP-meddelelsesheaderne. Det er dog kun de enheder, der kender IKM (Input Keying Material), der kan læse nyttelasten. Når telefonen er klargjort med IKM, kan telefonen og klargøringsserveren udveksle konfigurationsfiler sikkert, samtidig med at netværkselementer fra tredjeparter kan bruge meddelelsesheaderne til analyse og overvågning.

XML-konfigurationsparameteren IKM_HTTP_Encrypt_Content holder IKM på telefonen. Af sikkerhedsmæssige årsager er denne parameter ikke tilgængelig på telefonens administrationswebside. Den er heller ikke synlig i telefonens konfigurationsfil, som du kan få adgang til fra telefonens IP-adresse eller fra telefonens konfigurationsrapporter, der sendes til klargøringsserveren.

Hvis du vil bruge RFC 8188-baseret kryptering, skal du sikre følgende:

  • Klargør telefonen med IKM ved at angive IKM med XML-parameteren IKM_HTTP_Encrypt_Content i konfigurationsfilen, der sendes fra klargøringsserveren til telefonen.

  • Hvis denne kryptering anvendes på de konfigurationsfiler, der sendes fra klargøringsserveren til telefonen, skal du sørge for, at HTTP-headeren Content-Encoding i konfigurationsfilen har aes ｟_bpt_22｠ gcm.

    Hvis denne header ikke findes, prioriteres metoden AES-256-CBC. Telefonen anvender AES-256-CBC-dekryptering, hvis der findes en AES-256-CBC-nøgle i en profilregel, uanset IKM.

  • Hvis telefonen skal anvende denne kryptering på de konfigurationsrapporter, den sender til klargøringsserveren, skal du sikre, at der ikke er angivet en AES-256-CBC-nøgle i rapportreglen.

Valgfri gensynkroniseringsargumenter

Valgfrie argumenter, nøgle, uid og pwd, kan gå forud for de URL-adresser, der er indtastet i parametrene Profile_Rule* , samlet omsluttet af firkantede parenteser.

nøgle

Valgmuligheden --key fortæller telefonen, at den konfigurationsfil, den modtager fra klargøringsserveren, er krypteret med AES-256-CBC-kryptering, medmindre Content-Encoding -headeren i filen angiver aes-256-gcm -kryptering. Selve nøglen er angivet som en streng efter ordet --key. Nøglen kan eventuelt omsluttes i dobbelte anførselstegn ("). Telefonen bruger nøglen til at dekryptere konfigurationsfilen.

Brugseksempler
 [--key VerySecretValue] [--key "mit hemmelige udtryk"] [--key a37d2fb9055c1d04883a0745eb0917a4]

De valgfrie argumenter i parentes er makroudvidet. Parametre for specielle formål, GPP_SA til og med GPP_SD, er kun makroudvidet til makrovariabler, $SA til og med $SD, når de bruges som vigtige indstillingsargumenter. Se disse eksempler:

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

I åbne formatprofiler skal argumentet til --key være det samme som argumentet til valgmuligheden -k , der gives til openssl.

uid og pwd

Valgmulighederne uid og pwd kan bruges til at angive det bruger-id og den adgangskode, der skal sendes som svar på HTTP Basic- og Digest-godkendelsesudfordringer, når der anmodes om den angivne URL-adresse. De valgfrie argumenter i parentes er makroudvidet. Parametre for specielle formål, GPP_SA til og med GPP_SD, er kun makroudvidet til makrovariabler, $SA til og med $SD, når de bruges som vigtige indstillingsargumenter. Se disse eksempler:

GPP_SA = MitUserID GPP_SB = MySecretPassword

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

vil derefter blive udvidet til:

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

Datatyper

Disse datatyper bruges med konfigurationsprofilparametre:

  • {a,b,c,…} – et valg blandt a, b, c,…

  • Bool – boolesk værdi af enten "ja" eller "nej".

  • CadScript – et miniscript, der angiver kadenceparametrene for et signal. Op til 127 tegn.

    Syntaks: S1[;S2], hvor:

    • 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 kendt som et afsnit.

    • påi,j og frai,j er til/fra-varigheden i sekunder for et segment. i = 1 eller 2, og j = 1 til 6.

    • Di er sektionens samlede varighed i sekunder.

    Alle varigheder kan have op til tre decimaler til at give en opløsning på 1  ms. Jokertegnet "*" står for uendelig varighed. Segmenterne i en sektion afspilles i rækkefølge og gentages, indtil den samlede varighed afspilles.

    1. eksempel:

     60 (2/4) Antal kadencesektioner = 1 kadencesektion 1: Sektionslængde = 60 s Antal segmenter = 1 Segment 1: On=2s, Off=4s, samlet ringlængde = 60 s

    Eksempel 2 – Særlig ring (kort, kort, kort, lang):

     60(.2/.2,.2/.2,.2/.2,1/4) Antal kadencesektioner = 1 kadencesektion 1: Sektionslængde = 60 s Antal segmenter = 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,0 s, Off=4,0 s, samlet ringlængde = 60 s

  • DialPlanScript – scriptingsyntaks, der bruges til at angive opkaldsplaner for linje 1 og linje 2.

  • Flydende<n> – en flydende punktværdi med op til n decimaler.

  • FQDN – fuldt kvalificeret domænenavn. Det kan indeholde op til 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, der angiver parametrene for frekvens og niveau for en tone. Indeholder op til 127 tegn.

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

    • F1–F6 er frekvens i Hz (kun usignerede heltal).

    • L1–L6 er tilsvarende niveauer i dBm (med op til én decimal plads).

    Mellemrum før og efter kommaet er tilladt, men anbefales ikke.

    Eksempel 1 – tone for ventende opkald:

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

    Eksempel 2 – Opkaldstone:

     350@-19,440@-19 Antal frekvenser = 2 Frekvens 1 = 350 Hz ved –19 dBm Frekvens 2 = 440 Hz ved –19 dBm

  • IP – gyldig IPv4-adresse i form af x.x.x.x, hvor x er mellem 0 og 255. Eksempel: 10.1.2.100.

  • Bruger-id – bruger-id, som det vises i en URL-adresse, op til 63 tegn.

  • Telefon – en telefonnummerstreng, f.eks. 14081234567, *69, *72, 345678 eller en generisk URL-adresse, f.eks. 1234@10.10.10.100:5068 eller jsmith@Cisco.com. Strengen kan indeholde op til 39 tegn.

  • PhTmplt – en telefonnummerskabelon. Hver skabelon kan indeholde et eller flere mønstre, der er adskilt af et komma (,). Mellemrum i begyndelsen af hvert mønster ignoreres. "?" og "*" repræsenterer jokertegn. Hvis du vil repræsentere bogstaveligt, skal du bruge %xx. For example, %2a repræsenterer *. Skabelonen kan indeholde op til 39 tegn. Eksempler: "1408*, 1510*", "1408123????, 555?1."

  • Port – TCP-/UDP-portnummer (0-65535). Det kan angives i decimal- eller hex-format.

  • ProvisioningRuleSyntax – scriptingsyntaks, der bruges til at definere regler for konfigurationsgensynkronisering og firmwareopgradering.

  • PwrLevel – effektniveau udtrykt i dBm med én decimal, f.eks. –13,5 eller 1,5 (dBm).

  • RscTmplt – en skabelon for SIP-svarstatuskode, f.eks. "404, 5*", "61?", "407, 408, 487, 481". Det kan indeholde op til 39 tegn.

  • Sig – signeret n-bit-værdi. Det kan angives i decimal- eller hex-format. Negative værdier skal gå forud for tegnet "-". Et +-tegn før positive værdier er valgfrit.

  • Stjernekoder – aktiveringskode til en supplerende tjeneste, f.eks. *69. Koden kan indeholde op til 7 tegn.

  • Str – en generisk streng med op til n tegn, der ikke er reserveret.

  • Tid – varighed i sekunder med op til n decimaler. Ekstra angivne decimalpladser ignoreres.

  • ToneScript – et miniscript, der angiver frekvens-, niveau- og kadenceparametrene for en tone for opkaldsstatus. Script kan indeholde op til 127 tegn.

    Syntaks: FreqScript;Z1[;Z2].

    Afsnit Z1 svarer til afsnit S1 i et CadScript, bortset fra at hvert til/fra-segment efterfølges af en parameter for frekvenskomponenter: 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]]]]]) hvor:

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

    • 1 < nk < 6 angiver frekvenskomponenterne i FreqScript, der bruges i det pågældende segment.

    Hvis der bruges mere end én frekvenskomponent i et segment, summeres komponenterne sammen.

    Eksempel 1 – Opkaldstone:

     350@-19,440@-19;10(*/0/1+2) Antal frekvenser = 2 Frekvens 1 = 350 Hz ved –19 dBm Frekvens 2 = 440 Hz ved –19 dBm Antal kadensesektioner = 1 kadensesektion 1: Sektionslængde = 10 s Antal segmenter = 1 Segment 1: On=forever, med frekvenser 1 og 2 – samlet tonelængde = 10 s

    Eksempel 2 – Afbrudt tone:

     350@-19,440@-19;2(.1/.1/1+2);10(*/0/1+2) Antal frekvenser = 2 Frekvens 1 = 350 Hz ved –19 dBm Frekvens 2 = 440 Hz ved –19 dBm Antal kadensesektioner = 2 kadensesektion 1: Sektionslængde = 2s Antal segmenter = 1 Segment 1: On=0,1 s, Off=0,1 s med frekvenser 1 og 2 Kadence Afsnit 2: Sektionslængde = 10 s Antal segmenter = 1 Segment 1: On=forever, med frekvenser 1 og 2 – samlet tonelængde = 12 s

  • UNS – usigneret n-bit-værdi, hvor n = 8, 16 eller 32. Det kan angives i decimal- eller hex-format, f.eks. 12 eller 0x18, så længe værdien kan passe ind i n bit.

Vær opmærksom på disse:

  • repræsenterer et konfigurationsparameternavn. I en profil dannes det tilsvarende mærke ved at erstatte rummet med et understregningstegn "_", f.eks. Par_Navn.
  • Et tomt standardværdifelt indebærer en tom streng < “” >.
  • Telefonen fortsætter med at bruge de senest konfigurerede værdier for tags, der ikke er til stede i en given profil.
  • Skabeloner sammenlignes i den angivne rækkefølge. Det første, ikke det nærmeste, match er valgt. Parameternavnet skal matche nøjagtigt.
  • Hvis der er angivet mere end én definition for en parameter i en profil, er den sidste sådan definition i filen den, der træder i kraft på telefonen.
  • En parameterspecifikation med en tom parameterværdi tvinger parameteren tilbage til dens standardværdi. Hvis du vil angive en tom streng i stedet, skal du bruge den tomme streng "" som parameterværdien.