Konfigurer din telefon til gensynkronisering af profil

Gensynkroniser telefonprofilen over TFTP

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

1

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

2

På computeren skal du installere og aktivere en TFTP-server.

3

Brug en teksteditor til at oprette en konfigurationsprofil.

Hvis du vil kontrollere, om profilen er klargjort til telefonen senere, kan du indstille nogle af værdierne som markeringer. Angiv f.eks. værdien for GPP_A til 12345678 som vist i følgende eksempel:
<flat-profile>
  <GPP_A> 12345678
  </GPP_A>
</flat-profile>
4

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

Du kan kontrollere, at TFTP-serveren er konfigureret korrekt: Anmod om konfigurationsprofilfilen ved hjælp af en anden TFTP-klient end telefonen. Brug helst en TFTP-klient, der kører på en separat vært, fra klargøringsserveren.

5

Åbn websiden til administration i webbrowseren på computeren. Antag f.eks., at telefonens IP-adresse er 192.168.1.100, og åbn følgende URL-adresse i din webbrowser:

http://192.168.1.100/admin/advanced
6

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

7

Gensynkroniser testtelefonen til konfigurationsfilen, som du oprettede, ved at åbne gensynkroniserings-ULR-adressen i en webbrowser.

Eksempel:

Hvis IP-adressen på TFTP-serveren er 192.168.1.200, skal kommandoen svarer 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

Kontrollér, at parameteren er korrekt opdateret. Opdater administration til websiden, og gå til Tale > Klargøring.

Parameteren GPP_A burde nu indeholde værdien 12345678.

Klargør en telefonspecifik profil på en TFTP-Server

1

Få telefonens MAC-adresse fra produktmærkatet. (MAC-adressen er nummeret med tal og hexadecimale cifre med små bogstaver, f.eks. 000e08aabbcc.

2

Omdøb konfigurationsfilen til CP-xxxx mac-adresse.cfg (hvor xxxx erstattes med modelnummeret og mac-adresse med telefonens MAC adresse).

Eksempel:

CP-8875 000e08aabbcc.cfg

3

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

4

Gå til websiden til telefonadministration

5

Vælg Tale  > Klargøring.

6

Angiv stien til profilfilen i feltet Profilregel.

Eksempel: Antag, at IP adressen for TFTP-serveren er 192.168.1.200, og at navnet på profilfilen er 

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

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

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

Gensynkroniser telefonprofilen med HTTP GET

1

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

Apache-serveren, der er open source, kan hentes på internettet.

2

Upload konfigurationsprofilfilen til den virtuelle rodmappe på den installerede server.

3

For at kontrollere serverinstallationen og filadgangen til profilfilen skal du åbne profilen via en webbrowser.

4

Rediger testtelefonens Profile_Rule (Profilregel), så den peger på HTTP-serveren i stedet for TFTP-serveren, for at hente dens profil med jævne mellemrum.

Hvis f.eks. det antages, at HTTP-serveren er på 192.168.1.300, og profilnavnet er Basic. txt, skal du angive følgende værdi:

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

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

6

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

7

I HTTP-serverens logfiler kan du se, hvordan oplysninger, der identificerer testtelefonen, vises i loggen for brugeragenter.

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

Gensynkroniser telefonprofilen automatisk

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 afsendelse af en eksplicit anmodning om gensynkronisering til slutpunktet).

For at få telefonen til periodisk at gensynkronisere med en server defineres der en URL-adresse til en konfigurationsprofil ved hjælp af profilregelparameteren, og der defineres en gensynkroniseringsperiode ved hjælp af parameteren Resync_Periodic (Gensynkroniser periodisk).

1

Gå til websiden til telefonadministration

2

Vælg Tale  > Klargøring.

3

Angiv profilregelparameteren. I dette eksempel antages IP-adressen 192.168.1.200 til TFTP-serveren.

4

I feltet Gensynkroniser periodisk skal du angive en lille værdi som test, f.eks. 30 sekunder.

5

Klik på Send alle ændringer.

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

6

Observer de resulterende meddelelser i systemlogsporet.

7

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

<Resync_On_Reset>Ja</Resync_On_Reset>
8

Genstart telefonen for at tvinge den til at gensynkronisere med klargøringsserveren.

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

9

(Valgfri) Angiv værdien i feltet Forsinkelse ved nyt forsøg efter gensynkroniseringsfejl til et lille tal, f.eks. 30.

<Resync_Error_Retry_Delay>30</Resync_Error_Retry_Delay>
10

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

Parametre for gensynkronisering af profiler

Følgende tabel definerer funktionen og brugen af parametre for gensynkronisering af profiler i sektionen Konfigurationsprofil under fanen Tale > 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 profiler

Parameter

Beskrivelse

Provision Enable (Aktivér klargøring)

Tillader eller afviser profilgensynkroniseringshandlinger.

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

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

  • Gå til telefonens webside, og indstil dette felt til Ja for at tillade gensynkroniseringshandling eller Nej for at blokere gensynkroniseringshandling.

Standard: ja

Resync On Reset (Gensynkronisering ved nulstilling)

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

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

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

  • Gå til telefonens webside, og indstil dette felt til Ja for at tillade gensynkronisering ved start eller nulstilling eller Nej for at blokere gensynkronisering ved start eller nulstilling.

Standard: ja

Resync Random Delay (Vilkårlig forsinkelse på gensynkronisering)

Forhindrer en overbelastning af klargøringsserveren, når et stort antal enheder tændes samtidigt og forsøger indledende konfiguration. Denne forsinkelse gælder kun ved det indledende konfigurationsforsøg, efter en enhed tændes eller nulstilles.

Parameteren er det maksimale tidsinterval, som enheden venter, før der oprettes kontakt med 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.

Gyldig værdi er i intervallet mellem 0 og 65535.

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

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

  • På telefonens webside skal du angive antallet af enheder (20 sekunder) for telefonen for at forsinke gensynkronisering efter start eller nulstilling.

Standardværdien er 2 (40 sekunder).

Resync At (HHmm) (Gensynkroniser kl. (TTmm))

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

Værdien for dette felt skal være et tal på fire cifre lige fra 0000 til 2400, der angiver tiden i TTmm-formatet. 0959 angiver f.eks. 09:59.

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

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

  • På telefonens webside skal du angive tidspunktet i TTMM-formatet for telefonen for at starte gensynkronisering.

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

Resync At Random Delay (Gensynkronisering ved vilkårlig 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 timerne og minutter, og timerne og minutter plus vilkårlig forsinkelse (ttmm, ttmm+random_delay (vilkårlig forsinkelse)). Hvis f.eks. den vilkårlige forsinkelse = (synkroniser igen ved vilkårlig forsinkelse + 30)/60 minutter, konverteres inputværdien i sekunder til minutter og afrundes til næste minut for at beregne det endelige vilkårlige forsinkelsesinterval.

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

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

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

Gyldig værdi er i intervallet mellem 600 og 65535.

Hvis værdien er mindre end 600, er den interne tilfældige forsinkelse mellem 0 og 600.

Standardværdien er 600 sekunder (10 minutter).

Resync Periodic (Gensynkroniser periodisk)

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

De gyldige formater er som følger:

  • Et heltal

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

  • Flere heltal

    Eksempel: Input af 600,1200,300 angiver, at den første gensynkronisering sker om 600 sekunder, den anden gensynkronisering sker 1200 sekunder efter den første, og den tredje gensynkronisering sker 300 sekunder efter den anden.

  • Et tidsinterval

    Et input på 2400+30 angiver, at den næste gensynkronisering sker mellem 2400 og 2430 sekunder efter en gennemført gensynkronisering.

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

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

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

Indstil denne parameter til nul for at deaktivere periodisk gensynkroniseringen.

Standardværdien er 3600 sekunder.

Resync Error Retry Delay (Forsinkelse ved nyt forsøg efter gensynkroniseringsfejl)

Hvis en gensynkronisering mislykkes, fordi telefonen ikke kunne hente en profil fra serveren, eller den downloadede fil er beskadiget, eller der sker 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 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, at det næste forsøg sker mellem 2400 og 2430 sekunder efter en mislykket gensynkronisering.

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

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

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

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

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

Forced Resync Delay (Tvungen forsinkelse på gensynkronisering)

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

Enheden gensynkroniserer igen, når en af dens telefonlinjer er aktiv. Da en gensynkronisering kan tage adskillige sekunder, er det bedst at vente, indstil enheden har været inaktiv i længere tid før gensynkronisering. Dette giver en bruger mulighed for at foretage opkald efter hinanden uden afbrydelse.

Enheden har en tidsindstilling, der begynder at tælle ned, når alle dens linjer bliver ledige. Denne parameter er startværdien for tælleren. Gensynkroniseringshændelser forsinkes, før denne tæller når nul.

Gyldig værdi er i intervallet mellem 0 og 65535.

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

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

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

Standardindstillingen er 14,400 sekunder.

Resync From SIP (Gensynkronisering fra SIP)

Styrer anmodninger om gensynkronisering 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 med XML (cfg.xml) skal du angive en streng i dette format:

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

  • På telefonens webside skal du vælge Ja for at aktivere funktionen eller Nej for at deaktivere den.

Standard: ja

Resync efter forsøg på opgradering (Synkroniser igen efter opgraderingsforsøg)

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

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

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

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

Standard: ja

Resync Trigger 1 (Udløser 1 af gensynkronisering)

Resync Trigger 2 (Udløser 2 af gensynkronisering)

Hvis den logiske ligning i disse parametre vurderes til at være FALSK, udløses gensynkronisering ikke, også selvom Gensynkronisering ved nulstilling er indstillet til SAND. Kun gensynkroniseringen via URL-adresse til direkte handling og SIP notify ignorerer disse gensynkroniseringsudløsere.

Parametrene kan programmeres med et betinget udtryk, der udsættes for en makroudvidelse. Hvis du ønsker gyldige makroudvidelser, skal du se Makroudvidelsesvariabler under Klargøringsparametre.

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

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

    <Resync_Trigger_2 ua="na"/>

  • Angiv udløserne telefonens webside.

Standard: tom

User Configurable Resync (Gensynkronisering, bruger kan konfigurere)

Giver en bruger mulighed for gensynkronisere telefonen via menuen på telefonskærmen. Når den er indstillet til Ja, kan en bruger gensynkronisere konfigurationen af telefonen ved at angive profilreglen fra telefonen. Når indstillingen er angivet til Nej, vises parameteren Profilregel ikke i menuen på telefonskærmen.

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

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

  • 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

Resync Fails On FNF (Gensynkronisering mislykkes ved FNF)

En gensynkronisering anses typisk for at være mislykket, hvis en anmodet profil ikke modtages fra serveren. Denne parameter tilsidesætter denne virkemåde. Når den er indstillet til Nej, accepterer enheden svaret fil ikke fundet fra serveren som en gennemført gensynkronisering.

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

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

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

Standard: ja

Profilgodkendelsestype

Angiver legitimationsoplysningerne, der bruges til godkendelse af profil konto. Du kan vælge:

  • Disabled: Deaktiverer profilkontofunktionen. Når funktionen er deaktiveret, vises skærmen Konfiguration af profilkonti ikke på telefonskærmen.

  • Grundlæggende HTTP-godkendelse: HTTP-logonoplysninger, der bruges til at godkende profilkontoen.

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

    • Når telefonens XSI-godkendelsestype er indstillet til Logonoplysninger, bruges XSI-logonoplysningerne.

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

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

    <Profile_Authentication_Type ua="na">Grundlæggende HTTP-godkendelse</Profile_Authentication_Type>

  • På telefonens webside skal du vælge en indstilling på liste. så telefonen kan godkende profilgensynkronisering.

Standard: Grundlæggende HTTP-godkendelse

Du kan finde flere oplysninger under Angiv profilgodkendelsestypen under Angiv telefonen til gensynkronisering af profil.

Profilregel

Profile Rule B (Profilregel B)

Profile Rule C (Profilregel C)

Profile Rule D (Profilregel D)

Hver profilregel giver telefonen besked om den kilde, der skal hentes en profil (konfigurationsfilen) fra. For hver gensynkronisering anvender telefonen alle profilerne i rækkefølge.

Hvis du anvender AES-256-CBC-kryptering til konfigurationsfilerne, skal du angive krypteringsnøglen med nøgleordet --key på følgende måde:

[--key <krypteringsnøgle>]

Nøglen kan eventuelt angives i dobbelte anførselstegn (").

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

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

    <Profile_Rule_B ua="na"/>

    <Profile_Rule_C ua="na"/>

    <Profile_Rule_D ua="na"/>

  • På telefons webside skal du angive profilreglen.

Standard: /$PSN.xml

DHCP Option To Use (DHCP-indstilling i brug)

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

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

DHCPv6 Option To Use (DHCPv6-indstilling i brug)

DHCP-indstillinger, adskilt med 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 med en SIP-meddelelsespakke eller en HTTP-post til telefonens CGI-grænseflade: http://telefon-IP-adresse/CGI/Execute.

CP-xxxx-3PCC udvider Cisco XML-funktionen for 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, hentes klargøringsfilen fra [profile-rule]. Denne regel bruger makroer til at forenkle installationen af programmet til XML-tjenester.

URL-fortolkning med makroudvidelse

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

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

  • En serverport, der ikke er standard, og som er angivet i URL-adressen ved hjælp af standardsyntaksen :port efter navnet på serveren.

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

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

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

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

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

Profile_Rule (Profilregel) har værdien:

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

Når enheden gensynkroniserer, og makroerne udvides, beder telefonen med MAC-adressen 000e08012345 om profilen med det navn, der indeholder enhedens MAC-adresse, på følgende webadresse:

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

Angiv typen af profilgodkendelse

Profilgodkendelse giver brugerne af telefonen mulighed for at synkronisere klargøringsprofilen på telefonen. Oplysningerne om godkendelse kræves, mens telefonen forsøger at synkronisere igen og hente konfigurationsfilen og får HTTP- eller HTTPS 401-fejlen. Når du aktiverer denne funktion, vises skærmen Konfiguration af profilkonti på telefonen i følgende situationer:

  • Når HTTP- eller HTTPs 401-godkendelsesfejlen forekommer under klargøring for første gang, når telefonen har genstartet

  • Når brugernavn og adgangskode for profilkonto er tomme

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

Hvis skærmen Konfiguration af profilkonti ikke besvares eller ignoreres, kan brugeren også få adgang til installationsskærmen via telefonens skærmmenu eller programtasterne til opsætning, der kun vises, når der ikke er registreret en linje på telefonen.

Når du deaktiverer funktionen, vises skærmen Konfiguration af profilkonti ikke på telefonen.

Brugernavnet og adgangskoden på skærmen Profilregel har højere prioritet end profilkontoen.

  • Når du indtaster 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 gennemføres godkendelsen. Med den forkerte profilkonto vil godkendelse mislykkes.

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

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

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

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

Du kan angive typen af profilgodkendelse fra telefonens administrationswebside.

1

Gå til websiden til telefonadministration

2

Vælg Tale > Klargøring.

3

Gå til sektionen Konfigurationsprofil, og indstil parameteren Type af profilgodkendelse for at angive de legitimationsoplysninger, der skal bruges til godkendelse af profilkonto.

Du kan konfigurere denne parameter i telefonkonfiguration-XML-fil (cfg.xml) ved at indtaste en streng i dette format:

<Profile_Authentication_Type ua="na">Disabled</Profile_Authentication_Type>

Indstillinger:

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

  • Grundlæggende HTTP-godkendelse: HTTP-logonoplysninger, der bruges til at godkende profilkontoen.

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

    Når telefonens XSI-godkendelsestype er indstillet til Logonoplysninger, bruges XSI-logonoplysningerne.

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

Standard: Grundlæggende HTTP-godkendelse

4

Klik på Send alle ændringer.

Anvend en profil manuelt på din telefon

Download konfigurationsfilen til telefonen fra en TFTP-Server

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

1

Slut computeren til telefonens LAN-port.

2

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

3

Gå til en webbrowser, angiv telefonens LAN-IP-adresse, IP-adressen på computeren, filnavnet og logonlegitimationsoplysningerne. Brug dette format:

http://<WAN_IP_Adresse>/admin/resync?tftp://<PC_IP_Address>/<filnavn>&xuser=admin&xpassword=<password>

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 hente konfigurationen til telefonen ved hjælp af cURL. Dette kommandolinjeværktøj bruges til at overføre data med en URL-syntaks. Du kan downloade cURL på:

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


 

Vi anbefaler, at du ikke bruger cURL til at sende konfigurationen til telefonen, da brugernavnet og adgangskoden måske kan blive opfanget under brug af cURL.

1

Slut computeren til telefonens LAN-port.

2

Download konfigurationsfil 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 XML-oprettelsesværktøjer til at kompilere parametrene og værdierne.


 
UTF-8 tegnsættet er det eneste, der understøttes. Hvis du ændrer profilen i en editor, må du ikke ændre kodeformat; ellers kan telefonen ikke genkende filen.

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

Open-profilformat

Open-formatprofilen 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 gensynkroniseringshandling uden kompilering som et binært objekt.

Telefonen kan acceptere konfigurationsformater, der oprettes af standardværktøjer. Denne funktion forenkler 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 sikret med 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-beregning

En konfigurationsfil kan indeholde disse komponenter:

  • Elementkoder

  • Attributter

  • Parametre

  • Formateringsfunktioner

  • XML-kommentarer

Eksempel: Åbn profilformat

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

Elementkoden <flat-profile> omslutter alle parameterelementer, som telefonen genkender.

Egenskaber for elementkoder

Vær opmærksom på følgende regler, når du opretter eller opdaterer konfigurationsfilen.

  • XML-klargøringsformatet og webbrugergrænseflade giver mulighed for konfiguration af de samme indstillinger. XML-mærkenavnene og feltnavnene i webbrugergrænsefladen ligner, men varierer på grund af begrænsninger i XML-elementnavne. F.eks. understregningstegn (_) i XML-konfigurationsfil i stedet for mellemrum i webbrugergrænsefladen.

  • Telefonen genkender elementer, der har de rigtige parameternavne, der er omsluttet af det særlige <flat-profile>-element.

  • Elementnavne sættes i vinkelparenteser.

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

    • Elementnavne kan ikke indeholde mellemrum eller specialtegn. For at aflede elementnavnet fra webfeltnavnet skal alle understregningstegning udskiftes med et mellemrumstegn eller specialtegnene [, ], (, ) eller /.

      Eksempel: Elementet <Resync_On_Reset> repræsenterer feltet Gensynkroniser ved nulstilling.

    • Hvert elementnavn skal være entydigt. På telefonens webbrugergrænseflade kan de samme felter vises på mange sider, f.eks. linje-, bruger og lokalnummersiderne. Føj [n] til elementnavnet for at angive det nummer, der er vist under sidefanen.

      Eksempel: Elementet <Dial_Plan_1_> repræsenterer Opkaldsplan for linje 1.

  • Hver åbningskode for element skal have et matchende lukningskode for element. For eksempel:

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

  • Der skelnes mellem store og små bogstaver i elementkoder.

  • Tomme elementkoder er tilladte og fortolkes, som at værdien konfigureres som tom. Angiv åbningskoden for elementet uden en tilsvarende elementkode, og indsæt et mellemrumstegn og en skråstreg før den afsluttende vinkelparentes (>). I dette eksempel er Profile Rule B (Profilregel B) tom:

    <Profile_Rule_B />

  • En tom elementkode kan bruges til at forhindre, at overskrivning af værdier, som brugeren måtte have angivet, under en gensynkroniseringshandling. I det følgende eksempel er brugerindstillingerne for hurtigopkald uændret:

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

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

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

  • Elementnavne, der ikke genkendes, ignoreres.

Parameteregenskaber

Disse egenskaber gælder for parametrene:

  • De parametre, der ikke er angivet af en profil, ændres ikke på telefonen.

  • Parametre, der ikke kan genkendes, ignoreres.

  • Hvis profilen i Open-format indeholder flere forekomster af den samme parameterkode, tilsidesætter den sidste af en sådan forekomst eventuelle tidligere forekomster. For at undgå ved et uheld at tilsidesætte konfigurationsværdier for en parameter anbefaler vi, at hver profil angiver mindst én forekomst af en parameter.

  • Den sidste profil, der er behandlet, får forrang. Hvis flere profiler angiver den samme konfigurationsparameter, får værdien af den sidste profil forrang.

Strengformater

Disse egenskaber gælder for formateringen af strengene:

  • Kommentarer, der er tilladt via standard-XML-syntaks.

    <!-- Min kommentar indtastes her -->

  • Blanktegn før og efter er tilladt for at øge læsbarheden, men fjernes fra parameterværdien.

  • Nye linjer i en værdi konverteres til mellemrum.

  • En XML-header i formatet <? ?> er tilladt, men det ignoreres af telefonen.

  • Brug grundlæggende XML-tegn-escapes, hvis du vil bruge specialtegn. Det er vist i følgende tabel.

    Specialtegn

    Sekvens af XML-escape

    & (ampersand)

    &amp;

    < (mindre end)

    &lt;

    > (større end)

    &gt;

    ' (apostrof)

    &apos;

    ” (dobbelt anførselstegn)

    &quot;

    I følgende eksempel indtastes tegn-escapes for at repræsentere symboler for større end og mindre end, der kræves i en opkaldsplanregel. Dette eksempel definerer en opkaldsplan for informationshotline, der indstiller parameteren <Dial_Plan_1_> (Administratorlogon > Avanceret > Tale > Lokalnr. (n)) til at være lig med (S0 <:18005551212>).

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

  • Escapes for numeriske tegn ved brug af decimal-og hexadecimalværdier (f.eks. &#40; og &#x2e;) konverteres.

  • 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 kræves ikke, men den skal ske før kryptering.

Komprimering af Open-profil

Den understøttede komprimeringsmetode er en gzip-deflate-algoritme (RFC1951). Hjælpeværktøjet gzip og komprimeringsbiblioteket, der implementerer den samme algoritme (zlib), er tilgængelige på 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 i den oprindelige Open-profil genererer headeren. Telefonen undersøger den downloadede filheader for at bestemme filformatet.

Hvis f.eks. profile.xml 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

    Lader den oprindelige fil være på placeringen og producerer ny komprimeret fil.

Kryptering af Open-profil

Symmetrisk nøglekryptering kan bruges til at kryptere en Open-konfigurationsprofil, uanset om filen er komprimeret eller ej. Hvis der anvendes komprimering, skal det gøres før krypteringen.

Klargøringsserveren bruger HTTPS til at håndtere den indledende klargøring af telefonen efter installation. Hvis konfigurationsprofilerne forhåndskrypteres, kan du efterfølgende bruge HTTP til at synkronisere profilerne. 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-beregning

Nøglen eller IKM (Input Keying Material) skal allerede være klargjort 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 med filtypenavnet .cfg vil som regel indikere, at det er en konfigurationsprofil.

AES-256-CBC-kryptering

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

Værktøjet til OpenSSL-krypteringsværktøjet, der kan hentes forskellige steder på internettet, kan udføre kryptering. Understøttelse af AES 256-bit-kryptering kan kræve ny kompilering af værktøjet for at aktivere AES-koden. Firmwaren er blevet testet i forhold til version openssl-1.1.1d.

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

 # eksempel krypteringsnøgle = SecretPhrase1234 openssl enc –e –aes-256-cbc –k SecretPhrase1234 –in profile.xml –out profile.cfg # analog påkaldelse for en komprimeret xml-fil openssl enc –e –aes-256-cbc –k SecretPhrase1234 –in profile.xml.gz –out profile.cfg

Et -k med små bogstaver kommer før den hemmelige nøgle, som kan være en almindelig tekst, og som bruges til at generere en vilkårlig 64-bit salt. Når den hemmelige del er angivet med argumentet -k, afleder krypteringsværktøjet en vilkårlig 128-bit startvektor og den faktiske 256-bit krypteringsnøgle.

Når denne form for kryptering bruges i en konfigurationsprofil, skal telefonen oplyses om den hemmelige nøgleværdi for at kunne dekryptere filen. Denne værdi er angivet som en kvalifikator i profilens URL-adresse. Syntaksen er som følger, hvor der bruges en eksplicit URL-adresse:

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

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

Makroudvidelse

Flere klargøringsparametre bliver udsat for en makroudvidelse internt, før de bliver evalueret. Dette forhåndsevalueringstrin giver større fleksibilitet i forhold til at styre aktiviteterne med telefonens gensynkronisering og opgradering.

Disse parametergrupper udsættes for en makroudvidelse før evaluering:

  • Resync_Trigger_* (Udløser 1 af gensynkronisering_*)

  • Profile_Rule* (Profilregel*)

  • Log_xxx_Msg (Meddelelse om log xxx)

  • Opgraderingsregel

Under visse omstændigheder gennemgår nogle generelle parametre (GPP_*) også makroudvidelse, som det udtrykkeligt er angivet i afsnittet Valgfrie gensynkroniseringsargumenter nedenfor.

Under en makroudvidelse udskiftes indholdet af de navngivne variable udtrykkene for formen $NAME og $(NAME). Disse variabler omfatter parametre for generelle formål, flere produkt-id'er, visse hændelsestidsindstillinger og værdier for klargøringstilstand. Du kan se en komplet liste under Makroudvidelsesvariabler under Klargøringsparametre.

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

Administratoren angiver: $(MAU)config.cfg

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

Hvis et makronavn ikke genkendes, sker der ikke en udvidelse. Navnet STRANGE genkendes f.eks. ikke som et gyldig makronavn, mens MAU genkendes som et gyldigt makronavn.

Administratoren angiver: $STRANGE$MAU.cfg

Den resulterende makroudvidelse for en enhed med MAC-adressen 000E08012345 er: $STRANGE000E08012345.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, knyttes til makroudtrykkene $SA til og med $SD. Disse parametre bliver kun makroudvidet som argumentet for indstillingerne --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, der er adskilt af med operatoren og. Alle sammenligninger skal være opfyldt, hvis betingelsen skal være sand.

Hver enkelt sammenligning relatere til en af følgende tre typer konstanter:

  • Heltalsværdier

  • Software- eller hardwareversionsnumre

  • Streng med dobbelte anførselstegn

Versionsnumre

Softwareversionen for Cisco-videotelefon 8875 bruger dette format (hvor BN er buildnummeret):

PHONEOSyyyy.1-0-1-0001-BN

hvor yyyy angiver telefonmodellen eller telefonserien; 1 er den overordnede version; 0 er den underordnede version; 1-0001 er mikroversionen, og BN er buildnummeret.

Den sammenlignende streng skal bruge det samme format. Ellers vil det resultere i en fejl ved parsing af format.

Når du sammenligner softwareversionen, sammenlignes den overordnede version, den underordnede version og mikroversionen i rækkefølge, og tallene længst til venstre har forrang i forhold til de tilsidstnævnte. Når versionsnummeret er identiske, sammenlignes buildnummeret.

Eksempler på gyldigt versionsnummer

PHONEOS-8875.1-0-1-0001-19

Sammenligning

Strenge i anførselstegn kan sammenlignes for lighed eller ulighed. Heltal og versionsnumre kan også sammenlignes regnemæssigt. Sammenligningsoperatorerne kan udtrykkes som symboler eller akronymer. Akronymer er praktiske til at udtrykke betingelsen i en Open-formatprofil.

Operatør

Alternativ syntaks

Beskrivelse

Gælder for heltal og versionsoperander

Gælder for operander til strenge i anførselstegn

=

eq

lig med

Ja

Ja

!=

ne

ikke lig med

Ja

Ja

<

lt

mindre end

Ja

Nej

<=

le

mindre end eller lig med

Ja

Nej

>

gt

større end

Ja

Nej

>=

ge

større end eller lig med

Ja

Nej

OG

og

Ja

Ja

Det er vigtigt at sætte makrovariabler i dobbelte anførselstegn, hvis der forventes en strengkonstant. Hvis det ikke sker, forventes et tal eller versionsnummer.

Når betingede udtryk bruges sammen med parametrene Profile_Rule* (Profilregel*) og Upgrade_Rule (Opgraderingsregel), skal der sættes anførselstegn om betingede udtryk med syntaksen "(expr)?" som i dette eksempel på en opgraderingsregel. Husk at erstatte BN med buildnummeret på din firmwarefil, der skal opgraderes 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 forudgående syntaks med parenteser til at konfigurere parametrene Resync_Trigger_ * (Gensynkroniseringsudløser).

URL-syntaks

Brug standard-URL-syntaksen til at angive, hvordan du henter konfigurationsfiler og firmware henholdsvis i parametrene Profile_Rule* (Profilregel) og Upgrade_Rule (Opgraderingsregel). Syntaksen er som følger:

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

Hvor skema er en af disse værdier:

  • tftp

  • http

  • https

Hvis skema er udeladt, 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).


 

Når det gælder opgraderingsregler, skal serveren angives.

Hvis port mangler, bruges standardporten for det angivne skema. Tftp anvender UDP-port 69, http bruger TCP-port 80, https anvender 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 hentes 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 tom syntaks ikke af opgraderingsreglerne. Dette gælder kun for profilregel*.

RFC 8188-baseret kryptering af HTTP-indhold

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

XML-konfigurationsparameteren IKM_HTTP_Encrypt_Content indeholder IKM på telefonen. Denne parameter er af sikkerhedsmæssige årsager ikke tilgængelig på websiden til administration af telefonen. Den kan heller ikke ses i telefonens konfigurationsfil, som du kan få adgang til fra telefonens IP-adresse, eller fra telefonens konfigurationsrapporter, som 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 sikre, at HTTP-headeren Content-Encoding i konfigurationsfilen er aes128gcm.

    Hvis headeren ikke findes, får metoden AES-256-CBC førsteprioritet. Telefonen anvender AES-256-CBC-kryptering, hvis der findes en AES-256-CBC-nøgle i en profilregel, uafhængigt af IKM.

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

Valgfri argumenter til gensynkronisering

Valgfri argumenter, key, uid og pwd, kan komme før de URL-adresser, der er angivet i parameteren Profile_Rule*, der samlet er omsluttet af kantede parenteser.

Nøgle

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

Eksempler på brug
[--key VerySecretValue][--key “my secret phrase”][--key a37d2fb9055c1d04883a0745eb0917a4]

De valgfri argumenter i kantede parenteser er makroudvidet. Parametrene for specielle formål GPP_SA til og med GPP_SD er kun makroudvidede ind i makrovariabler $SA til og med $SD, når de bruges som nøgleindstillingsargumenter. Se disse eksempler:

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

I åbne formatprofiler skal argumentet til --key skal være det samme som argumentet til den indstilling -k, der er givet til openssl.

uid og pwd

Indstillingerne 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. De valgfri argumenter i kantede parenteser er makroudvidet. Parametrene for specielle formål GPP_SA til og med GPP_SD er kun makroudvidede ind i makrovariabler $SA til og med $SD, når de bruges som nøgleindstillingsargumenter. Se disse eksempler:

GPP_SA = MyUserID GPP_SB = MySecretPassword

[--uid $SA --pwd $SB] https://klargøringsserver_url/stil_til_din_konfig/din_Konfig.xml

ville derefter blive udvidet til:

[--uid MyUserID --pwdMySecretPassword] https://klargøringsserver_url/stil_til_din_konfig/din_konfig.xml

Datatyper

Følgende datatyper anvendes med konfigurationsprofilparametre:

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

  • Boolesk – boolesk værdi med enten "ja" eller "nej".

  • CadScript – et miniscript, der angiver kadanceparametrene 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 kaldes en sektion.

    • oni,j og offi,j er til/fra-varigheden i sekunder af et segment. i = 1 eller 2 og j = 1 til 6.

    • Di er den samlede varighed af sektionen i sekunder.

    Alle varigheder kan have op til tre decimaler for at give trin på 1 ms. Jokertegnet "*" betyder tidsubegrænset varighed. Segmenter i en sektion afspilles i rækkefølge og gentages, indtil den samlede varighed er blevet afspillet.

    Eksempel 1:

     60(2/4) Antal kadencesektioner = 1 Kadence Sektion 1: Sektionslængde = 60 s Antal segmenter = 1 Segment 1: Til=2s, Off =4s Samlet ringlængde = 60s

    Eksempel 2 – karakteristisk ringetone (kort,kort,kort,lang):

     60(.2/.2,.2/.2,.2/.2,1/4) Antal kadenceafsnit = 1 Kadence Sektion 1: Sektionslængde = 60'ere Antal segmenter = 4 Segment 1: Til = 0,2 sek., Fra = 0,2 sek. Segment 2: Til = 0,2 sek., Fra = 0,2 sek. Segment 3: Til = 0,2 sek., Fra = 0,2 s Segment 4: Til = 1,0 sek., Fra = 4,0 sek. Samlet ringlængde = 60 s

  • DialPlanScript – scriptingsyntaks, der bruges til at angive opkaldsplanerne Linje 1 og Linje 2.

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

  • FQDN – fuldt kvalificeret domænenavn. Den kan indeholde op til 63 tegn. Der er følgende eksempler:

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

    • sip.Cisco.com eller 109.12.14.12

  • FreqScript – et miniscript, som 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 heltal uden fortegn).

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

    Mellemrum før og efter et komma 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 – ringetone:

     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 med komma (,). Mellemrum i begyndelsen af hvert mønster ignoreres. "?" og "*" repræsenterer jokertegn. Brug % xx til at repræsentere konstanter. %2a repræsenterer f.eks. *. 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 firmwareopgraderinger.

  • PwrLevel – strømniveau udtrykt i dBm med en decimal, f.eks. -13,5 eller 1,5 (dBm).

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

  • Sig<n> – n-bitværdi med fortegn. Det kan angives i decimal- eller hex-format. Et "-"-tegn skal stå før negative værdier. Et +-tegn kan sættes før positive værdier.

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

  • Str<n> – en generisk streng med op til n ikke-reserverede tegn.

  • Time<n> – tidsvarighed i sekunder, med op til n decimalpladser. Ekstra angivne decimaler ignoreres.

  • ToneScript – et miniscript, der angiver frekvens, niveau og kadenceparametrene for en tone i et igangværende opkald. Script kan indeholde op til 127 tegn.

    Syntaks: FreqScript;Z1[;Z2].

    Z1-sektionen svarer til S1-sektionen i et CadScript, med undtagelse af 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 det FreqScript, der bruges i dette segment.

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

    Eksempel 1 – ringetone:

     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 kadencesektioner = 1 kadence Sektion 1: Sektionslængde = 10 s Antal segmenter = 1 Segment 1: Til = for evigt, med frekvenserne 1 og 2 Samlet tonelængde = 10s

    Eksempel 2 – hakkende 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 kadencesektioner = 2 Kadence Sektion 1: Sektionslængde = 2s Antal segmenter = 1 Segment 1: Til = 0,1s, Off = 0,1s med frekvens 1 og 2 Kadence Sektion 2: Sektionslængde = 10s Antal segmenter = 1 Segment 1: Til=for evigt, med frekvenserne 1 og 2 Samlet tonelængde = 12s

  • Uns<n> – n-bit-værdi uden fortegn, hvor n = 8, 16 eller 32. Den kan angives i decimal-eller HEX-format, som f. eks. 12 eller 0x18, hvis værdien kan være på n-bit.


 

Overvej disse:

  • <Par Name> repræsenterer et konfigurationsparameter navn. I en profil er den tilsvarende kode dannet ved at erstatte pladsen med et understregningstegn "_", f.eks. Par_Name.
  • Et tomt standardværdifeltet indebærer en tom streng < "" >.
  • Telefonen fortsætter med at bruge de sidste konfigurerede værdier for koder, der ikke findes i en bestemt profil.
  • Skabeloner sammenlignes i den angivne rækkefølge. Det første, ikke tætteste, match vælges. Parameternavnet skal matche helt nøjagtigt.
  • Hvis der er angivet mere end én definition for en parameter i en profil, vil en sådan sidste definition i filen være den, der aktiveres på telefonen.
  • En parameterspecifikation med en tom parameterværdi tvinger parameteren tilbage til dens standardværdi. For i stedet at angive en tom streng skal du bruge en tom streng "" som parameterværdien.