I den här artikeln
dropdown icon
Konfigurera din telefon för profilsynkronisering
    Synkronisera telefonprofilen igen via TFTP
    Skapa en telefonspecifik profil på en TFTP-server
    Synkronisera telefonprofilen igen med HTTP GET
    Synkronisera telefonprofilen automatiskt
    Parametrar för återsynkronisering av profil
    Tillhandahållande via Cisco XML
    URL-upplösning med makroexpansion
    Ange profilautentiseringstyp
dropdown icon
Tillämpa en profil manuellt på telefonen
    Ladda ner konfigurationsfilen till telefonen från en TFTP-server
    Ladda ner konfigurationsfilen till telefonen med cURL
dropdown icon
Referenser för profilkonfiguration
    Konfigurationsprofilformat
    Öppna profilkomprimering
    Öppna profilkryptering
    Valfria återsynkroniseringsargument
    Datatyper

Konfigurera profilinställningar för 9800-serien och 8875-telefoner (BroadWorks)

list-menuI den här artikeln
list-menuHar du feedback?

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:

<flat-profile>
  <GPP_A> 12345678
  </GPP_A>
</flat-profile>
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:


http://192.168.1.100/admin/advanced

6

Välj fliken Röst > Till handahållande 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:


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 konfigurationsprofilfilen basic.txt från TFTP-servern på IP-adress 192.168.1.200. Telefonen analyserar sedan den nedladdade filen och uppdaterar parametern GPP_A med värdet 12345678.

8

Kontrollera att parametern uppdaterades korrekt. Uppdatera administrationswebbsidan och gå till Rö st > Provisioning.

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 CP-xxxx macaddress.cfg (ersätt xxxx med modellnummer och macaddress med telefonens MAC -adress).

Exempel:

CP-8875 000e08aabbcc.cfg

3

Flytta den nya filen till den virtuella rotkatalogen på TFTP-servern.

4

Gå till webbsidan för telefonadministration.

5

Välj Röst > Tillhandah ållande.

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


<Profile_Rule>
tftp://192.168.1.200/CP-8875$MA.cfg
</Profile_Rule>
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:

<Profile_Rule>
http://192.168.1.200/basic.txt
</Profile_Rule>
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 Röst > Tillhandah ållande.

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.


<Resync_On_Reset>Yes</Resync_On_Reset>

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.


<Resync_Error_Retry_Delay>30</Resync_Error_Retry_Delay>

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 > Till handah ål lande på 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.

Tabell 1. Parametrar för återsynkronisering av profil

Parameter

Beskrivning

Aktivera tillhandahållande

Tillåter eller nekar återsynkroniseringsåtgärder för konfigurationsprofil.

  • I telefonkonfigurationsfilen (cfg.xml) med XML anger du en sträng i detta format:

    <Provision_Enable ua="na">Ja</Provision_Enable>
  • På telefonens webbsida anger du fältet Ja för att tillåta återsynkroniseringsåtgärder eller Nej för att blockera återsynkroniseringsåtgärder.

Standard: Ja

Synkronisera igen vid återställning

Anger om telefonen synkroniserar konfigurationer igen med etableringsservern efter uppstart och efter varje uppgraderingsförsök.

  • I telefonkonfigurationsfilen (cfg.xml) med XML anger du en sträng i detta format:

    <Resync_On_Reset ua="na">Ja</Resync_On_Reset>
  • På telefonens webbsida ställer du in det här fältet till Ja för att tillåta återsynkronisering vid uppstart eller återställning, eller Nej för att blockera omsynkronisering vid start eller återställning.

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.

  • I telefonkonfigurationsfilen (cfg.xml) med XML anger du en sträng i detta format:

    <Resync_Random_Delay ua="na">2</Resync_Random_Delay>
  • På telefonens webbsida anger du antalet enheter (20 sekunder) för att telefonen ska fördröja återsynkronisering efter uppstart eller återställning.

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.

  • I telefonkonfigurationsfilen (cfg.xml) med XML anger du en sträng i detta format:

    <Resync_At__HHmm_ ua="na">0959</Resync_At__HHmm_>
  • På telefonens webbsida anger du tiden i HHMM-format för att telefonen ska starta omsynkronisering.

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.

  • I telefonkonfigurationsfilen (cfg.xml) med XML anger du en sträng i detta format:

    <Resync_At_Random_Delay ua="na">600</Resync_At_Random_Delay>
  • Ange tidsperioden i sekunder på telefonens webbsida.

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:

  • Ett heltal

    Exempel: En ingång på 3000 indikerar att nästa återsynkronisering sker på 3000 sekunder.

  • Flera heltal

    Exempel: En ingång på 600,1200,300 indikerar att den första återsynkroniseringen sker på 600 sekunder, den andra återsynkroniseringen sker på 1200 sekunder efter den första och den tredje återsynkroniseringen sker på 300 sekunder efter den andra.

  • Ett tidsintervall

    Exempelvis indikerar en ingång på 2400+30 att nästa omsynkronisering sker mellan 2400 och 2430 sekunder efter en lyckad omsynkronisering.

  • I telefonkonfigurationsfilen (cfg.xml) med XML anger du en sträng i detta format:

    <Resync_Periodic ua="na">3600</Resync_Periodic>
  • Ange tidsperioden i sekunder på telefonens webbsida.

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:

  • Ett heltal

    Exempel: En ingång på 300 indikerar att nästa försök för återsynkronisering sker på 300 sekunder.

  • Flera heltal

    Exempel: En ingång på 600 200 300 indikerar att det första omförsöket inträffar inom 600 sekunder efter felet, det andra försöket inträffar på 1200 sekunder efter misslyckandet i det första omförsöket och det tredje försöket inträffar på 300 sekunder efter misslyckandet i det andra försöket.

  • Ett tidsintervall

    Exempelvis indikerar en inmatning på 2400+30 att nästa försök inträffar mellan 2400 och 2430 sekunder efter ett återsynkroniseringsfel.

Om fördröjningen är inställd på 0 försöker enheten inte synkronisera igen efter ett misslyckat återsynkroniseringsförsök.

  • I telefonkonfigurationsfilen (cfg.xml) med XML anger du en sträng i detta format:

    <Resync_Error_Retry_Delay ua="na">60,120,240,480,960,1920,3840,7680,15360,30720,61440,8640.8640.86400</Resync_Error_Retry_Delay>
  • Ange tidsperioden i sekunder på telefonens webbsida.

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.

  • I telefonkonfigurationsfilen (cfg.xml) med XML anger du en sträng i detta format:

    <Forced_Resync_Delay ua="na">14400</Forced_Resync_Delay>
  • Ange tidsperioden i sekunder på telefonens webbsida.

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.

  • I telefonkonfigurationsfilen (cfg.xml) med XML anger du en sträng i detta format:

    <Resync_From_SIP ua="na">Ja</Resync_From_SIP>
  • På telefonens webbsida väljer du Ja för att aktivera den här funktionen, eller Nej för att inaktivera den.

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.

  • I telefonkonfigurationsfilen (cfg.xml) med XML anger du en sträng i detta format:

    <Resync_After_Upgrade_Attempt ua="na">Ja</Resync_After_Upgrade_Attempt>
  • På telefonens webbsida väljer du Ja för att utlösa återsynkronisering efter en uppgradering av den inbyggda programvaran, eller Nej för att inte synkronisera om.

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.

  • I telefonkonfigurationsfilen (cfg.xml) med XML anger du en sträng i detta format:

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

    <Resync_Trigger_2 ua="na"/>

  • Ange utlösare på telefonens webbsida.

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.

  • I telefonkonfigurationsfilen (cfg.xml) med XML anger du en sträng i detta format:

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

  • På telefonens webbsida väljer du Ja för att visa parametern Profilregel på telefonmenyn, eller välj Nej för att dölja den här parametern.

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 inte hittades från servern som en lyckad återsynkronisering.

  • I telefonkonfigurationsfilen (cfg.xml) med XML anger du en sträng i detta format:

    <Resync_Fails_On_FNF ua="na">Ja</Resync_Fails_On_FNF>
  • På telefonens webbsida väljer du Ja om du vill ta ett svar som inte hittades som en misslyckad återsynkronisering, eller välj Nej för att ta ett svar som inte hittades som en lyckad återsynkronisering.

Standard: Ja

Typ av profilautentisering

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

  • Inaktiver ad: Inaktiverar profilkontofunktionen. När den här funktionen är inaktiverad visas inte inställningsmenyn Profilkonto på telefonskärmen.

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

  • XSI-autentisering: XSI-inloggningsuppgifter eller XSI SIP-referenser används för att autentisera profilkontot. Autentiseringsuppgifterna beror på telefon ens XSI-autenti seringstyp:

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

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

  • I telefonkonfigurationsfilen (cfg.xml) med XML anger du en sträng i detta format:

    <Profile_Authentication_Type ua="na">Grundläggande Http-autentisering</Profile_Authentication_Type>
  • På telefonens webbsida väljer du ett alternativ i listan för telefonen för att autentisera profilsynkronisering.

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.

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

[--nyckel] <encryption key>

Du kan bifoga krypteringsnyckeln med dubbla citattecken (”) valfritt.

  • I telefonkonfigurationsfilen (cfg.xml) med XML anger du en sträng i detta format:

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

    <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, 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 efter servernamnet.

  • 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 Röst > Tillhandah ållande.

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:

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

Alternativ:

  • Inaktiver ad: Inaktiverar profilkontofunktionen. När den här funktionen är inaktiverad visas inte inställningsmenyn Profilkonto på telefonskärmen.

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

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

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

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

Exempel:

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

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:

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

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.

Endast teckenuppsättningen UTF-8 stöds. Om du ändrar profilen i en redigerare ändrar du inte kodningsformatet, annars kan telefonen inte känna igen filen.

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 (Administratörsinloggning > avanc erat > Rö st > Ext (n)) lika med (S0 <:18005551212>).

    
    <flat-profile>
     <Dial_Plan_1_>
      (S0 &lt;:18005551212&gt;)
     </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.xml

    Ersätter originalfilen med komprimerad fil.

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

    Lä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ån provisioneringsservern 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 --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. Nyckeln själv anges som en sträng efter termen --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 = 60s
    
    

    Exempel 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 dBm
    
    

    Exempel 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 = 10s
    
    

    Exempel 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.
Var den här artikeln användbar?
Var den här artikeln användbar?