Konfigurera telefonen för profilomsynkronisering

Synkronisera om telefonprofilen över TFTP

Telefonen har stöd för flera nätverksprotokoll för att hämta konfigurationsprofiler. Det mest grundläggande profilöverföringsprotokollet är TFTP (RFC1350). TFTP används i stor utsträckning för etablering av nätverksenheter inom privata LAN-nätverk. Även om det inte rekommenderas för distribution av fjärrslutpunkter över internet kan TFTP vara praktiskt för distribution inom små organisationer, för intern företablering och för utveckling och testning. I följande procedur ändras en profil efter hämtning av en fil från en TFTP-server.

1

I en LAN-miljö ansluter du datorn och telefonen till en hubb, växel eller en liten router.

2

Installera och aktivera en TFTP-server på datorn.

3

Använd en textredigerare för att skapa en konfigurationsprofil.

Om du vill kontrollera om profilen har etablerats för din telefon senare kan du ange vissa av värdena som markeringar. Ställ till exempel in värdet för GPP_A till 12345678 som visas i följande exempel:
 <flat-profile>   <GPP_A> 12345678   A> </flat-profile>
_
4

Spara XML-konfigurationsfilen i TFTP-serverns rotkatalog.

Du kan kontrollera att TFTP-servern är korrekt konfigurerad: begär konfigurationsprofilen 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 etableringsservern.

5

Öppna administrationswebbsidan i webbläsaren på din dator. Anta till exempel att telefonens IP-adress är 192.168.1.100, öppna följande URL i din webbläsare:


http://192.168.1.100/admin/advanced
6

Välj fliken Röst > Reservering och inspektera värdena för de allmänna parametrarna GPP_A till och med GPP_P. Dessa ska vara tomma.

7

Synkronisera om testtelefonen till den konfigurationsprofil som du har skapat genom att öppna omsynkroniserings-URL:en i en webbläsare.

Exempel:

Om TFTP-serverns IP-adress är 192.168.1.200 bör kommandot likna följande exempel:


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

När telefonen tar emot det här kommandot begär enheten på adressen 192.168.1.100 konfigurationsfilen basic.txt från TFTP-servern på IP-adressen 192.168.1.200. Telefonen parser sedan den hämtade filen och uppdaterar GPP_En parameter med värdet 12345678.

8

Kontrollera att parametern har uppdaterats korrekt. Uppdatera administrationswebbsidan och gå till Röst > Reservering.

GPP_En parameter ska nu innehålla värdet 12345678.

Tillhandahåll en telefonspecifik profil på en TFTP-server
1

Hämta telefonens MAC-adress från produktetiketten. (MAC-adressen är numret, med siffror och gemena hexadecimala tecken, till exempel 000e08aabbcc.

2

Byt namn på konfigurationsfilen till CP-xxxx macaddress.cfg (ersätta xxxx med modellnumret och macaddress med telefonens MAC-adress).

Exempel:

CP-8875 000e08aabbcc.cfg

3

Flytta den nya filen till TFTP-serverns virtuella rotkatalog.

4

Öppna webbsidan för telefonadministration.

5

Välj Röst  > Reservering.

6

Ange sökvägen till profilfilen i fältet Profilregel .

Exempel: Anta att TFTP-serverns IP-adress är 192.168.1.200 och profilfilens namn är 

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

Klicka på Skicka in alla ändringar. Detta orsakar en omedelbar omstart och omsynkronisering.

När nästa omsynkronisering inträffar hämtar telefonen den nya filen genom att expandera $MA-makrouttrycket till sin MAC-adress.

Synkronisera om telefonprofilen med HTTP GET
1

Installera en HTTP-server på den lokala datorn eller en annan tillgänglig värd.

Apache-servern med öppen källkod kan hämtas från internet.

2

Ladda upp konfigurationsprofilen till den installerade serverns virtuella rotkatalog.

3

För att kontrollera korrekt serverinstallation och åtkomst till profilfilen öppnar du profilen med en webbläsare.

4

Ändra Profile_-regeln för testtelefonen så att den pekar på HTTP-servern i stället för TFTP-servern, så att du regelbundet hämtar profilen.

Om till exempel HTTP-servern är 192.168.1.300 och profilfilens namn är basic.txt anger du följande värde:

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

Klicka på Skicka in alla ändringar. Detta orsakar en omedelbar omstart och omsynkronisering.

6

Observera syslog-meddelanden som telefonen skickar. De regelbundna omsynkroniseringarna ska nu hämta profilen från HTTP-servern.

7

Observera hur information som identifierar testtelefonen visas i loggen över användaragenter i HTTP-serverloggarna.

Denna information bör innehålla tillverkare, produktnamn, aktuell version av den fasta programvaran och serienummer.

Synkronisera om telefonprofilen automatiskt

En enhet kan regelbundet synkronisera till etableringsservern för att säkerställa att alla profiländringar som görs på servern sprids till slutpunktsenheten (i motsats till att en uttrycklig omsynkroniseringsbegäran skickas till slutpunkten).

Om du vill att telefonen regelbundet ska synkroniseras till en server definieras en URL för konfigurationsprofilen med hjälp av parametern Profile_Rule och en omsynkroniseringsperiod definieras med hjälp av parametern Resync_Periodic.

1

Öppna webbsidan för telefonadministration.

2

Välj Röst  > Reservering.

3

Definiera parametern Profile_Rule. I det här exemplet antas en IP-adress för TFTP-server på 192.168.1.200.

4

I fältet Omsynkronisera periodvis anger du ett litet värde för testning, t.ex. 30 sekunder.

5

Klicka på Skicka in alla ändringar.

Med de nya parameterinställningarna synkroniserar telefonen två gånger per minut till konfigurationsfilen som anges av URL:en.

6

Observera de resulterande meddelandena i syslog-spårningen.

7

Kontrollera att fältet Omsynkronisera vid återställning är inställt på Ja.

 <Resync_On_Reset>JaOn_Reset>
esync_
8

Starta om telefonen för att tvinga den att synkronisera till etableringsservern.

Om omsynkroniseringen misslyckas av någon anledning, t.ex. om servern inte svarar, väntar enheten (för antal sekunder som konfigurerats i Retry Delay för omsynkroniseringsfel) innan den försöker synkronisera igen. Om Retry Delay för omsynkroniseringsfel är noll försöker telefonen inte synkronisera igen efter ett misslyckat omsynkroniseringsförsök.

9

(Valfritt) Ange värdet i fältet Omsynkroniseringsfel Retry Delay till ett litet nummer, t.ex. 30.

 <Resync_Error_Retry_Fördröjning>30Error_Retry_Fördröjning>
esync_
10

Inaktivera TFTP-servern och observera resultaten i syslog-utdata.

Parametrar för profilomsynkronisering

Följande tabell definierar hur parametrarna för profilomsynkronisering i avsnittet Konfigurationsprofil på fliken Röst > Etablering på telefonens webbsida fungerar och används. Den definierar även syntaxen för strängen som läggs till i telefonens konfigurationsfil (cfg.xml) med XML-kod för att konfigurera en parameter.

Tabell 1. Parametrar för profilomsynkronisering

Parameter

Beskrivning

Aktivera tillhandahåll

Tillåter eller nekar omsynkroniseringsåtgärder för konfigurationsprofilen.

  • Ange en sträng i det här formatet i telefonens konfigurationsfil (cfg.xml) med XML:

    <Provision_Aktivera ua="na">JaAktivera>rovision_

  • På telefonens webbsida ställer du in det här fältet på Ja för att tillåta omsynkroniseringsåtgärder eller Nej för att blockera omsynkroniseringsåtgärder.

Standard: Ja

Omsynkronisering vid återställning

Anger om telefonen omsynkroniserar konfigurationer med etableringsservern efter start och efter varje uppgraderingsförsök.

  • Ange en sträng i det här formatet i telefonens konfigurationsfil (cfg.xml) med XML:

    <Resync_On_Reset ua="na">JaOn_Reset>esync_

  • På telefonens webbsida ställer du in det här fältet på Ja för att tillåta omsynkronisering vid start eller återställning, eller Nej för att blockera omsynkronisering vid start eller återställning.

Standard: Ja

Slumpmässig fördröjning för omsynkronisering

Förhindrar en överbelastning av etableringsservern när ett stort antal enheter startas samtidigt och försöker med den inledande konfigurationen. Fördröjningen gäller endast vid det första konfigurationsförsöket efter att enheten startas eller återställs.

Parametern är det maximala tidsintervall som enheten väntar innan den kontaktar etableringsservern. Den faktiska fördröjningen är ett pseudo-slumpmässigt tal mellan 0 och det här värdet.

Den här parametern är i enheter om 20 sekunder.

Det giltiga värdet är mellan 0 och 65 535.

  • Ange en sträng i det här formatet i telefonens konfigurationsfil (cfg.xml) med XML:

    <Resync_Random_Fördröjning ua="na">2Random_Fördröjning>esync_

  • På telefonens webbsida anger du antalet enheter (20 sekunder) som telefonen ska fördröja omsynkronisering efter start eller återställning.

Standardvärdet är 2 (40 sekunder).

Omsynkronisering Vid (HHmm)

Tiden (HHmm) som telefonen omsynkroniserar med etableringsservern.

Värdet för det här fältet måste vara ett fyrsiffrigt nummer mellan 0000 och 2400 för att ange tiden i HHmm-format. Till exempel betyder 0959 09:59.

  • Ange en sträng i det här formatet i telefonens konfigurationsfil (cfg.xml) med XML:

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

  • På telefonens webbsida anger du tiden i HHMM-format för telefonen att starta omsynkronisering.

Standardvärdet är tomt. Om värdet är ogiltigt ignoreras parametern. Om den här parametern har angetts med ett giltigt värde ignoreras parametern Resync Periodic.

Omsynkronisering vid slumpmässig fördröjning

Förhindrar överbelastning av etableringsservern när ett stort antal enheter slås på samtidigt.

För att undvika överfulla omsynkroniseringsförfrågningar till servern från flera telefoner synkroniseras telefonen om inom intervallet mellan timmar och minuter, och timmar och minuter plus den slumpmässiga fördröjningen (hhmm, hhmm+random_delay). Om den slumpmässiga fördröjningen till exempel = (Omsynkronisera vid slumpmässig fördröjning + 30)/60 minuter konverteras inmatningsvärdet i sekunder till minuter och avrundas uppåt till nästa minut för att beräkna det slutliga random_delay intervallet.

  • Ange en sträng i det här formatet i telefonens konfigurationsfil (cfg.xml) med XML:

    <Resync_At_Random_Fördröjning ua="na">600At_Random_Fördröjning>esync_

  • På telefonens webbsida anger du tidsperioden i sekunder.

Det giltiga värdet är 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).

Regelbunden omsynkronisering

Tidsintervallet mellan regelbunden omsynkronisering med etableringsservern. Den associerade omsynkroniseringstimern aktiveras endast efter den första lyckade synkroniseringen med servern.

Följande giltiga format är:

  • Ett heltal

    Exempel: En inmatning på 3000 indikerar att nästa omsynkronisering sker om 3 000 sekunder.

  • Flera heltal

    Exempel: En inmatning på 600 1200 300 anger att den första omsynkroniseringen sker efter 600 sekunder, den andra omsynkroniseringen sker 1 200 sekunder efter den första och den tredje omsynkroniseringen sker 300 sekunder efter den andra.

  • Ett tidsintervall

    Exempel: En inmatning på 2400+30 indikerar att nästa omsynkronisering inträffar mellan 2400 och 2430 sekunder efter en lyckad omsynkronisering.

  • Ange en sträng i det här formatet i telefonens konfigurationsfil (cfg.xml) med XML:

    <Resync_Periodic ua="na">3600Periodic>esync_

  • På telefonens webbsida anger du tidsperioden i sekunder.

Ställ in den här parametern på noll för att inaktivera periodisk omsynkronisering.

Standardvärdet är 3600 sekunder.

Omsynkroniseringsfel, fördröjning för nytt försök

Om en omsynkronisering misslyckas eftersom telefonen inte kunde hämta en profil från servern, den hämtade filen är skadad eller ett internt fel uppstår, försöker telefonen synkronisera igen efter en tid som anges i sekunder.

Följande giltiga format är:

  • Ett heltal

    Exempel: En inmatning på 300 anger att nästa försök för omsynkronisering inträffar om 300 sekunder.

  • Flera heltal

    Exempel: En inmatning på 600 1200 300 anger att det första försöket inträffar 600 sekunder efter misslyckandet, det andra försöket inträffar 1 200 sekunder efter misslyckandet av det första försöket och det tredje försöket inträffar 300 sekunder efter misslyckandet av det andra försöket.

  • Ett tidsintervall

    Exempel: En inmatning på 2400+30 indikerar att nästa omförsök inträffar mellan 2400 och 2430 sekunder efter ett omsynkroniseringsfel.

Om fördröjningen är 0 försöker enheten inte synkronisera igen efter ett misslyckat omsynkroniseringsförsök.

  • Ange en sträng i det här formatet i telefonens konfigurationsfil (cfg.xml) med XML:

    <Resync_Error_Retry_Fördröjning ua="na">60,120,240,480,960,1920,3840,7680,15360,30720,61440,86400Error_Retry_Fördröjning>esync_

  • På telefonens webbsida anger du tidsperioden i sekunder.

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

Fördröjning av framtvingad omsynkronisering

Maximal fördröjning (i sekunder) som telefonen väntar innan den utför en omsynkronisering.

Enheten synkroniseras inte om 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 en längre tid innan omsynkroniseringen görs. Detta gör att en användare kan ringa samtal i följd utan avbrott.

Enheten har en timer som börjar räknas ned när alla dess linjer blir inaktiva. Den här parametern är räknarens initiala värde. Omsynkroniseringshändelser fördröjs tills räknaren minskar till noll.

Det giltiga värdet är mellan 0 och 65 535.

  • Ange en sträng i det här formatet i telefonens konfigurationsfil (cfg.xml) med XML:

    <Forced_Resync_Fördröjning ua="na">14400Resync_Fördröjning>orced_

  • På telefonens webbsida anger du tidsperioden i sekunder.

Standardvärdet är 14 400 sekunder.

Omsynkronisering från SIP

Kontrollerar förfrågningar om omsynkroniseringsåtgärder via en SIP NOTIFY-händelse som skickas från tjänsteleverantörens proxyserver till telefonen. Om detta är aktiverat kan proxyn begära en omsynkronisering genom att skicka ett SIP NOTIFY-meddelande som innehåller händelsen: omsynkronisera sidhuvudet till enheten.

  • Ange en sträng i det här formatet i telefonens konfigurationsfil (cfg.xml) med XML:

    <Resync_From_SIP ua="na">JaFrom_SIP>esync_

  • På telefonens webbsida väljer du Ja för att aktivera den här funktionen eller Nej för att inaktivera den.

Standard: Ja

Omsynkronisering efter uppgraderingsförsök

Aktiverar eller inaktiverar omsynkroniseringsåtgärden när en uppgradering har inträffat. Om Ja väljs utlöses synkronisering efter en uppgradering av den fasta programvaran.

  • Ange en sträng i det här formatet i telefonens konfigurationsfil (cfg.xml) med XML:

    <Resync_After_Upgrade_Försök ua="na">JaAfter_Upgrade_Försök>esync_

  • På telefonens webbsida väljer du Ja för att utlösa omsynkronisering efter en uppgradering av den fasta programvaran eller Nej för att inte omsynkronisera.

Standard: Ja

Omsynkroniseringsutlösare 1

Omsynkroniseringsutlösare 2

Om den logiska ekvationen i dessa parametrar utvärderas som FALSE utlöses inte omsynkronisering även om Omsynkronisering vid återställning är inställd på TRUE. Endast omsynkroniseringen via URL:en för direkt åtgärd och SIP-meddelande ignorerar dessa utlösare för omsynkronisering.

Parametrarna kan programmeras med ett villkorsuttryck som makroexpanderas. För giltiga makroexpanderingar, se Makroexpansionsvariabler under Etableringsparametrar.

  • Ange en sträng i det här formatet i telefonens konfigurationsfil (cfg.xml) med XML:

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

    <Resync_Trigger_2 ua="na"/>

  • Ange utlösarna på telefonens webbsida.

Standard: Tom

Användarkonfigurerbar omsynkronisering

Låter en användare synkronisera telefonen från telefonskärmens meny. Om detta är Ja kan en användare synkronisera telefonkonfigurationen genom att ange profilregeln från telefonen. Om inställt på Nej visas inte parametern Profilregel på telefonskärmens meny.

  • Ange en sträng i det här formatet i telefonens konfigurationsfil (cfg.xml) med XML:

    <User_Configurable_Resync ua="na">JaConfigurable_Resync>ser_

  • På telefonens webbsida väljer du Ja för att visa parametern Profilregel i telefonmenyn eller väljer Nej för att dölja denna parameter.

Standard: Ja

Omsynkronisering misslyckas på FNF

En omsynkronisering anses vanligtvis misslyckad om en begärd profil inte tas emot från servern. Den här parametern åsidosätter detta beteende. Om detta är Nej accepterar enheten ett file-not-found -svar från servern som en lyckad omsynkronisering.

  • Ange en sträng i det här formatet i telefonens konfigurationsfil (cfg.xml) med XML:

    <Resync_Fails_On_FNF ua="na">JaFails_On_FNF>esync_

  • På telefonens webbsida väljer du Ja för att ta ett file-not-found -svar som en misslyckad omsynkronisering eller väljer Nej för att ta ett file-not-found -svar som en lyckad omsynkronisering.

Standard: Ja

Profilautentiseringstyp

Anger de autentiseringsuppgifter som ska användas för autentisering av profilkonto. De tillgängliga alternativen är:

  • Inaktiverad: Inaktiverar funktionen för profilkonto. När den här funktionen är inaktiverad visas inte menyn Konfiguration av profilkonto på telefonskärmen.

  • Grundläggande HTTP-autentisering: HTTP-inloggningsuppgifterna används för att autentisera profilkontot.

  • XSI-autentisering: XSI-inloggningsuppgifter eller XSI SIP-inloggningsuppgifter används för att autentisera profilkontot. Autentiseringsuppgifterna beror på XSI-autentiseringstypen för telefonen:

    • När XSI-autentiseringstypen för telefonen är inställd på Inloggningsuppgifter används XSI-inloggningsuppgifterna.

    • När XSI-autentiseringstypen för telefonen är inställd på SIP-autentiseringsuppgifter används XSI SIP-autentiseringsuppgifterna.

  • Ange en sträng i det här formatet i telefonens konfigurationsfil (cfg.xml) med XML:

    <Profile_Authentication_Type ua="na">Grundläggande http-autentiseringAuthentication_Type>rofile_

  • På telefonens webbsida väljer du ett alternativ i listan för att telefonen ska autentisera profilomsynkronisering.

Standard: Grundläggande HTTP-autentisering

Mer information finns i Ange typ av profilautentisering under Ange telefonen för profilomsynkronisering.

Profilregel

Profilregel B

Profilregel C

Profilregel D

Varje profilregel informerar telefonen om en källa som du kan hämta en profil från (konfigurationsfil). Under varje omsynkronisering tillämpar telefonen alla profiler i följd.

Om du tillämpar AES-256-CBC-kryptering på konfigurationsfilerna anger du krypteringsnyckeln med nyckelordet --key enligt följande:

[--nyckel ]

Du kan även omsluta krypteringsnyckeln med dubbla citattecken (”).

  • Ange en sträng i det här formatet i telefonens konfigurationsfil (cfg.xml) med XML:

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

    <Profile_Rule_B ua="na"/>

    <Profile_Rule_C ua="na"/>

    <Profile_Rule_D ua="na"/>

  • Ange profilregeln på telefonens webbsida.

Standard: /$PSN.xml

DHCP-alternativ Att Använda

DHCP-alternativ, avgränsade med kommatecken, som används för att hämta inbyggd programvara och profiler.

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

DHCPv6-alternativ att använda

DHCP-alternativ, avgränsade med kommatecken, som används för att hämta inbyggd programvara och profiler.

Standard: 17,160,159

Etablering via Cisco XML

Du kan etablera telefoner via Cisco XML-funktioner.

Du kan skicka ett XML-objekt till telefonen via ett SIP Notify-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 etablering via ett XML-objekt:

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

När telefonen har tagit emot XML-objektet hämtas etableringsfilen från [profile-rule]. Den här regeln använder makron för att förenkla utvecklingen av XML-tjänstprogrammet.

URL-upplösning med makroexpandering

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 namn på en etableringsserver eller en explicit 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 URL:en genom att använda standardsyntaxen :port efter servernamnet.

  • Underkatalogen till serverns virtuella rotkatalog där profilen lagras, angiven med URL-standardnotation och hanteras av makroexpandering.

Till exempel begär följande Profile_Rule profilfilen ($PN.cfg), i serverns underkatalog /cisco/config, från TFTP-servern som körs på värden prov.telco.com och lyssnar efter en anslutning på port 6900: 

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

En profil för varje telefon kan identifieras i en allmän parameter, där dess värde refereras till i en gemensam profilregel med hjälp av makroexpandering.

Anta till exempel att GPP_B definieras som Dj6Lmp23Q.

Profile_-regeln har värdet:

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

När enheten synkroniseras och makron expanderas begär telefonen med en MAC-adress på 000e08012345 profilen med namnet som innehåller enhetens MAC-adress på följande URL:

 tftp://prov.telco.com/cisco/dj6lmp23q/000e08012345.cfg
Ange typ av profilautentisering

Med profilautentisering kan telefonanvändare synkronisera etableringsprofilen på telefonen. Autentiseringsinformation krävs när telefonen försöker omsynkronisera 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 autentiseringsfelet 401 för HTTP eller HTTPs inträffar under första etableringen efter att telefonen har startats om

  • När profilkontots användarnamn och lösenord är tomma

  • När det inte finns något användarnamn och lösenord i profilregeln

Om skärmen Konfiguration av profilkonto missas eller ignoreras kan användaren även komma åt inställningsskärmen via telefonskärmens meny, eller den programstyrda knappen Konfiguration , som endast visas när ingen linje på telefonen är registrerad.

När du inaktiverar funktionen visas inte skärmen Konfiguration av 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 digest för att omsynkronisera profilen. Med rätt profilkonto godkänns 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 kräver telefonen autentisering eller digest för att omsynkronisera profilen. Profilkontot används inte för telefonomsynkronisering. Inloggningen lyckades.

  • När du anger en korrekt URL i fältet Profilregel med felaktigt användarnamn och lösenord kräver telefonen autentisering eller digest för att omsynkronisera profilen. Profilkontot används inte för telefonomsynkronisering. Inloggningen misslyckas alltid.

  • När du anger en felaktig URL i fältet Profilregel misslyckas inloggningen alltid.

Du kan även konfigurera parametrarna i telefonens konfigurationsfil med XML-kod (cfg.xml).

Du kan ange typ av profilautentisering på webbsidan för telefonadministration.

1

Öppna webbsidan för telefonadministration.

2

Välj Röst > Reservering.

3

I avsnittet Konfigurationsprofil ställer du in parametern Profilautentiseringstyp för att ange de autentiseringsuppgifter som ska användas för autentisering av profilkonto.

Du kan konfigurera den här parametern i telefonens konfigurationsfil (cfg.xml) genom att ange en sträng i det här formatet:

<Profile_Authentication_Typ ua="na">InaktiveradAuthentication_Typ>
rofile_

Val:

  • Inaktiverad: Inaktiverar profilkontofunktionen. När den här funktionen är inaktiverad visas inte menyn Konfiguration av profilkonto på telefonskärmen.

  • Grundläggande HTTP-autentisering: HTTP-inloggningsuppgifterna används för att autentisera profilkontot.

  • XSI-autentisering: XSI-inloggningsuppgifter eller XSI SIP-inloggningsuppgifter används för att autentisera profilkontot. Autentiseringsuppgifterna beror på XSI-autentiseringstypen för telefonen:

    När XSI-autentiseringstypen för telefonen är inställd på Inloggningsuppgifter används XSI-inloggningsuppgifterna.

    När XSI-autentiseringstypen för telefonen är inställd på SIP-autentiseringsuppgifter används XSI SIP-autentiseringsuppgifterna.

Standard: Grundläggande HTTP-autentisering

4

Klicka på Skicka in alla ändringar.

Tillämpa en profil manuellt på telefonen

Hämta konfigurationsfilen till telefonen från en TFTP-server

Utför dessa steg för att hämta konfigurationsfilen till ett TFTP-serverprogram på datorn.

1

Anslut datorn till LAN-porten på telefonen.

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, filnamnet och inloggningsuppgifterna. Använd det här formatet:

http://<WAN_IP_-adress>/admin/resync?tftp://<PC_IP_-adress>/<file_name>&xuser=admin&xpassword=

Exempel: 

http://192.168.15.1/admin/resync?tftp://192.168.15.100/my_config.xml&xuser=admin&xpassword=admin
Hämta konfigurationsfilen till telefonen med cURL

Utför dessa steg för att hämta konfigurationen till telefonen med hjälp av cURL. Det här kommandoradsverktyget används för att överföra data med en URL-syntax. För att hämta cURL går du till:

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

Vi rekommenderar att du inte använder cURL för att publicera konfigurationen på telefonen eftersom användarnamn och lösenord kan hämtas när du använder cURL.

1

Anslut datorn till LAN-porten på telefonen.

2

Hämta konfigurationsfilen till telefonen genom att ange följande cURL-kommando:

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

Konfigurationsprofiler

Telefonen accepterar konfigurationer i XML-format.

Exemplen i det här avsnittet använder konfigurationsprofiler med XML-syntax.

Format för konfigurationsprofilen

Konfigurationsprofilen definierar parametervärden för telefonen.

XML-formatet för konfigurationsprofilen använder XML-standardverktyg för att kompilera parametrarna och värdena.

Endast UTF-8-teckenuppsättningen stöds. Om du ändrar profilen i en redigerare ska du inte ändra kodningsformatet. Annars känner inte telefonen igen filen.

Varje telefon har en annan funktionsuppsättning och därför en annan uppsättning parametrar.

Format för öppen profil

Profilen med öppet format är en textfil med XML-liknande syntax i en hierarki med elementattribut och elementvärden. I det här formatet kan du använda standardverktyg för att skapa konfigurationsfilen. En XML-konfigurationsfil kan skickas från etableringsservern till telefonen under en omsynkronisering, utan att kompilera som binärt objekt.

Telefonen kan godkänna konfigurationsformat som genereras av standardverktyg. Den här funktionen underlättar utvecklingen av programvara för backend-etableringsservern som genererar konfigurationsprofiler från befintliga databaser.

För att skydda konfidentiell information i konfigurationsprofilen skickar etableringsservern XML-konfigurationsfilen till telefonen via en kanal som skyddas av TLS. Om du vill kan filen komprimeras med hjälp av gzip-komprimeringsalgoritmen (RFC1951).

Filen kan krypteras med någon av följande krypteringsmetoder:

  • AES-256-CBC-kryptering

  • RFC-8188 baserad HTTP-innehållskryptering med AES-128-GCM chiffrering

En konfigurationsfil kan innehålla följande komponenter:

  • Elementtaggar

  • Attribut

  • Parametrar

  • Formateringsfunktioner

  • XML-kommentarer

Exempel: Format för öppen profil

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

Elementtaggen omfattar 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 konfiguration av samma inställningar. XML-taggnamnen och fältnamnen i webbgränssnittet är liknande men varierar på grund av begränsningar för XML-elementnamn. Till exempel understreck ( _ ) i XML-konfigurationsfilen i stället för mellanslag i webbgränssnittet.

  • Telefonen känner igen element med korrekta parameternamn som är inkapslade i det särskilda -elementet.

  • Elementnamn omges av vinkelparenteser.

  • De flesta elementnamn liknar fältnamnen i telefonens webbgränssnitt, med följande ändringar:

    • Elementnamn får inte innehålla blanksteg eller specialtecken. Om du vill härleda elementnamnet från webbfältnamnet ersätter du ett understreck för varje mellanslag eller specialtecknen [, ], (, ) eller /.

      Exempel: Elementet <Resync_On_Reset> representerar fältet Omsynkronisering vid återställning .

    • Varje elementnamn måste vara unikt. I telefonens webbgränssnitt kan samma fält visas på flera webbsidor, till exempel sidorna Linje, Användare och Anknytning. Lägg till [n] i elementnamnet för att indikera numret som visas på sidfliken.

      Exempel: Elementet <Dial_Plan_1_> representerar nummerplanen för linje 1.

  • Varje inledande elementtagg måste ha en matchande avslutande elementtagg. Till exempel:

      <Resync_On_Reset> Ja On_Reset> <Resync_Periodic> 7200 Periodic> <Profile_Rule>tftp://prov.telco.com:esync_esync_ 6900/cisco/config/CP_xxxx_MPP.cfg Rule>
    rofile_

  • Elementtaggar är skiftlägeskänsliga.

  • Tomma elementtaggar tillåts och kommer att tolkas som att värdet ska vara tomt. Ange den inledande elementtaggen utan motsvarande elementtagg och infoga ett mellanslag och ett snedstreck före stängningsvinkelfä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 värden som tillhandahålls av användaren skrivs över under en omsynkronisering. I följande exempel är användarens kortnummerinställningar oförändrade:

    <flat-profile> <Speed_Kategori: Utbildningial_2-stjärniga_Namn ua="rw"/> <Speed_Kategori: Utbildningial_2-stjärniga_Nummer ua="rw"/> <Speed_Kategori: Utbildningial_3-stjärniga_Namn ua="rw"/> <Speed_Kategori: Utbildningial_3-stjärniga_Nummer ua="rw"/> <Speed_Kategori: Utbildningial_4-stjärniga_Namn ua="rw"/> <Speed_Kategori: Utbildningial_4-stjärniga_Nummer ua="rw"/> <Speed_Kategori: Utbildningial_5-stjärniga_Namn ua="rw"/> <Speed_Kategori: Utbildningial_5-stjärniga_Nummer ua="rw"/> <Speed_Kategori: Utbildningial_6-månadersperiod_Namn ua="rw"/> <Speed_Kategori: Utbildningial_6-månadersperiod_Nummer ua="rw"/> <Speed_Kategori: Utbildningial_7:e_Namn ua="rw"/> <Speed_Kategori: Utbildningial_7:e_Nummer ua="rw"/> <Speed_Kategori: Utbildningial_8_Namn ua="rw"/> <Speed_Kategori: Utbildningial_8_Nummer ua="rw"/> <Speed_Kategori: Utbildningial_9:e_Namn ua="rw"/> <Speed_Kategori: Utbildningial_9:e_Nummer ua="rw"/> </flat-profile>

  • Använd ett tomt värde om du vill ange motsvarande parameter till en tom sträng. Ange ett inledande och avslutande element 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>   A> </flat-profile>
    _

  • Ej igenkä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.

  • Parametrar som inte känns igen ignoreras.

  • Om profilen med öppet format innehåller flera förekomster av samma parametertagg åsidosätter den sista förekomster 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 bearbetade profilen har företräde. Om flera profiler anger samma konfigurationsparameter prioriteras värdet för den senare profilen.

Strängformat

Dessa egenskaper gäller formateringen av strängarna:

  • Kommentarer tillåts via XML-standardsyntax.

  • Inledande och efterföljande blanksteg tillåts för läsbarhet men tas bort från parametervärdet.

  • Nya linjer inom ett värde konverteras till mellanslag.

  • Ett XML-sidhuvud i formuläret <? ?> är tillåtet, men telefonen ignorerar det.

  • Om du vill ange specialtecken använder du grundläggande XML-tecken som visas i följande tabell.

    Specialtecken

    XML-escape-sekvens

    & (ampersand)

    &

    < (mindre än)

    <

    > (större än)

    >

    ” (apostrof)

    '

    ” (dubbla citattecken)

    "

    I följande exempel anges escape-tecken för att representera symbolerna större än och mindre än som krävs i en nummerplansregel. Detta exempel definierar en nummerplan för hotline som ställer in <Dial_Plan_1_>-parametern (Administratörsinloggning > avancerad > Röst > Ankn (n)) lika med (S0 ).

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

  • Numeriska escape-tecken med decimalvärden och hexadecimala värden (t.ex. ( och .) är översatta.

  • Telefonens inbyggda programvara stöder endast ASCII-tecken.

Komprimering och kryptering av öppen profil (XML)

Den öppna konfigurationsprofilen kan komprimeras för att minska nätverksbelastningen på etableringsservern. Profilen kan också krypteras för att skydda konfidentiell information. Komprimering krävs inte, men måste föregå kryptering.

Komprimering av öppen profil

Komprimeringsmetoden som stöds är gzip-komprimeringsalgoritmen (RFC1951). Verktyget gzip och komprimeringsbiblioteket som implementerar samma algoritm (zlib) är tillgängliga från webbplatser på Internet.

För att identifiera komprimering förväntar sig telefonen att den komprimerade filen innehåller en gzip-kompatibel rubrik. Anropet av gzip-verktyget i den ursprungliga öppna profilen genereras. Telefonen kontrollerar den hämtade filrubriken för att fastställa filformatet.

Om till exempel profile.xml är en giltig profil accepteras även filen profile.xml.gz . Något av följande kommandon kan generera den här profiltypen:

  • >gzip profile.xml

    Ersätter den ursprungliga filen med den komprimerade filen.

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

    Lämnar originalfilen på plats och skapar en ny komprimerad fil.

Kryptering av öppen profil

Kryptering med symmetriska nycklar kan användas för att kryptera en öppen konfigurationsprofil, oavsett om filen är komprimerad eller inte. Komprimering, om den används, måste tillämpas före kryptering.

Etableringsservern använder HTTPS för att hantera den inledande etableringen av telefonen efter distribution. Med förhandskryptering av konfigurationsprofiler offline kan du använda HTTP för att synkronisera profiler senare. Detta minskar belastningen på HTTPS-servern i storskaliga distributioner.

Telefonen har stöd för två krypteringsmetoder för konfigurationsfiler:

  • AES-256-CBC-kryptering

  • RFC 8188-baserad HTTP-innehållskryptering med AES-128-GCM chiffrering

Nyckeln eller Input Keying Material (IKM) måste företableras till enheten vid en tidigare tidpunkt. Startfunktionen av den hemliga nyckeln kan utföras på ett säkert sätt med hjälp av HTTPS.

Namnet på konfigurationsfilen kräver inte ett specifikt format, men ett filnamn som slutar med tillägget .cfg anger normalt en konfigurationsprofil.

AES-256-CBC-kryptering

Telefonen stöder AES-256-CBC-kryptering för konfigurationsfiler.

Krypteringsverktyget OpenSSL, som kan hämtas från olika webbplatser på Internet, kan utföra krypteringen. Stöd för 256-bitars AES-kryptering kan kräva omkompilering av verktyget för att aktivera AES-koden. Den fasta programvaran har testats mot version openssl-1.1.1d.

För en krypterad fil förväntar sig profilen att filen har samma format som genererats av följande kommando:

 # exempel på krypteringsnyckel = SecretPhrase384 openssl enc –e –aes-256-cbc –k SecretPhrase384 –in profile.xml –out profile.cfg # analog anropning för en komprimerad xml-fil openssl enc –e –aes-256-cbc –k SecretPhrase384 –in profile.xml.gz –out profile.cfg

En liten -k föregår den hemliga nyckeln, som kan vara en oformaterad textfras, och som används för att generera ett slumpmässigt 64-bitars salt. Med hemligheten som anges av argumentet -k hämtar krypteringsverktyget en slumpmässig första 128-bitars vektor och den faktiska 256-bitars krypteringsnyckeln.

När den här formen av kryptering används på en konfigurationsprofil måste telefonen informeras om värdet för hemlig nyckel för att dekryptera filen. Detta värde anges som en kvalificerare i profil-URL:en. Syntaxen är följande och använder en uttrycklig URL:

 [--nyckel “SecretPhrase”] http://prov.telco.com/path/profile.cfg

Detta värde programmeras med hjälp av en av Profile_Rule -parametrarna.

Makroexpandering

Flera etableringsparametrar genomgår intern makroexpandering innan de utvärderas. Detta förutvärderingssteg ger större flexibilitet vid kontroll av omsynkroniserings- och uppgraderingsaktiviteter för telefonen.

Dessa parametergrupper genomgår makroexpandering före utvärdering:

  • Resync_Trigger_*

  • Profile_-regel*

  • Log_xxx_Msg

  • Upgrade_-regel

Under vissa omständigheter genomgår även vissa allmänna parametrar (GPP_*) makroexpandering, vilket uttryckligen anges i avsnittet Valfria omsynkroniseringsargument nedan.

Under makroexpandering ersätter innehållet i de namngivna variablerna uttryck i formatet $NAME och $(NAME). Dessa variabler omfattar allmänna parametrar, flera produktidentifierare, vissa händelsetimer och värden för etableringsstatus. En fullständig lista finns i Makroexpansionsvariabler under Etableringsparametrar.

I följande exempel används uttrycket $(MAU) för att infoga MAC-adressen 000E08012345.

Administratören anger: $(MAU)config.cfg

Den resulterande makroexpanderingen för en enhet med MAC-adressen 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 anger: $STRANGE$MAU.cfg

Den resulterande makroexpanderingen för en enhet med MAC-adressen 000E08012345 är: $STRANGE176E08012345.cfg

Makroexpandering tillämpas inte rekursivt. Till exempel expanderas $$MAU” till $MAU” ($$ expanderas) och resulterar inte i MAC-adressen.

Innehållet i specialparametrarna, GPP_SA till och med GPP_SD, mappas till makrouttrycken $SA till och med $SD. Dessa parametrar makroexpanderas endast som argument för alternativen --key , --uid och --pwd i en omsynkroniserings-URL.

Villkorsuttryck

Villkorsuttryck kan utlösa omsynkroniseringshändelser och välja bland alternativa URL:er för omsynkroniserings- och uppgraderingsåtgärder.

Villkorsuttryck består av en lista med jämförelser, avgränsade med operatorn och . Alla jämförelser måste uppfyllas för att villkoret ska vara sant.

Varje jämförelse kan avse någon av följande tre typer av literaler:

  • Heltalsvärden

  • Versionsnummer för programvara eller maskinvara

  • Strängar med dubbla citattecken

Versionsnummer

Programvaruversionen för Cisco Video Phone 8875 använder detta format (där BN är build-numret):

TELEFONERåååå.1-0-1-0001-BN

där yyyy anger telefonmodellen eller telefonserien, 1 är den större versionen, 0 är den mindre versionen, 1-0001 är mikroversionen och BN är build-numret.

Jämförelsesträngen måste använda samma format. Annars resulterar ett formattolkningsfel.

Vid jämförelse av programvaruversionen jämförs huvudversionen, delversionen och mikroversionen i följd, och siffrorna längst till vänster har företräde framför de senare. När versionsnumren är identiska jämförs build-numret.

Exempel på giltigt versionsnummer

telefon-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 profil med öppet format.

Operatör

Alternativ syntax

Beskrivning

Gäller för heltal och versionsoperander

Gäller för citerade strängoperander

=

eq

lika med

Ja

Ja

!=

ne

inte lika med

Ja

Ja

<

Det

mindre än

Ja

Nej

<=

le

mindre än eller lika med

Ja

Nej

>

gt

större än

Ja

Nej

>=

ge

större än eller lika med

Ja

Nej

Och

och

Ja

Ja

Det är viktigt att makrovariabler omsluts med dubbla citattecken där en strängliteral förväntas. Gör inte det när ett nummer eller versionsnummer förväntas.

När de används i samband med parametrarna Profile_Rule* och Upgrade_Rule måste villkorsuttryck ingå i syntaxen ”(expr)?” som i det här exemplet på uppgraderingsregeln. Kom ihåg att ersätta BN med versionsnumret för den fasta programvaran som du vill uppgradera till.

($SWVER inte 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 Resync_Trigger_*-parametrarna.

URL-syntax

Använd URL-standardsyntaxen för att ange hur konfigurationsfiler och fast programvara ska hämtas i parametrarna Profile_Rule* respektive Upgrade_Rule. Syntaxen är följande:

[ schema:// ] [ server [:port]] filsökväg

Där schema är ett av dessa värden:

  • tftp-plats

  • http

  • https

Om schemat utelämnas antas tftp. Servern kan vara ett DNS-igenkänt värdnamn eller en numerisk IP-adress. Porten är destinationens UDP- eller TCP-portnummer. Filsökvägen måste börja med rotkatalogen (/). Den måste vara en absolut sökväg.

Om server saknas används tftp-servern som anges via DHCP (alternativ 66).

Servern måste anges för uppgraderingsregler.

Om port saknas används standardporten för det angivna schemat. Tftp använder UDP-port 69, http använder TCP-port 80 och https använder TCP-port 443.

En filsökväg måste finnas. Den behöver inte nödvändigtvis referera till en statisk fil, men kan indikera dynamiskt innehåll som hämtas via CGI.

Makroexpandering används inom URL:er. Följande är exempel på giltiga URL:er:

 /$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 uppgraderingsregler. Den är endast tillämplig för profilregel*.

RFC 8188-baserad kryptering av HTTP-innehåll

Telefonen stöder RFC 8188-baserad HTTP-innehållskryptering med AES-128-GCM chiffrering för konfigurationsfiler. Med den här krypteringsmetoden kan alla enheter läsa HTTP-meddelanderubrikerna. Men endast de enheter som känner till Input Keying Material (IKM) kan läsa nyttolasten. När telefonen etableras med IKM kan telefonen och etableringsservern utbyta konfigurationsfiler på ett säkert sätt, samtidigt som nätverkselement från tredje part kan använda meddelanderubrikerna i analytiska och övervakande syften.

XML-konfigurationsparametern IKM_HTTP_Encrypt_Content innehåller IKM på telefonen. Av säkerhetsskäl är den här parametern inte tillgänglig på webbsidan för telefonadministration. Den visas inte heller i telefonens konfigurationsfil, som du kan komma åt från telefonens IP-adress eller från telefonens konfigurationsrapporter som skickas till etableringsservern.

Om du vill använda RFC 8188-baserad kryptering ska du kontrollera följande:

  • Tillhandahåll telefonen med IKM genom att ange IKM med XML-parametern IKM_HTTP_Encrypt_Content i konfigurationsfilen som skickas från etableringsservern till telefonen.

  • Om denna kryptering tillämpas på konfigurationsfilerna som skickas från etableringsservern till telefonen ska du se till att HTTP-sidhuvudet Content-Encoding i konfigurationsfilen har aes208 gcm.

    I avsaknad av detta sidhuvud 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 denna kryptering på de konfigurationsrapporter som den skickar till etableringsservern ska du se till att det inte finns någon angiven AES-256-CBC-nyckel i rapportregeln.

Valfria omsynkroniseringsargument

Valfria argument, nyckel, uid och pwd, kan föregå de URL:er som anges i parametrarna Profile_Rule* , som tillsammans omges av hakparenteser.

knapp

Alternativet --key talar om för telefonen att konfigurationsfilen som den tar emot från etableringsservern är krypterad med AES-256-CBC-kryptering, såvida inte sidhuvudet Content-Encoding i filen anger aes208 gcm -kryptering. Själva nyckeln anges som en sträng efter termen --key. Nyckeln kan även omslutas med dubbla citattecken (”). Telefonen använder nyckeln för att avkryptera konfigurationsfilen.

Användningsexempel
 [--key VerySecretValue] [--key “min hemliga fras”] [--key a37d2fb9055c1d04 a0745eb0917a4]

De streckade valfria argumenten är makroexpanderade. Specialparametrar, GPP_SA till och med GPP_SD, makroexpanderas endast till makrovariabler, $SA till och med $SD, när de används som argument för nyckelalternativ. Se följande exempel:

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

I profiler med öppet format måste argumentet till --key vara samma som argumentet till alternativet -k som ges till openssl.

uid och pwd

Alternativen uid och pwd kan användas för att ange användar-ID och lösenord som skickas som svar på HTTP Basic- och Digest-autentiseringsproblem när angiven URL begärs. De streckade valfria argumenten är makroexpanderade. Specialparametrar, GPP_SA till och med GPP_SD, makroexpanderas endast till makrovariabler, $SA till och med $SD, när de används som argument för nyckelalternativ. Se följande exempel:

GPP_SA = mitt användar-ID GPP_SB = mitt hemliga lösenord

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

skulle sedan expandera till:

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

Datatyper

Dessa datatyper används med parametrar för konfigurationsprofilen:

  • {a,b,c, ｟_ph_25｠} – Ett val bland a, b, c, ｟_ph_25｠

  • Bool – Booleskt värde på antingen ”ja” eller ”nej”.

  • CadScript – Ett miniskript som anger kadensparametrarna för en signal. Upp till 127 tecken.

    Syntax: S1[;S2], där:

    • s:ti Sverige=di Sverige(påi,1/avi,1[,påi,2/avi,2[,påKategori: Personer med funktionsnedsättning/avKategori: Personer med funktionsnedsättning[,påKategori: Personer med funktionsnedsättning/avKategori: Personer med funktionsnedsättning[,påi,5/avi,5[,påi,6/avi,6]]]]) och kallas ett avsnitt.

    • oni,j och offi,j är på/av-varaktigheten i sekunder för ett segment. i = 1 eller 2 och j = 1 till 6.

    • Di är avsnittets totala varaktighet i sekunder.

    Alla durationer kan ha upp till tre decimaler för att ge en ms upplösning. Jokertecknet ”*” står för en oändlig varaktighet. Segmenten i ett avsnitt spelas upp i ordning och upprepas tills den totala varaktigheten spelas upp.

    Exempel 1:

     60(2/4) Antal kadensavsnitt = 1 Kadensavsnitt 1: Avsnittslängd = 60 s Antal segment = 1 Segment 1: On=2s, Av=4s Total ringlängd = 60s

    Exempel 2 – Distinkt ringsignal (kort, kort, kort, lång):

     60(.2/.2,.2/.2,.2/.2,1/4) Antal kadensavsnitt = 1 kadensavsnitt 1: Avsnittslängd = 60 s Antal segment = 4 Segment 1: På=0,2s, Av=0,2s Segment 2: På=0,2s, Av=0,2s Segment 3: På=0,2s, Av=0,2s Segment 4: On=1,0 s, Av=4,0 s Total ringlängd = 60 s

  • DialPlanScript – Skriptsyntax som används för att ange nummerplaner för linje 1 och linje 2.

  • Float – Ett flyttal med upp till n decimaler.

  • FQDN – fullständigt kvalificerat domännamn. Den kan innehålla upp till 63 tecken. Exempel på detta är:

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

    • sip.Cisco.com eller 109.12.14.12

  • FreqScript – Ett miniskript som anger frekvens- och nivåparametrar för en ton. Innehåller upp till 127 tecken.

    Syntax: F1@L1[,F2@L2[,F3@L3[,F4@L4[,F5@L5[,F6@L6]]]]], där:

    • F1–F6 är frekvensen i Hz (endast osignerade heltal).

    • L1–L6 ä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 – Ton för samtal väntar:

     440@-10 Antal frekvenser = 1 frekvens 1 = 440 Hz vid –10 dBm

    Exempel 2 – Kopplingston:

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

  • IP – Giltig IPv4-adress i formatet x.x.x.x, där x är mellan 0 och 255. Exempel: 10.1.2.100.

  • UserID – Användar-ID som det visas i en URL. Upp till 63 tecken.

  • Telefon – En telefonnummersträng, till exempel 14081234567, *69, *72, 345678, eller en allmän URL, 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 avgränsas med kommatecken (,). Blanktecken i början av varje mönster ignoreras. ”?” och ”*” representerar jokertecken. För att representera bokstavligt, använd %xx. For example, %2a representerar *. Mallen kan innehålla upp till 39 tecken. Exempel: ”1408*, 1510*”, ”1408123????, 555?1.”

  • Port – TCP-/UDP-portnummer (0–65535). Den kan anges i decimalformat eller hexadecimalt format.

  • ProvisioningRuleSyntax – Skriptsyntax som används för att definiera regler för konfigurationssynkronisering och uppgradering av fast programvara.

  • PwrLevel – Strömnivå uttryckt i dBm med en decimal, till exempel –13,5 eller 1,5 (dBm).

  • RscTmplt – En mall för statuskod för SIP-svar, t.ex. ”404, 5*”, ”61?”, ”407, 408, 487, 481”. Den kan innehålla upp till 39 tecken.

  • Sig – Signerat n-bitarvärde. Den kan anges i decimalformat eller hexadecimalt format. Ett ”-”-tecken måste föregås av 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 – En generisk sträng med upp till n oreserverade tecken.

  • Tid – 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 samtalsförloppston. Skriptet kan innehålla upp till 127 tecken.

    Syntax: FreqScript;Z1[;Z2].

    Avsnitt Z1 liknar avsnittet S1 i en CadScript, förutom att varje på/av-segment följs av en parameter för frekvenskomponenter: Z-dur1 = d1(påi,1/avi,1/fi,1[,påi,2/avi,2/fi,2 [,påKategori: Personer med funktionsnedsättning/avKategori: Personer med funktionsnedsättning/fKategori: Personer med funktionsnedsättning [,påKategori: Personer med funktionsnedsättning/avKategori: Personer med funktionsnedsättning/fKategori: Personer med funktionsnedsättning [,påi,5/avi,5/fi,5 [,påi,6/avi,6/fi,6]]]]) där

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

    • 1 < nk < 6 anger frekvenskomponenterna i FreqScript som används i det segmentet.

    Om mer än en frekvenskomponent används i ett segment summeras komponenterna.

    Exempel 1 – Kopplingston:

     350@-19,440@-19;10(*/0/1+2) Antal frekvenser = 2 Frekvens 1 = 350 Hz vid –19 dBm Frekvens 2 = 440 Hz vid –19 dBm Antal kadensavsnitt = 1 Kadensavsnitt 1: Avsnittslängd = 10 s Antal segment = 1 Segment 1: On=forever, med frekvenserna 1 och 2 Total tonlängd = 10s

    Exempel 2 – Kopplingston:

     350@-19,440@-19;2(.1/.1/1+2);10(*/0/1+2) Antal frekvenser = 2 Frekvens 1 = 350 Hz vid –19 dBm Frekvens 2 = 440 Hz vid –19 dBm Antal kadenssektioner = 2 Kadenssektion 1: Avsnittslängd = 2s Antal segment = 1 Segment 1: På=0,1s, Av=0,1s med frekvens 1 och 2 kadensavsnitt 2: Avsnittslängd = 10 s Antal segment = 1 Segment 1: On=forever, med frekvenserna 1 och 2 Total tonlängd = 12 s

  • Uns – Osignerat n-bitsvärde, där n = 8, 16 eller 32. Det kan anges i decimalformat eller hexadecimalt format, t.ex. 12 eller 0x18, så länge värdet kan passa in i n bitar.

Ta dessa i beaktande:

  • representerar ett konfigurationsparameternamn. I en profil skapas motsvarande tagg genom att utrymmet ersätts med ett understreck ”_”, t.ex. Par_Namn.
  • 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 angiven ordning. Den första, inte närmaste, matchningen har valts. Parameternamnet måste matcha exakt.
  • Om mer än en definition för en parameter anges i en profil är den sista definitionen i filen den som gäller i telefonen.
  • En parameterspecifikation med ett tomt parametervärde tvingar parametern tillbaka till standardvärdet. Om du istället vill ange en tom sträng använder du den tomma strängen "" som parametervärde.