Profielinstellingen configureren voor telefoons uit de 9800 en 8875 (BroadWorks)

Configureer uw telefoon 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 protocol voor de overdracht van profielen is TFTP (RFC1350). TFTP wordt veel gebruikt voor de bevoorrading van netwerkapparaten binnen particuliere LAN-netwerken. Hoewel TFTP niet wordt aanbevolen voor de implementatie van externe eindpunten op het internet, kan het handig zijn voor implementatie binnen kleine organisaties, voor interne preprovisioning en voor ontwikkeling en testen. In de volgende procedure wordt een profiel gewijzigd na het downloaden van een bestand van een TFTP-server.

1	Verbind binnen een LAN-omgeving uw computer en de telefoon met een hub, switch of kleine router.
2	Installeer en activeer een TFTP-server op de computer.
3	Gebruik een teksteditor om een configuratieprofiel te maken. Om later te controleren of het profiel naar uw telefoon is gestuurd, kunt u enkele waarden als markeringen instellen. Stel bijvoorbeeld de waarde voor GPP_A in op 12345678, zoals in het volgende voorbeeld wordt getoond: `<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 correct is geconfigureerd: vraag het configuratieprofielbestand aan met een andere TFTP-client dan de telefoon. Gebruik bij voorkeur een TFTP-client die draait op een andere host dan de provisioningsserver.
5	Open in de webbrowser op uw computer de webpagina voor administratie. Stel bijvoorbeeld dat het IP-adres van de telefoon 192.168.1.100 is, open dan de volgende URL in uw webbrowser: `http://192.168.1.100/admin/advanced`
6	Selecteer het tabblad Spraak > Provisioning en inspecteer de waarden van de algemene parameters GPP_A tot en met GPP_P. Deze zouden leeg moeten zijn.
7	Synchroniseer de testtelefoon opnieuw met het configuratieprofiel dat u hebt aangemaakt door de hersynchronisatie-URL 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 dit commando ontvangt, vraagt het apparaat op adres 192.168.1.100 het configuratieprofielbestand `basic.txt` op bij de TFTP-server op IP-adres 192.168.1.200. De telefoon parseert vervolgens het gedownloade bestand en werkt de parameter GPP_A bij met de waarde 12345678.
8	Controleer of de parameter correct is bijgewerkt. Vernieuw de webpagina voor de administratie en ga naar Spraak > Provisioning. De parameter GPP_A zou nu de waarde 12345678 moeten bevatten.

Een telefoonspecifiek profiel aanbieden op een TFTP-server

1	Verkrijg het MAC-adres van de telefoon op het etiket van het product. (Het MAC-adres is het nummer, waarbij gebruik wordt gemaakt van cijfers en hexadecimale cijfers in kleine letters, bijvoorbeeld 000e08aabbcc.
2	Hernoem uw configuratiebestand naar `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	Ga naar de webpagina voor telefoonadministratie.
5	Selecteer Spraak > Provisioning.
6	Voer het pad van het profielbestand in het veld Profielregel in. Voorbeeld: Stel dat het IP-adres van de TFTP-server 192.168.1.200 is en de bestandsnaam van het profiel `<Profile_Rule> tftp://192.168.1.200/CP-8875$MA.cfg </Profile_Rule>`
7	Klik op Alle wijzigingen indienen. Dit zorgt voor een onmiddellijke herstart en hersynchronisatie. Bij de volgende hersynchronisatie haalt de telefoon het nieuwe bestand op door de macro-expressie $MA uit te breiden naar het MAC-adres.

Het telefoonprofiel opnieuw synchroniseren met HTTP GET

1	Installeer een HTTP-server op de lokale computer of een andere toegankelijke host. De open source Apache-server kan van het internet worden gedownload.
2	Upload het configuratieprofielbestand naar de virtuele hoofdmap van de geïnstalleerde server.
3	Om de juiste serverinstallatie en toegang tot het profielbestand te controleren, opent u het profiel met een webbrowser.
4	Wijzig de Profile_Rule van de testtelefoon zodat deze naar de HTTP-server verwijst in plaats van naar de TFTP-server, zodat het profiel van de telefoon regelmatig wordt gedownload. Stel bijvoorbeeld dat de HTTP-server 192.168.1.300 is en de bestandsnaam van het profiel basic.txt is, voer dan de volgende waarde in: `<Profile_Rule> http://192.168.1.200/basic.txt </Profile_Rule>`
5	Klik op Alle wijzigingen indienen. Dit zorgt voor een onmiddellijke herstart en hersynchronisatie.
6	Bekijk de syslogberichten die de telefoon verstuurt. De periodieke hersynchronisatie zou nu het profiel van de HTTP-server moeten verkrijgen.
7	Bekijk in de logboeken van de HTTP-server hoe informatie die de testtelefoon identificeert, wordt weergegeven in het logboek van de gebruikersagenten. Deze informatie moet de fabrikant, de productnaam, de huidige firmwareversie en het serienummer bevatten.

Het telefoonprofiel automatisch opnieuw synchroniseren

Een apparaat kan periodiek opnieuw worden gesynchroniseerd met de inrichtingsserver om ervoor te zorgen dat eventuele profielwijzigingen die op de server worden aangebracht, worden doorgegeven aan het eindpuntapparaat (in plaats van een expliciet hersynchronisatieverzoek naar het eindpunt te sturen).

Om ervoor te zorgen dat de telefoon periodiek opnieuw wordt gesynchroniseerd met een server, wordt een URL van het configuratieprofiel gedefinieerd met behulp van de parameter Profile_Rule, en een hersynchronisatieperiode wordt gedefinieerd met de parameter Resync_Periodic.

1	Ga naar de webpagina voor telefoonadministratie.
2	Selecteer Spraak > Provisioning.
3	Definieer de parameter Profile_Rule. In dit voorbeeld wordt uitgegaan van een IP-adres van de TFTP-server van 192.168.1.200.
4	Voer in het veld Periodiek opnieuw synchroniseren een kleine waarde in om te testen, zoals 30 seconden.
5	Klik op Alle wijzigingen indienen. Met de nieuwe parameterinstellingen wordt de telefoon twee keer per minuut opnieuw gesynchroniseerd met het configuratiebestand dat de URL specificeert.
6	Bekijk de resulterende berichten in de syslog-trace.
7	Zorg ervoor dat het veld Opnieuw synchroniseren bij opnieuw instellen is ingesteld op Ja. `<Resync_On_Reset>Yes</Resync_On_Reset>`
8	Schakel de telefoon uit om de telefoon opnieuw te laten synchroniseren met de inrichtingsserver. Als de hersynchronisatie om welke reden dan ook mislukt, bijvoorbeeld als de server niet reageert, wacht het apparaat (gedurende het aantal seconden dat is geconfigureerd in Resync Error Retry Delay) voordat het opnieuw probeert te synchroniseren. Als de Resync Error Retry Delay nul is, probeert de telefoon niet opnieuw te synchroniseren na een mislukte hersynchronisatiepoging.
9	(Optioneel) Stel de waarde van het veld Resync Error Retry Delay in op een klein getal, zoals 30. `<Resync_Error_Retry_Delay>30</Resync_Error_Retry_Delay>`
10	Schakel de TFTP-server uit en bekijk de resultaten in de syslog-uitvoer.

Parameters voor hersynchronisatie van profielen

De volgende tabel definieert de functie en het gebruik van de parameters voor hersynchronisatie van profielen in de sectie Configuratieprofiel onder het tabblad Spraak > Provisioning op de webpagina van de telefoon. Het definieert ook de syntaxis van de tekenreeks die wordt toegevoegd aan het telefoonconfiguratiebestand (cfg.xml) met XML-code om een parameter te configureren.

Tabel 1. Parameters voor hersynchronisatie van profielen
Parameter	Beschrijving
Voorziening inschakelen	Staat acties voor het opnieuw synchroniseren van het configuratieprofiel toe of weigert deze. Voer in het configuratiebestand van de telefoon (cfg.xml) met XML een tekenreeks in dit formaat in: `<Provision_Enable ua="na">Ja</Provision_Enable>` Stel dit veld op de webpagina van de telefoon in op Ja om hersynchronisatieacties toe te staan, of op Nee om hersynchronisatieacties te blokkeren. Standaard: Ja
Opnieuw synchroniseren bij het opnieuw instellen	Specificeert of de telefoon de configuraties opnieuw synchroniseert met de inrichtingsserver na het opstarten en na elke upgradepoging. Voer in het configuratiebestand van de telefoon (cfg.xml) met XML een tekenreeks in dit formaat in: `<Resync_On_Reset ua="na">Ja</Resync_On_Reset>` Stel dit veld op de webpagina van de telefoon in op Ja om hersynchronisatie toe te staan bij het opstarten of opnieuw instellen, of op Nee om de hersynchronisatie te blokkeren bij het opstarten of opnieuw instellen. Standaard: Ja
Willekeurige vertraging opnieuw synchroniseren	Voorkomt overbelasting van de provisioningsserver wanneer een groot aantal apparaten tegelijkertijd wordt ingeschakeld en de initiële configuratie wordt geprobeerd. Deze vertraging is alleen van kracht bij de eerste configuratiepoging, na het inschakelen of opnieuw instellen van het apparaat. De parameter is het maximale tijdsinterval dat het apparaat wacht voordat het contact maakt met de provisioningserver. De werkelijke vertraging is een pseudo-willekeurig getal tussen 0 en deze waarde. Deze parameter is in eenheden van 20 seconden. De geldige waarde ligt tussen 0 en 65535. Voer in het configuratiebestand van de telefoon (cfg.xml) met XML een tekenreeks in dit formaat in: `<Resync_Random_Delay ua="na">2</Resync_Random_Delay>` Geef op de webpagina van de telefoon het aantal eenheden op (20 seconden) waarop de telefoon de hersynchronisatie moet uitstellen na het opstarten of opnieuw instellen. De standaardwaarde is 2 (40 seconden).
Opnieuw synchroniseren (Hmm)	Het tijdstip (HHmm) dat de telefoon opnieuw wordt gesynchroniseerd met de provisioningsserver. De waarde voor dit veld moet een viercijferig getal zijn, variërend van 0000 tot 2400 om de tijd aan te geven in HHMM-formaat. 0959 betekent bijvoorbeeld 09:59 uur. Voer in het configuratiebestand van de telefoon (cfg.xml) met XML een tekenreeks in dit formaat in: `<Resync_At__HHmm_ ua="na">0959</Resync_At__HHmm_>` Geef op de webpagina van de telefoon in HHMM-formaat het tijdstip op waarop de telefoon opnieuw moet worden gesynchroniseerd. De standaardwaarde is leeg. Als de waarde ongeldig is, wordt de parameter genegeerd. Als deze parameter met een geldige waarde is ingesteld, wordt de parameter Resync Periodic genegeerd.
Met willekeurige vertraging opnieuw synchroniseren	Voorkomt overbelasting van de provisioningsserver wanneer een groot aantal apparaten tegelijkertijd wordt ingeschakeld. Om te voorkomen dat hersynchronisatieverzoeken vanaf meerdere telefoons naar de server worden overspoeld, wordt de telefoon opnieuw gesynchroniseerd tussen de uren en minuten, en de uren en minuten plus de willekeurige vertraging (hhmm, hhmm+random_delay). Als de willekeurige vertraging bijvoorbeeld = (Resync At Random Delay + 30) /60 minuten, wordt de invoerwaarde in seconden omgezet in minuten, waarbij naar boven wordt afgerond naar de volgende minuut om het uiteindelijke random_delay interval te berekenen. Voer in het configuratiebestand van de telefoon (cfg.xml) met XML een tekenreeks in dit formaat in: `<Resync_At_Random_Delay ua="na">600</Resync_At_Random_Delay>` Geef op de webpagina van de telefoon de tijdsperiode op in seconden. De geldige waarde ligt tussen 600 en 65535. Als de waarde lager is dan 600, ligt de willekeurige interne vertraging tussen 0 en 600. De standaardwaarde is 600 seconden (10 minuten).
Periodiek opnieuw synchroniseren	Het tijdsinterval tussen de periodieke hersynchronisatie met de provisioningsserver. De bijbehorende hersynchronisatietimer is pas actief na de eerste succesvolle synchronisatie met de server. De geldige formaten zijn als volgt: Een geheel getal Voorbeeld: een invoer van `3000` geeft aan dat de volgende hersynchronisatie binnen 3000 seconden plaatsvindt. Meerdere gehele getallen Voorbeeld: een invoer van `600.120.300` geeft aan dat de eerste hersynchronisatie binnen 600 seconden plaatsvindt, de tweede hersynchronisatie binnen 1200 seconden na de eerste en de derde hersynchronisatie binnen 300 seconden na de tweede. Een tijdbereik Een invoer van `2400+30` geeft bijvoorbeeld aan dat de volgende hersynchronisatie plaatsvindt tussen 2400 en 2430 seconden na een succesvolle hersynchronisatie. Voer in het configuratiebestand van de telefoon (cfg.xml) met XML een tekenreeks in dit formaat in: `<Resync_Periodic ua="na">3600</Resync_Periodic>` Geef op de webpagina van de telefoon de tijdsperiode op in seconden. Zet deze parameter op nul om periodieke hersynchronisatie uit te schakelen. De standaardwaarde is 3600 seconden.
Fout bij opnieuw synchroniseren, opnieuw proberen, vertraging	Als een hersynchronisatie mislukt omdat de telefoon geen profiel van de server kon ophalen, of als het gedownloade bestand beschadigd is, of als er een interne fout optreedt, probeert de telefoon opnieuw te synchroniseren na een tijd die is opgegeven in seconden. De geldige formaten zijn als volgt: Een geheel getal Voorbeeld: een invoer van `300` geeft aan dat de volgende poging om opnieuw te synchroniseren binnen 300 seconden plaatsvindt. Meerdere gehele getallen Voorbeeld: Een invoer van `600.1200.300` geeft aan dat de eerste poging plaatsvindt binnen 600 seconden na de mislukking, de tweede poging binnen 1200 seconden na de mislukking van de eerste poging en de derde poging binnen 300 seconden na het mislukken van de tweede poging. Een tijdbereik Een invoer van `2400+30` geeft bijvoorbeeld aan dat de volgende poging plaatsvindt tussen 2400 en 2430 seconden na een mislukte hersynchronisatie. Als de vertraging is ingesteld op 0, probeert het apparaat niet opnieuw te synchroniseren na een mislukte hersynchronisatiepoging. Voer in het configuratiebestand van de telefoon (cfg.xml) met XML een tekenreeks in dit formaat 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 tijdsperiode op in seconden. Standaard: 60.120,240,480,960,1920,3840,7680,15360,30720.61440,86400
Vertraging van gedwongen hersynchronisatie	Maximale vertraging (in seconden) wanneer de telefoon wacht voordat een hersynchronisatie wordt uitgevoerd. Het apparaat wordt niet opnieuw gesynchroniseerd terwijl een van de telefoonlijnen actief is. Omdat een hersynchronisatie enkele seconden kan duren, is het wenselijk om te wachten tot het apparaat langere tijd niet actief is geweest alvorens opnieuw te synchroniseren. Dit stelt een gebruiker in staat om zonder onderbreking achter elkaar te bellen. Het apparaat heeft een timer die begint af te tellen wanneer alle lijnen niet worden gebruikt. Deze parameter is de beginwaarde van de teller. Hersynchronisatiegebeurtenissen worden uitgesteld tot deze teller op nul is gedaald. De geldige waarde ligt tussen 0 en 65535. Voer in het configuratiebestand van de telefoon (cfg.xml) met XML een tekenreeks in dit formaat in: `<Forced_Resync_Delay ua="na">14400</Forced_Resync_Delay>` Geef op de webpagina van de telefoon de tijdsperiode op in seconden. De standaardwaarde is 14.400 seconden.
Opnieuw synchroniseren vanuit SIP	Beheert aanvragen voor hersynchronisatiebewerkingen via een SIP NOTIFY-gebeurtenis die van de proxyserver van de serviceprovider naar de telefoon wordt gestuurd. Indien ingeschakeld, kan de proxy een hersynchronisatie aanvragen door een SIP NOTIFY-bericht met de Event: resync-header naar het apparaat te sturen. Voer in het configuratiebestand van de telefoon (cfg.xml) met XML een tekenreeks in dit formaat in: `<Resync_From_SIP ua="na">Ja</Resync_From_SIP>` Selecteer op de webpagina van de telefoon Ja om deze functie in te schakelen, of Nee om deze uit te schakelen. Standaard: Ja
Opnieuw synchroniseren na een upgradepoging	Schakelt de hersynchronisatie in of uit nadat een upgrade heeft plaatsgevonden. Als Ja is geselecteerd, wordt de synchronisatie geactiveerd na een firmware-upgrade. Voer in het configuratiebestand van de telefoon (cfg.xml) met XML een tekenreeks in dit formaat in: `<Resync_After_Upgrade_Attempt ua="na">Ja</Resync_After_Upgrade_Attempt>` Selecteer op de webpagina van de telefoon Ja om de hersynchronisatie te activeren na een firmware-upgrade, of Nee om niet opnieuw te synchroniseren. Standaard: Ja
Trigger 1 opnieuw synchroniseren Trigger 2 opnieuw synchroniseren	Als de logische vergelijking in deze parameters op FALSE uitmondt, wordt hersynchronisatie niet geactiveerd, zelfs niet als Resync On Reset is ingesteld op TRUE. Alleen de hersynchronisatie via een directe actie-URL en de SIP-melding negeert deze hersynchronisatietriggers. De parameters kunnen worden geprogrammeerd met een voorwaardelijke expressie die een macro-uitbreiding ondergaat. Voor de geldige macro-uitbreidingen, zie Macro-uitbreidingsvariabelen onder Inrichtingsparameters. Voer in het configuratiebestand van de telefoon (cfg.xml) met XML een tekenreeks in dit formaat in: `<Resync_Trigger_1 ua="na">$UPGTMR gt 300 en $PRVTMR ge 600</Resync_Trigger_1>` `<Resync_Trigger_2 ua="na"/>` Geef op de webpagina van de telefoon de triggers op. Standaard: Blanco
Door de gebruiker configureerbare hersynchronisatie	Hiermee kan een gebruiker de telefoon opnieuw synchroniseren via het menu op het telefoonscherm. Indien ingesteld op Ja, kan een gebruiker de telefoonconfiguratie opnieuw synchroniseren door de profielregel op de telefoon in te voeren. Indien ingesteld op Nee, wordt de parameter Profielregel niet weergegeven in het menu van het telefoonscherm. Voer in het configuratiebestand van de telefoon (cfg.xml) met XML een tekenreeks in dit formaat in: `<User_Configurable_Resync ua="na">Ja</User_Configurable_Resync>` Selecteer op de webpagina van de telefoon Ja om de parameter Profielregel in het telefoonmenu weer te geven, of selecteer Nee om deze parameter te verbergen. Standaard: Ja
Hersynchronisatie mislukt op FNF	Een hersynchronisatie wordt doorgaans als mislukt beschouwd als een aangevraagd profiel niet van de server wordt ontvangen. Deze parameter overschrijft dit gedrag. Als deze optie op Nee is ingesteld, accepteert het apparaat een antwoord van `de server dat niet is gevonden` als een succesvolle hersynchronisatie. Voer in het configuratiebestand van de telefoon (cfg.xml) met XML een tekenreeks in dit formaat in: `<Resync_Fails_On_FNF ua="na">Ja</Resync_Fails_On_FNF>` Selecteer op de webpagina van de telefoon Ja om een antwoord dat `niet is gevonden als een mislukte hersynchronisatie` te beschouwen, of selecteer Nee om een antwoord dat niet is gevonden als een succesvolle hersynchronisatie te beschouwen`.` Standaard: Ja
Authenticatietype van het profiel	Specificeert de inloggegevens die moeten worden gebruikt voor de authenticatie van een profielaccount. De beschikbare opties zijn: Uitgeschakeld: Schakelt de functie voor het profielaccount uit. Als deze functie is uitgeschakeld, wordt het menu voor het instellen van een profielaccount niet op het telefoonscherm weergegeven. Basis HTTP-authenticatie: De HTTP-inloggegevens worden gebruikt om het profielaccount te verifiëren. XSI-authenticatie: XSI-inloggegevens of XSI SIP-inloggegevens worden gebruikt om het profielaccount te verifiëren. De verificatiegegevens zijn afhankelijk van het XSI-verificatietype voor de telefoon: Wanneer het XSI-verificatietype voor de telefoon is ingesteld op Inloggegevens, worden de XSI-inloggegevens gebruikt. Als het XSI-verificatietype voor de telefoon is ingesteld op SIP-inloggegevens, worden de XSI SIP-inloggegevens gebruikt. Voer in het configuratiebestand van de telefoon (cfg.xml) met XML een tekenreeks in dit formaat in: `<Profile_Authentication_Type ua="na">Eenvoudige HTTP-authenticatie</Profile_Authentication_Type>` Selecteer op de webpagina van de telefoon een optie in de lijst om het profiel opnieuw te synchroniseren met de telefoon. Standaard: eenvoudige HTTP-authenticatie Voor meer informatie, zie Specificeer het verificatietype van het profiel onder Specificeer de telefoon voor hersynchronisatie van profielen.
Profielregel Profielregel B Profielregel C Profielregel D	Elke profielregel informeert de telefoon over een bron waar hij een profiel kan verkrijgen (configuratiebestand). Tijdens elke hersynchronisatie past de telefoon alle profielen achter elkaar toe. `Als u AES-256-CBC-versleuteling toepast op de configuratiebestanden, specificeer dan de coderingssleutel met het sleutelwoord --key als volgt:` `[--sleutel]` <encryption key> U kunt de coderingssleutel optioneel tussen dubbele aanhalingstekens plaatsen („). Voer in het configuratiebestand van de telefoon (cfg.xml) met XML een tekenreeks in dit formaat in: `<Profile_Rule ua="na">/$psn.xml</Profile_Rule>` `<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`
DHCP-optie om te gebruiken	DHCP-opties, gescheiden door komma's, die worden gebruikt om firmware en profielen op te halen. Standaard: 66.160.159.150,60,43,125
DHCPv6 optie om te gebruiken	DHCP-opties, gescheiden door komma's, die worden gebruikt om firmware en profielen op te halen. Standaard: 17.160.159

Provisioning via Cisco XML

U kunt telefoons bevoorraden via Cisco XML-functies.

U kunt een XML-object naar de telefoon sturen via een SIP Notify-pakket of een HTTP-bericht naar de CGI-interface van de telefoon: http://PhoneIPAddress/CGI/Execute.

De CP-xxxx-3PCC breidt de Cisco XML-functie uit om provisioning 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 maakt gebruik van macro's om de ontwikkeling van de XML-servicetoepassing te vereenvoudigen.

URL-resolutie met macro-uitbreiding

Submappen met meerdere profielen op de server bieden een handige methode om een groot aantal gebruikte apparaten te beheren. De URL van het profiel kan het volgende bevatten:

Een provisioning servernaam of een expliciet IP-adres. Als in het profiel de inrichtingsserver bij naam wordt geïdentificeerd, voert de telefoon een DNS-zoekopdracht uit om de naam op te lossen.
Een niet-standaard serverpoort die in de URL wordt gespecificeerd met behulp van de standaard syntax:port na de servernaam.
De submap van de virtuele hoofdmap van de server waar het profiel is opgeslagen, gespecificeerd met behulp van standaard URL-notatie en beheerd door macro-uitbreiding.

Met de volgende Profile_Rule wordt bijvoorbeeld het profielbestand ($pn.cfg) in de submap van de server /cisco/config opgevraagd bij de TFTP-server die draait op host prov.telco.com en luistert naar een verbinding op poort 6900:


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

Voor elke telefoon kan een profiel worden geïdentificeerd aan de hand van een parameter voor algemene doeleinden, waarbij de waarde ervan binnen een algemene profielregel wordt aangeduid met behulp van macro-uitbreiding.

Stel bijvoorbeeld dat GPP_B gedefinieerd is als Dj6Lmp23Q.

De Profile_Rule heeft de waarde:


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

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


tftp://prov.telco.com/cisco/Dj6Lmp23Q/000e08012345.cfg

Specificeer het verificatietype van het profiel

Met profielverificatie kunnen telefoongebruikers het inrichtingsprofiel opnieuw synchroniseren met de telefoon. Authenticatiegegevens zijn vereist wanneer de telefoon voor de eerste keer probeert het configuratiebestand opnieuw te synchroniseren en te downloaden en een HTTP- of HTTPS 401-verificatiefout krijgt. Wanneer u deze functie inschakelt, wordt het scherm voor het instellen van uw profielaccount op de telefoon weergegeven voor de volgende situaties:

Wanneer de HTTP- of HTTPs 401-authenticatiefout optreedt tijdens de eerste levering nadat de telefoon opnieuw is opgestart
Als de gebruikersnaam en het wachtwoord van het profielaccount leeg zijn
Als er geen gebruikersnaam en wachtwoord in de profielregel staan

Als het instellingenscherm van het Profielaccount wordt gemist of genegeerd, heeft de gebruiker ook toegang tot het instellingenscherm via het menu op het telefoonscherm, of via de softkey Setup, die alleen wordt weergegeven als er geen lijn op de telefoon is geregistreerd.

Wanneer u de functie uitschakelt, wordt het scherm voor het instellen van uw profielaccount niet weergegeven op de telefoon.

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

Als u een correcte URL opgeeft in het veld Profielregel zonder gebruikersnaam en wachtwoord, heeft de telefoon authenticatie of samenvatting nodig om het profiel opnieuw te synchroniseren. Met het juiste profielaccount is de authenticatie geslaagd. Bij een onjuist profielaccount mislukt de authenticatie.
Als u in het veld Profielregel een correcte URL opgeeft met een correcte gebruikersnaam en wachtwoord, heeft de telefoon authenticatie of samenvatting nodig om het profiel opnieuw te synchroniseren. Het profielaccount wordt niet gebruikt voor hersynchronisatie van de telefoon. De aanmelding is gelukt.
Als u een correcte URL opgeeft in het veld Profielregel met een onjuiste gebruikersnaam en wachtwoord, heeft de telefoon authenticatie of samenvatting nodig om het profiel opnieuw te synchroniseren. Het profielaccount wordt niet gebruikt voor hersynchronisatie van de telefoon. Aanmelden mislukt altijd.
Als u een onjuiste URL opgeeft in het veld Profielregel, mislukt het aanmelden altijd.

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

U kunt het verificatietype van het profiel opgeven op de webpagina voor telefoonbeheer.

1	Ga naar de webpagina voor telefoonadministratie.
2	Selecteer Spraak > Provisioning.
3	Stel in de sectie Configuratieprofiel de parameter Profile Authentication Type in om te specificeren welke inloggegevens moeten worden gebruikt voor de verificatie van profielaccounts. U kunt deze parameter configureren in het XML-bestand voor de telefoonconfiguratie (cfg.xml) door een tekenreeks in deze indeling in te voeren: `<Profile_Authentication_Type ua="na">Disabled</Profile_Authentication_Type>` Opties: Uitgeschakeld: Schakelt de functie voor het profielaccount uit. Als deze functie is uitgeschakeld, wordt het menu voor het instellen van een profielaccount niet weergegeven op het telefoonscherm. Basis HTTP-authenticatie: De HTTP-inloggegevens worden gebruikt om het profielaccount te verifiëren. XSI-authenticatie: XSI-inloggegevens of XSI SIP-inloggegevens worden gebruikt om het profielaccount te verifiëren. De verificatiegegevens zijn afhankelijk van het XSI-verificatietype voor de telefoon: Wanneer het XSI-verificatietype voor de telefoon is ingesteld op Inloggegevens, worden de XSI-inloggegevens gebruikt. Als het XSI-verificatietype voor de telefoon is ingesteld op SIP-inloggegevens, worden de XSI SIP-inloggegevens gebruikt. Standaard: eenvoudige HTTP-authenticatie
4	Klik op Alle wijzigingen indienen.

Handmatig een profiel op uw telefoon toepassen

Download het configuratiebestand naar de telefoon vanaf een TFTP-server

Voltooi deze stappen om het configuratiebestand naar een TFTP-servertoepassing op uw pc te downloaden.

1	Verbind uw computer met 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 hoofdmap van de TFTP.
3	Voer in een webbrowser het IP-adres van het telefoonnetwerk, het IP-adres van de computer, de bestandsnaam en de inloggegevens in. Gebruik dit formaat: `http://<WAN_IP_Address>/admin/resync?tftp://<PC_IP_Address>/<file_name>&xuser=admin&xpassword=<password>` Voorbeeld: `http://192.168.15.1/admin/resync?tftp://192.168.15.100/my_config.xml&xuser=admin&xpassword=admin`

Download het configuratiebestand naar de telefoon met cURL

Voltooi deze stappen om de configuratie naar de telefoon te downloaden met behulp van cURL. Dit opdrachtregelprogramma wordt gebruikt om gegevens over te dragen met een URL-syntaxis. Om cURL te downloaden, gaat u naar:

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

We raden u aan cURL niet te gebruiken om de configuratie naar de telefoon te posten, omdat de gebruikersnaam en het wachtwoord mogelijk worden vastgelegd tijdens het gebruik van cURL.

1	Verbind uw computer met 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”`

Referenties voor profielconfiguratie

De telefoon accepteert configuraties in XML-formaat.

De voorbeelden in deze sectie maken gebruik van configuratieprofielen met XML-syntaxis.

Formaten van configuratieprofielen

Het configuratieprofiel definieert de parameterwaarden voor de telefoon.

Het XML-formaat van het configuratieprofiel maakt gebruik van standaard XML-ontwerptools om de parameters en waarden te compileren.

Alleen de UTF-8-tekenset wordt ondersteund. Als u het profiel wijzigt in een editor, verander dan niet het coderingsformaat; anders kan de telefoon het bestand niet herkennen.

Elke telefoon heeft een andere set functies en dus verschillende parameters.

Open het profielformaat

Het profiel in open formaat is een tekstbestand met een XML-achtige syntaxis in een hiërarchie van elementen, met elementkenmerken en -waarden. Met dit formaat kunt u standaardhulpmiddelen gebruiken om het configuratiebestand te maken. Tijdens een hersynchronisatie kan een XML-configuratiebestand van de inrichtingsserver naar de telefoon worden gestuurd, zonder compilatie als binair object.

De telefoon kan configuratieformaten accepteren die door standaardtools worden gegenereerd. Deze functie vereenvoudigt de ontwikkeling van serversoftware voor back-end provisioning die configuratieprofielen genereert op basis van bestaande databases.

Om vertrouwelijke informatie in het configuratieprofiel te beschermen, bezorgt de inrichtingsserver het XML-configuratiebestand naar de telefoon via een kanaal dat is beveiligd met TLS. Optioneel kan het bestand worden gecomprimeerd met behulp van het gzip deflate-algoritme (RFC1951).

Het bestand kan worden versleuteld met een van de volgende versleutelingsmethoden:

AES-256-CBC-versleuteling
HTTP-inhoudsversleuteling op basis van RFC-8188 met AES-128-GCM-codering

Een configuratiebestand kan de volgende onderdelen bevatten:

Labels voor elementen
Kenmerken
Parameters
Opmaakfuncties
XML-opmerkingen

Voorbeeld: Open het profielformaat


<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 <flat-profile>elementtag bevat alle parameterelementen die de telefoon herkent.

Eigenschappen van de elementtag

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

Het XML-inrichtingsformaat en de webinterface maken het mogelijk dezelfde instellingen te configureren. De XML-tagnamen en veldnamen in de webinterface zijn vergelijkbaar, maar variëren als gevolg van beperkingen op de naam van XML-elementen. Bijvoorbeeld onderstrepingstekens (_) in het XML-configuratiebestand in plaats van spaties in de webinterface.

<flat-profile>De telefoon herkent elementen met de juiste parameternamen die zijn ingekapseld in het speciale element.

De namen van elementen staan tussen haakjes.

De meeste elementnamen lijken op de veldnamen op de webinterface van de telefoon, met de volgende wijzigingen:

Elementnamen mogen geen spaties of speciale tekens bevatten. Om de elementnaam af te leiden uit de naam van het webveld, moet u elke spatie of de speciale tekens [,], (,) of/vervangen door een onderstrepingsteken.

Voorbeeld: Het <Resync_On_Reset>element vertegenwoordigt het veld Resync On Reset.

De naam van elk element moet uniek zijn. In de webinterface van de telefoon kunnen dezelfde velden op meerdere webpagina's verschijnen, zoals de pagina Line, User en Extension. Voeg [n] toe aan de naam van het element om het nummer aan te geven dat op het paginatabblad wordt weergegeven.

Voorbeeld: Het <Dial_Plan_1_>element vertegenwoordigt het kiesschema voor lijn 1.

Elke tag met een openingselement moet voorzien zijn van een bijpassende tag voor het sluitelement. 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>

Elementtags zijn hoofdlettergevoelig.

Labels met lege elementen zijn toegestaan en worden geïnterpreteerd als een configuratie van de waarde als leeg. Voer de tag voor het openingselement in zonder een bijbehorend elementlabel, en plaats een spatie en een schuine streep naar voren vóór de sluithoekbeugel (>). In dit voorbeeld is profielregel B leeg:

<Profile_Rule_B />

Een lege elementtag kan worden gebruikt om te voorkomen dat de door de gebruiker opgegeven waarden worden overschreven tijdens een hersynchronisatiebewerking. In het volgende voorbeeld zijn de instellingen voor snelkiezen van de gebruiker 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 element voor openen en sluiten in zonder een waarde ertussen. In het volgende voorbeeld is de parameter GPP_A ingesteld op een lege tekenreeks.

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

De namen van elementen die niet worden herkend, worden genegeerd.

Eigenschappen van de parameters

Deze eigenschappen zijn van toepassing op de parameters:
Alle parameters die niet in een profiel worden gespecificeerd, blijven ongewijzigd in de telefoon.
Parameters die niet worden herkend, worden genegeerd.
Als het Open Format-profiel meerdere exemplaren van dezelfde parametertag bevat, heeft de laatste keer voorrang op alle eerdere exemplaren. Om te voorkomen dat de configuratiewaarden voor een parameter per ongeluk worden overschreven, raden we aan dat elk profiel ten hoogste één exemplaar van een parameter specificeert.
Het laatst verwerkte profiel heeft voorrang. Als meerdere profielen dezelfde configuratieparameter specificeren, heeft de waarde van dat laatste profiel voorrang.

Formaten voor tekenreeksen

Deze eigenschappen zijn van toepassing op de opmaak van de tekenreeksen:
Opmerkingen zijn toegestaan via de standaard XML-syntaxis.

Witruimte vóór en achter is toegestaan voor de leesbaarheid, maar wordt verwijderd uit de parameterwaarde.
Nieuwe regels binnen een waarde worden omgezet in spaties.
Een XML-koptekst van het formulier <? ? > is toegestaan, maar de telefoon negeert dat.
Om speciale tekens in te voeren, gebruikt u eenvoudige Escapes van XML-tekens, zoals weergegeven in de volgende tabel.
Speciaal personage
XML-ontsnappingsreeks
& (met een hoofdletter)
&
< (minder dan)
<
> (groter dan)
>
'(apostrof)
'
” (dubbele aanhalingstekens)
„
In het volgende voorbeeld worden tekens ingevoerd om de symbolen groter dan en kleiner dan weer te geven die vereist zijn in een kiesplanregel. In dit voorbeeld wordt een informatiehotline gedefinieerd waarbij de <Dial_Plan_1_>parameter (Admin Login > advanced > Voice > Ext (n)) gelijk is aan (S0 <:18005551212>).
<flat-profile> <Dial_Plan_1_> (S0 <:18005551212>) </Dial_Plan_1_> </flat-profile>
Numerieke tekens, waarbij gebruik wordt gemaakt van decimale en hexadecimale waarden (s.a. (en.), worden vertaald.
De firmware van de telefoon ondersteunt alleen ASCII-tekens.

Speciaal personage	XML-ontsnappingsreeks
& (met een hoofdletter)	&
< (minder dan)	<
> (groter dan)	>
'(apostrof)	'
” (dubbele aanhalingstekens)	„

Compressie van open profielen

De ondersteunde compressiemethode is het gzip deflate-algoritme (RFC1951). Het gzip-hulpprogramma en de compressiebibliotheek die hetzelfde algoritme implementeert (zlib) zijn beschikbaar op internetsites.

Om de compressie te identificeren, verwacht de telefoon dat het gecomprimeerde bestand een header bevat die compatibel is met gzip. Als u het gzip-hulpprogramma aanroept op het oorspronkelijke Open-profiel, wordt de koptekst gegenereerd. De telefoon inspecteert de koptekst van het gedownloade bestand om de bestandsindeling te bepalen.

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

>gzip profile.xml

Vervangt het originele bestand door een gecomprimeerd bestand.

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

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

Encryptie van open profielen

Symmetrische sleutelversleuteling kan worden gebruikt om een open configuratieprofiel te versleutelen, ongeacht of het bestand gecomprimeerd is of niet. Compressie, indien toegepast, moet vóór de versleuteling worden toegepast.

De provisioningsserver gebruikt HTTPS om de eerste provisioning van de telefoon na de implementatie af te handelen. Door configuratieprofielen vooraf offline te versleutelen, kunt u HTTP gebruiken om profielen vervolgens opnieuw te synchroniseren. Dit vermindert de belasting van de HTTPS-server bij grootschalige implementaties.

De telefoon ondersteunt twee coderingsmethoden voor configuratiebestanden:

AES-256-CBC-versleuteling

Versleuteling van HTTP-inhoud op basis van RFC 8188 met AES-128-GCM-codering

De sleutel of het Input Keying Material (IKM) moet op een eerder tijdstip in het apparaat worden geplaatst. Het opstarten van de geheime sleutel kan veilig worden uitgevoerd door HTTPS te gebruiken.

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

AES-256-CBC-versleuteling

De telefoon ondersteunt AES-256-CBC-versleuteling voor configuratiebestanden.

De OpenSSL-coderingstool, die op verschillende internetsites kan worden gedownload, kan de versleuteling uitvoeren. Voor ondersteuning van 256-bits AES-versleuteling is het mogelijk dat de tool opnieuw moet worden gecompileerd om de AES-code in te schakelen. De firmware is getest met versie openssl-1.1.1d.

Voor een versleuteld bestand verwacht het profiel dat het bestand hetzelfde formaat heeft als gegenereerd met de volgende opdracht:

# example encryption key = SecretPhrase1234 openssl enc –e –aes-256-cbc –k SecretPhrase1234 –in profile.xml –out profile.cfg # analogous invocation for a compressed xml file openssl enc –e –aes-256-cbc –k SecretPhrase1234 –in profile.xml.gz –out profile.cfg

Een kleine letter -k gaat vooraf aan de geheime sleutel, wat elke zin in platte tekst kan zijn, en die wordt gebruikt om een willekeurige 64-bits salt te genereren. Met het geheim dat wordt gespecificeerd door het argument -k, leidt de coderingstool een willekeurige initiële vector van 128 bits en de werkelijke 256-bits coderingssleutel af.

Wanneer deze vorm van versleuteling wordt gebruikt voor een configuratieprofiel, moet de telefoon op de hoogte worden gebracht van de waarde van de geheime sleutel om het bestand te ontsleutelen. 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 een van de parameters Profile_Rule.

Verschillende voorzieningsparameters worden intern macrouitgebreid voordat ze worden geëvalueerd. Deze preevaluatiestap biedt meer flexibiliteit bij het regelen van de hersynchronisatie- en upgradeactiviteiten van de telefoon.

Deze parametergroepen worden vóór de evaluatie macrouitgebreid:

Resync_Trigger_*

Profile_Rule*

Log_xxx_msg

Upgrade_Rule

Onder bepaalde omstandigheden worden sommige parameters voor algemeen gebruik (GPP_*) ook macrouitgebreid, zoals expliciet wordt aangegeven in de sectie Optionele argumenten voor hersynchronisatie hieronder.

Tijdens de macro-uitbreiding vervangt de inhoud van de benoemde variabelen uitdrukkingen in de vorm $NAME en $ (NAME). Deze variabelen omvatten parameters voor algemene doeleinden, verschillende product-ID's, bepaalde timers voor gebeurtenissen en waarden voor de inrichtingsstatus. Voor een volledige lijst, zie Macro-uitbreidingsvariabelen onder Inrichtingsparameters.

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 een macronaam niet wordt herkend, blijft deze onuitgebreid. 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. $$MAU” wordt bijvoorbeeld uitgebreid naar $MAU” (de $$ is uitgebreid) en resulteert niet in het MAC-adres.

De inhoud van de speciale parameters, GPP_SA tot en met GPP_SD, wordt toegewezen aan de macro-expressies $SA tot en met $SD. Deze parameters worden enkel macrouitgebreid als argument voor de opties --key, --uid en --pwd in een hersynchronisatie-URL.

Voorwaardelijke expressies kunnen hersynchronisatiegebeurtenissen activeren en een keuze maken uit alternatieve URL's voor hersynchronisatie- en upgradebewerkingen.

Voorwaardelijke uitdrukkingen bestaan uit een lijst van vergelijkingen, gescheiden door de operator and. Om de voorwaarde waar te maken, moet aan alle vergelijkingen zijn voldaan.

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

Gehele waarden

Versienummers van software of hardware

Tekenreeksen met dubbele aanhalingstekens

Versienummers

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

TELEFOON YYYY. 1-0-1-0001 - BN

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

De vergelijkingsreeks moet hetzelfde formaat hebben. Anders ontstaat er een fout bij het parseren van de indeling.

Bij het vergelijken van de softwareversie worden de hoofdversie, de kleinere versie en de microversie achter elkaar vergeleken, en de meest linkse cijfers hebben voorrang op de laatste. Als de versienummers identiek zijn, wordt het buildnummer vergeleken.

Voorbeelden van een geldig versienummer

PHONEOS-8875.1-0-1-0001-19

Vergelijking

Geciteerde tekenreeksen kunnen worden vergeleken op basis van gelijkheid of ongelijkheid. Gehele getallen en versienummers kunnen ook rekenkundig worden vergeleken. De vergelijkingsoperatoren kunnen worden uitgedrukt als symbolen of als acroniemen. Acroniemen zijn handig om de voorwaarde uit te drukken in een profiel in open formaat.

Operator

Alternatieve syntaxis

Beschrijving

Van toepassing op Integer- en versieoperanden

Van toepassing op tekenreeksoperanden tussen aanhalingstekens

=

eq

gelijk aan

Ja

Ja

!=

een

niet gelijk aan

Ja

Ja

<

Veel

minder dan

Ja

Nee

<=

le

minder dan of gelijk aan

Ja

Nee

>

gt

groter dan

Ja

Nee

>=

leeftijd

groter dan of gelijk aan

Ja

Nee

AND

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.

Wanneer ze worden gebruikt in de context van de parameters Profile_Rule* en Upgrade_Rule, moeten voorwaardelijke expressies worden opgenomen in de syntaxis „(expr)?” zoals in dit voorbeeld van de upgraderegel. Vergeet niet BN te vervangen door het buildnummer van uw firmware-load om naar te 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 voorgaande syntaxis met haakjes niet om de parameters Resync_Trigger_* te configureren.

Operator	Alternatieve syntaxis	Beschrijving	Van toepassing op Integer- en versieoperanden	Van toepassing op tekenreeksoperanden tussen aanhalingstekens
=	eq	gelijk aan	Ja	Ja
!=	een	niet gelijk aan	Ja	Ja
<	Veel	minder dan	Ja	Nee
<=	le	minder dan of gelijk aan	Ja	Nee
>	gt	groter dan	Ja	Nee
>=	leeftijd	groter dan of gelijk aan	Ja	Nee
AND		en	Ja	Ja

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

[schema://] [server [:port]] bestandspad

Waar het schema een van deze waarden is:

tftp

http

https

Als het schema wordt weggelaten, wordt uitgegaan van tftp. De server kan een hostnaam zijn die door DNS wordt herkend of een numeriek IP-adres. De poort is het UDP- of TCP-poortnummer van de bestemming. Het bestandspad moet beginnen met de hoofdmap (/); het moet een absoluut pad zijn.

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

Voor de upgraderegels moet de server gespecificeerd zijn.

Als de 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 hoeft niet noodzakelijk te verwijzen naar een statisch bestand, maar kan duiden op dynamische inhoud die via CGI is verkregen.

Macro-uitbreiding is van toepassing binnen URL's. De volgende zijn 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

Wanneer u DHCP-optie 66 gebruikt, wordt de lege syntaxis niet ondersteund door upgraderegels. Dit is alleen van toepassing op de profielregel*.

Op RFC 8188 gebaseerde HTTP-inhoudsversleuteling

De telefoon ondersteunt op RFC 8188 gebaseerde HTTP-inhoudsversleuteling met AES-128-GCM-codering voor configuratiebestanden. Met deze versleutelingsmethode kan elke entiteit de HTTP-berichtkoppen lezen. Maar alleen de entiteiten die het Input Keying Material (IKM) kennen, kunnen de payload lezen. Wanneer de telefoon is voorzien van de IKM, kunnen de telefoon en de inrichtingsserver op een veilige manier configuratiebestanden uitwisselen, terwijl netwerkelementen van derden de berichtkoppen kunnen gebruiken voor analyse- en bewakingsdoeleinden.

De XML-configuratieparameter IKM_HTTP_Encryptbevat de IKM op de telefoon. Om veiligheidsredenen is deze parameter niet toegankelijk op de webpagina voor telefoonbeheer. Het is ook niet zichtbaar in het configuratiebestand van de telefoon, dat u kunt openen via het IP-adres van de telefoon of via de configuratierapporten van de telefoon die naar de inrichtingsserver worden gestuurd.

Als u de versleuteling op basis van RFC 8188 wilt gebruiken, zorg dan voor het volgende:

Voorzie de telefoon van de IKM door de IKM op te geven met de XML-parameter IKM_HTTP_Encryptin het configuratiebestand dat van de inrichtingsserver naar de telefoon wordt verzonden.

Als deze versleuteling wordt toegepast op de configuratiebestanden die van de inrichtingsserver naar de telefoon worden verzonden, zorg er dan voor dat de Content-Encoding HTTP-header in het configuratiebestand aes128gcm bevat.

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

Als u wilt dat de telefoon deze versleuteling toepast op de configuratierapporten die naar de inrichtingsserver worden gestuurd, zorg er dan voor dat er geen AES-256-CBC-sleutel is gespecificeerd in de rapportregel.

Optionele argumenten voor hersynchronisatie

Optionele argumenten, key, uid en pwd, kunnen voorafgaan aan de URL's die zijn ingevoerd in de parameters Profile_Rule*, die gezamenlijk tussen vierkante haken staan.

sleutel
uid en pwd

De optie --key vertelt de telefoon dat het configuratiebestand dat het van de inrichtingsserver ontvangt, versleuteld is met AES-256-CBC-versleuteling, tenzij de Content-Encoding-header in het bestand wijst op aes128gcm-versleuteling. De sleutel zelf wordt gespecificeerd 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 ontcijferen.

Voorbeelden van gebruik

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

De optionele argumenten tussen haakjes zijn macrouitgebreid. Parameters voor speciale doeleinden, GPP_SA tot en met GPP_SD, worden macrovariabelen, $SA tot en met $SD, alleen als ze worden gebruikt als belangrijke optieargumenten. Bekijk deze voorbeelden:

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

In profielen in open formaat moet het argument voor --key hetzelfde zijn als het argument voor de optie -k dat aan openssl wordt gegeven.

De opties uid en pwd kunnen worden gebruikt om de gebruikersnaam en het wachtwoord op te geven die worden verzonden als reactie op de authenticatieproblemen van HTTP Basic en Digest wanneer de opgegeven URL wordt gevraagd. De optionele argumenten tussen haakjes zijn macrouitgebreid. Parameters voor speciale doeleinden, GPP_SA tot en met GPP_SD, worden macrovariabelen, $SA tot en met $SD, alleen als ze worden gebruikt als belangrijke optieargumenten. Bekijk deze voorbeelden:

GPP_SA = MyUserID GPP_SB = MySecretPassword

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

zou dan uitbreiden naar:

[--uid myUserID --PwdMySecretPassword] https://provisioning_server_url/path_to_your_config/your_config.xml

Gegevenstypes

Deze gegevenstypen worden gebruikt in combinatie met de parameters van het configuratieprofiel:

{a, b, c,...} —Een keuze tussen a, b, c,...

Bool — Booleaanse waarde van „ja” of „nee”.

CADScript — een miniscript dat de cadansparameters van een signaal specificeert. Maximaal 127 tekens.

Syntaxis: S ₁ [; S ₂], waarbij:

_{_{S _i =D _i (op _{i,1 /off i,1} [, op _i,2 /off _i,2 [, op i,3 /off _i,3 _{[, op i,4} /off _i,4 _{[, op i,5 /off i,5} _{[, op _i,6 /off i,6}]]]]) en staat _bekend als een sectie.}}

on _{i, j} en off _{i, j} zijn de aan-/uit-duur in seconden van een segment. i = 1 of 2, en j = 1 tot 6.

D _i is de totale duur van de sectie in seconden.

Alle looptijden kunnen maximaal drie cijfers achter de komma bevatten, wat een resolutie van 1 ms oplevert. Het jokerteken „*” staat voor oneindig lang. De segmenten binnen een sectie worden op volgorde gespeeld en herhaald tot de totale speelduur is voltooid.

Voorbeeld 1:

60(2/4) Number of Cadence Sections = 1 Cadence Section 1: Section Length = 60 s Number of Segments = 1 Segment 1: On=2s, Off=4s Total Ring Length = 60s

Voorbeeld 2 — Onderscheidende ring (kort, kort, lang):

60(.2/.2,.2/.2,.2/.2,1/4) Number of Cadence Sections = 1 Cadence Section 1: Section Length = 60s Number of Segments = 4 Segment 1: On=0.2s, Off=0.2s Segment 2: On=0.2s, Off=0.2s Segment 3: On=0.2s, Off=0.2s Segment 4: On=1.0s, Off=4.0s Total Ring Length = 60s

DialPlanScript — scriptsyntaxis die wordt gebruikt om de belplannen voor lijn 1 en lijn 2 te specificeren.

Float <n>— Een waarde met drijvende komma met maximaal n cijfers achter de komma.

FQDN: volledig gekwalificeerde domeinnaam. Het kan maximaal 63 tekens bevatten. Voorbeelden zijn de volgende:
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: F ₁ @L ₁ [, F ₂ @L ₂ [, F ₃ @L ₃ [, F ₄ @L ₄ [, F ₅ @L ₅ [, F ₆ @L ₆]]]], waarbij:

F ₁ —F ₆ zijn frequenties in Hz (alleen gehele getallen zonder teken).

L ₁ — L ₆ zijn corresponderende niveaus in dBm (met maximaal één cijfer achter de komma).

Witte spaties voor en na de komma zijn toegestaan, maar worden niet aanbevolen.

Voorbeeld 1: Wachttoon voor gesprekken:

440@-10 Number of Frequencies = 1 Frequency 1 = 440 Hz at –10 dBm

Voorbeeld 2 — Kiestoon:

350@-19,440@-19 Number of Frequencies = 2 Frequency 1 = 350 Hz at –19 dBm Frequency 2 = 440 Hz at –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.

Gebruikersnaam—gebruikersnaam zoals die wordt weergegeven in een URL; maximaal 63 tekens.

Telefoon: een reeks telefoonnummers, zoals 14081234567, *69, *72, 345678; of een algemene URL, zoals 1234 @10 .10.10.10. 100:5068 of jsmith@Cisco.com. De tekenreeks mag maximaal 39 tekens bevatten.

Phtmplt, een sjabloon voor een telefoonnummer. Elk sjabloon kan een of meer patronen bevatten die van elkaar worden gescheiden door een komma (,). De witruimte aan het begin van elk patroon wordt genegeerd. „?” en „*” staan voor jokertekens. Gebruik %xx om het letterlijk weer te geven. %2a staat bijvoorbeeld voor *. Het sjabloon mag maximaal 39 tekens bevatten. Voorbeelden: „1408*, 1510*”, „1408123???? , 55? 1.”.

Poort—TCP/UDP-poortnummer (0-65535). Het kan worden gespecificeerd in decimaal of hexadecimaal formaat.

ProvisioningRuleSyntax: scriptsyntaxis die wordt gebruikt om de regels voor het opnieuw synchroniseren van de configuratie en het upgraden van de firmware te definiëren.

PWRLevel — vermogensniveau uitgedrukt in dBm met één cijfer achter de komma, zoals —13,5 of 1,5 (dBm).

RSCTMPLT, een sjabloon voor de SIP-responsstatuscode, zoals „404, 5*”, „61?” , „407, 408, 487, 481”. Het mag maximaal 39 tekens bevatten.

Sig <n>— Getekende n-bitwaarde. Het kan worden gespecificeerd in decimaal of hexadecimaal formaat. Een „-” -teken moet voorafgaan aan negatieve waarden. Een + teken voor positieve waarden is optioneel.

Star Codes—Activeringscode voor een aanvullende dienst, zoals *69. De code mag maximaal 7 tekens bevatten.

Star <n>— Een algemene tekenreeks met maximaal n niet-gereserveerde tekens.

<n>Tijd — Tijdsduur in seconden, met maximaal n cijfers achter de komma. Extra gespecificeerde cijfers achter de komma worden genegeerd.

ToneScript — een miniscript dat de frequentie-, niveau- en cadansparameters van een voortgangstoon van een gesprek specificeert. Het script mag maximaal 127 tekens bevatten.

_{Syntaxis: FreqScript; Z ₁ [; Z 2].}

_{_{_{_{_{_{_{Sectie Z ₁ is vergelijkbaar met de sectie S ₁ in een CADScript, behalve dat elk aan/uit-segment wordt gevolgd door een parameter voor de frequentiecomponenten: Z _{1 = D ₁} (aan i,1 /uit i,1 /f _{i,1 [, aan i,2} /uit _i,2 /f _{i,2 [, op i,3} _{/uit i,3} /f _{i,3 [, op _i,4 /uit _{i,4 /f i,4} [, op i,5} _{/uit _i,5 /f i,5 [, aan _i,6 /uit i,6 /uit i,6} /f}}}}}}} _i,6]]]]]) waarbij:

Als _{ik, j} = n ₁ [+n ₂] +n ₃ [+n ₄ [+n ₅ [+n ₆]]]].

1 < n _k < 6 specificeert de frequentiecomponenten in het FreqScript die in dat segment worden gebruikt.

Als er 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) Number of Frequencies = 2 Frequency 1 = 350 Hz at –19 dBm Frequency 2 = 440 Hz at –19 dBm Number of Cadence Sections = 1 Cadence Section 1: Section Length = 10 s Number of Segments = 1 Segment 1: On=forever, with Frequencies 1 and 2 Total Tone Length = 10s

Voorbeeld 2 — Stottertoon:

350@-19,440@-19;2(.1/.1/1+2);10(*/0/1+2) Number of Frequencies = 2 Frequency 1 = 350 Hz at –19 dBm Frequency 2 = 440 Hz at –19 dBm Number of Cadence Sections = 2 Cadence Section 1: Section Length = 2s Number of Segments = 1 Segment 1: On=0.1s, Off=0.1s with Frequencies 1 and 2 Cadence Section 2: Section Length = 10s Number of Segments = 1 Segment 1: On=forever, with Frequencies 1 and 2 Total Tone Length = 12s

Uns <n>—N-bitwaarde zonder handtekening, waarbij n = 8, 16 of 32. Het kan worden gespecificeerd in decimaal of hexadecimaal formaat, zoals 12 of 0x18, zolang de waarde maar in n bits past.

Houd hier rekening mee:

<Par Name>vertegenwoordigt de naam van een configuratieparameter. In een profiel wordt de corresponderende tag gevormd door de spatie te vervangen door een onderstrepingsteken „_”, zoals Par_Name.
Een leeg veld met een standaardwaarde impliceert een lege tekenreeks < „” >.
De telefoon blijft de laatst geconfigureerde waarden gebruiken voor tags die niet aanwezig zijn in een bepaald profiel.
Sjablonen worden vergeleken in de aangegeven volgorde. De eerste, niet de dichtstbijzijnde, match is geselecteerd. De naam van de parameter moet exact overeenkomen.
Als er meer dan één definitie voor een parameter wordt gegeven in een profiel, is de laatste definitie in het bestand de definitie die van kracht wordt op de telefoon.
Een parameterspecificatie met een lege parameterwaarde dwingt de parameter terug naar de standaardwaarde. Als u in plaats daarvan een lege tekenreeks wilt opgeven, gebruikt u de lege tekenreeks „” als parameterwaarde.

Cisco AI Assistant

Hartelijk dank voor uw feedback