- Start
- /
- Artikel
Konfigurera profilinställningar för 9800-serien och 8875-telefoner (BroadWorks)
Den här hjälpartikeln är för Cisco Desk Phone 9800-serien och Cisco Video Phone 8875 registrerade på Cisco BroadWorks. Informationen på den här sidan inkluderar profilsynkronisering, manuell tillämpning av profil, och konfigurationssyntax.
Konfigurera din telefon för profilsynkronisering
Synkronisera telefonprofilen igen via TFTP
Telefonen stöder flera nätverksprotokoll för att hämta konfigurationsprofiler. Det mest grundläggande protokollet för profilöverföring är TFTP (RFC1350). TFTP används ofta för tillhandahållande av nätverksenheter inom privata LAN-nätverk. Även om TFTP inte rekommenderas för distribution av fjärrslutpunkter över Internet, kan TFTP vara praktiskt för distribution inom små organisationer, för intern preprovisionering och för utveckling och testning. I följande procedur ändras en profil efter nedladdning av en fil från en TFTP-server.
| 1 |
Anslut datorn och telefonen till ett nav, switch eller liten router i en LAN-miljö. |
| 2 |
Installera och aktivera en TFTP-server på datorn. |
| 3 |
Använd en textredigerare för att skapa en konfigurationsprofil. För att verifiera om profilen har etablerats till din telefon senare kan du ange några av värdena som markeringar. Ange till exempel värdet för GPP_A till 12345678 som visas i följande exempel:
|
| 4 |
Spara XML-konfigurationsfilen i rotkatalogen på TFTP-servern. Du kan kontrollera att TFTP-servern är korrekt konfigurerad: begär konfigurationsprofilfilen med hjälp av en annan TFTP-klient än telefonen. Använd helst en TFTP-klient som körs på en separat värd från provisioneringsservern. |
| 5 |
Öppna administrationswebbsidan i webbläsaren på din dator. Antag till exempel att telefonens IP-adress är 192.168.1.100, öppna följande URL i din webbläsare:
|
| 6 |
Välj fliken och kontrollera värdena för de allmänna parametrarna GPP_A till GPP_P. Dessa borde vara tomma. |
| 7 |
Synkronisera testtelefonen igen till konfigurationsprofilen som du skapade genom att öppna resync-webbadressen i en webbläsare. Exempel: Om TFTP-serverns IP-adress är 192.168.1.200 bör kommandot likna följande exempel:
När telefonen tar emot det här kommandot begär enheten på adressen 192.168.1.100 konfigurationsprofilfilen |
| 8 |
Kontrollera att parametern uppdaterades korrekt. Uppdatera administrationswebbsidan och gå till . Parametern GPP_A ska nu innehålla värdet 12345678. |
Skapa en telefonspecifik profil på en TFTP-server
| 1 |
Hämta telefonens MAC-adress från produktetiketten. (MAC-adressen är numret, med siffror och gemener hexsiffror, till exempel 000e08aabbcc. |
| 2 |
Byt namn på konfigurationsfilen till Exempel:
|
| 3 |
Flytta den nya filen till den virtuella rotkatalogen på TFTP-servern. |
| 4 |
Gå till webbsidan för telefonadministration. |
| 5 |
Välj |
| 6 |
Ange sökvägen till profilfilen i fältet Profilregel. Exempel: Antag att TFTP-serverns IP-adress är 192.168.1.200 och profilfilnamnet är
|
| 7 |
Klicka på Skicka alla ändringar. Detta orsakar en omedelbar omstart och omsynkronisering. När nästa omsynkronisering sker hämtar telefonen den nya filen genom att expandera makrouttrycket $MA till sin MAC-adress. |
Synkronisera telefonprofilen igen med HTTP GET
| 1 |
Installera en HTTP-server på den lokala datorn eller annan tillgänglig värd. Apache-servern med öppen källkod kan laddas ner från internet. |
| 2 |
Ladda upp konfigurationsprofilfilen till den virtuella rotkatalogen på den installerade servern. |
| 3 |
För att verifiera korrekt serverinstallation och åtkomst till profilfilen, öppna profilen med en webbläsare. |
| 4 |
Ändra profilregeln för testtelefonen så att den pekar på HTTP-servern i stället för TFTP-servern, så att profilen hämtas regelbundet. Om du till exempel antar att HTTP-servern är på 192.168.1.300 och profilfilnamnet är basic.txt anger du följande värde:
|
| 5 |
Klicka på Skicka alla ändringar. Detta orsakar en omedelbar omstart och omsynkronisering. |
| 6 |
Observera syslog-meddelanden som telefonen skickar. De periodiska omsynkroniseringarna bör nu hämta profilen från HTTP-servern. |
| 7 |
I HTTP-serverloggarna kan du observera hur information som identifierar testtelefonen visas i loggen för användaragenter. Denna information bör innehålla tillverkaren, produktnamnet, aktuell firmwareversion och serienummer. |
Synkronisera telefonprofilen automatiskt
En enhet kan synkronisera om med jämna mellanrum till etableringsservern för att säkerställa att alla profiländringar som gjorts på servern sprids till slutpunktsenheten (i motsats till att skicka en uttrycklig begäran om återsynkronisering till slutpunkten).
För att få telefonen att synkronisera om med en server med jämna mellanrum definieras en URL för konfigurationsprofil med parametern Profile_Rule och en återsynkroniseringsperiod definieras med hjälp av parametern Resync_Periodic.
| 1 |
Gå till webbsidan för telefonadministration. |
| 2 |
Välj |
| 3 |
Definiera parametern Profile_Rule. I det här exemplet antas en TFTP-serverns IP-adress på 192.168.1.200. |
| 4 |
I fältet Återsynkronisera periodisk anger du ett litet värde för testning, till exempel 30 sekunder. |
| 5 |
Klicka på Skicka alla ändringar. Med de nya parameterinställningarna synkroniseras telefonen två gånger i minuten till den konfigurationsfil som URL:en anger. |
| 6 |
Observera de resulterande meddelandena i syslog-spårningen. |
| 7 |
Kontrollera att fältet Synkronisera vid återställning är inställt på Ja.
|
| 8 |
Slå av telefonen för att tvinga den att synkronisera igen med provisioneringsservern. Om återsynkroniseringsåtgärden misslyckas av någon anledning, till exempel om servern inte svarar, väntar enheten (i det antal sekunder som konfigurerats i Återsynkroniseringsfelförsöksfördröjning) innan den försöker synkronisera igen. Om återsynkroniseringsfel Återförsöksfördröjning är noll försöker telefonen inte synkronisera om efter ett misslyckat återsynkroniseringsförsök. |
| 9 |
(Valfritt) Ställ in värdet för fältet Åter synkroniseringsfel Fördröjning för försök igen till ett litet tal, till exempel 30.
|
| 10 |
Inaktivera TFTP-servern och observera resultaten i syslog-utdata. |
Parametrar för återsynkronisering av profil
Följande tabell definierar funktionen och användningen av parametrarna för återsynkronisering av profiler i avsnittet Konfigurationsprofil under fliken Röst telefonens webbsida. Den definierar också syntaxen för strängen som läggs till i telefonkonfigurationsfilen (cfg.xml) med XML-kod för att konfigurera en parameter.
|
Parameter |
Beskrivning |
|---|---|
|
Aktivera tillhandahållande |
Tillåter eller nekar återsynkroniseringsåtgärder för konfigurationsprofil.
Standard: Ja |
|
Synkronisera igen vid återställning |
Anger om telefonen synkroniserar konfigurationer igen med etableringsservern efter uppstart och efter varje uppgraderingsförsök.
Standard: Ja |
|
Återsynkronisera slumpmässig fördröjning |
Förhindrar en överbelastning av provisioneringsservern när ett stort antal enheter slås på samtidigt och försöker konfigurera den första. Denna fördröjning gäller endast vid det första konfigurationsförsöket, efter att en enhet har slagits på eller återställts. Parametern är det maximala tidsintervall som enheten väntar innan den tar kontakt med etableringsservern. Den faktiska fördröjningen är ett pseudoslumpmässigt tal mellan 0 och detta värde. Denna parameter är i enheter på 20 sekunder. Det giltiga värdet ligger mellan 0 och 65535.
Standardvärdet är 2 (40 sekunder). |
|
Synkronisera igen vid (HHmm) |
Tiden (HHmm) som telefonen synkroniserar igen med provisioneringsservern. Värdet för detta fält måste vara ett fyrsiffrigt tal som sträcker sig från 0000 till 2400 för att indikera tiden i HHmm-format. Till exempel indikerar 0959 09:59.
Standardvärdet är tomt. Om värdet är ogiltigt ignoreras parametern. Om parametern är inställd med ett giltigt värde ignoreras parametern Resync Perio dic. |
|
Synkronisera igen vid slumpmässig fördröjning |
Förhindrar en överbelastning av provisioneringsservern när ett stort antal enheter slås på samtidigt. För att undvika översvämning av omsynkroniseringsförfrågningar till servern från flera telefoner synkroniseras telefonen om i intervallet mellan timmar och minuter och timmar och minuter plus slumpmässig fördröjning (hhmm, hhmm+random_delay). Till exempel, om den slumpmässiga fördröjningen = (Återsynkronisera vid slumpmässig fördröjning + 30) /60 minuter, omvandlas ingångsvärdet i sekunder till minuter, avrundas upp till nästa minut för att beräkna det slutliga random_delay intervallet.
Det giltiga värdet varierar mellan 600 och 65535. Om värdet är mindre än 600 är den slumpmässiga interna fördröjningen mellan 0 och 600. Standardvärdet är 600 sekunder (10 minuter). |
|
Återsynkronisera periodisk |
Tidsintervallet mellan periodisk återsynkronisering med provisioneringsservern. Den tillhörande återsynkroniseringstimern är aktiv först efter den första lyckade synkroniseringen med servern. De giltiga formaten är följande:
Ställ in den här parametern till noll för att inaktivera periodisk återsynkronisering. Standardvärdet är 3600 sekunder. |
|
Återsynkroniseringsfel Fördröjning för försök igen |
Om en återsynkronisering misslyckas på grund av att telefonen inte kunde hämta en profil från servern, eller den nedladdade filen är skadad eller ett internt fel uppstår, försöker telefonen synkronisera igen efter en tid som anges i sekunder. De giltiga formaten är följande:
Om fördröjningen är inställd på 0 försöker enheten inte synkronisera igen efter ett misslyckat återsynkroniseringsförsök.
Standard: 60,120,240,480,960,1920,3840,7680,15360,30720,61440,86400 |
|
Tvingad återsynkroniseringsfördröjning |
Maximal fördröjning (i sekunder) telefonen väntar innan en återsynkronisering utförs. Enheten synkroniseras inte igen medan en av dess telefonlinjer är aktiv. Eftersom en omsynkronisering kan ta flera sekunder är det önskvärt att vänta tills enheten har varit inaktiv under en längre period innan den synkroniseras igen. Detta gör det möjligt för en användare att ringa samtal i följd utan avbrott. Enheten har en timer som börjar räkna ner när alla dess linjer blir inaktiva. Denna parameter är räknarens initiala värde. Återsynkroniseringshändelser försenas tills denna räknare minskar till noll. Det giltiga värdet ligger mellan 0 och 65535.
Standardvärdet är 14 400 sekunder. |
|
Återsynkronisera från SIP |
Styr begäranden om återsynkronisering via en SIP NOTIFY-händelse som skickas från tjänsteleverantörens proxyserver till telefonen. Om aktiverat kan proxyservern begära en omsynkronisering genom att skicka ett SIP NOTIFY-meddelande som innehåller Event: resync-rubriken till enheten.
Standard: Ja |
|
Synkronisera igen efter uppgraderingsförsök |
Aktiverar eller inaktiverar återsynkroniseringsåtgärden efter en uppgradering. Om Ja är markerat aktiveras synkroniseringen efter en uppgradering av den inbyggda programvaran.
Standard: Ja |
|
Återsynkronisera utlösare 1 Återsynkronisera utlösare 2 |
Om den logiska ekvationen i dessa parametrar utvärderas till FALSE utlöses inte återsynkronisering även när Resync On Reset är inställt på SANT. Endast resync via direkthandlings-URL och SIP-meddelande ignorerar dessa återsynkroniseringsutlösare. Parametrarna kan programmeras med ett villkorligt uttryck som genomgår makroexpansion. För giltiga makroutvidgningar, se Variabler för makroexpansion under Tillhandah ål lande parametrar.
Standard: Tom |
|
Användarkonfigurerbar återsynkronisering |
Tillåter en användare att synkronisera telefonen igen från telefonens skärmmeny. När inställt på Ja kan en användare synkronisera telefonkonfigurationen igen genom att ange profilregeln från telefonen. När inställt på Nej visas inte parametern Profilregel på telefonens skärmmeny.
Standard: Ja |
|
Resync misslyckas på FNF |
En omsynkronisering anses vanligtvis vara misslyckad om en begärd profil inte tas emot från servern. Den här parametern åsidosätter detta beteende. När den är inst äl ld på Nej accepterar enheten ett svar som
Standard: Ja |
|
Typ av profilautentisering |
Anger autentiseringsuppgifter som ska användas för autentisering av profilkonton. De tillgängliga alternativen är:
Standard: Grundläggande HTTP-autentisering Mer information finns i Ange profilautentiseringstyp under Ange telefonen för profilsynkronisering. |
|
Profilregel Profilregel B Profilregel C Profilregel D |
Varje profilregel informerar telefonen om en källa från vilken en profil ska hämtas (konfigurationsfil). Under varje återsynkronisering tillämpar telefonen alla profiler i följd.
Du kan bifoga krypteringsnyckeln med dubbla citattecken (”) valfritt.
Standard: |
|
DHCP-alternativ att använda |
DHCP-alternativ, avgränsade med kommatecken, används för att hämta firmware och profiler. Standard: 66,160,159,150,60,43,125 |
|
DHCPv6 Alternativ att använda |
DHCP-alternativ, avgränsade med kommatecken, används för att hämta firmware och profiler. Standard: 17,160,159 |
Tillhandahållande via Cisco XML
Du kan tillhandahålla telefoner via Cisco XML-funktioner.
Du kan skicka ett XML-objekt till telefonen med ett SIP Notificy-paket eller en HTTP-post till telefonens CGI-gränssnitt: http://PhoneIPAddress/CGI/Execute.
CP-xxxx-3PCC utökar Cisco XML-funktionen för att stödja provisionering via ett XML-objekt:
<CP-xxxx-3PCCExecute>
<ExecuteItem URL=Resync:[profile-rule]/>
</CP-xxxx-3PCCExecute>
När telefonen har tagit emot XML-objektet hämtas provisioneringsfilen från [profilregel]. Denna regel använder makron för att förenkla utvecklingen av XML-tjänstprogrammet.
URL-upplösning med makroexpansion
Underkataloger med flera profiler på servern ger en bekväm metod för att hantera ett stort antal distribuerade enheter. Profilens URL kan innehålla:
-
Ett etableringsservernamn eller en uttrycklig IP-adress. Om profilen identifierar etableringsservern efter namn utför telefonen en DNS-sökning för att lösa namnet.
-
En serverport som inte är standard som anges i webbadressen med hjälp av standardsyntax:port
efterservernamnet. -
Underkatalogen till serverns virtuella rotkatalog där profilen lagras, specificerad med hjälp av standard URL-notation och hanteras av makroexpansion.
Följande Profil_Rule begär till exempel profilfilen ($PN.cfg) i serverns underkatalog /cisco/config från TFTP-servern som körs på host prov.telco .com och lyssnar efter en anslutning på port 6900:
<Profile_Rule>
tftp://prov.telco.com:6900/cisco/config/$PN.cfg
</Profile_Rule>
En profil för varje telefon kan identifieras i en parameter för allmänt ändamål, med dess värde hänvisat till inom en gemensam profilregel genom att använda makroexpansion.
Antag till exempel att GPP_B definieras som Dj6Lmp23Q.
Profile_Rule har värdet:
tftp://prov.telco.com/cisco/$B/$MA.cfg
När enheten synkroniseras igen och makron expanderas begär telefonen med MAC-adressen 000e08012345 profilen med namnet som innehåller enhetens MAC-adress på följande URL:
tftp://prov.telco.com/cisco/Dj6Lmp23Q/000e08012345.cfg
Ange profilautentiseringstyp
Profilautentisering gör det möjligt för telefonanvändare att synkronisera provisioneringsprofilen på telefonen igen. Autentiseringsinformation krävs när telefonen försöker synkronisera och hämta konfigurationsfilen för första gången och får ett HTTP- eller HTTPS 401-autentiseringsfel. När du aktiverar den här funktionen visas skärmen Konfiguration av profilkonto på telefonen i följande situationer:
-
När HTTP- eller HTTPs 401-autentiseringsfelet inträffar vid första etablering efter att telefonen startas om
-
När användarnamnet och lösenordet för profilkontot är tomma
-
När det inte finns något användarnamn och lösenord i profilregeln
Om inställningsskärmen för profilkonto saknas eller ignoreras kan användaren också komma åt inställningsskärmen via telefonens skärmmeny eller programknappen Inställning, som bara visas när ingen linje på telefonen är registrerad.
När du inaktiverar funktionen visas inte inställningsskärmen för profilkonto på telefonen.
Användarnamnet och lösenordet i fältet Profilregel har högre prioritet än profilkontot.
-
När du anger en korrekt URL i fältet Profilregel utan användarnamn och lösenord kräver telefonen autentisering eller sammanfattning för att synkronisera profilen igen. Med rätt profilkonto passerar autentiseringen. Med ett felaktigt profilkonto misslyckas autentiseringen.
-
När du anger en korrekt URL i fältet Profilregel med rätt användarnamn och lösenord, telefonen kräver autentisering eller sammanfattning för att synkronisera profilen igen. Profilkontot används inte för telefonsynkronisering. Inloggningen är framgångsrik.
-
När du anger en korrekt URL i fältet Profilregel med ett felaktigt användarnamn och lösenord, telefonen kräver autentisering eller sammanfattning för att synkronisera profilen igen. Profilkontot används inte för omsynkronisering av telefonen. Inloggningen misslyckas alltid.
-
När du anger en felaktig URL i fältet Profilregel misslyckas inloggningen alltid.
Du kan också konfigurera parametrarna i telefonkonfigurationsfilen med XML (cfg.xml) kod.
Du kan ange profilautentiseringstypen från webbsidan för telefonadministration.
| 1 |
Gå till webbsidan för telefonadministration. |
| 2 |
Välj |
| 3 |
Ange parametern Typ av profilautentisering i avsnittet Konfigurations profil för att ange de autenti seringsuppgifter som ska användas för profilkontoautentisering. Du kan konfigurera den här parametern i XML-filen för telefonkonfiguration (cfg.xml) genom att ange en sträng i detta format:
Alternativ:
Standard: Grundläggande HTTP-autentisering |
| 4 |
Klicka på Skicka alla ändringar. |
Tillämpa en profil manuellt på telefonen
Ladda ner konfigurationsfilen till telefonen från en TFTP-server
Utför dessa steg för att ladda ned konfigurationsfilen till ett TFTP-serverprogram på datorn.
| 1 |
Anslut datorn till telefonens LAN-port. |
| 2 |
Kör ett TFTP-serverprogram på datorn och kontrollera att konfigurationsfilen är tillgänglig i TFTP-rotkatalogen. |
| 3 |
I en webbläsare anger du telefonens LAN-IP-adress, datorns IP-adress, filnamn och inloggningsuppgifter. Använd detta format:
Exempel:
|
Ladda ner konfigurationsfilen till telefonen med cURL
Slutför dessa steg för att ladda ner konfigurationen till telefonen med hjälp av cURL. Detta kommandoradsverktyg används för att överföra data med en URL-syntax. För att ladda ner cURL, besök:
https://curl.haxx.se/download.html
Vi rekommenderar att du inte använder cURL för att skicka konfigurationen till telefonen eftersom användarnamnet och lösenordet kan fångas när du använder cURL.
| 1 |
Anslut datorn till telefonens LAN-port. |
| 2 |
Ladda ner konfigurationsfilen till telefonen genom att ange följande cURL-kommando:
|
Referenser för profilkonfiguration
Telefonen accepterar konfigurationer i XML-format.
Exemplen i det här avsnittet använder konfigurationsprofiler med XML-syntax.
Konfigurationsprofilformat
Konfigurationsprofilen definierar parametervärdena för telefonen.
Konfigurationsprofilens XML-format använder standard XML-redigeringsverktyg för att kompilera parametrarna och värdena.
Varje telefon har en annan funktionsuppsättning och därför en annan uppsättning parametrar.
Öppna profilformat
Profilen med öppet format är en textfil med XML-liknande syntax i en hierarki av element, med elementattribut och värden. Med det här formatet kan du använda standardverktyg för att skapa konfigurationsfilen. En XML-konfigurationsfil kan skickas från provisioneringsservern till telefonen under en återsynkroniseringsåtgärd, utan kompilering som ett binärt objekt.
Telefonen kan acceptera konfigurationsformat som standardverktyg genererar. Den här funktionen underlättar utvecklingen av serverprogramvara för back-end-provisionering som genererar konfigurationsprofiler från befintliga databaser.
För att skydda konfidentiell information i konfigurationsprofilen levererar provisioneringsservern XML-konfigurationsfilen till telefonen via en kanal som är skyddad av TLS. Alternativt kan filen komprimeras med hjälp av gzip deflate algoritm (RFC1951).
Filen kan krypteras med en av dessa krypteringsmetoder:
-
AES-256-CBC-kryptering
-
RFC-8188-baserad HTTP-innehållskryptering med AES-128-GCM-kryptering
En konfigurationsfil kan innehålla följande komponenter:
-
Elementtaggar
-
Attribut
-
Parametrar
-
Formateringsfunktioner
-
XML-kommentarer
Exempel: Öppna profilformat
<flat-profile>
<Resync_On_Reset> Yes </Resync_On_Reset>
<Resync_Periodic> 7200 </Resync_Periodic>
<Profile_Rule> tftp://prov.telco.com:6900/cisco/config/CP_xxxx_MPP.cfg</Profile_Rule>
</flat-profile>
E <flat-profile>lementtaggen omsluter alla parameterelement som telefonen känner igen.
Egenskaper för elementtagg
Tänk på följande regler när du skapar eller uppdaterar konfigurationsfilen.
-
XML-etableringsformatet och webbgränssnittet tillåter konfigurering av samma inställningar. Namnen på XML-taggen och fältnamnen i webbgränssnittet liknar varandra men varierar beroende på begränsningar för XML-elementnamn. Till exempel understreck (_) i XML-konfigurationsfilen istället för mellanslag på webbgränssnittet.
-
<flat-profile>Telefonen känner igen element med korrekta parameternamn som är inkapslade i special
elementet. -
Elementnamn är inneslutna i vinkelparenteser.
-
De flesta elementnamn liknar fältnamnen på telefonens webbgränssnitt, med följande ändringar:
-
Elementnamn får inte innehålla mellanslag eller specialtecken. Om du vill härleda elementnamnet från webbfältets namn ersätter du ett understreck för varje mellanslag eller specialtecknen
[,],(,)eller/.Exempel: <Resync_On_Reset>Elementet representerar fältet Återsynkronisera vid återställning.
-
Varje elementnamn måste vara unikt. I telefonens webbgränssnitt kan samma fält visas på flera webbsidor, till exempel sidorna Line, User och Extension. Lägg till
[n]till elementnamnet för att ange numret som visas på sidfliken.Exempel:
<Dial_Plan_1_>Elementet representerar uppr ingningsplanen för linje 1.
-
-
Varje öppningselementtagg måste ha en matchande tagg för avslutande element. Till exempel:
<flat-profile> <Resync_On_Reset> Yes </Resync_On_Reset> <Resync_Periodic> 7200 </Resync_Periodic> <Profile_Rule>tftp://prov.telco.com: 6900/cisco/config/CP_xxxx_MPP.cfg </Profile_Rule> </flat-profile> -
Elementtaggar är skiftlägeskänsliga.
-
Tomma elementtaggar är tillåtna och tolkas som att värdet konfigureras så att det är tomt. Ange taggen för öppningselementet utan motsvarande elementtagg och infoga ett mellanslag och ett snedstreck före slutvinkelfästet (>). I det här exemplet är profilregel B tom:
<Profile_Rule_B /> -
En tom elementtagg kan användas för att förhindra att användarlevererade värden skrivs över under en återsynkroniseringsåtgärd. I följande exempel är användarens inställningar för snabbval oförändrade:
<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> -
Använd ett tomt värde för att ställa in motsvarande parameter till en tom sträng. Ange ett öppnings- och stängningselement utan något värde mellan dem. I följande exempel är parametern GPP_A inställd på en tom sträng.
<flat-profile> <GPP_A> </GPP_A> </flat-profile> -
Oigenkända elementnamn ignoreras.
Parameteregenskaper
Dessa egenskaper gäller för parametrarna:
Alla parametrar som inte anges av en profil lämnas oförändrade i telefonen.
Okända parametrar ignoreras.
Om profilen Open format innehåller flera förekomster av samma parametertagg, åsidosätter den senaste händelsen alla tidigare. För att undvika oavsiktlig åsidosättning av konfigurationsvärden för en parameter rekommenderar vi att varje profil anger högst en instans av en parameter.
Den senast behandlade profilen har företräde. Om flera profiler anger samma konfigurationsparameter har värdet för den senare profilen företräde.
Strängformat
Dessa egenskaper gäller för formateringen av strängarna:
Kommentarer tillåts genom standard XML-syntax.
<!-- My comment is typed here -->Inledande och efterföljande blanksteg tillåts för läsbarhet men tas bort från parametervärdet.
Nya rader inom ett värde konverteras till mellanslag.
En XML-rubrik av formuläret
<? ?> är tillåtet, men telefonen ignorerar det.Om du vill ange specialtecken använder du grundläggande XML-teckenövergångar, som visas i följande tabell.
Specialtecken
XML Escape-sekvens
& (ampersand)
&
< (mindre än)
<
> (större än)
>
'(apostrof)
'
” (dubbel citat)
”
I följande exempel anges teckenomgångar för att representera symbolerna större än och mindre än som krävs i en uppringningsplanregel. I det här exemplet definieras en uppringningsplan <Dial_Plan_1_>för informationstelefon som anger parametern ( lika med (S0 <:18005551212>).
<flat-profile> <Dial_Plan_1_> (S0 <:18005551212>) </Dial_Plan_1_> </flat-profile>Numeriska teckenöversättningar med decimalvärden och hexadecimala värden
(s.a. (och.) översätts.Telefonens firmware stöder endast ASCII-tecken.
Öppna profilkomprimering
Den komprimeringsmetoden som stöds är gzip deflate-algoritmen (RFC1951). Gzip-verktyget och komprimeringsbiblioteket som implementerar samma algoritm (zlib) är tillgängliga från webbplatser.
För att identifiera komprimering förväntar sig telefonen att den komprimerade filen innehåller en gzip-kompatibel rubrik. Anropandet av gzip-verktyget på den ursprungliga Open-profilen genererar rubriken. Telefonen inspekterar den nedladdade filrubriken för att bestämma filformatet.
Om till exempel profile.xml är en giltig profil accepteras även filen profil.xml. gz. Endera av följande kommandon kan generera den här profiltypen:
-
> gzip profile.xmlErsätter originalfilen med komprimerad fil.
-
>cat profile.xml | gzip > profile.xml.gzLämnar originalfilen på plats och producerar ny komprimerad fil.
Öppna profilkryptering
Symmetrisk nyckelkryptering kan användas för att kryptera en öppen konfigurationsprofil, oavsett om filen är komprimerad eller inte. Komprimering, om den tillämpas, måste tillämpas före kryptering.
Provisionsservern använder HTTPS för att hantera den första etableringen av telefonen efter distributionen. Förkryptering av konfigurationsprofiler offline tillåter användning av HTTP för att synkronisera profiler senare. Detta minskar belastningen på HTTPS-servern i storskaliga distributioner.
Telefonen stöder två metoder för kryptering för konfigurationsfiler:
-
AES-256-CBC-kryptering
-
RFC 8188-baserad HTTP-innehållskryptering med AES-128-GCM-kryptering
Nyckeln eller Input Keying Material (IKM) måste vara förinställd i enheten vid en tidigare tidpunkt. Bootstrap av den hemliga nyckeln kan åstadkommas säkert med hjälp av HTTPS.
Namnet på konfigurationsfilen kräver inget specifikt format, men ett filnamn som slutar med filändelsen .cfg indikerar normalt en konfigurationsprofil.
AES-256-CBC-kryptering
Telefonen stöder AES-256-CBC-kryptering för konfigurationsfiler.
OpenSSL-krypteringsverktyget, tillgängligt för nedladdning från olika webbplatser, kan utföra krypteringen. Stöd för 256-bitars AES-kryptering kan kräva omkompilering av verktyget för att aktivera AES-koden. Firmware har testats mot version openssl-1.1.1d.
För en krypterad fil förväntar sig profilen att filen har samma format som genereras av följande kommando:
# example encryption key = SecretPhrase1234
openssl enc –e –aes-256-cbc –k SecretPhrase1234 –in profile.xml –out profile.cfg
# analogous invocation for a compressed xml file
openssl enc –e –aes-256-cbc –k SecretPhrase1234 –in profile.xml.gz –out profile.cfg
En liten bokstav -k föregår den hemliga nyckeln, som kan vara vilken vanlig textfras som helst, och som används för att generera ett slumpmässigt 64-bitars salt. Med hemligheten som anges av argumentet -k härleder krypteringsverktyget en slumpmässig 128-bitars initialvektor och den faktiska 256-bitars krypteringsnyckeln.
När denna form av kryptering används på en konfigurationsprofil måste telefonen informeras om det hemliga nyckelvärdet för att dekryptera filen. Det här värdet anges som en kvalificerare i profilens URL. Syntaxen är som följer, med en uttrycklig URL:
[--key “SecretPhrase1234”] http://prov.telco.com/path/profile.cfg
Detta värde programmeras med hjälp av en av parametrarna Profile_Rule.
Flera provisioneringsparametrar genomgår makroexpansion internt innan de utvärderas. Detta förutvärderingssteg ger större flexibilitet när det gäller att kontrollera telefonens omsynkronisering och uppgraderingsaktiviteter.
Dessa parametergrupper genomgår makroexpansion före utvärdering:
-
Återsynkronisera utlösare_*
-
Profilregel*
-
Logg_xxx_meddelande
-
Uppgradering_regel
Under vissa förhållanden genomgår även vissa allmänna parametrar (GPP_*) makroexpansion, vilket uttryckligen anges i avsnittet Val fria återsynkroniseringsargument nedan.
Under makroexpansion ersätter innehållet i de namngivna variablerna uttryck i formen $NAME och $ (NAME). Dessa variabler inkluderar allmänna parametrar, flera produktidentifierare, vissa händelsetimrar och tillståndsvärden för provisionering. En fullständig lista finns i Makroexpansionsvariabler under Provisioneringsparametrar.
I följande exempel används uttrycket $ (MAU) för att infoga MAC-adressen 000E08012345.
Administratören anger: $ (MAU) config.cfg
Den resulterande makroexpansionen för en enhet med MAC-adress 000E08012345 är: 000E08012345config.cfg
Om ett makronamn inte känns igen förblir det oexpanderat. Namnet STRANGE känns till exempel inte igen som ett giltigt makronamn, medan MAU känns igen som ett giltigt makronamn.
Administratören skriver: $strange$mau.cfg
Den resulterande makroexpansionen för en enhet med MAC-adress 000E08012345 är: $ Strange000E08012345.cfg
Makroexpansion tillämpas inte rekursivt. Till exempel expanderar $ $ MAU ”till $ MAU” ($$ expanderas) och resulterar inte i MAC-adressen.
Innehållet i parametrarna för specialändamål, GPP_SA till GPP_SD, mappas till makrouttrycken $SA till $SD. Dessa parametrar är endast makroexpanderade som argumentet för alternativen --key, -- uid och -- pwd i en resync-URL.
Villkorliga uttryck kan utlösa återsynkroniseringshändelser och välja mellan alternativa webbadresser för omsynkronisering och uppgradering.
Villkorliga uttryck består av en lista med jämförelser, åtskilda av oper atorn och. Alla jämförelser måste vara uppfyllda för att villkoret ska vara sant.
Varje jämförelse kan relatera till en av följande tre typer av bokstäver:
-
Heltalsvärden
-
Versionsnummer för programvara eller maskinvara
-
Dubbelciterade strängar
Versionsnummer
Programversionen för Cisco Video Phone 8875 använder detta format (där BN är byggnumret):
PHONEOS åååå. 1-0-1-0001 - BN
där yyyy indikerar telefonmodellen eller telefonserien; 1 är huvudversionen; 0 är den mindre versionen; 1-0001 är mikroversionen; och BN är bygg numret.
Jämförelsesträngen måste använda samma format. Annars uppstår ett formateringsfel.
När man jämför programvaruversionen jämförs huvudversionen, den mindre versionen och mikroversionen i följd, och siffrorna längst till vänster har företräde framför de senare. När versionsnummer är identiska jämförs byggnumret.
Exempel på giltigt versionsnummer
PHONEOS-8875.1-0-1-0001-19
Jämförelse
Citerade strängar kan jämföras för jämlikhet eller ojämlikhet. Heltal och versionsnummer kan också jämföras aritmetiskt. Jämförelseoperatorerna kan uttryckas som symboler eller som akronymer. Akronymer är praktiska för att uttrycka villkoret i en öppen formatprofil.
|
Operatör |
Alternativ syntax |
Beskrivning |
Gäller för heltal och versionsoperander |
Gäller för citerade strängoperander |
|---|---|---|---|---|
|
= |
ekv |
lika med |
Javisst |
Javisst |
|
!= |
no |
inte lika med |
Javisst |
Javisst |
|
< |
lt |
mindre än |
Javisst |
Nej |
|
<= |
le |
mindre än eller lika med |
Javisst |
Nej |
|
> |
gt |
större än |
Javisst |
Nej |
|
>= |
ge |
större än eller lika med |
Javisst |
Nej |
|
AND |
|
och |
Javisst |
Javisst |
Det är viktigt att bifoga makrovariabler i dubbla citattecken där en strängliteral förväntas. Gör inte det där ett nummer eller versionsnummer förväntas.
När de används i samband med parametrarna Profile_Rule* och Upgrade_Rule måste villkorliga uttryck vara inneslutna i syntaxen ”(expr)?” som i det här uppgraderingsregelexemplet. Kom ihåg att ersätta BN med byggnumret för din firmware-belastning att uppgradera till.
($SWVER ne PHONEOS-8875.1-0-1-0001-19)? http://ps.tell.com/sw/PHONEOS-8875.1-0-1-0001-BN.loads
Använd inte föregående syntax med parenteser för att konfigurera parametrarna Resync_Trigger_*.
Använd standardsyntaxen URL för att ange hur konfigurationsfiler och inläsningar av fast programvara ska hämtas i parametrarna Profile_Rule* respektive Upgrade_Rule. Syntaxen är som följer:
[schema://] [server [:port]] filsökväg
Där systemet är ett av dessa värden:
-
tftp
-
http
-
https
Om schem at utelämnas antas tftp. Servern kan vara ett DNS-erkänt värdnamn eller en numerisk IP-adress. Porten är destinationens UDP- eller TCP-portnummer. Filsökvägen måste börja med rotkatalogen (/); det måste vara en absolut sökväg.
Om servern saknas används den tftp-server som anges via DHCP (alternativ 66).
För uppgraderingsregler måste servern anges.
Om porten saknas används standardporten för det angivna schemat. Tftp använder UDP-port 69, http använder TCP-port 80, https använder TCP-port 443.
En filsökväg måste vara närvarande. Det behöver inte nödvändigtvis hänvisa till en statisk fil, men kan indikera dynamiskt innehåll som erhållits genom CGI.
Makroexpansion gäller inom URL:er. Följande är exempel på giltiga webbadresser:
/$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 använder DHCP-alternativ 66 stöds inte den tomma syntaxen av uppgraderingsreglerna. Det gäller endast för profilregel*.
RFC 8188-baserad HTTP-innehållskryptering
Telefonen stöder RFC 8188-baserad HTTP-innehållskryptering med AES-128-GCM-kryptering för konfigurationsfiler. Med denna krypteringsmetod kan alla enheter läsa HTTP-meddelanderubrikerna. Det är dock bara de enheter som känner till Input Keying Material (IKM) som kan läsa nyttolasten. När telefonen är etablerad med IKM kan telefonen och provisioneringsservern utbyta konfigurationsfiler på ett säkert sätt, samtidigt som nätverkselement från tredje part kan använda meddelanderubrikerna för analys- och övervakningsändamål.
XML-konfigurationsparametern IKM_HTTP_EncryptContent innehåller IKM på telefonen. Av säkerhetsskäl är den här parametern inte tillgänglig på telefonadministrationens webbsida. Det syns inte heller i telefonens konfigurationsfil, som du kan komma åt från telefonens IP-adress eller från telefonens konfigurationsrapporter som skickas till provisioneringsservern.
Om du vill använda RFC 8188-baserad kryptering kontrollerar du följande:
-
Tillhandahålla telefonen med IKM genom att ange IKM med XML-parametern
IKM_HTTP_EncryptContent i konfigurationsfilen som skickas frånprovisioneringsservern till telefonen. -
Om den här krypteringen tillämpas på konfigurationsfilerna som skickas från provisioneringsservern till telefonen kontrollerar du att HTTP-rubriken för innehållsk odning i konfigurationsfilen har aes128gcm.
I avsaknad av denna rubrik ges AES-256-CBC-metoden företräde. Telefonen tillämpar AES-256-CBC-dekryptering om en AES-256-CBC-nyckel finns i en profilregel, oavsett IKM.
-
Om du vill att telefonen ska tillämpa den här krypteringen på konfigurationsrapporterna som skickas till etableringsservern kontrollerar du att det inte finns någon AES-256-CBC-nyckel som anges i rapportregeln.
Valfria återsynkroniseringsargument
Valfria argument, key, uid och pwd, kan föregå de webbadresser som anges i parametrarna Profile_Rule*, tillsammans inneslutna av hakparenteser.
Alternativet
Nyckeln själv anges som en sträng efter termen --key talar om för telefonen att konfigurationsfilen som den tar emot från provisioneringsservern är krypterad med AES-256-CBC-kryptering, såvida inte innehållskodningshuvudet i filen indikerar aes128gcm-kryptering.--key. Nyckeln kan bifogas med dubbla citattecken (”) valfritt. Telefonen använder nyckeln för att dekryptera konfigurationsfilen.
Användningsexempel
[--key VerySecretValue]
[--key “my secret phrase”]
[--key a37d2fb9055c1d04883a0745eb0917a4]
De valfria argumenten inom parentes är makroexpanderade. Specialparametrar, GPP_SA till GPP_SD, är makroexpanderade till makrovariabler, $SA till $SD, endast när de används som nyckelalternativargument. Se dessa exempel:
[--key $SC]
[--key “$SD”]
I öppna formatprofiler måste argumentet till --key vara detsamma som argumentet för alternativet -k som ges till openssl.
Alternativen uid och pwd kan användas för att ange användar-ID och lösenord som ska skickas som svar på HTTP Basic- och Digest-autentiseringsutmaningar när den angivna webbadressen begärs. De valfria argumenten inom parentes är makroexpanderade. Specialparametrar, GPP_SA till GPP_SD, är makroexpanderade till makrovariabler, $SA till $SD, endast när de används som nyckelalternativargument. Se dessa exempel:
GPP_SA = MyUserID
GPP_SB = MySecretPassword
[--uid $SA --pwd $SB] https://provisioning_server_url/path_to_your_config/your_config.xml
skulle sedan utvidgas till:
[--uid MyUserID --pwdMySecretPassword] https://provisioning_server_url/path_to_your_config/your_config.xml
Datatyper
Dessa datatyper används med konfigurationsprofilparametrar:
-
{a, b, c,...} - Ett val mellan a, b, c,...
-
Bool—booleskt värde för antingen ”ja” eller ”nej”.
-
CADscript — ett miniskript som anger kadensparametrarna för en signal. Upp till 127 tecken.
Syntax: S 1 [; S 2], där:
-
S i =D i (på i,1 /av i,1 [, på i, 2 /av i, 2 [, på i, 3 /av i, 3 [, på i,4 /av i, 4 [, på i,5 /av i ,5 [, på i ,6 /av i ,6]]]]) och är känd som en sektion.
-
på i, j och av i, j är på/av-varaktigheten i sekunder för ett segment. i = 1 eller 2, och j = 1 till 6.
-
D i är sektionens totala varaktighet i sekunder.
Alla varaktigheter kan ha upp till tre decimaler för att ge 1 ms upplösning. Jokertecknet ”*” står för oändlig varaktighet. Segmenten i en sektion spelas i ordning och upprepas tills den totala varaktigheten spelas.
Exempel 1:
60(2/4) Number of Cadence Sections = 1 Cadence Section 1: Section Length = 60 s Number of Segments = 1 Segment 1: On=2s, Off=4s Total Ring Length = 60sExempel 2 — Distinkt ring (kort, kort, kort, lång):
60(.2/.2,.2/.2,.2/.2,1/4) Number of Cadence Sections = 1 Cadence Section 1: Section Length = 60s Number of Segments = 4 Segment 1: On=0.2s, Off=0.2s Segment 2: On=0.2s, Off=0.2s Segment 3: On=0.2s, Off=0.2s Segment 4: On=1.0s, Off=4.0s Total Ring Length = 60s -
-
DialPlanScript — Skriptsyntax som används för att ange uppringningsplaner för rad 1 och rad 2.
-
<n>Flytande —Ett flyttalsvärde med upp till n decimaler.
-
FQDN — Fullt kvalificerat domännamn. Den kan innehålla upp till 63 tecken. Exempel är följande:
sip.cisco.com:5060 eller 109.12.14. 12:12345
Sip.cisco.com eller 109.12.14.12
-
FreqScript — ett miniskript som specificerar frekvens- och nivåparametrarna för en ton. Innehåller upp till 127 tecken.
Syntax: F 1 @L 1 [, F 2 @L 2 [, F 3 @L 3 [, F 4 @L 4 [, F 5 @L 5 [, F 6 @L 6]]]], där:
-
F 1 —F 6 är frekvens i Hz (endast osignerade heltal).
-
L 1 —L 6 är motsvarande nivåer i dBm (med upp till en decimal).
Blanksteg före och efter kommatecken är tillåtna men rekommenderas inte.
Exempel 1 — Väntton för samtal:
440@-10 Number of Frequencies = 1 Frequency 1 = 440 Hz at –10 dBmExempel 2 — Rington:
350@-19,440@-19 Number of Frequencies = 2 Frequency 1 = 350 Hz at –19 dBm Frequency 2 = 440 Hz at –19 dBm -
-
IP— Giltig IPv4-adress i form av x.x.x.x, där x är mellan 0 och 255. Exempel: 10.1.2.100.
-
Användar-ID — Användar-ID som det visas i en webbadress; upp till 63 tecken.
-
Telefon — En telefonnummersträng, till exempel 14081234567, *69, *72, 345678; eller en allmän webbadress, till exempel 1234 @10 .10.10. 100:5068 eller jsmith@Cisco.com. Strängen kan innehålla upp till 39 tecken.
-
PHTMPLT - en telefonnummermall. Varje mall kan innehålla ett eller flera mönster som är åtskilda med ett komma (,). Vitt utrymme i början av varje mönster ignoreras. ”?” och ”*” representerar jokertecken. Använd %xx för att representera bokstavligen. Till exempel representerar% 2a *. Mallen kan innehålla upp till 39 tecken. Exempel: ”1408*, 1510*”, ”1408123???? , 555? 1.”.
-
Port — TCP/UDP-portnummer (0-65535). Det kan anges i decimal- eller hexformat.
-
ProvisioningRuleSyntax — Skriptsyntax som används för att definiera regler för återsynkronisering av konfiguration och uppgradering av firmware.
-
PWRnivå — effektnivå uttryckt i dBm med en decimal, till exempel —13,5 eller 1,5 (dBm).
-
RSCTMPLT — en mall för SIP-svarsstatuskod, till exempel ”404, 5*”, ”61?” , ”407, 408, 487, 481 ”. Den kan innehålla upp till 39 tecken.
-
Sig <n>—Signerat n-bitvärde. Det kan anges i decimal- eller hexformat. Ett ”-” -tecken måste föregå negativa värden. Ett +-tecken före positiva värden är valfritt.
-
Stjärnkoder — Aktiveringskod för en tilläggstjänst, t.ex. *69. Koden kan innehålla upp till 7 tecken.
-
Str <n>—En generisk sträng med upp till n icke-reserverade tecken.
-
Tid <n>—Tidslängd i sekunder, med upp till n decimaler. Extra angivna decimaler ignoreras.
-
ToneScript — ett miniskript som anger frekvens, nivå och kadensparametrar för en samtalston. Skriptet kan innehålla upp till 127 tecken.
Syntax: FreqScript; Z 1 [; Z 2].
Avsnittet Z 1 liknar S 1-avsnittet i ett CADscript, förutom att varje på/av-segment följs av en frekvenskomponentparameter: Z 1 = D 1 (på i,1 /av i,1 /f i, 1 [, på i,2 /off i, 2 /f i, 2 [, på i, 3 /av i,3 /f i, 3 [, på i, 4 /off i, 4 /f i, 4 /f i, 4 [, på i,5 /av i ,5 /f i,5 [, på i ,6 /av i ,6 /f i,6]]]]) där
-
f i, j = n 1 [+n 2] +n 3 [+n 4 [+n 5 [+n 6]]]].
-
1 < n k < 6 anger frekvenskomponenterna i FreqScript som används i det segmentet.
Om mer än en frekvenskomponent används i ett segment summeras komponenterna tillsammans.
Exempel 1 — Ringsignal:
350@-19,440@-19;10(*/0/1+2) Number of Frequencies = 2 Frequency 1 = 350 Hz at –19 dBm Frequency 2 = 440 Hz at –19 dBm Number of Cadence Sections = 1 Cadence Section 1: Section Length = 10 s Number of Segments = 1 Segment 1: On=forever, with Frequencies 1 and 2 Total Tone Length = 10sExempel 2 — Stammande ton:
350@-19,440@-19;2(.1/.1/1+2);10(*/0/1+2) Number of Frequencies = 2 Frequency 1 = 350 Hz at –19 dBm Frequency 2 = 440 Hz at –19 dBm Number of Cadence Sections = 2 Cadence Section 1: Section Length = 2s Number of Segments = 1 Segment 1: On=0.1s, Off=0.1s with Frequencies 1 and 2 Cadence Section 2: Section Length = 10s Number of Segments = 1 Segment 1: On=forever, with Frequencies 1 and 2 Total Tone Length = 12s -
-
Uns <n>—Osignerat n-bitvärde, där n = 8, 16 eller 32. Det kan anges i decimal- eller hexformat, till exempel 12 eller 0x18, så länge värdet kan passa in i n bitar.
Håll dessa under övervägande:
- <Par Name>representerar ett konfigurationsparameternamn. I en profil bildas motsvarande tagg genom att ersätta mellanslaget med ett understreck ”_”, till exempel Par _Name.
- Ett tomt standardvärdefält innebär en tom sträng < ”” >.
- Telefonen fortsätter att använda de senast konfigurerade värdena för taggar som inte finns i en viss profil.
- Mallar jämförs i den angivna ordningen. Den första, inte den närmaste, matchen väljs. Parameternamnet måste matcha exakt.
- Om mer än en definition för en parameter ges i en profil är den sista definitionen i filen den som träder i kraft i telefonen.
- En parameterspecifikation med ett tomt parametervärde tvingar parametern tillbaka till standardvärdet. Om du vill ange en tom sträng istället använder du den tomma strängen ”” som parametervärde.