Uw telefoon configureren voor hersynchronisatie van profielen

Het telefoonprofiel opnieuw synchroniseren via TFTP

De telefoon ondersteunt meerdere netwerkprotocollen voor het ophalen van configuratieprofielen. Het meest eenvoudige profieloverdrachtsprotocol is TFTP (RFC1350). TFTP wordt veel gebruikt voor de inrichting van netwerkapparaten binnen privé LAN-netwerken. Hoewel het niet wordt aanbevolen voor de implementatie van externe eindpunten via het internet, kan TFTP nuttig zijn voor implementatie binnen kleine organisaties, voorinrichting op locatie en het ontwikkelen en testen. In de volgende procedure wordt een profiel aangepast na het downloaden van een bestand van een TFTP-server.

1

Sluit uw computer en de telefoon aan op een hub, switch of kleine router in een LAN-omgeving.

2

Installeer en activeer een TFTP-server op de computer.

3

Gebruik een teksteditor om een configuratieprofiel te maken.

Als u later wilt controleren of het profiel op uw telefoon is ingericht, kunt u enkele waarden als markeringen instellen. Stel bijvoorbeeld de waarde voor GPP_A in op 12345678 zoals wordt weergegeven in het volgende voorbeeld:
<flat-profile>
  <GPP_A> 12345678
  </GPP_A>
</flat-profile>
4

Sla het XML-configuratiebestand op in de hoofdmap van de TFTP-server.

U kunt controleren of de TFTP-server juist is geconfigureerd: vraag het configuratiebestand op via een andere TFTP-client dan de telefoon. Bij voorkeur gebruikt u een TFTP-client die wordt uitgevoerd op een andere host dan de inrichtingsserver.

5

Open de beheerwebpagina in de webbrowser op uw computer. Stel bijvoorbeeld dat het IP-adres van de telefoon 192.168.1.100 is. U opent dan de volgende URL in uw webbrowser:

http://192.168.1.100/admin/advanced
6

Selecteer het tabblad Spraak > Inrichting en controleer de waarden van de parameters voor algemene doeleinden GPP_A tot GPP_P. Deze zouden leeg moeten zijn.

7

Hersynchroniseer de testtelefoon met het configuratieprofiel dat u hebt gemaakt door de URL voor hersynchronisatie in een webbrowser te openen.

Voorbeeld:

Als het IP-adres van de TFTP-server 192.168.1.200 is, zou de opdracht vergelijkbaar moeten zijn met het volgende voorbeeld:

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

Wanneer de telefoon deze opdracht ontvangt, vraagt het apparaat op adres 192.168.1.100 het configuratieprofielbestand basic.txt op van de TFTP-server op IP-adres 192.168.1.200. De telefoon parseert het gedownloade bestand vervolgens en werkt de parameter GPP_A bij met de waarde 12345678.

8

Controleer of de parameter correct is bijgewerkt. Vernieuw de beheerwebpagina en ga naar Spraak > Inrichting..

De parameter GPP_A moet de waarde 12345678 nu bevatten.

Inrichting van een telefoonspecifiek profiel op een TFTP-server
1

Verkrijg het MAC-adres van de telefoon van het productlabel. (Het MAC-adres is het nummer, met cijfers en kleine hexadecimale tekens, bijvoorbeeld 000e08aabbcc.

2

Wijzig de naam van uw configuratiebestand in CP-xxxx macaddress.cfg (vervang xxxx door het modelnummer en macaddress door het MAC adres van de telefoon).

Voorbeeld:

CP-8875 000e08aabbcc.cfg

3

Verplaats het nieuwe bestand naar de virtuele hoofdmap van de TFTP-server.

4

Open de beheerwebpagina van de telefoon.

5

Selecteer Spraak  > Inrichting.

6

Geef het pad van het profielbestand op in het veld Profielregel.

Voorbeeld: veronderstel dat het IP-adres van de TFTP-server 192.168.1.200 is en de naam van het profielbestand is 

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

Klik op Submit All Changes. Hierdoor wordt er direct opnieuw opgestart en gehersynchroniseerd.

Wanneer de volgende hersynchronisatie wordt uitgevoerd, haalt de telefoon het nieuwe bestand op door de macro-expressie $MA uit te breiden tot het MAC-adres.

Het telefoonprofiel hersynchroniseren met HTTP GET
1

Installeer een HTTP-server op de lokale computer of een andere toegankelijke host.

De open-source Apache-server kan worden gedownload van internet.

2

Upload het configuratieprofielbestand naar de virtuele hoofdmap van de geïnstalleerde server.

3

Als u de juiste serverinstallatie en toegang tot het profielbestand wilt verifiëren, opent u het profiel met een webbrowser.

4

Wijzig de Profile_Rule van de testtelefoon om naar de HTTP-server te verwijzen in plaats van de TFTP-server, zodat het profiel periodiek wordt gedownload.

Als er bijvoorbeeld een HTTP-server is op 192.168.1.300 en de naam van het profielbestand basic.txt is, voert u de volgende waarde in:

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

Klik op Submit All Changes. Hierdoor wordt er direct opnieuw opgestart en gehersynchroniseerd.

6

Bekijk de syslog-berichten die de telefoon verzendt. De periodieke hersynchronisaties zouden nu het profiel van de HTTP-server moeten ophalen.

7

In de HTTP-serverlogboeken ziet u hoe de informatie die de testtelefoon identificeert in het logboek van gebruikersagenten verschijnt.

Deze informatie moet de fabrikant, de productnaam, de huidige firmwareversie en het serienummer bevatten.

Het telefoonprofiel automatisch hersynchroniseren

Een apparaat kan periodiek hersynchroniseren naar de inrichtingsserver om ervoor te zorgen dat eventuele profielwijzigingen op de server worden doorgegeven aan het eindpuntapparaat (in tegenstelling tot het verzenden van een expliciet verzoek tot hersynchronisatie naar het eindpunt).

Zodat de telefoon periodiek hersynchroniseert naar een server, wordt er een configuratieprofiel-URL gedefinieerd met de parameter Profile_Rule en wordt er een hersynchronisatieperiode gedefinieerd met de parameter Resync_Periodic.

1

Open de beheerwebpagina van de telefoon.

2

Selecteer Spraak  > Inrichting.

3

Definieer de parameter Profile_Rule. In dit voorbeeld wordt verondersteld dat het IP-adres van de TFTP-server 192.168.1.200 is.

4

Voer in het veld Resync Periodic een kleine waarde in om te testen, zoals 30 seconden.

5

Klik op Alle wijzigingen verzenden.

Met de nieuwe parameterinstellingen zal de telefoon twee keer per minuut hersynchroniseren naar het configuratiebestand dat de URL specificeert.

6

Bekijk de resulterende berichten in de syslog-tracering.

7

Zorg ervoor dat het veld Resync On Request is ingesteld op Ja.

<Resync_On_Reset>Yes</Resync_On_Reset>
8

Zet de telefoon uit en weer aan om een hersynchronisatie naar de inrichtingsserver af te dwingen.

Als de hersynchronisatie mislukt om een bepaalde reden, zoals dat de server niet reageert, wacht het toestel (voor het aantal seconden dat is geconfigureerd in Resync Error Retry Delay) voordat deze opnieuw probeert te hersynchroniseren. Als de Resync Error Retry Delay wordt ingesteld op 0, probeert de telefoon niet nogmaals te hersynchroniseren na een mislukte hersynchronisatiepoging.

9

(Optioneel) Stel de waarde van het veld Resync Error Retry Delay in op een klein nummer, zoals 30.

<Resync_Error_Retry_Delay>30</Resync_Error_Retry_Delay>
10

Schakel de TFTP-server uit en observeer de resultaten in de syslog-uitvoer.

Parameters voor het hersynchroniseren van profielen

In de volgende tabel worden de functie en het gebruik van de parameters voor hersynchroniseren van profielen in de sectie Configuratieprofiel op het tabblad Spraak > Inrichting op de webpagina van de telefoon gedefinieerd. Hij definieert ook de syntaxis van de tekenreeks die aan het telefoonconfiguratiebestand (cfg.xml) is toegevoegd met XML-code om een parameter te configureren.

Tabel 1. Parameters voor het hersynchroniseren van profielen

Parameter

Beschrijving

Inrichting inschakelen

Hiermee worden hersynchronisatieacties toegestaan of geweigerd.

  • Voer in het telefoonconfiguratiebestand met XML (cfg.xml) een tekenreeks in deze notatie in:

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

  • Op de webpagina van de telefoon stelt u dit veld in op Ja om hersynchronisatieacties toe te staan of op Nee om deze te blokkeren.

Standaard: Ja

Hersynchroniseren bij reset

Hiermee geeft u aan of de telefoon de configuraties opnieuw synchroniseert met de inrichtingsserver na het opstarten en na elke upgradepoging.

  • Voer in het telefoonconfiguratiebestand met XML (cfg.xml) een tekenreeks in deze notatie in:

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

  • Op de webpagina van de telefoon stelt u dit veld in op Ja om hersynchronisatie bij opstarten of resetten toe te staan of op Nee om hersynchronisatie bij opstarten of resetten te blokkeren.

Standaard: Ja

Resync Random Delay (Willekeurige vertraging hersynchr.)

Hiermee wordt overbelasting van de inrichtingsserver voorkomen wanneer een groot aantal apparaten tegelijk opstart en de eerste configuratiepoging uitvoeren. Deze vertraging heeft alleen effect op de eerste configuratiepoging, na het inschakelen of resetten van een apparaat.

De parameter is het maximale tijdsinterval dat het apparaat wacht voordat u contact opneemt met de inrichtingsserver. De werkelijke vertraging is een pseudo-willekeurig getal tussen 0 en deze waarde.

Deze parameter is een eenheid van 20 seconden.

Geldige waarden zijn van 0 tot 65535.

  • Voer in het telefoonconfiguratiebestand met XML (cfg.xml) een tekenreeks in deze notatie in:

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

  • Op de webpagina van de telefoon geeft u het aantal eenheden (20 seconden) op voor de telefoon om de synchronisatie te vertragen na het opstarten of resetten.

De standaardwaarde is 2 (40 seconden).

Resync At (HHmm) (Hersynchroniseren om (UUmm))

De uren en minuten (UUmm) waarop het apparaat hersynchroniseert met de inrichtingsserver.

De waarde voor dit veld moet een viercijferig nummer zijn van 0000 tot 2400 om de tijd in de indeling UUmm aan te geven. 0959 geeft bijvoorbeeld 09:59 aan.

  • Voer in het telefoonconfiguratiebestand met XML (cfg.xml) een tekenreeks in deze notatie in:

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

  • Geef op de webpagina telefoon de tijd op in de uumm-indeling voor de telefoon om de synchronisatie te starten.

De standaardwaarde is leeg. Als de waarde ongeldig is, wordt de parameter genegeerd. Als deze parameter is ingesteld met een geldige waarde, wordt de parameter Periodiek hersynchroniseren genegeerd.

Resync At Random Delay (Hersynchr. bij willekeurige vertraging)

Hiermee wordt overbelasting van de inrichtingsserver voorkomen wanneer een groot aantal apparaten tegelijk opstart.

Om te voorkomen dat de server overbelast raakt met verzoeken voor hersynchronisatie van meerdere telefoons, wordt de telefoon gehersynchroniseerd binnen het bereik van de uren en minuten, en de uren en minuten plus de willekeurige vertraging (hhmm, hhmm + random_delay). Bijvoorbeeld bij: willekeurige vertraging = (Hersynchroniseren bij willekeurige vertraging +30)/60 minuten, wordt de ingevoerde waarde in seconden geconverteerd naar minuten, met afronding naar boven tot de volgende minuut om het uiteindelijke random_delay-interval te berekenen.

  • Voer in het telefoonconfiguratiebestand met XML (cfg.xml) een tekenreeks in deze notatie in:

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

  • Geef op de webpagina van de telefoon de tijdperiode in seconden op.

Geldige waarden zijn van 600 tot 65535.

Als de waarde lager is dan 600, wordt de interne willekeurige vertraging tussen 0 en 600.

De standaardwaarde is 600 seconden (10 minuten).

Resync Periodic (Periodiek hersynchroniseren)

Het tijdsinterval tussen periodieke hersynchronisatie met de inrichtingsserver. De gekoppelde hersynchronisatietimer is alleen actief na de eerste geslaagde synchronisatie met de server.

De geldige indelingen zijn als volgt:

  • Een geheel getal

    Voorbeeld: een invoer van 3000 geeft aan dat de volgende hersynchronisatie over 3000 seconden optreedt.

  • Meerdere gehele getallen

    Voorbeeld: een invoer van 600,1200,300 geeft aan dat de eerste hersynchronisatie optreedt over 600 seconden, de tweede hersynchronisatie 1200 seconden na de eerste en de derde hersynchronisatie 300 seconden na de tweede.

  • Een tijdsbereik

    Bijvoorbeeld, een invoer van 2400+30 geeft aan dat de volgende hersynchronisatie tussen 2400 en 2430 seconden na een geslaagde hersynchronisatie optreedt.

  • Voer in het telefoonconfiguratiebestand met XML (cfg.xml) een tekenreeks in deze notatie in:

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

  • Geef op de webpagina van de telefoon de tijdperiode in seconden op.

Stel deze parameter in op nul om periodieke hersynchronisatie uit te schakelen.

De standaardwaarde is 3600 seconden.

Resync Error Retry Delay (Vertraging nieuwe poging na hersynchronisatiefout)

Als een hersynchronisatiebewerking mislukt omdat het IP-telefonieapparaat geen profiel van de server kan ophalen, omdat het gedownloade bestand beschadigd is of omdat er een interne fout optreedt, probeert het apparaat opnieuw te hersynchroniseren na een in seconden gespecificeerde tijd.

De geldige indelingen zijn als volgt:

  • Een geheel getal

    Voorbeeld: een invoer van 300 geeft aan dat de volgende poging tot hersynchronisatie over 300 seconden optreedt.

  • Meerdere gehele getallen

    Voorbeeld: een invoer van 600,1200,300 geeft aan dat de eerste poging optreedt over 600 seconden na de fout, de tweede poging 1200 seconden nadat de eerste poging is mislukt en de derde poging 300 seconden nadat de tweede poging is mislukt.

  • Een tijdsbereik

    Bijvoorbeeld, een invoer van 2400+30 geeft aan dat de volgende poging tussen 2400 en 2430 seconden na een mislukte hersynchronisatie optreedt.

Als de vertraging wordt ingesteld op 0, probeert het apparaat niet nogmaals te hersynchroniseren na een mislukte hersynchronisatiepoging.

  • Voer in het telefoonconfiguratiebestand met XML (cfg.xml) een tekenreeks in deze notatie in:

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

  • Geef op de webpagina van de telefoon de tijdperiode in seconden op.

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

Forced Resync Delay (Geforceerde vertraging hersynchronisatie)

Maximale vertraging (in seconden) die de telefoon wacht voordat een hersynchronisatie wordt uitgevoerd.

Het apparaat voert geen hersynchronisatie uit terwijl een van de telefoonlijnen actief is. Omdat een hersynchronisatie enkele seconden kan duren, is het gewenst om te wachten totdat het apparaat gedurende langere tijd inactief is voordat hersynchronisatie wordt uitgevoerd. Hierdoor kan een gebruiker zonder onderbreking oproepen blijven plaatsen.

Het apparaat heeft een timer die begint af te tellen wanneer alle lijnen inactief worden. Deze parameter is de eerste waarde van de teller. Hersynchronisaties worden uitgesteld tot deze teller op nul staat.

Geldige waarden zijn van 0 tot 65535.

  • Voer in het telefoonconfiguratiebestand met XML (cfg.xml) een tekenreeks in deze notatie in:

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

  • Geef op de webpagina van de telefoon de tijdperiode in seconden op.

De standaardwaarde is 14,400 seconden.

Resync From SIP (Hersynchroniseren via SIP)

Hiermee worden aanvragen voor hersynchronisatiebewerkingen geregeld via een SIP NOTIFY-gebeurtenis die vanaf de proxyserver van de serviceprovider naar de telefoon is verzonden. Indien ingeschakeld kan de proxy een hersynchronisatie aanvragen door een SIP NOTIFY-bericht met de koptekst Gebeurtenis: hersynchr. naar het apparaat te verzenden.

  • Voer in het telefoonconfiguratiebestand met XML (cfg.xml) een tekenreeks in deze notatie in:

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

  • Op de webpagina van de telefoon selecteert u Ja om deze functie in te schakelen of op Nee om deze uit te schakelen.

Standaard: Ja

Resync After Upgrade Attempt (Hersynchroniseren na upgradepoging)

Hiermee schakelt u of de hersynchronisatiebewerking in of uit nadat een upgrade is uitgevoerd. Als Ja is geselecteerd, wordt de synchronisatie na een firmware-upgrade gestart.

  • Voer in het telefoonconfiguratiebestand met XML (cfg.xml) een tekenreeks in deze notatie in:

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

  • Op de webpagina van de telefoon selecteert u Ja om hersynchroniseren na een firmware-upgrade te starten of Nee op niet opnieuw synchroniseren.

Standaard: Ja

Resync Trigger 1 (Trigger 1 hersynchronisatie)

Resync Trigger 2 (Trigger 2 hersynchronisatie)

Als het resultaat van de logische vergelijking in de deze parameters FALSE is, wordt hersynchroniseren niet geactiveerd, zelfs niet wanneer Hersynchroniseren bij reset is ingesteld op TRUE. Deze trigger voor hersynchronisatie wordt alleen genegeerd bij hersynchroniseren via directe actie-URL en SIP-melding.

De parameters kunnen worden geprogrammeerd met een voorwaardelijke expressie die macro-uitbreiding ondergaat. Zie Macro-uitbreidingsvariabelen onder Inrichtingsparameters voor de geldige macro-uitbreidingen .

  • Voer in het telefoonconfiguratiebestand met XML (cfg.xml) een tekenreeks in deze notatie in:

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

    <Resync_Trigger_2 ua="na"/>

  • Op de webpagina van de telefoongeeft u de triggers op.

Standaard: leeg

Door gebruiker configureerbare hersynchronisatie

Hiermee kan een gebruiker de telefoon hersynchroniseren via het menu op het telefoonscherm. Wanneer deze is ingesteld op Ja, kan een gebruiker de telefoon configuratie opnieuw synchroniseren door de profielregel van de telefoon in te voeren. Wanneer Neeis ingesteld, wordt de parameter Profielregel niet weergegeven in het menu op het telefoonscherm.

  • Voer in het telefoonconfiguratiebestand met XML (cfg.xml) een tekenreeks in deze notatie in:

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

  • Op de webpagina telefoon selecteert u Ja om de parameter profielregel in het telefoonmenu weer te geven of selecteert u Nee om deze parameter te verbergen.

Standaard: Ja

Resync Fails On FNF (Hersynchronisatie bij FNF)

Een hersynchronisatie wordt meestal als mislukt beschouwd als een aangevraagd profiel niet van de server wordt ontvangen. Deze parameter negeert dit gedrag. Wanneer deze optie is ingesteld op Nee, accepteert het apparaat een file-not-found-antwoord van de server als een succesvolle hersynchronisatie.

  • Voer in het telefoonconfiguratiebestand met XML (cfg.xml) een tekenreeks in deze notatie in:

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

  • Op de webpagina telefoon selecteert u Ja als u een niet-gevonden antwoord wilt ontvangen als een mislukte hersynchronisatie, of selecteert u Nee als u een niet-gevonden antwoord als een geslaagde hersynchronisatie wilt door voeren.

Standaard: Ja

Profielverificatietype

Geeft de aanmeldgegevens aan die moeten worden gebruikt voor de profielaccountverificatie. De beschikbare opties zijn:

  • Uitgeschakeld: schakelt de profielaccountfunctie uit. Wanneer deze functie is uitgeschakeld, wordt het menu Profielaccountinstelling niet weergegeven op het scherm van de telefoon.

  • Standaard HTTP-verificatie: de HTTP-aanmeldgegevens worden gebruikt om de profielaccount te verifiëren.

  • XSI-verificatie: XSI- of XSI SIP-aanmeldgegevens worden gebruikt om de profielaccount te verifiëren. De aanmeldgegevens voor de verificatie hangen af van het XSI-verificatietype voor de telefoon:

    • Wanneer het XSI-verificatietype voor de telefoon is ingesteld op Aanmeldgegevens, worden de XSI-aanmeldgegevens gebruikt.

    • Wanneer het XSI-verificatietype voor de telefoon is ingesteld op SIP-aanmeldgegevens, worden de XSI SIP-aanmeldgegevens gebruikt.

  • Voer in het telefoonconfiguratiebestand met XML (cfg.xml) een tekenreeks in deze notatie in:

    <Profile_Authentication_Type ua="na">Standaard Http-verificatie</Profile_Authentication_Type>

  • Op de webpagina van de telefoonselecteert u een optie in de lijst voor de telefoon om de synchronisatie van het profiel te verifiëren.

Standaard: standaard HTTP-verificatie

Zie voor meer informatie het verificatietype voor het profiel opgeven onder Telefoon opgeven voor profielsynchhroon.

Profielregel

Profielregel B

Profielregel C

Profielregel D

Elke profielregel informeert de telefoon over een bron waarvan hij een profiel kan halen (configuratiebestand). Tijdens elke hersynchronisatie past de telefoon alle profielen achtereenvolgens toe.

Als u AES-256-CBC-codering op de configuratiebestanden toepast, geef de coderingssleutel dan als volgt op met het trefwoord --sleutel:

[--sleutel <coderingssleutel>]

U kunt de coderingssleutel optioneel tussen dubbele aanhalingstekens (") plaatsen.

  • Voer in het telefoonconfiguratiebestand met XML (cfg.xml) een tekenreeks in deze notatie in:

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

    <Profile_Rule_B ua="na"/>

    <Profile_Rule_C ua="na"/>

    <Profile_Rule_D ua="na"/>

  • Op de webpagina van de telefoon geeft u de profielregel op.

Standaard: /$PSN.xml

DHCP Option To Use (Te gebruiken DHCP-optie)

DHCP-opties, gescheiden door komma's, gebruikt om firmware en profielen op te halen.

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

Te gebruiken DHCPv6-optie

DHCP-opties, gescheiden door komma's, gebruikt om firmware en profielen op te halen.

Standaard: 17,160,159

Inrichting via Cisco XML

U kunt telefoons inrichten via functies van Cisco XML.

U kunt een XML-object verzenden naar de telefoon met een SIP Notify-pakket of een HTTP Post naar de CGI-interface van de telefoon: http://PhoneIPAddress/CGI/Execute.

De CP-xxxx-3PCC breidt de Cisco XML-functie uit om inrichting via een XML-object te ondersteunen:

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

Nadat de telefoon het XML-object heeft ontvangen, wordt het inrichtingsbestand uit [profiel-regel] gedownload. Deze regel gebruikt macro's om de ontwikkeling van de XML-servicestoepassing te vereenvoudigen.

URL-oplossing met macro-uitbreiding

Submappen met meerdere profielen op de server bieden een handige methode voor het beheren van een groot aantal geïmplementeerde apparaten. De profiel-URL kan het volgende bevatten:

  • Een inrichtingsservernaam of een expliciet IP-adres. Als het profiel de inrichtingsserver op naam identificeert, voert de telefoon een DNS-zoekopdracht uit om de naam op te halen.

  • Een niet-standaard serverpoort die wordt opgegeven in de URL met behulp van de standaardsyntaxis :poort na de servernaam.

  • De submap van de virtuele hoofdmap van de server waar het profiel is opgeslagen, opgegeven door de standaard URL-notatie te gebruiken en beheerd door macro-uitbreiding.

Bijvoorbeeld: de volgende Profile_Rule vraagt het profielbestand ($PN.cfg), in de serversubmap /cisco/config, op van de TFTP-server die wordt uitgevoerd op de host prov.telco.com die luistert naar een verbinding op poort 6900: 

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

Een profiel voor elke telefoon kan worden geïdentificeerd in een parameter voor algemene doeleinden, waarbij binnen een gemeenschappelijke profielregel met behulp van macro-uitbreiding naar de waarde wordt verwezen.

Stel bijvoorbeeld dat GPP_B wordt gedefinieerd als Dj6Lmp23Q.

De Profile_Rule heeft de waarde:

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

Wanneer het apparaat hersynchroniseert en de macro's worden uitgebreid, vraagt de telefoon met MAC-adres 000e08012345 het profiel op met de naam die het MAC-adres van het apparaat bevat op de volgende URL:

tftp://prov.telco.com/cisco/Dj6Lmp23Q/000e08012345.cfg
Het type profielverificatie opgeven

Met profielverificatie kunnen telefoongebruikers het inrichtingsprofiel hersynchroniseren op de telefoon. Verificatiegegevens zijn vereist als de telefoon het configuratiebestand opnieuw probeert te synchroniseren en te downloaden en er voor het eerst een verificatiefout HTTP of HTTPS 401 wordt weergegeven. Als u deze functie inschakelt, wordt het scherm Profielaccountinstelling weergegeven op de telefoon voor de volgende situaties:

  • Wanneer de verificatiefout HTTP of HTTPs 401 optreedt tijdens de eerste keer inrichting nadat de telefoon opnieuw is opgestart

  • Wanneer de gebruikersnaam en het wachtwoord voor het profielaccount leeg zijn

  • Als er geen gebruikersnaam en wachtwoord in de profielregel aanwezig zijn

Als het scherm Profielaccountinstellingwordt gemist of genegeerd, kan de gebruiker het instellingsscherm ook openen via het telefoonschermmenu of de schermtoets Instellingen, die alleen verschijnt wanneer er geen lijn op de telefoon is geregistreerd.

Wanneer u de functie uitschakelt, wordt het scherm Profielaccountinstelling niet weergegeven op de telefoon.

De gebruikersnaam en het wachtwoord in het veld Profielregel hebben hogere prioriteit dan het profielaccount.

  • Wanneer u een juiste URL opgeeft in het veld Profielregel zonder een gebruikersnaam en wachtwoord, is verificatie of digest-verificatie op de telefoon nodig om het profiel te hersynchroniseren. Met het juiste profielaccount slaagt de verificatie. Met een onjuist profielaccount mislukt de verificatie.

  • Wanneer u een juiste URL opgeeft in het veld Profielregel met een correcte gebruikersnaam en wachtwoord, is verificatie of digest-verificatie op de telefoon nodig om het profiel te hersynchroniseren. Het profielaccount wordt niet gebruikt voor het hersynchroniseren van de telefoon. Aanmelden is gelukt.

  • Wanneer u een juiste URL opgeeft in het veld Profielregel met een onjuiste gebruikersnaam en wachtwoord, is verificatie of digest-verificatie op de telefoon nodig om het profiel te hersynchroniseren. Het profielaccount wordt niet gebruikt voor het hersynchroniseren van de telefoon. Aanmelding mislukt altijd.

  • Wanneer u een onjuiste URL opgeeft in het veld Profielregel, mislukt het aanmelden altijd.

U kunt de parameters ook configureren in het configuratiebestand voor de telefoon met XML-code (cfg.xml).

U kunt het verificatietype voor het profiel op de beheerwebpagina van de telefoon opgeven.

1

Open de beheerwebpagina van de telefoon.

2

Selecteer Spraak > Inrichting.

3

Stel in de sectie Configuration Profile (Configuratieprofiel) de parameter Profile Authentication Type (Profielverificatietype) in om de referenties op te geven die moeten worden gebruikt voor verificatie van het profielaccount.

U kunt deze parameter configureren in het XML-bestand met de telefoonconfiguratie (cfg.xml) door een tekenreeks met deze notatie in te voeren:

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

Opties:

  • Uitgeschakeld: hiermee wordt de functie voor het profielaccount uitgeschakeld. Wanneer deze functie is uitgeschakeld, wordt het menu Instellingen profielaccount niet weergegeven op het telefoonscherm.

  • Standaard HTTP-verificatie: de HTTP-aanmeldgegevens worden gebruikt om de profielaccount te verifiëren.

  • XSI-verificatie: XSI- of XSI SIP-aanmeldgegevens worden gebruikt om de profielaccount te verifiëren. De aanmeldgegevens voor de verificatie hangen af van het XSI-verificatietype voor de telefoon:

    Wanneer het XSI-verificatietype voor de telefoon is ingesteld op Aanmeldgegevens, worden de XSI-aanmeldgegevens gebruikt.

    Wanneer het XSI-verificatietype voor de telefoon is ingesteld op SIP-aanmeldgegevens, worden de XSI SIP-aanmeldgegevens gebruikt.

Standaard: standaard HTTP-verificatie

4

Klik op Submit All Changes.

Handmatig een profiel op uw telefoon toepassen

Het configuratiebestand downloaden naar de telefoon vanaf een TFTP-server

Voltooi deze stappen om het configuratiebestand te downloaden naar aan TFTP-servertoepassing op uw computer.

1

Sluit uw computer aan op de LAN-poort van de telefoon.

2

Voer een TFTP-servertoepassing uit op de computer en zorg ervoor dat het configuratiebestand beschikbaar is in de TFTP-hoofdmap.

3

Voer vanuit een webbrowser het LAN-IP-adres van de telefoon, het IP-adres van de computer, de bestandsnaam en de aanmeldingsgegevens in. Gebruik deze indeling:

http://<WAN_IP_adres>/admin/resync?tftp://<PC_IP_adres>/<bestandsnaam>&xuser=admin&xpassword=<wachtwoord>

Voorbeeld: 

http://192.168.15.1/admin/resync?tftp://192.168.15.100/my_config.xml&xuser=admin&xpassword=admin
Het configuratiebestand downloaden naar de telefoon met cURL

Voer de volgende stappen uit om de configuratie naar de telefoon te downloaden met behulp van cURL. Dit opdrachtregelhulpprogramma wordt gebruikt om gegevens over te dragen met een URL-syntaxis. Als u cURL wilt downloaden, gaat u naar:

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

We raden aan dat u cURL niet gebruikt om de configuratie naar de telefoon te verzenden, omdat de gebruikersnaam en het wachtwoord kunnen worden vastgelegd als u cURL gebruikt.

1

Sluit uw computer aan op de LAN-poort van de telefoon.

2

Download het configuratiebestand naar de telefoon door de volgende cURL-opdracht in te voeren:

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

Configuratieprofielen

De telefoon accepteert configuraties in een XML-indeling.

In de voorbeelden in deze sectie worden configuratieprofielen met XML-syntaxis gebruikt.

Indelingen van het configuratieprofiel

Het configuratieprofiel definieert de parameterwaarden voor de telefoon.

De XML-indeling van het configuratieprofiel gebruikt standaard-XML-ontwerpprogramma's bij het samenstellen van de parameters en waarden.

Alleen de tekenset UTF-8 wordt ondersteund. Als u het profiel in een editor wijzigt, wijzig dan niet de indeling voor de codering, anders kan de telefoon het bestand niet herkennen.

Elke telefoon heeft een andere functieset en daarom een andere set parameters.

Open profielindeling

Het profiel met open indeling is een tekstbestand met een XML-achtige syntaxis in een hiërarchie van elementen, met elementattributen en waarden. Met deze indeling kunt u standaard hulpprogramma's gebruiken om het configuratiebestand te maken. Een XML-configuratiebestand kan vanaf de inrichtingsserver naar de telefoon worden verzonden tijdens een hersynchronisatiebewerking, zonder compilatie als een binair object.

De telefoon kan configuratie-indelingen accepteren die door standaard hulpprogramma's worden gegenereerd. Deze functie vereenvoudigt de ontwikkeling van de back-end software voor de inrichtingsserver waarmee configuratieprofielen worden gegenereerd uit bestaande databases.

Om vertrouwelijke informatie in het configuratieprofiel te beveiligen, levert de inrichtingsserver het XML-configuratiebestand aan de telefoon via een kanaal dat is beveiligd met TLS. Het bestand kan optioneel worden gecomprimeerd met behulp van het gzip-verkleiningsalgoritme (RFC1951).

Het bestand kan met een van de volgende coderingsmethoden worden gecodeerd:

  • AES-256-CBC-codering

  • HTTP-inhoudcodering op basis van RFC-8188 met AES-128-GCM ciphering

Een configuratiebestand kan deze onderdelen bevatten:

  • Element-tags

  • Attributen

  • Parameters

  • Functies voor het opmaken

  • XML-opmerkingen

Voorbeeld: Opmaak profiel openen

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

De element-tag <flat-profile> sluit alle parameterelementen in die door de telefoon worden herkend.

Eigenschappen van de element-tag

Houd rekening met de volgende regels wanneer u het configuratiebestand maakt of bijwerkt.

  • Met de XML-inrichtingsindeling en de webgebruikersinterface kunt u dezelfde instellingen configureren. De XML-tagnamen en de veldnamen in de webgebruikersinterface zijn vergelijkbaar, maar wijken af vanwege naambeperkingen voor XML-elementen. Bijvoorbeeld onderstrepingstekens ( _ ) in het XML-configuratiebestand in plaats van spaties in de webgebruikersinterface.

  • De telefoon herkent elementen met de juiste parameternamen die worden ingesloten in het speciale element <flat-profile>.

  • Elementnamen worden tussen punthaken ingesloten.

  • De meeste elementnamen zijn vergelijkbaar met de veldnamen in de webgebruikersinterface van de telefoon, met de volgende wijzigingen:

    • Elementnamen mogen geen spaties of speciale tekens bevatten. Als u de elementnaam wilt afleiden van de veldnaam op de beheerpagina, kunt u elke spatie of de speciale tekens [, ], (, ) of / vervangen voor een onderstrepingsteken.

      Voorbeeld: het element <Resync_On_Reset> staat voor het veld Resync On Reset.

    • Elke elementnaam moet uniek zijn. In de webgebruikersinterface van de telefoon kunnen dezelfde velden op meerdere webpagina's worden weergegeven, zoals de pagina's Lijn, Gebruiker en Toestelnummer. Voeg [n] toe aan de elementnaam om het nummer aan te geven dat wordt weergegeven in het tabblad van de pagina.

      Voorbeeld: het element <Dial_Plan_1_> staat voor het Kiesplan voor lijn 1.

  • Elke openende element-tag moet een overeenkomende sluitende element-tag hebben. Bijvoorbeeld:

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

  • Element-tags zijn hoofdlettergevoelig.

  • Lege element-tags zijn toegestaan en worden geïnterpreteerd als dat ze de waarde configureren als leeg. Voer de openende element-tag in zonder corresponderende element-tag, en plaats een spatie en een slash voor het sluitende punthaakje (>). In dit voorbeeld is Profile Rule B (profielregel B) leeg:

    <Profile_Rule_B />

  • Een lege element-tag kan worden gebruikt om het overschrijven van een door de gebruiker opgegeven waarde te voorkomen tijdens hersynchronisatie. In het volgende voorbeeld blijven de gebruikersinstellingen voor snelkiesnummers ongewijzigd:

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

  • Gebruik een lege waarde om de corresponderende parameter in te stellen op een lege tekenreeks. Voer een openend en sluitend element in zonder waarde ertussen. In het volgende voorbeeld wordt de parameter GPP_A ingesteld op een lege tekenreeks.

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

  • Niet-herkende elementnamen worden genegeerd.

Parametereigenschappen

Deze eigenschappen zijn van toepassing op de parameters:

  • Eventuele parameters die niet door een profiel zijn gespecificeerd blijven ongewijzigd in de telefoon.

  • Onbekende parameters worden genegeerd.

  • Als het profiel met open indeling meerdere exemplaren van dezelfde parametertag bevat, overschrijft het laatste exemplaar de eerdere. Als u wilt voorkomen dat u per ongeluk configuratiewaarden van een parameter overschrijft, raden we aan dat elk profiel maximaal één instantie van een parameter specificeert.

  • Het laatste profiel dat wordt verwerkt heeft voorrang. Als meerdere profielen dezelfde configuratieparameter specificeren, heeft de waarde van het laatste profiel voorrang.

Indelingen van tekenreeksen

Deze eigenschappen zijn van toepassing op de indeling van de tekenreeksen:

  • Opmerkingen zijn toegestaan met de standaard XML-syntaxis.

    <!-- Mijn opmerking wordt hier getypt -->

  • Een spatie voor- en achteraan is toegestaan voor leesbaarheid, maar wordt verwijderd uit de parameterwaarde.

  • Nieuwe regels binnen een waarde worden omgezet tot spaties.

  • Een XML-koptekst met de vorm <? ?> is toegestaan, maar wordt door de telefoon genegeerd.

  • Als u speciale tekens wilt invoeren, dient u de standaard XML-tekennotering te gebruiken, zoals u kunt zien in de volgende tabel.

    Speciaal teken

    XML-tekenvolgorde

    & (ampersand)

    &amp;

    < (minder dan)

    &lt;

    > (meer dan)

    &gt;

    ’ (apostrof)

    &apos;

    ” (dubbele aanhalingstekens)

    &quot;

    In het volgende voorbeeld wordt de tekennotering gebruikt voor de symbolen voor meer dan en minder dan, zoals vereist voor een kiesplanregel. Dit voorbeeld definieert een kiesplan voor een informatietelefoonlijn waarbij de parameter <Dial_Plan_1_> (Beheerdersaanmelding > Geavanceerd > Spraak > Toestel (n)) wordt ingesteld op gelijk aan (S0 <:18005551212>).

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

  • Numerieke tekennotering, met decimale en hexadecimale waarden (s.a. &#40; en &#x2e;), wordt omgezet.

  • De firmware van de telefoon ondersteunt alleen ASCII-tekens.

Compressie en codering van een open profiel

Het open configuratieprofiel kan worden gecomprimeerd als u de netwerkbelasting van de inrichtingsserver wilt verlagen. Het profiel kan ook worden gecodeerd om vertrouwelijke informatie te beschermen. Compressie is niet vereist, maar moet voorafgaan aan codering.

Compressie van een open profiel

De ondersteunde compressiemethode is het gzip-verkleiningsalgoritme (RFC1951). Het hulpprogramma gzip en de compressiebibliotheek die hetzelfde algoritme implementeert (zlib) zijn beschikbaar via het internet.

Voor het identificeren van de compressie verwacht de telefoon dat het bestand een gzip-compatibele koptekst bevat. Wanneer het gzip-hulpprogramma wordt aangeroepen op het oorspronkelijke open profiel, wordt de koptekst gegenereerd. De telefoon controleert de gedownloade bestandskoptekst om de bestandsindeling te bepalen.

Bijvoorbeeld, als profile.xml een geldig profiel is, wordt het bestand profile.xml.gz ook geaccepteerd. Een van de volgende opdrachten kan dit profieltype genereren:

  • >gzip profile.xml

    Hiermee wordt het oorspronkelijke bestand vervangen door het gecomprimeerde bestand.

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

    Hiermee blijft het oorspronkelijke bestand intact en wordt een nieuw gecomprimeerd bestand gemaakt.

Codering van een open profiel

Codering met een symmetrische sleutel kan worden gebruikt om een open configuratieprofiel te coderen, ongeacht of het bestand is gecomprimeerd of niet. Als er een compressie wordt toegepast, moet dit voor de codering gebeuren.

De inrichtingsserver werkt met HTTPS om de eerste inrichting van de telefoon af te handelen na implementatie. Vooraf offline coderen van configuratieprofielen zorgt ervoor dat HTTP later kan worden gebruikt om profielen te hersynchroniseren. Deze functie vermindert de belasting van de HTTPS-server bij grootschalige implementaties.

De telefoon ondersteunt twee coderingsmethoden voor configuratiebestanden:

  • AES-256-CBC-codering

  • HTTP-inhoudcodering op basis van RFC-8188 met AES-128-GCM ciphering

De sleutel of Input Keying Material (IKM) moet op een eerder moment worden vooringericht op het apparaat. Bootstrap van de geheime sleutel kan via HTTPS veilig worden uitgevoerd.

De naam van het configuratiebestand vereist geen specifieke indeling, maar een bestandsnaam die eindigt met de extensie .cfg wijst doorgaans op een configuratieprofiel.

AES-256-CBC-codering

De telefoon ondersteunt de AES-256-CBC-codering voor configuratiebestanden.

Het coderingshulpprogramma OpenSSL, te downloaden van verschillende internetsites, kan de codering uitvoeren. Voor ondersteuning van 256-bits AES-codering is mogelijk hercompilatie van het hulpprogramma nodig om de AES-code in te schakelen. De firmware is getest tegen versie openssl-1.1.1d.

Voor een gecodeerd bestand verwacht het profiel dat het bestand dezelfde indeling heeft zoals gegenereerd door de volgende opdracht:

 # voorbeeld encryptiesleutel = SecretPhrase1234 openssl enc –e –aes-256-cbc –k SecretPhrase1234 –in profile.xml –uit profiel.cfg # analoge invocation voor een gecomprimeerd xml-bestand openssl enc –e –aes-256-cbc –k SecretPhrase1234 –in profile.xml.gz –uit profiel.cfg

Een kleine letter -k gaat vooraf aan de geheime sleutel, die tekst zonder opmaak moet zijn, en deze wordt gebruikt voor het genereren van een willekeurige 64-bits salt. Met het geheim gespecificeerd door het -k-argument, kan het coderingshulpprogramma een willekeurige 128-bits initiële vector en de werkelijke 256-bits codeersleutel afleiden.

Wanneer deze vorm van codering wordt gebruikt voor een configuratieprofiel, moet de telefoon op de hoogte worden gesteld van de geheime sleutelwaarde om het bestand te decoderen. Deze waarde wordt gespecificeerd als een kwalificatie in de URL van het profiel. De syntaxis is als volgt, met een expliciete URL:

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

Deze waarde wordt geprogrammeerd met behulp van één van de parameters van Profile_Rule.

Uitbreiding van macro

Verschillende inrichtingsparameters ondergaan interne macro-uitbreiding voordat ze worden geëvalueerd. Deze stap voor evaluatie biedt meer flexibiliteit bij het beheren van de hersynchronisatie- en upgrade-activiteiten van de telefoon.

Deze parametergroepen ondergaan macro-uitbreiding voorafgaand aan evaluatie:

  • Resync_Trigger_*

  • Profile_Rule*

  • Log_xxx_Msg

  • Upgrade_Rule

Onder bepaalde omstandigheden worden sommige parameters voor algemene doeleinden (GPP_*) ook macro-uitbreiding ondergaan, zoals expliciet wordt aangegeven in het onderstaande gedeelte Optionele resyncheelargumenten .

De inhoud van de benoemde variabelen vervangt tijdens macro-uitbreiding de expressies met de vorm $NAME en $(NAME). Deze variabelen zijn onder andere parameters voor algemene doeleinden, verschillende product-id's, bepaalde gebeurtenistimers en statuswaarden voor inrichting. Zie Macro-uitbreidingsvariabelen onder Inrichtingsparameters voor een volledige lijst.

In het volgende voorbeeld wordt de uitdrukking $(MAU) gebruikt om het MAC-adres 000E08012345 in te voegen.

De beheerder voert het volgende in: $(MAU)config.cfg

De resulterende macro-uitbreiding voor een apparaat met MAC-adres 000E08012345 is: 000E08012345config.cfg

Als de macronaam niet wordt herkend, blijft het niet-uitgebreid. De naam STRANGE wordt bijvoorbeeld niet herkend als een geldige macronaam, terwijl MAU wordt herkend als een geldige macronaam.

De beheerder voert het volgende in: $STRANGE$MAU.cfg

De resulterende macro-uitbreiding voor een apparaat met MAC-adres 000E08012345 is: $STRANGE000E08012345.cfg

Macro-uitbreiding wordt niet recursief toegepast. Bijvoorbeeld, $$MAU” wordt uitgebreid naar $MAU” (de $$ wordt uitgebreid), en leidt niet tot het MAC-adres.

De inhoud van de parameters voor speciale doeleinden, GPP_SA tot GPP_SD, zijn toegewezen aan de macro-expressies $SA tot $SD. Deze parameters worden alleen macro-uitgebreid als het argument van de opties --key , --uid en --pwd in een URL voor hersynchronisatie.

Voorwaardelijke expressies

Voorwaardelijke expressies kunnen hersynchronisatie activeren en selecteren uit alternatieve URL's voor hersynchronisatie- en upgradebewerkingen.

Voorwaardelijke expressies bestaan uit een lijst met vergelijkingen, gescheiden door de en-operator. Alle vergelijkingen moeten worden voldaan, anders is de voorwaarde niet waar.

Elke vergelijking kan betrekking hebben tot een van de volgende drie soorten letterlijke waarden:

  • Integerwaarden

  • Software- of hardwareversienummers

  • Tekenreeksen met dubbele aanhalingstekens

Versienummers

De softwareversie voor de Cisco-videotelefoon 8875 gebruikt deze indeling (waarbij BN het buildnummer is):

PHONEOSyyyy.1-0-1-0001-BN

waarbij yyyy het telefoonmodel of de telefoonreeks aangeeft; 1 is de hoofdversie; 0 is de secundaire versie; 1-0001 is de microversie; en BN is het buildnummer.

De vergelijkende tekenreeks moet dezelfde indeling gebruiken. Anders ontstaat er een fout bij het parseren van de indeling.

Wanneer u de softwareversie vergelijkt, worden de hoofdversie, secundaire versie en microversie in volgorde vergeleken. De meest linkse cijfers hebben voorrang op de latere. Als de versienummers identiek zijn, wordt het buildnummer vergeleken.

Voorbeelden van een geldig versienummer

PHONEOS-8875.1-0-1-0001-19

Vergelijking

Tekenreeksen tussen aanhalingstekens kunnen worden vergeleken voor gelijkheid of ongelijkheid. Gehele getallen en versienummers kunnen ook rekenkundig worden vergeleken. De vergelijkingsoperators kunnen worden uitgedrukt als symbolen of acroniemen. Acroniemen zijn handig om de voorwaarde in een profiel met open indeling uit te drukken.

Operator

Alternatieve syntaxis

Beschrijving

Van toepassing op gehele getallen en versie-operanden

Van toepassing op operanden met een tekenreeks tussen aanhalingstekens

=

eq

gelijk aan

Ja

Ja

!=

ne

niet gelijk aan

Ja

Ja

<

lt

minder dan

Ja

Nee

<=

le

minder dan of gelijk aan

Ja

Nee

>

gt

meer dan

Ja

Nee

>=

ge

meer dan of gelijk aan

Ja

Nee

EN

en

Ja

Ja

Het is belangrijk om macrovariabelen tussen dubbele aanhalingstekens te plaatsen wanneer een letterlijke tekenreeks wordt verwacht. Doe dit niet wanneer er een nummer of versienummer wordt verwacht.

In de context van de parameters Profile_Rule* en Upgrade_Rule, moeten voorwaardelijke expressies binnen de syntaxis "(expr)?" worden geplaatst, zoals in dit voorbeeld van de upgraderegel. Vergeet niet BN te vervangen door het buildnummer van de firmwarelading waarnaar moet worden geüpgraded.

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

Gebruik de voorafgaande syntaxis tussen haakjes niet om de parameters Resync_Trigger_* te configureren.

URL-syntaxis

Gebruik de standaard URL-syntaxis om te specificeren hoe configuratiebestanden en firmwareversies moeten worden opgehaald in de parameters Profile_Rule* en Upgrade_Rule. De syntaxis is als volgt:

[ schema:// ] [ server [:poort]] bestandspad

Hierbij is schema een van deze waarden:

  • tftp

  • http

  • https

Als schema niet is opgegeven, wordt tftp aangenomen. De server kan een hostnaam met DNS-herkenning of een numeriek IP-adres zijn. De poort is de bestemmings-UDP of het TCP-poortnummer. Het bestandspad moet beginnen met de hoofdmap (/). Dit moet een absoluut pad zijn.

Als server ontbreekt, wordt de tftp-server die is gespecificeerd via DHCP (optie 66) gebruikt.

Voor upgraderegels moet de server worden opgegeven.

Als poort ontbreekt, wordt de standaardpoort voor het gespecificeerde schema gebruikt. Tftp gebruikt UDP-poort 69, http gebruikt TCP-poort 80, https gebruikt TCP-poort 443.

Er moet een bestandspad aanwezig zijn. Het moet niet noodzakelijk verwijzen naar een statisch bestand, maar kan ook dynamische inhoud aangeven die is verkregen via CGI.

Macro-uitbreiding is van toepassing binnen de URL's. Hieronder ziet u voorbeelden van geldige URL's:

 /$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

Als u DHCP-optie 66 gebruikt, wordt lege syntaxis nu niet ondersteund door upgraderegels. Dit is alleen van toepassing op Profile Rule*.

HTTP-inhoudcodering op basis van RFC-8188

De telefoon ondersteunt de HTTP-inhoudcodering op basis van RFC 8188 met AES-128-GCM versleuteling voor configuratiebestanden. Met deze coderingsmethode kan elke entiteit de HTTP-berichtkoppen lezen. Alleen de entiteiten die het Input Keying Material (IKM) kennen, kunnen echter de payload lezen. Wanneer de inrichting van de telefoon is gedaan met het IKM, kunnen de telefoon en de inrichtingsserver veilig configuratiebestanden uitwisselen, terwijl ze het voor derde netwerkelementen mogelijk maken om de berichtkoppen te gebruiken voor analyse- en monitoringdoeleinden.

De XML-configuratieparameter IKM_HTTP_Encrypt_Content bevat het IKM op de telefoon. Deze parameter is om veiligheidsredenen niet toegankelijk op de telefoonbeheerwebpagina. Hij is ook niet zichtbaar in het configuratiebestand van de telefoon dat u kunt bereiken via het IP-adres van de telefoon of via de configuratierapporten van de telefoon die naar de inrichtingsserver zijn gestuurd.

Als u de codering op basis van RFC 8188 wilt gebruiken, moet u de volgende zaken garanderen:

  • Richt de telefoon in met het IKM door het IKM op te geven met de XML-parameter IKM_HTTP_Encrypt_Content in het configuratiebestand dat van de inrichtingsserver naar de telefoon wordt gestuurd.

  • Als deze codering wordt toegepast op de configuratiebestanden die van de inrichtingsserver naar de telefoon worden gestuurd, garandeer dan dat de HTTP-kop Inhoudcodering in het configuratiebestand aes128gcm aangeeft..

    Als deze kop ontbreekt, krijgt de methode van AES-256-CBC voorrang. De telefoon past de AES-256-CBC-codering toe als er een AES-256-CBC-sleutel aanwezig is in een profielregel, ongeacht het IKM.

  • Als u wilt dat de telefoon deze codering toepast op de configuratierapporten die het naar de inrichtingsserver stuurt, garandeer dan dat er geen AES-256-CBC-sleutel in de rapportregel is opgegeven.

Argumenten voor optioneel hersynchroniseren

Optionele argumenten, sleutel, gebruikers-id en wachtwoord kunnen voorafgaan aan de URL's die worden ingevoerd in Profile_Rule*-parameters, gezamenlijk ingesloten door vierkante haken.

sleutel

De optie --toets geeft aan de telefoon door dat het ontvangen configuratiebestand van de inrichtingsserver is gecodeerd met de AES-256-CBC-codering, tenzij de koptekst Inhoudscodering in het bestand de codering aes128gcm aangeeft. De sleutel zelf wordt opgegeven als een tekenreeks na de term --key. De sleutel kan optioneel tussen dubbele aanhalingstekens (") worden geplaatst. De telefoon gebruikt de sleutel om het configuratiebestand te decoderen.

Gebruiksvoorbeelden
[--key VerySecretValue][--key “my secret phrase”][--key a37d2fb9055c1d04883a0745eb0917a4]

De optionele argumenten tussen haakjes zijn macro-uitgebreid. Parameters voor speciale doeleinden, GPP_SA tot GPP_SD, worden macro-uitgebreid tot macro-variabelen $SA tot $SD, maar alleen wanneer ze worden gebruikt als sleuteloptie-argumenten. Zie de volgende voorbeelden:

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

In profielen met open indeling moet het argument voor --key hetzelfde zijn als het argument voor de optie -k die wordt toegekend aan openssl.

uid en pwd (gebruikers-id en wachtwoord)

De opties uid en pwd kunnen worden gebruikt om de gebruikers-id en het wachtwoord op te geven die in reactie op HTTP Basic- en Digest-verificatie-uitdagingen worden verzonden wanneer de opgegeven URL wordt gevraagd. De optionele argumenten tussen haakjes zijn macro-uitgebreid. Parameters voor speciale doeleinden, GPP_SA tot GPP_SD, worden macro-uitgebreid tot macro-variabelen $SA tot $SD, maar alleen wanneer ze worden gebruikt als sleuteloptie-argumenten. Zie de volgende voorbeelden:

GPP_SA = MijnUserID GPP_SB = MySecretPassword

[--uid $SA --pwd $SB] https://provisioning_server_url/pad_naar_uw_config/uw_config.xml

wordt vervolgens uitgebreid naar:

[--uid MijnGebruikersID --pwdMijnGeheimeWachtwoord] https://provisioning_server_url/pad_naar_uw_config/uw_config.xml

Gegevenstypen

Deze gegevenstypen worden gebruikt met configuratieprofielparameters:

  • {a,b,c,…}: een keuze uit a, b, c, …

  • Booleaans: booleaanse waarde van 'ja' of 'nee'.

  • CadScript: een miniscript waarmee de cadansparameters van een signaal worden gespecificeerd. Maximaal 127 tekens.

    Syntaxis: S1[;S2] waarbij:

    • Si=Di(aani,1/uiti,1[,aani,2/uiti,2[,aani,3/uiti,3[,aani,4/uiti,4[,aani,5/uiti,5[,aani,6/uiti,6]]]]]) en is bekend als een sectie.

    • aani,j en uiti,j zijn de aan/uit duur in seconden van een segment. i = 1 of 2 en j = 1 tot 6.

    • Di is de totale duur van de sectie in seconden.

    Alle duren kunnen tot drie decimaalplaatsen hebben om oplossing tot 1 ms te bieden. Een wildcardteken '*' staat voor oneindige duur. De segmenten binnen een sectie worden op volgorde afgespeeld en herhaald tot de totale duur is afgespeeld.

    Voorbeeld 1:

     60(2/4) Aantal cadence-secties = 1 cadencesectie 1: sectielengte = 60 s Aantal segmenten = 1 segment 1: aan=2s, uit=4s totale ringlengte = 60 s

    Voorbeeld 2: afwijkende beltoon (kort, kort, kort, lang):

     60(.2/.2,.2,.2/.2,2,1/4) Aantal cadence-secties = 1 Cadence-sectie 1: Sectielengte = 60 s Aantal segmenten = 4 Segment 1: on=0,2s, Uit=0,2s segment 2: aan=0,2s, uit=0,2s segment 3: aan=0,2s, uit=0,2s segment 4: aan=1,0s, uit=4,0s totale bellengte = 60 s

  • Nummerplanscript: scriptsyntaxis die wordt gebruikt om nummerplannen voor lijn 1 en lijn 2 te specificeren.

  • <n> zweven: een zwevende puntwaarde met maximaal n decimalen.

  • FQDN: volledig gekwalificeerde domeinnaam. Deze kan maximaal 63 tekens lang zijn. Hieronder ziet u enkele voorbeelden:

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

    • sip.Cisco.com of 109.12.14.12

  • FreqScript: een miniscript dat de frequentie- en niveauparameters van een toon specificeert. Bevat maximaal 127 tekens.

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

    • F1-F6 frequentie in Hz zijn (alleen niet-ondertekende gehele getallen).

    • L1– L6 bijbehorende niveaus in dBm zijn (met maximaal één decimaal).

    Spaties voor en na de komma zijn toegestaan, maar niet aanbevolen.

    Voorbeeld 1: toon voor wachtend gesprek:

     440@-10 Aantal frequenties = 1 Frequentie 1 = 440 Hz bij –10 dBm

    Voorbeeld 2: kiestoon:

     350@-19.440@-19 Number of Frequency = 2 Frequency 1 = 350 Hz at –19 dBm Frequentie 2 = 440 Hz bij –19 dBm

  • IP: geldig IPv4-adres in de vorm van x.x.x.x, waarbij x een getal tussen 0 en 255 is, bijvoorbeeld 10.1.2.100.

  • Gebruikers-id: gebruikers-id zoals deze wordt weergegeven in een URL; maximaal 63 tekens.

  • Telefoon: een telefoonnummerreeks, zoals 14081234567, *69, *72, 345678; of een generieke URL zoals 1234@10.10.10.100:5068 of jsmith@Cisco.com. De tekenreeks kan maximaal 39 tekens bevatten.

  • PhTmplt: een telefoonnummersjabloon. Elke sjabloon kan een of meer patronen bevatten die worden gescheiden door een komma (,). Spaties aan het begin van elk patroon worden genegeerd. '?' en '*' vertegenwoordigen wildcard-tekens. Als u deze tekens letterlijk wilt aangeven, gebruikt u %xx. Zo staat %2a bijvoorbeeld voor *. De sjabloon kan maximaal 39 tekens bevatten. Voorbeelden: "1408*, 1510*", "1408123????, 555?1.".

  • Poort: TCP/UDP-poortnummer (0-65535). Deze kan worden gespecificeerd in decimale of hexadecimale indeling.

  • ProvisioningRuleSyntax: scriptsyntaxis die wordt gebruikt voor het definiëren van configuratieregels, hersynchronisatieregels en firmware-upgraderegels.

  • PwrLevel: stroomniveau uitgedrukt in dBm met één decimaal, zoals –13,5 of 1,5 (dBm).

  • RscTmplt: een sjabloon van de SIP-antwoordstatuscode zoals "404, 5*", "61?", "407, 408, 487, 481". Dit kan maximaal 39 tekens bevatten.

  • Sig<n>: ondertekende n-bits-waarde. Deze kan worden gespecificeerd in decimale of hexadecimale indeling. Een '-' teken moet voorafgaan aan negatieve waarden. Een +-teken voorafgaand aan positieve waarden is optioneel.

  • Stercodes: activeringscode voor een aanvullende service, zoals *69. De code kan maximaal 7 tekens bevatten.

  • Str<n>: een algemene tekenreeks met maximaal n niet-gereserveerde tekens.

  • Time<n>: tijdsduur in seconden, met maximaal n decimalen. Extra gespecificeerde decimaalplaatsen worden genegeerd.

  • ToneScript: een miniscript dat de frequentie-, niveau- en cadansparameters van een toon voor gespreksvoorgang specificeert. Script kan maximaal 127 tekens bevatten.

    Syntaxis: FreqScript;Z1[;Z2].

    De sectie Z1 is vergelijkbaar met de sectie S1 in een CadScript, behalve dat elk aan/uit-segment wordt gevolgd door een parameter met frequentiecomponenten: Z1 = D1(aani,1/uiti,1/fi,1[,aani,2/uiti,2/fi,2 [,aani,3/uiti,3/fi,3 [,aani,4/uiti,4/fi,4 [,aani,5/uiti,5/fi,5 [,aani,6/uiti,6/fi,6]]]]]) waarbij:

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

    • 1 < nk < 6 specificeert de frequentiecomponenten in FreqScript die worden gebruikt in dat segment.

    Als meer dan één frequentiecomponent in een segment wordt gebruikt, worden de componenten bij elkaar opgeteld.

    Voorbeeld 1: kiestoon:

     350@-19,440@-19; 10(*0/1+2) Aantal frequenties = 2 frequenties 1 = 350 Hz bij –19 dBm Frequentie 2 = 440 Hz bij –19 dBm Aantal cadencesecties = 1 Cadence Sectie 1: Sectielengte = 10 s Aantal segmenten = 1 Segment 1: On=altijd, met frequenties 1 en 2 Totale toonlengte = 10 s

    Voorbeeld 2: stottertoon:

     350@-19,440@-19; 2(.1/.1/1+2); 10(*0/1+2) Aantal frequenties = 2 frequenties 1 = 350 Hz bij –19 dBm Frequentie 2 = 440 Hz bij –19 dBm Aantal cadencesecties = 2 cadence secties 1: Sectielengte = 2s Aantal segmenten = 1 Segment 1: On=0.1s, Uit=0.1s met frequenties 1 en 2 Cadence Sectie 2: Sectielengte = 10 s Aantal segmenten = 1 Segment 1: Aan=altijd, met frequenties 1 en 2 totale toonlengte = 12s

  • Uns<n>: niet-ondertekende n-bits waarde, waarbij n = 8, 16 of 32. Deze kan worden opgegeven in een decimale of hexadecimale indeling, zoals 12 of 0x18, zolang de waarde in n bits kan passen.

Denk aan het volgende:

  • <Par Name> staat voor een naam van een configuratieparameter. In een profiel wordt de bijbehorende tag gevormd door de spatie te vervangen door een onderstrepingsteken "_", zoals Par_Name.
  • Een leeg standaardwaardeveld betekent een lege string < "" >.
  • De telefoon blijft de laatst geconfigureerde waarden gebruiken voor tags die niet in een bepaald profiel aanwezig zijn.
  • Sjablonen worden vergeleken in de aangegeven volgorde. De eerste, niet de dichtstbijzijnde, overeenkomst wordt geselecteerd. De parameternaam moet exact overeenkomen.
  • Als er meer dan één definitie van een parameter wordt gegeven in een profiel, is de laatste dergelijke definitie in het bestand de definitie die wordt toegepast in de telefoon.
  • Een parameterspecificatie met een lege parameterwaarde forceert de parameter terug op de standaardwaarde. Als u in plaats daarvan een lege tekenreeks wilt specificeren, gebruikt u de lege tekenreeks "" als de parameterwaarde.