Uw telefoon configureren voor het opnieuw synchroniseren 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 handig zijn voor implementatie binnen kleine organisaties, voorinrichting op locatie en ontwikkeling 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 tekstverwerker om een configuratieprofiel te maken.

Als u wilt controleren of het profiel later op uw telefoon is ingericht, kunt u enkele van de waarden als markeringen instellen. Stel bijvoorbeeld de waarde voor GPP_A in op 12345678 zoals weergegeven in het volgende voorbeeld:
 <flat-profile>   <GPP_A> 12345678   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 configuratieprofielbestand aan met een TFTP-client anders 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, opent u de volgende URL in uw webbrowser:


http://192.168.1.100/admin/advanced
6

Selecteer het tabblad Spraak > Inrichten 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, moet de opdracht vergelijkbaar 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 juist is bijgewerkt. Vernieuw de beheerwebpagina en ga naar Spraak > Inrichten.

De parameter GPP_A moet nu de waarde 12345678 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 naar CP-xxxx macaddress.cfg (vervang xxxx met het modelnummer en macaddress met 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

Voer het pad van het profielbestand in het veld Profielregel in.

Bijvoorbeeld: Stel dat het IP-adres van de TFTP-server 192.168.1.200 is en de naam van het profielbestand 

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

Klik op Alle wijzigingen verzenden. Hierdoor wordt direct opnieuw opgestart en gehersynchroniseerd.

Wanneer de volgende hersynchronisatie plaatsvindt, haalt de telefoon het nieuwe bestand op door de macro-expressie $MA uit te breiden naar 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

Open het profiel met een webbrowser om de juiste serverinstallatie en toegang tot het profielbestand te controleren.

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.

Bijvoorbeeld, ervan uitgaande dat de HTTP-server zich op 192.168.1.300 bevindt en de profielbestandsnaam basic.txt is, voert u de volgende waarde in:

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

Klik op Alle wijzigingen verzenden. Hierdoor wordt 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 met gebruikersagenten wordt weergegeven.

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

Om ervoor te zorgen dat de telefoon periodiek hersynchroniseert naar een server, wordt een URL van het configuratieprofiel gedefinieerd met de parameter Profile_Rule en wordt 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 ervan uitgegaan dat het IP-adres van de TFTP-server 192.168.1.200 is.

4

Voer in het veld Periodiek hersynchroniseren een kleine waarde in om te testen, zoals 30 seconden.

5

Klik op Alle wijzigingen verzenden.

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

6

Bekijk de resulterende berichten in de syslog-tracering.

7

Zorg ervoor dat het veld Hersynchroniseren bij reset is ingesteld op Ja.

 <Resync_On_Reset>JaOn_Reset>
esync_
8

Schakel de telefoon uit en weer in om hersynchronisatie naar de inrichtingsserver te forceren.

Als de hersynchronisatiebewerking om een bepaalde reden mislukt, bijvoorbeeld als de server niet reageert, wacht het toestel (voor het aantal seconden dat is geconfigureerd in Vertraging nieuwe poging na hersynchronisatiefout) voordat opnieuw wordt geprobeerd te hersynchroniseren. Als Vertraging nieuwe poging na fout bij hersynchroniseren nul is, probeert de telefoon niet te hersynchroniseren na een mislukte hersynchronisatiepoging.

9

(Optioneel) Stel de waarde van het veld Vertraging nieuwe poging na fout bij hersynchroniseren in op een klein getal, zoals 30.

 <Resync_Error_Retry_Delay>30Error_Retry_Delay>
esync_
10

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

Parameters voor hersynchroniseren van profiel

De volgende tabel definieert de functie en het gebruik van de parameters voor hersynchronisatie van profielen in de sectie Configuratieprofiel op het tabblad Spraak > Inrichting op de webpagina van de telefoon. 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 hersynchroniseren van profiel

Parameter

Beschrijving

Inrichten inschakelen

Hiermee worden hersynchronisatieacties toegestaan of geweigerd.

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

    <Provision_Enable ua="na">JaEnable>rovision_

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

Standaard: Ja

Hersynchroniseren bij reset

Geeft aan of de telefoon de configuraties hersynchroniseert met de inrichtingsserver na het opstarten en na elke upgradepoging.

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

    <Resync_On_Reset ua="na">JaOn_Reset>esync_

  • Stel dit veld op de webpagina van de telefoon 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

Willekeurige vertraging hersynchroniseren

Hiermee wordt overbelasting van de inrichtingsserver voorkomen wanneer een groot aantal apparaten tegelijk opstart en de eerste configuratie proberen. 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 het 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 (cfg.xml) met XML een tekenreeks in de volgende notatie in:

    <Resync_Random_Delay ua="na">2Random_Delay>esync_

  • Op de webpagina van de telefoon, geef 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).

Hersynchroniseren om (UUmm)

De tijd (UUmm) waarop de telefoon 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 (cfg.xml) met XML een tekenreeks in de volgende notatie in:

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

  • Geef op de webpagina van de telefoon de tijd op in HHMM-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 Resync Periodic (Periodiek hersynchroniseren) genegeerd.

Willekeurige vertraging hersynchroniseren

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). Als de willekeurige vertraging bijvoorbeeld = (Hersynchroniseren bij willekeurige vertraging + 30)/60 minuten is, wordt de invoerwaarde 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 (cfg.xml) met XML een tekenreeks in de volgende notatie in:

    <Resync_At_Random_Delay ua="na">600At_Random_Delay>esync_

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

Geldige waarden zijn van 600 tot 65535.

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

De standaardwaarde is 600 seconden (10 minuten).

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 succesvolle hersynchronisatie optreedt.

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

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

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

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

De standaardwaarde is 3600 seconden.

Vertraging nieuwe poging na fout bij hersynchroniseren

Als een hersynchronisatiebewerking mislukt omdat de telefoon geen profiel van de server kan ophalen, omdat het gedownloade bestand beschadigd is of omdat er een interne fout optreedt, probeert de telefoon opnieuw te hersynchroniseren na een in seconden opgegeven 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 na de fout van de eerste poging en de derde poging 300 seconden na de fout van de tweede poging.

  • Een tijdsbereik

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

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

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

    <Resync_Error_Retry_Vertraging ua="na">60,120,240,480,960,1920,3840,7680,15360,30720,61440,86400Error_Retry_Vertraging>esync_

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

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

Geforceerde vertraging hersynchronisatie

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

Het apparaat hersynchroniseert niet wanneer een van de telefoonlijnen actief is. Omdat een hersynchronisatie enkele seconden kan duren, is het wenselijk om te wachten totdat het apparaat gedurende langere tijd inactief is voordat hersynchronisatie wordt uitgevoerd. Hierdoor kan een gebruiker zonder onderbreking oproepen plaatsen.

Het apparaat heeft een timer die begint af te tellen wanneer alle lijnen inactief worden. Deze parameter is de beginwaarde van de teller. Hersynchronisatiegebeurtenissen worden uitgesteld totdat deze teller op nul staat.

Geldige waarden zijn van 0 tot 65535.

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

    <Forced_Resync_Delay ua="na">14400Resync_Delay>orced_

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

De standaardwaarde is 14,400 seconden.

Hersynchroniseren van 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 te verzenden met de Gebeurtenis: koptekst hersynchroniseren naar het apparaat.

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

    <Resync_From_SIP ua="na">JaFrom_SIP>esync_

  • Selecteer op de telefoonwebpaginaJa om deze functie in te schakelen of selecteer Nee om deze uit te schakelen.

Standaard: Ja

Hersynchroniseren na upgradepoging

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

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

    <Resync_After_Upgrade_Attempt ua="na">JaAfter_Upgrade_Attempt>esync_

  • Selecteer op de webpagina van de telefoonJa om hersynchronisatie na een firmware-upgrade te activeren of Nee om niet te hersynchroniseren.

Standaard: Ja

Hersynchronisatietrigger 1

Hersynchronisatietrigger 2

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

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

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

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

    <Resync_Trigger_2 ua="na"/>

  • Geef op de webpagina van de telefoon de triggers op.

Standaard: Leeg

Door gebruiker configureerbare hersynchronisatie

Hiermee kan een gebruiker de telefoon hersynchroniseren via het menu op het telefoonscherm. Indien ingesteld op Ja, kan een gebruiker de telefoonconfiguratie hersynchroniseren door de profielregel van de telefoon in te voeren. Indien ingesteld op Nee, wordt de parameter Profielregel niet weergegeven in het menu op het telefoonscherm.

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

    <User_Configurable_Resync ua="na">JaConfigurable_Resync>ser_

  • Selecteer op de telefoonwebpaginaJa om de parameter Profielregel in het telefoonmenu weer te geven of selecteer Nee om deze parameter te verbergen.

Standaard: Ja

Hersynchroniseren mislukt op FNF

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

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

    <Resync_Fails_On_FNF ua="na">JaFails_On_FNF>esync_

  • Selecteer op de telefoonwebpaginaJa om een bestand-niet-gevonden -antwoord aan te nemen als een mislukte hersynchronisatie of selecteer Nee om een bestand-niet-gevonden -antwoord aan te nemen als een geslaagde hersynchronisatie.

Standaard: Ja

Profielverificatietype

Geeft de aanmeldgegevens aan die moeten worden gebruikt voor de verificatie van het profielaccount. De beschikbare opties zijn:

  • Uitgeschakeld: Schakelt de functie voor het profielaccount uit. Wanneer deze functie is uitgeschakeld, wordt het menu Profielaccount instellen niet weergegeven op het telefoonscherm.

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

  • XSI-verificatie: XSI-aanmeldgegevens of XSI SIP-aanmeldgegevens worden gebruikt om de profielaccount te verifiëren. De aanmeldingsgegevens 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-referenties, worden de XSI SIP-referenties gebruikt.

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

    <Profile_Authentication_Type ua="na">Standaard Http-verificatieAuthentication_Type>rofile_

  • Selecteer op de telefoonwebpagina een optie in de lijst voor de telefoon om de synchronisatie van het profiel te verifiëren.

Standaard: Standaard HTTP-verificatie

Zie Het verificatietype voor het profiel opgeven onder De telefoon opgeven voor het hersynchroniseren van het profiel voor meer informatie.

Profielregel

Profielregel B

Profielregel C

Profielregel D

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

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

[--sleutel ]

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

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

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

    <Profile_Rule_B ua="na"/>

    <Profile_Rule_C ua="na"/>

    <Profile_Rule_D ua="na"/>

  • Geef op de webpagina van de telefoon de profielregel op.

Standaard: /$PSN.xml

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 Cisco XML-functies.

U kunt een XML-object naar de telefoon verzenden via 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 gedownload van [profile-rule]. Deze regel gebruikt macro's om de ontwikkeling van de toepassing voor XML-services te vereenvoudigen.

URL-resolutie 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 met behulp van standaard URL-notatie 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 Rule>
rofile_

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

Stel bijvoorbeeld dat GPP_B is 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 een 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
Profielverificatietype 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. Wanneer u deze functie inschakelt, wordt het scherm Profielaccount instellen 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

  • Wanneer er geen gebruikersnaam en wachtwoord in de profielregel zijn

Als het scherm Profielaccount instellen wordt gemist of genegeerd, kan de gebruiker het instelscherm ook openen via het telefoonschermmenu of de schermtoets Instellen , die alleen wordt weergegeven wanneer er geen lijn op de telefoon is geregistreerd.

Wanneer u de functie uitschakelt, wordt het scherm Profielaccount instellen 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 juiste 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. Aanmelden mislukt altijd.

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

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

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

1

Open de beheerwebpagina van de telefoon.

2

Selecteer Spraak > Inrichten.

3

Stel in het gedeelte Configuratieprofiel de parameter Profielverificatietype in om de aanmeldgegevens 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">UitgeschakeldAuthentication_Type>
rofile_

Opties:

  • Uitgeschakeld: Schakelt de functie voor het profielaccount uit. Wanneer deze functie is uitgeschakeld, wordt het menu Profielaccount instellen niet weergegeven op het telefoonscherm.

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

  • XSI-verificatie: XSI-aanmeldgegevens of XSI SIP-aanmeldgegevens worden gebruikt om de profielaccount te verifiëren. De aanmeldingsgegevens 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-referenties, worden de XSI SIP-referenties gebruikt.

Standaard: Standaard HTTP-verificatie

4

Klik op Alle wijzigingen verzenden.

Handmatig een profiel toepassen op uw telefoon

Het configuratiebestand downloaden naar de telefoon vanaf een TFTP-server

Voer de volgende stappen uit om het configuratiebestand te downloaden naar een TFTP-servertoepassing op uw computer.

1

Sluit de 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 in een webbrowser het LAN-IP-adres van de telefoon, het IP-adres van de computer, de bestandsnaam en de aanmeldingsgegevens in. Gebruik deze notatie;

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

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 via 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 u aan geen cURL te gebruiken om de configuratie op de telefoon te plaatsen, omdat de gebruikersnaam en het wachtwoord mogelijk worden vastgelegd tijdens het gebruik van cURL.

1

Sluit de 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 XML-indeling.

De voorbeelden in dit gedeelte gebruiken configuratieprofielen met XML-syntaxis.

Configuratie profielindelingen

Het configuratieprofiel definieert de parameterwaarden voor de telefoon.

De XML-indeling van het configuratieprofiel gebruikt standaard XML-ontwerptools om de parameters en waarden samen te stellen.

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.

Profielindeling openen

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

De telefoon kan configuratieindelingen accepteren die door standaardtools 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. Optioneel kan het bestand worden gecomprimeerd met behulp van het gzip-verkleiningsalgoritme (RFC ).

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:

  • Elementlabels

  • Kenmerken

  • Parameters

  • Functies voor opmaak

  • XML-opmerkingen

Voorbeeld: Profielindeling openen

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

De elementtag bevat alle parameterelementen die de telefoon herkent.

Eigenschappen van 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 variëren vanwege naambeperkingen voor XML-elementen. Bijvoorbeeld onderstrepingstekens ( _ ) in XML-configuratiebestand in plaats van spaties in de webgebruikersinterface.

  • De telefoon herkent elementen met de juiste parameternamen die zijn ingesloten in het speciale element.

  • Elementnamen worden tussen punthaken geplaatst.

  • 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 webveldnaam, vervangt u elke spatie of de speciale tekens [, ], (, ) of / een liggend streepje.

      Bijvoorbeeld: Het element <Resync_On_Reset> staat voor het veld Hersynchroniseren op reset .

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

      Bijvoorbeeld: Het element <Dial_Plan_1_> staat voor het belplan voor lijn 1.

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

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

  • 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 de sluitende hoeksteun (>). In dit voorbeeld is Profielregel B leeg:

     <Profile_Rule_B />

  • Een lege element-tag kan worden gebruikt om te voorkomen dat een door de gebruiker opgegeven waarde wordt overschreven tijdens hersynchronisatie. In het volgende voorbeeld blijven de instellingen voor snelkiesnummers voor gebruikers ongewijzigd:

     <Speed_dial_2_Naam ua="rw"/> <Speed_dial_2_Nummer ua="rw"/> <Speed_dial_3_Naam ua="rw"/> <Speed_dial_3_Nummer ua="rw"/> <Speed_dial_4_Naam ua="rw"/> <Speed_dial_4_Nummer ua="rw"/> <Speed_dial_5_Naam ua="rw"/> <Speed_dial_5_Nummer ua="rw"/> <Speed_dial_6_Naam ua="rw"/> <Speed_dial_6_Nummer ua="rw"/> <Speed_dial_7_Naam ua="rw"/> <Speed_dial_7_Nummer ua="rw"/> <Speed_dial_8_Naam ua="rw"/> <Speed_dial_8_Nummer ua="rw"/> <Speed_dial_9_Naam ua="rw"/> <Speed_dial_9_Nummer ua="rw"/>

  • 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>   A> </flat-profile>
    _

  • Niet-herkende elementnamen worden genegeerd.

Parametereigenschappen

Deze eigenschappen zijn van toepassing op de parameters:

  • Parameters die niet door een profiel zijn gespecificeerd, blijven ongewijzigd in de telefoon.

  • Niet-herkende parameters worden genegeerd.

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

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

Indelingen van tekenreeks

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

  • Opmerkingen zijn toegestaan met de standaard XML-syntaxis.

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

  • Nieuwe lijnen binnen een waarde worden geconverteerd naar spaties.

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

  • Als u speciale tekens wilt invoeren, gebruikt u de standaard XML-tekennotering, zoals weergegeven in de volgende tabel.

    Speciaal teken

    XML-ontsnappingsreeks

    & (ampersand)

    &

    < (minder dan)

    <

    > (meer dan)

    >

    ’ (apostrof)

    '

    ” (dubbele aanhalingstekens)

    "

    In het volgende voorbeeld worden tekennotering gebruikt voor de symbolen voor meer dan en minder dan die vereist zijn in een kiesplanregel. In dit voorbeeld wordt een nummerplan van de informatielijn gedefinieerd waarmee de parameter <Dial_Plan_1_> (Beheerderaanmelding > geavanceerd > Spraak > Toestel (n)) gelijk is aan (S0 ).

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

  • Numerieke tekennotering, met decimale en hexadecimale waarden (s.a. ( en .) worden vertaald.

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

Compressie en codering van een open profiel (XML)

Het open configuratieprofiel kan worden gecomprimeerd om de netwerkbelasting op de inrichtingsserver te verminderen. 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 (RFC ). Het hulpprogramma gzip en de compressiebibliotheek die hetzelfde algoritme implementeert (zlib) zijn beschikbaar op internetsites.

Voor het identificeren van de compressie verwacht de telefoon dat het gecomprimeerde bestand een gzip-compatibele header 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.

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

  • >gzip profile.xml

    Vervangt het oorspronkelijke bestand door het gecomprimeerde bestand.

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

    Laat het oorspronkelijke bestand op zijn plaats en produceert een nieuw gecomprimeerd bestand.

Codering van 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 deze vóór de codering worden toegepast.

De inrichtingsserver gebruikt HTTPS om de eerste inrichting van de telefoon af te handelen na implementatie. Vooraf offline coderen van configuratieprofielen maakt het mogelijk om HTTP vervolgens te gebruiken om profielen te hersynchroniseren. Dit 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 veilig worden uitgevoerd via HTTPS.

De naam van het configuratiebestand vereist geen specifieke indeling, maar een bestandsnaam die eindigt met de extensie .cfg geeft normaal gesproken een configuratieprofiel aan.

AES-256-CBC-codering

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

Het coderingshulpprogramma OpenSSL, dat vanaf verschillende internetsites kan worden gedownload, 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 als gegenereerd door de volgende opdracht:

 # voorbeeld coderingssleutel = SecretPhrase1234 openssl enc –e –aes-256-cbc –k SecretPhrase1234 –in profile.xml –out profile.cfg # analoge invocatie voor een gecomprimeerd xml-bestand openssl enc –e –aes-256-cbc –k SecretPhrase1234 –in profile.xml.gz –out profile.cfg

Een kleine letter -k gaat vooraf aan de geheime sleutel, die een platte tekst kan zijn, en die wordt gebruikt om een willekeurige 64-bits zout te genereren. Met het geheim gespecificeerd door het -k-argument, kan het coderingshulpprogramma een willekeurige 128-bits initiële vector en de werkelijke 256-bits coderingssleutel afleiden.

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

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

Deze waarde wordt geprogrammeerd met behulp van een van de parameters Profile_Rule .

Macro-uitbreiding

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 upgradeactiviteiten van de telefoon.

Deze parametergroepen ondergaan macro-uitbreiding voorafgaand aan evaluatie:

  • Resync_Trigger_*

  • Profile_Regel*

  • Log_xxx_mng

  • Upgrade_regel

Onder bepaalde omstandigheden ondergaan sommige parameters voor algemene doeleinden (GPP_*) ook macro-uitbreiding, zoals expliciet aangegeven in het onderstaande gedeelte Argumenten voor optioneel hersynchroniseren .

Tijdens macro-uitbreiding vervangt de inhoud van de benoemde variabelen de expressies van 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: $(MAU)config.cfg in

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

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

De beheerder voert: $STRANGE$MAU.cfg in

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 --sleutel , --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 om de voorwaarde waar te maken.

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

  • Gehele getallen

  • Software- of hardwareversienummers

  • Tekenreeksen met dubbele aanhalingstekens

Versienummers

De softwareversie voor Cisco Video Phone 8875 gebruikt deze indeling (waarbij BN het buildnummer is):

TELEFOONOSjjjj.1-0-1-0001-BN

waarbij yyyy het telefoonmodel of de telefoonserie 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 resulteert 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 voor het uitdrukken van de voorwaarde in een profiel met open indeling.

Operator

Alternatieve syntaxis

Beschrijving

Van toepassing op gehele getallen en versie-operanden

Van toepassing op operanden met een aangehaalde tekenreeks

=

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

groter 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 als er een nummer of versienummer wordt verwacht.

Bij gebruik 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 u wilt upgraden.

($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 Resync_Trigger_*-parameters te configureren.

URL-syntaxis

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

[ scheme:// ] [ server [:port]] bestandspad

Waarbij schema een van de volgende waarden is:

  • tftp

  • http

  • https

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

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

Voor upgraderegels moet de server worden opgegeven.

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

Er moet een bestandspad aanwezig zijn. Het hoeft niet noodzakelijk te 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

Bij gebruik van DHCP-optie 66 wordt lege syntaxis niet ondersteund door upgraderegels. Deze is alleen van toepassing op Profile Rule*.

HTTP-inhoudcodering op basis van RFC 8188

De telefoon ondersteunt 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 telefoon is ingericht met het IKM, kunnen de telefoon en de inrichtingsserver veilig configuratiebestanden uitwisselen, terwijl ze het voor externe netwerkelementen mogelijk maken 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 webpagina voor telefoonbeheer. Hij is ook niet zichtbaar in het configuratiebestand van de telefoon dat u kunt openen vanaf 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 zorgen voor het volgende:

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

  • Als deze codering wordt toegepast op de configuratiebestanden die van de inrichtingsserver naar de telefoon worden verzonden, moet u ervoor zorgen dat de HTTP-koptekst Content-Encoding in het configuratiebestand aes gcm heeft.

    Als deze koptekst ontbreekt, krijgt de methode 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 verzendt, zorg er dan voor dat er geen AES-256-CBC-sleutel is opgegeven in de rapportregel.

Argumenten voor optioneel hersynchroniseren

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

Toets

De optie --key vertelt de telefoon dat het ontvangen configuratiebestand van de inrichtingsserver is gecodeerd met de AES-256-CBC-codering, tenzij de koptekst Content-Encoding in het bestand de aes gcm -codering aangeeft. De sleutel zelf wordt gespecificeerd als een tekenreeks na de term --sleutel. De sleutel kan optioneel tussen dubbele aanhalingstekens (") worden geplaatst. De telefoon gebruikt de sleutel om het configuratiebestand te decoderen.

Gebruiksvoorbeelden
 [--key VerySecretValue] [--key 'mijn geheime zin'] [--key a37d2fb9055c1d04 a0745eb0917a4]

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, alleen wanneer ze worden gebruikt als sleuteloptie-argumenten. Zie de volgende voorbeelden:

[--sleutel $SC] [--sleutel '$SD']

In profielen met open indeling moet het argument naar --sleutel hetzelfde zijn als het argument naar de optie -k die wordt gegeven aan openssl.

uid en pwd

De opties uid en pwd kunnen worden gebruikt om de gebruikers-id en het wachtwoord op te geven die worden verzonden als reactie op HTTP Basic- en Digest-verificatie-uitdagingen wanneer de opgegeven URL wordt aangevraagd. 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, alleen wanneer ze worden gebruikt als sleuteloptie-argumenten. Zie de volgende voorbeelden:

GPP_SA = MyUserID GPP_SB = MySecretPassword

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

wordt vervolgens uitgebreid naar:

[--uid MijnGebruikers-id --pwdMijnGeheimeWachtwoord] https://provisioning_server_url/path_to_your_config/your_config.xml

Gegevenstypen

Deze gegevenstypen worden gebruikt met configuratieprofielparameters:

  • {a,b,c,…}—Een keuze tussen a, b, c, …

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

  • CadScript: een miniscript dat de cadansparameters van een signaal specificeert. 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.

    Elke duur kan tot drie decimalen hebben om een resolutie van 1 ms te bieden. Het jokerteken '*' staat voor oneindige duur. De segmenten binnen een sectie worden op volgorde afgespeeld en herhaald tot de totale duur wordt afgespeeld.

    Voorbeeld 1:

     60(2/4) Aantal cadenssecties = 1 Cadenssectie 1: Sectielengte = 60 s Aantal segmenten = 1 Segment 1: Aan=2s, Uit=4s Totale beltoonlengte = 60s

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

     60(.2/.2,.2/.2,.2/.2,1/4) Aantal cadenssecties = 1 Cadenssectie 1: Sectielengte = 60s Aantal segmenten = 4 Segment 1: Aan=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,0 s, Uit=4,0 s Totale beltoonlengte = 60 s

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

  • Zwevend: een waarde van het zwevende punt met maximaal n decimalen.

  • FQDN: volledig gekwalificeerde domeinnaam. Deze kan maximaal 63 tekens bevatten. Hieronder volgen 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 zijn frequentie in Hz (alleen niet-ondertekende gehele getallen).

    • L1–L6 corresponderende 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 Aantal frequenties = 2 Frequentie 1 = 350 Hz bij –19 dBm Frequentie 2 = 440 Hz bij –19 dBm

  • IP: geldig IPv4-adres in de vorm van x.x.x.x, waarbij x tussen 0 en 255 ligt. Voorbeeld: 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 '*' staan voor jokertekens. Als u letterlijk wilt weergeven, gebruikt u %xx. For example, %2a staat 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 om configuratieregels te definiëren, hersynchroniseren en firmware-upgraderegels.

  • PwrLevel: voedingsniveau 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”. Deze kan maximaal 39 tekens bevatten.

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

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

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

  • Tijd—Tijdsduur in seconden, met maximaal n decimalen. Extra gespecificeerde decimalen worden genegeerd.

  • ToneScript: een miniscript dat de frequentie-, niveau- en cadansparameters van een toon voor gespreksvoortgang 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 het FreqScript die in dat segment worden gebruikt.

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

    Voorbeeld 1: kiestoon:

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

    Voorbeeld 2: stottertoon:

     350@-19,440@-19;2(.1/.1/1+2);10(*/0/1+2) Aantal frequenties = 2 Frequentie 1 = 350 Hz bij –19 dBm Frequentie 2 = 440 Hz bij –19 dBm Aantal cadenssecties = 2 Cadenssectie 1: Sectielengte = 2s Aantal segmenten = 1 Segment 1: On=0,1s, Off=0,1s met frequentie 1 en 2 Frequentie Sectie 2: Sectielengte = 10 s Aantal segmenten = 1 Segment 1: On=forever, met frequenties 1 en 2 Totale toonlengte = 12s

  • VN: niet-ondertekende n-bits waarde, waarbij n = 8, 16 of 32. Deze kan worden gespecificeerd in decimale of hexadecimale indeling, zoals 12 of 0x18, zolang de waarde in n bits past.

Houd deze in overweging:

  • staat voor een configuratieparameternaam. In een profiel wordt de bijbehorende tag gevormd door de spatie te vervangen door een onderstrepingsteken '_', zoals Par_Naam.
  • Een leeg standaardwaardenveld impliceert een lege tekenreeks < “” >.
  • De telefoon blijft de laatst geconfigureerde waarden gebruiken voor tags die niet in een bepaald profiel aanwezig zijn.
  • Sjablonen worden vergeleken in de opgegeven volgorde. De eerste overeenkomst, niet de dichtstbijzijnde, wordt geselecteerd. De parameternaam moet exact overeenkomen.
  • Als er meer dan één definitie voor een parameter wordt gegeven in een profiel, is de laatste dergelijke definitie in het bestand de definitie die van kracht wordt in de telefoon.
  • Een parameterspecificatie met een lege parameterwaarde forceert de parameter terug naar de standaardwaarde. Als u in plaats daarvan een lege tekenreeks wilt opgeven, gebruikt u de lege tekenreeks '' als de parameterwaarde.