Configurer les paramètres de profil pour les téléphones des séries 9800 et 8875 (BroadWorks)

Configurez votre téléphone pour la resynchronisation de votre profil

Resynchroniser le profil téléphonique via TFTP

Le téléphone prend en charge plusieurs protocoles réseau pour récupérer les profils de configuration. Le protocole de transfert de profil le plus élémentaire est le TFTP (RFC1350). Le TFTP est largement utilisé pour l'approvisionnement de périphériques réseau au sein de réseaux locaux privés. Bien qu'il ne soit pas recommandé pour le déploiement de terminaux distants sur Internet, le TFTP peut être pratique pour le déploiement au sein de petites organisations, pour le préprovisionnement en interne, ainsi que pour le développement et les tests. Dans la procédure suivante, un profil est modifié après avoir téléchargé un fichier depuis un serveur TFTP.

1	Dans un environnement LAN, connectez votre ordinateur et votre téléphone à un hub, un switch ou un petit routeur.
2	Sur l'ordinateur, installez et activez un serveur TFTP.
3	Utilisez un éditeur de texte pour créer un profil de configuration. Pour vérifier si le profil a été configuré sur votre téléphone ultérieurement, vous pouvez définir certaines valeurs sous forme de points. Par exemple, définissez la valeur de GPP_A sur 12345678, comme indiqué dans l'exemple suivant : `<flat-profile>  <GPP_A> 12345678  </GPP_A> </flat-profile>`
4	Enregistrez le fichier de configuration XML dans le répertoire racine du serveur TFTP. Vous pouvez vérifier que le serveur TFTP est correctement configuré : demandez le fichier de profil de configuration en utilisant un autre client TFTP que le téléphone. Utilisez de préférence un client TFTP qui fonctionne sur un hôte distinct de celui du serveur d'approvisionnement.
5	Dans le navigateur Web de votre ordinateur, ouvrez la page Web d'administration. Par exemple, supposons que l'adresse IP du téléphone est 192.168.1.100, ouvrez l'URL suivante dans votre navigateur Web : `http://192.168.1.100/admin/advanced`
6	Sélectionnez l'onglet Voice > Provisioning et vérifiez les valeurs des paramètres généraux GPP_A à GPP_P. Ils devraient être vides.
7	Resynchronisez le téléphone de test avec le profil de configuration que vous avez créé en ouvrant l'URL de resynchronisation dans un navigateur Web. Exemple : Si l'adresse IP du serveur TFTP est 192.168.1.200, la commande doit être similaire à l'exemple suivant : `http://192.168.1.100/admin/resync?tftp://192.168.1.200/basic.txt` Lorsque le téléphone reçoit cette commande, l'appareil situé à l'adresse 192.168.1.100 demande le fichier de profil de configuration `basic.txt` au serveur TFTP à l'adresse IP 192.168.1.200. Le téléphone analyse ensuite le fichier téléchargé et met à jour le paramètre GPP_A avec la valeur 12345678.
8	Vérifiez que le paramètre a été correctement mis à jour. Actualisez la page Web d'administration et accédez à Voice > Provisioning. Le paramètre GPP_A devrait désormais contenir la valeur 12345678.

Fournir un profil spécifique au téléphone sur un serveur TFTP

1	Obtenez l'adresse MAC du téléphone sur l'étiquette du produit. (L'adresse MAC est le chiffre, composé de chiffres et de chiffres hexadécimaux minuscules, par exemple 000e08aabbcc.
2	Renommez votre fichier de configuration en `CP-xxxx macaddress.cfg` (en remplaçant `xxxx` par le numéro de modèle et l'adresse MAC par l'`adresse MAC` du téléphone). Exemple : `CP-8875 000e08aabbcc.cfg`
3	Déplacez le nouveau fichier vers le répertoire racine virtuel du serveur TFTP.
4	Accédez à la page Web d'administration du téléphone.
5	Sélectionnez Voix > Approvisionnement.
6	Entrez le chemin du fichier de profil dans le champ Règle du profil. Exemple : supposons que l'adresse IP du serveur TFTP est 192.168.1.200 et que le nom du fichier de profil est `<Profile_Rule> tftp://192.168.1.200/CP-8875$MA.cfg </Profile_Rule>`
7	Cliquez sur Soumettre toutes les modifications. Cela entraîne un redémarrage et une resynchronisation immédiats. Lors de la prochaine resynchronisation, le téléphone récupère le nouveau fichier en étendant l'expression macro $MA à son adresse MAC.

Resynchroniser le profil téléphonique avec HTTP GET

1	Installez un serveur HTTP sur l'ordinateur local ou sur un autre hôte accessible. Le serveur open source Apache peut être téléchargé sur Internet.
2	Téléchargez le fichier de profil de configuration dans le répertoire racine virtuel du serveur installé.
3	Pour vérifier l'installation correcte du serveur et l'accès au fichier de profil, ouvrez le profil avec un navigateur Web.
4	Modifiez la règle Profile_Rule du téléphone de test pour qu'elle pointe vers le serveur HTTP à la place du serveur TFTP, afin de télécharger son profil régulièrement. Par exemple, en supposant que le serveur HTTP est 192.168.1.300 et que le nom du fichier de profil est basic.txt, entrez la valeur suivante : `<Profile_Rule> http://192.168.1.200/basic.txt </Profile_Rule>`
5	Cliquez sur Soumettre toutes les modifications. Cela entraîne un redémarrage et une resynchronisation immédiats.
6	Observez les messages Syslog envoyés par le téléphone. Les resynchronisations périodiques devraient maintenant consister à obtenir le profil depuis le serveur HTTP.
7	Dans les journaux du serveur HTTP, observez comment les informations identifiant le téléphone de test apparaissent dans le journal des agents utilisateurs. Ces informations doivent inclure le fabricant, le nom du produit, la version actuelle du firmware et le numéro de série.

Resynchroniser automatiquement le profil téléphonique

Un appareil peut se resynchroniser périodiquement avec le serveur d'approvisionnement afin de garantir que toute modification de profil apportée sur le serveur soit transmise au terminal (au lieu d'envoyer une demande de resynchronisation explicite au terminal).

Pour que le téléphone soit resynchronisé régulièrement avec un serveur, l'URL d'un profil de configuration est définie à l'aide du paramètre Profile_Rule, et une période de resynchronisation est définie à l'aide du paramètre Resync_Periodic.

1	Accédez à la page Web d'administration du téléphone.
2	Sélectionnez Voix > Approvisionnement.
3	Définissez le paramètre Profile_Rule. Cet exemple suppose que l'adresse IP d'un serveur TFTP est 192.168.1.200.
4	Dans le champ Périodique de resynchronisation, entrez une petite valeur pour les tests, par exemple 30 secondes.
5	Cliquez sur Soumettre toutes les modifications. Avec les nouveaux paramètres, le téléphone se resynchronise deux fois par minute avec le fichier de configuration indiqué par l'URL.
6	Observez les messages qui en résultent dans le Syslog Trace.
7	Assurez-vous que le champ Resync On Reset est réglé sur Oui. `<Resync_On_Reset>Yes</Resync_On_Reset>`
8	Redémarrez le téléphone pour le forcer à se resynchroniser avec le serveur d'approvisionnement. Si l'opération de resynchronisation échoue pour une raison quelconque, par exemple si le serveur ne répond pas, l'unité attend (le nombre de secondes configuré dans Resync Error Retry Delay) avant de tenter de se resynchroniser à nouveau. Si Resync Error Retry Delay est nul, le téléphone n'essaie pas de resynchroniser après une tentative de resynchronisation infructueuse.
9	(Facultatif) Définissez la valeur du champ Resync Error Retry Delay sur un petit chiffre, par exemple 30. `<Resync_Error_Retry_Delay>30</Resync_Error_Retry_Delay>`
10	Désactivez le serveur TFTP et observez les résultats dans la sortie Syslog.

Paramètres de resynchronisation du profil

Le tableau suivant définit la fonction et l'utilisation des paramètres de resynchronisation du profil dans la section Profil de configuration, sous l'onglet Voice > Provisioning de la page Web du téléphone. Il définit également la syntaxe de la chaîne ajoutée au fichier de configuration du téléphone (cfg.xml) avec du code XML pour configurer un paramètre.

Tableau 1. Paramètres de resynchronisation du profil
Paramètre	Description
Activer la mise à disposition	Autorise ou refuse les actions de resynchronisation du profil de configuration. Dans le fichier de configuration du téléphone (cfg.xml) au format XML, entrez une chaîne au format suivant : `<Provision_Enable ua="na">Oui</Provision_Enable>` Sur la page Web du téléphone, définissez ce champ sur Oui pour autoriser les actions de resynchronisation, ou sur Non pour bloquer les actions de resynchronisation. Par défaut : Oui
Resynchronisation lors de la réinitialisation	Indique si le téléphone resynchronise les configurations avec le serveur d'approvisionnement après la mise sous tension et après chaque tentative de mise à niveau. Dans le fichier de configuration du téléphone (cfg.xml) au format XML, entrez une chaîne au format suivant : `<Resync_On_Reset ua="na">Oui</Resync_On_Reset>` Sur la page Web du téléphone, définissez ce champ sur Oui pour autoriser la resynchronisation au démarrage ou à la réinitialisation, ou sur Non pour bloquer la resynchronisation au démarrage ou à la réinitialisation. Par défaut : Oui
Retard aléatoire de resynchronisation	Empêche la surcharge du serveur d'approvisionnement lorsqu'un grand nombre d'appareils s'allument simultanément et tentent de procéder à la configuration initiale. Ce délai ne prend effet que lors de la première tentative de configuration, après la mise sous tension ou la réinitialisation de l'appareil. Le paramètre est l'intervalle de temps maximum que l'appareil attend avant d'entrer en contact avec le serveur d'approvisionnement. Le délai réel est un nombre pseudo-aléatoire compris entre 0 et cette valeur. Ce paramètre est exprimé en 20 secondes. La valeur valide est comprise entre 0 et 65535. Dans le fichier de configuration du téléphone (cfg.xml) au format XML, entrez une chaîne au format suivant : `<Resync_Random_Delay ua="na">2</Resync_Random_Delay>` Sur la page Web du téléphone, indiquez le nombre d'unités (20 secondes) pour que le téléphone retarde la resynchronisation après la mise sous tension ou la réinitialisation. La valeur par défaut est 2 (40 secondes).
Date de resynchronisation (HHmm)	L'heure (HHmm) à laquelle le téléphone se resynchronise avec le serveur d'approvisionnement. La valeur de ce champ doit être un nombre à quatre chiffres compris entre 0000 et 2400 pour indiquer l'heure au format HHmm. Par exemple, 0959 indique 09h59. Dans le fichier de configuration du téléphone (cfg.xml) au format XML, entrez une chaîne au format suivant : `<Resync_At__HHmm_ ua="na">0959</Resync_At__HHmm_>` Sur la page Web du téléphone, indiquez l'heure au format HHMM à laquelle le téléphone doit démarrer la resynchronisation. La valeur par défaut est vide. Si la valeur n'est pas valide, le paramètre est ignoré. Si ce paramètre est défini avec une valeur valide, le paramètre Resync Periodic est ignoré.
Resynchronisation aléatoire	Empêche la surcharge du serveur d'approvisionnement lorsqu'un grand nombre d'appareils s'allument simultanément. Pour éviter d'inonder le serveur de demandes de resynchronisation provenant de plusieurs téléphones, le téléphone se resynchronise entre les heures et les minutes, plus le délai aléatoire (hhmm, hhmm+random_delay). Par exemple, si le délai aléatoire = (Resynchronisation aléatoire + 30) /60 minutes, la valeur saisie en secondes est convertie en minutes, arrondie à la minute suivante pour calculer l'intervalle final random_delay. Dans le fichier de configuration du téléphone (cfg.xml) au format XML, entrez une chaîne au format suivant : `<Resync_At_Random_Delay ua="na">600</Resync_At_Random_Delay>` Sur la page Web du téléphone, indiquez la période en secondes. La valeur valide est comprise entre 600 et 65 535. Si la valeur est inférieure à 600, le délai aléatoire interne est compris entre 0 et 600. La valeur par défaut est de 600 secondes (10 minutes).
Resynchronisation périodique	L'intervalle de temps entre les resynchronisations périodiques avec le serveur d'approvisionnement. Le chronomètre de resynchronisation associé n'est actif qu'après la première synchronisation réussie avec le serveur. Les formats valides sont les suivants : Un entier Exemple : Une entrée de `3 000` indique que la prochaine resynchronisation aura lieu dans 3 000 secondes. Nombres entiers Exemple : Une entrée de `600 200 300` indique que la première resynchronisation a lieu dans 600 secondes, la deuxième dans 1 200 secondes après la première et la troisième dans 300 secondes après la seconde. Un intervalle de temps Par exemple, une entrée de `2400+30` indique que la prochaine resynchronisation aura lieu entre 2400 et 2430 secondes après une resynchronisation réussie. Dans le fichier de configuration du téléphone (cfg.xml) au format XML, entrez une chaîne au format suivant : `<Resync_Periodic ua="na">3 600</Resync_Periodic>` Sur la page Web du téléphone, indiquez la période en secondes. Réglez ce paramètre sur zéro pour désactiver la resynchronisation périodique. La valeur par défaut est de 3 600 secondes.
Erreur de resynchronisation : nouvelle tentative	Si une opération de resynchronisation échoue parce que le téléphone n'a pas pu récupérer de profil sur le serveur, que le fichier téléchargé est endommagé ou qu'une erreur interne se produit, le téléphone essaie de se resynchroniser à nouveau après un délai spécifié en secondes. Les formats valides sont les suivants : Un entier Exemple : Une entrée de `300` indique que la prochaine tentative de resynchronisation aura lieu dans 300 secondes. Nombres entiers Exemple : Une entrée de `600 200 300` indique que la première tentative a lieu 600 secondes après l'échec, la deuxième tentative 1 200 secondes après l'échec de la première tentative et la troisième 300 secondes après l'échec de la deuxième tentative. Un intervalle de temps Par exemple, une entrée de `2400+30` indique que la prochaine tentative aura lieu entre 2400 et 2430 secondes après un échec de resynchronisation. Si le délai est réglé sur 0, l'appareil n'essaie pas de se resynchroniser à nouveau après une tentative de resynchronisation infructueuse. Dans le fichier de configuration du téléphone (cfg.xml) au format XML, entrez une chaîne au format suivant : `<Resync_Error_Retry_Delay ua="na">60 120 240 480 960, 1920, 3840, 7680, 15360, 30720, 61440, 86400</Resync_Error_Retry_Delay>` Sur la page Web du téléphone, indiquez la période en secondes. Par défaut : 60 120 240 480 960, 1920, 3840, 7680, 15360, 30720, 61440, 86400
Retard de resynchronisation forcé	Délai maximum (en secondes) pendant lequel le téléphone attend avant d'effectuer une resynchronisation. L'appareil ne se resynchronise pas tant que l'une de ses lignes téléphoniques est active. Comme une resynchronisation peut prendre plusieurs secondes, il est préférable d'attendre que l'appareil soit inactif pendant une longue période avant de procéder à la resynchronisation. Cela permet à un utilisateur de passer des appels successifs sans interruption. L'appareil dispose d'un compte à rebours qui lance le compte à rebours lorsque toutes ses lignes sont inactives. Ce paramètre est la valeur initiale du compteur. Les événements de resynchronisation sont retardés jusqu'à ce que ce compteur passe à zéro. La valeur valide est comprise entre 0 et 65535. Dans le fichier de configuration du téléphone (cfg.xml) au format XML, entrez une chaîne au format suivant : `<Forced_Resync_Delay ua="na">14 400</Forced_Resync_Delay>` Sur la page Web du téléphone, indiquez la période en secondes. La valeur par défaut est de 14 400 secondes.
Resynchronisation depuis SIP	Contrôle les demandes d'opérations de resynchronisation via un événement SIP NOTIFY envoyé par le serveur proxy du fournisseur de services au téléphone. S'il est activé, le proxy peut demander une resynchronisation en envoyant un message SIP NOTIFY contenant l'en-tête Event : resync à l'appareil. Dans le fichier de configuration du téléphone (cfg.xml) au format XML, entrez une chaîne au format suivant : `<Resync_From_SIP ua="na">Oui</Resync_From_SIP>` Sur la page Web du téléphone, sélectionnez Oui pour activer cette fonctionnalité, ou Non pour la désactiver. Par défaut : Oui
Resynchronisation après une tentative de mise à niveau	Active ou désactive l'opération de resynchronisation après toute mise à niveau. Si Oui est sélectionné, la synchronisation est déclenchée après une mise à niveau du firmware. Dans le fichier de configuration du téléphone (cfg.xml) au format XML, entrez une chaîne au format suivant : `<Resync_After_Upgrade_Attempt ua="na">Oui</Resync_After_Upgrade_Attempt>` Sur la page Web du téléphone, sélectionnez Oui pour déclencher la resynchronisation après une mise à niveau du firmware, ou Non pour ne pas le resynchroniser. Par défaut : Oui
Resynchroniser Trigger 1 Resync Trigger 2	Si l'équation logique de ces paramètres est évaluée à FALSE, la resynchronisation n'est pas déclenchée, même si Resync On Reset est réglé sur TRUE. Seule la resynchronisation via une URL d'action directe et une notification SIP ignorent ces déclencheurs de resynchronisation. Les paramètres peuvent être programmés à l'aide d'une expression conditionnelle qui fait l'objet d'un développement macro. Pour les extensions de macros valides, voir Variables d'extension de macros dans la section Paramètres d'approvisionnement. Dans le fichier de configuration du téléphone (cfg.xml) au format XML, entrez une chaîne au format suivant : `<Resync_Trigger_1 ua="na">$UPGTMR gt 300 et $PRVTMR get 600</Resync_Trigger_1>` `<Resync_Trigger_2 ua="na"/>` Sur la page Web du téléphone, spécifiez les déclencheurs. Par défaut : vide
Resynchronisation configurable par l'utilisateur	Permet à un utilisateur de resynchroniser le téléphone depuis le menu de l'écran du téléphone. Lorsque ce paramètre est réglé sur Oui, l'utilisateur peut resynchroniser la configuration du téléphone en saisissant la règle de profil depuis le téléphone. Lorsqu'il est réglé sur Non, le paramètre de règle du profil ne s'affiche pas sur le menu de l'écran du téléphone. Dans le fichier de configuration du téléphone (cfg.xml) au format XML, entrez une chaîne au format suivant : `<User_Configurable_Resync ua="na">Oui</User_Configurable_Resync>` Sur la page Web du téléphone, sélectionnez Oui pour afficher le paramètre de règle du profil dans le menu du téléphone, ou sélectionnez Non pour masquer ce paramètre. Par défaut : Oui
La resynchronisation échoue sur FNF	Une resynchronisation est généralement considérée comme un échec si le profil demandé n'est pas reçu du serveur. Ce paramètre remplace ce comportement. Lorsqu'il est réglé sur Non, l'appareil accepte une réponse « `fichier introuvable » de` la part du serveur en tant que resynchronisation réussie. Dans le fichier de configuration du téléphone (cfg.xml) au format XML, entrez une chaîne au format suivant : `<Resync_Fails_On_FNF ua="na">Oui</Resync_Fails_On_FNF>` Sur la page Web du téléphone, sélectionnez Oui pour considérer une réponse « `fichier introuvable » en cas d'`échec de la resynchronisation, ou sélectionnez Non pour considérer une réponse « `fichier introuvable » comme une resynchronisation réussie.` Par défaut : Oui
Type d'authentification du profil	Spécifie les informations d'identification à utiliser pour l'authentification des comptes de profil. Les options disponibles sont les suivantes : Désactivé : désactive la fonction de compte de profil. Lorsque cette fonctionnalité est désactivée, le menu de configuration du compte de profil ne s'affiche pas sur l'écran du téléphone. Authentification HTTP de base : Les informations de connexion HTTP sont utilisées pour authentifier le compte de profil. Authentification XSI : les informations de connexion XSI ou les informations d'identification SIP XSI sont utilisées pour authentifier le compte de profil. Les informations d'authentification dépendent du type d'authentification XSI du téléphone : Lorsque le type d'authentification XSI du téléphone est défini sur Identifiants de connexion, ce sont les identifiants de connexion XSI qui sont utilisés. Lorsque le type d'authentification XSI du téléphone est défini sur Informations SIP, les informations d'identification SIP XSI sont utilisées. Dans le fichier de configuration du téléphone (cfg.xml) au format XML, entrez une chaîne au format suivant : `<Profile_Authentication_Type ua="na">Authentification HTTP de base</Profile_Authentication_Type>` Sur la page Web du téléphone, sélectionnez une option dans la liste pour authentifier la resynchronisation du profil. Par défaut : authentification HTTP de base Pour plus d'informations, voir Spécifier le type d'authentification du profil sous Spécifier le téléphone pour la resynchronisation du profil.
Règle de profil Règle du profil B Règle de profil C Règle D du profil	Chaque règle de profil indique au téléphone la source auprès de laquelle il peut obtenir un profil (fichier de configuration). À chaque opération de resynchronisation, le téléphone applique tous les profils dans l'ordre. `Si vous appliquez le cryptage AES-256-CBC aux fichiers de configuration, spécifiez la clé de cryptage avec le mot clé --key comme suit :` `[--key]` <encryption key> Vous pouvez mettre la clé de cryptage entre guillemets doubles («) en option. Dans le fichier de configuration du téléphone (cfg.xml) au format XML, entrez une chaîne au format suivant : `<Profile_Rule ua="na">/$PSN.xml</Profile_Rule>` `<Profile_Rule_B ua="na"/>` `<Profile_Rule_C ua="na"/>` `<Profile_Rule_D ua="na"/>` Sur la page Web du téléphone, indiquez la règle du profil. Par défaut : `/$PSN.xml`
Option DHCP à utiliser	Les options DHCP, séparées par des virgules, utilisées pour récupérer le firmware et les profils. Par défaut : 66 160, 159, 150, 60, 43, 125
Option DHCPv6 à utiliser	Les options DHCP, séparées par des virgules, utilisées pour récupérer le firmware et les profils. Par défaut : 17 160 159

Approvisionnement via Cisco XML

Vous pouvez approvisionner des téléphones via les fonctions XML de Cisco.

Vous pouvez envoyer un objet XML au téléphone par un paquet de notification SIP ou un message HTTP sur l'interface CGI du téléphone : http://PhoneIPAddress/CGI/Execute.

Le CP-xxxx-3PCC étend la fonctionnalité XML de Cisco pour permettre le provisionnement via un objet XML :


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

Une fois que le téléphone a reçu l'objet XML, il télécharge le fichier d'approvisionnement depuis [profile-rule]. Cette règle utilise des macros pour simplifier le développement de l'application de services XML.

Résolution d'URL avec extension des macros

Les sous-répertoires contenant plusieurs profils sur le serveur constituent une méthode pratique pour gérer un grand nombre d'appareils déployés. L'URL du profil peut contenir :

Le nom du serveur d'approvisionnement ou une adresse IP explicite. Si le profil identifie le serveur d'approvisionnement par son nom, le téléphone effectue une recherche DNS pour résoudre le nom.
Un port de serveur non standard qui est spécifié dans l'URL en utilisant la syntaxe standard : port après le nom du serveur.
Le sous-répertoire du répertoire racine virtuel du serveur dans lequel le profil est stocké, spécifié à l'aide de la notation URL standard et géré par une extension de macros.

Par exemple, la règle Profile_Rule suivante demande le fichier de profil ($PN.cfg), situé dans le sous-répertoire du serveur /cisco/config, depuis le serveur TFTP qui fonctionne sur l'hôte prov.telco.com et écoute une connexion sur le port 6900 :


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

Le profil de chaque téléphone peut être identifié grâce à un paramètre général, sa valeur étant référencée selon une règle de profil commune en utilisant le développement macro.

Supposons par exemple que GPP_B soit défini comme Dj6Lmp23Q.

La règle Profile_Rule a la valeur suivante :


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

Lorsque l'appareil est resynchronisé et que les macros sont étendues, le téléphone dont l'adresse MAC est 000e08012345 demande le profil dont le nom contient l'adresse MAC de l'appareil à l'URL suivante :


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

Spécifiez le type d'authentification du profil

L'authentification du profil permet aux utilisateurs de resynchroniser le profil d'approvisionnement sur le téléphone. Les informations d'authentification sont requises lorsque le téléphone essaie de resynchroniser et de télécharger le fichier de configuration pour la première fois et qu'il reçoit une erreur d'authentification HTTP ou HTTPS 401. Lorsque vous activez cette fonctionnalité, l'écran de configuration du compte de profil s'affiche sur le téléphone dans les situations suivantes :

Lorsque l'erreur d'authentification HTTP ou HTTPS 401 se produit lors du premier provisionnement après le redémarrage du téléphone
Quand le nom d'utilisateur et le mot de passe du compte de profil sont vides
Quand il n'y a ni nom d'utilisateur ni mot de passe dans la règle du profil

Si l'écran de configuration du compte de profil est oublié ou ignoré, l'utilisateur peut également accéder à l'écran de configuration via le menu de l'écran du téléphone, ou via la touche programmable Configuration, qui s'affiche uniquement lorsqu'aucune ligne n'est enregistrée sur le téléphone.

Lorsque vous désactivez cette fonctionnalité, l'écran de configuration du compte de profil ne s'affiche pas sur le téléphone.

Le nom d'utilisateur et le mot de passe figurant dans le champ Règle du profil ont une priorité plus élevée que le compte de profil.

Lorsque vous fournissez une URL correcte dans le champ Règle du profil sans nom d'utilisateur ni mot de passe, le téléphone nécessite une authentification ou un résumé pour resynchroniser le profil. Avec le bon compte de profil, l'authentification passe. Avec un compte de profil incorrect, l'authentification échoue.
Lorsque vous fournissez une URL correcte dans le champ Règle du profil avec un nom d'utilisateur et un mot de passe corrects, le téléphone nécessite une authentification ou un résumé pour resynchroniser le profil. Le compte de profil n'est pas utilisé pour la resynchronisation du téléphone. La connexion est réussie.
Lorsque vous fournissez une URL correcte dans le champ Règle du profil avec un nom d'utilisateur et un mot de passe incorrects, le téléphone nécessite une authentification ou un résumé pour resynchroniser le profil. Le compte de profil n'est pas utilisé pour la resynchronisation du téléphone. La connexion échoue toujours.
Lorsque vous fournissez une URL incorrecte dans le champ Règle du profil, la connexion échoue toujours.

Vous pouvez également configurer les paramètres dans le fichier de configuration du téléphone à l'aide du code XML (cfg.xml).

Vous pouvez spécifier le type d'authentification du profil sur la page Web d'administration du téléphone.

1	Accédez à la page Web d'administration du téléphone.
2	Sélectionnez Voix > Approvisionnement.
3	Dans la section Profil de configuration, définissez le paramètre Type d'authentification du profil pour spécifier les informations d'identification à utiliser pour l'authentification des comptes de profil. Vous pouvez configurer ce paramètre dans le fichier XML de configuration du téléphone (cfg.xml) en saisissant une chaîne au format suivant : `<Profile_Authentication_Type ua="na">Disabled</Profile_Authentication_Type>` Options : Désactivé : désactive la fonctionnalité du compte de profil. Lorsque cette fonctionnalité est désactivée, le menu de configuration du compte de profil ne s'affiche pas sur l'écran du téléphone. Authentification HTTP de base : Les informations de connexion HTTP sont utilisées pour authentifier le compte de profil. Authentification XSI : les informations de connexion XSI ou les informations d'identification SIP XSI sont utilisées pour authentifier le compte de profil. Les informations d'authentification dépendent du type d'authentification XSI du téléphone : Lorsque le type d'authentification XSI du téléphone est défini sur Identifiants de connexion, ce sont les identifiants de connexion XSI qui sont utilisés. Lorsque le type d'authentification XSI du téléphone est défini sur Informations SIP, ce sont les informations d'identification SIP XSI qui sont utilisées. Par défaut : authentification HTTP de base
4	Cliquez sur Soumettre toutes les modifications.

Appliquer un profil manuellement à votre téléphone

Téléchargez le fichier de configuration sur le téléphone depuis un serveur TFTP

Suivez ces étapes pour télécharger le fichier de configuration sur une application serveur TFTP sur votre PC.

1	Connectez votre ordinateur au port LAN du téléphone.
2	Lancez une application serveur TFTP sur l'ordinateur et assurez-vous que le fichier de configuration est disponible dans le répertoire racine du TFTP.
3	Dans un navigateur Web, entrez l'adresse IP du réseau local du téléphone, l'adresse IP de l'ordinateur, le nom du fichier et les informations de connexion. Utilisez ce format : `http://<WAN_IP_Address>/admin/resync?tftp://<PC_IP_Address>/<file_name>&xuser=admin&xpassword=<password>` Exemple : `http://192.168.15.1/admin/resync?tftp://192.168.15.100/my_config.xml&xuser=admin&xpassword=admin`

Téléchargez le fichier de configuration sur le téléphone avec cURL

Suivez ces étapes pour télécharger la configuration sur le téléphone à l'aide de cURL. Cet outil de ligne de commande est utilisé pour transférer des données selon une syntaxe d'URL. Pour télécharger cURL, rendez-vous sur :

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

Nous vous recommandons de ne pas utiliser cURL pour publier la configuration sur le téléphone, car le nom d'utilisateur et le mot de passe risquent d'être capturés lors de l'utilisation de cURL.

1	Connectez votre ordinateur au port LAN du téléphone.
2	Téléchargez le fichier de configuration sur le téléphone en saisissant la commande cURL suivante : `curl –d @my_config.xml “http://192.168.15.1/admin/config.xml&xuser=admin&xpassword=admin”`

Références pour la configuration du profil

Le téléphone accepte les configurations au format XML.

Les exemples de cette section utilisent des profils de configuration utilisant la syntaxe XML.

Formats de profil de configuration

Le profil de configuration définit les valeurs des paramètres du téléphone.

Le format XML du profil de configuration utilise des outils de création XML standard pour compiler les paramètres et les valeurs.

Seul le jeu de caractères UTF-8 est pris en charge. Si vous modifiez le profil dans un éditeur, ne changez pas le format d'encodage ; sinon, le téléphone ne reconnaîtra pas le fichier.

Chaque téléphone possède un ensemble de fonctionnalités différent et, par conséquent, un ensemble de paramètres différent.

Format de profil ouvert

Le profil au format ouvert est un fichier texte dont la syntaxe ressemble à celle du XML et qui comporte une hiérarchie d'éléments, avec des attributs et des valeurs. Ce format vous permet d'utiliser des outils standard pour créer le fichier de configuration. Un fichier de configuration XML peut être envoyé du serveur d'approvisionnement au téléphone lors d'une opération de resynchronisation, sans compilation en tant qu'objet binaire.

Le téléphone peut accepter les formats de configuration générés par les outils standard. Cette fonctionnalité facilite le développement d'un logiciel de serveur d'approvisionnement principal qui génère des profils de configuration à partir de bases de données existantes.

Pour protéger les informations confidentielles du profil de configuration, le serveur d'approvisionnement transmet le fichier de configuration XML au téléphone via un canal sécurisé par TLS. En option, le fichier peut être compressé à l'aide de l'algorithme gzip deflate (RFC1951).

Le fichier peut être crypté selon l'une des méthodes de cryptage suivantes :

Chiffrement AES-256-CBC
Chiffrement du contenu HTTP basé sur la RFC-8188 avec chiffrement AES-128-GCM

Un fichier de configuration peut inclure les composants suivants :

Tags d'éléments
Attributs
Paramètres
Fonctionnalités de formatage
commentaires XML

Exemple : format de profil ouvert


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

La <flat-profile>balise Element contient tous les éléments de paramètres reconnus par le téléphone.

Propriétés des balises Element

Gardez les règles suivantes à l'esprit lorsque vous créez ou mettez à jour le fichier de configuration.

Le format d'approvisionnement XML et l'interface utilisateur Web permettent de configurer les mêmes paramètres. Les noms des balises XML et les noms des champs de l'interface utilisateur Web sont similaires mais varient en raison des restrictions relatives aux noms des éléments XML. Par exemple, des soulignements (_) dans le fichier de configuration XML au lieu d'espaces sur l'interface utilisateur Web.

Le téléphone reconnaît les éléments dont les noms de paramètres sont appropriés et qui sont encapsulés dans l'<flat-profile>élément spécial.

Les noms des éléments sont placés entre crochets.

La plupart des noms d'éléments sont similaires aux noms de champs de l'interface utilisateur Web du téléphone, avec les modifications suivantes :

Les noms des éléments ne doivent pas inclure d'espaces ni de caractères spéciaux. Pour dériver le nom de l'élément à partir du nom du champ Web, remplacez chaque espace par un trait de soulignement ou par les caractères spéciaux [,], (,) ou/.

Exemple : L'<Resync_On_Reset>élément représente le champ Resync On Reset.

Le nom de chaque élément doit être unique. Dans l'interface utilisateur Web du téléphone, les mêmes champs peuvent apparaître sur plusieurs pages Web, telles que les pages Ligne, Utilisateur et Extension. Ajoutez [n] au nom de l'élément pour indiquer le numéro qui apparaît dans l'onglet de la page.

Exemple : L'<Dial_Plan_1_>élément représente le plan de numérotation de la ligne 1.

Chaque étiquette d'élément d'ouverture doit avoir une étiquette d'élément de fermeture correspondante. Par exemple :

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

Les tags des éléments font la distinction entre majuscules et minuscules.

Les balises d'éléments vides sont autorisées et seront interprétées comme configurant la valeur pour qu'elle soit vide. Entrez la balise d'élément d'ouverture sans la balise d'élément correspondante, et insérez un espace et une barre oblique avant l'angle de fermeture (>). Dans cet exemple, la règle de profil B est vide :

<Profile_Rule_B />

Une balise d'élément vide peut être utilisée pour empêcher le remplacement des valeurs fournies par l'utilisateur lors d'une opération de resynchronisation. Dans l'exemple suivant, les paramètres de numérotation rapide de l'utilisateur restent inchangés :

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

Utilisez une valeur vide pour définir le paramètre correspondant sur une chaîne vide. Entrez un élément d'ouverture et un élément de fermeture sans aucune valeur entre les deux. Dans l'exemple suivant, le paramètre GPP_A est défini sur une chaîne vide.

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

Les noms d'éléments non reconnus sont ignorés.

Propriétés des paramètres

Ces propriétés s'appliquent aux paramètres :
Tous les paramètres qui ne sont pas spécifiés par un profil restent inchangés sur le téléphone.
Les paramètres non reconnus sont ignorés.
Si le profil Open Format contient plusieurs occurrences de la même balise de paramètre, la dernière occurrence remplace les précédentes. Pour éviter de modifier par inadvertance les valeurs de configuration d'un paramètre, nous recommandons que chaque profil spécifie au plus une instance de paramètre.
Le dernier profil traité est prioritaire. Si plusieurs profils spécifient le même paramètre de configuration, la valeur de ce dernier profil est prioritaire.

Formats de chaînes

Ces propriétés s'appliquent à la mise en forme des chaînes :
Les commentaires sont autorisés selon la syntaxe XML standard.

Les espaces blancs de début et de fin sont autorisés pour des raisons de lisibilité mais ils sont supprimés de la valeur du paramètre.
Les nouvelles lignes d'une valeur sont converties en espaces.
Un en-tête XML de la forme < ? ? > est autorisé, mais le téléphone l'ignore.
Pour saisir des caractères spéciaux, utilisez des échappements de caractères XML de base, comme indiqué dans le tableau suivant.
Personnage spécial
Séquence d'échappement XML
& (esperluette)
ET
< (moins de)
<
> (supérieur à)
>
« (apostrophe)
«
» (guillemets doubles)
«
Dans l'exemple suivant, les caractères échappés sont saisis pour représenter les symboles supérieurs et inférieurs à requis dans une règle de numérotation. Cet exemple définit un plan de numérotation de la hotline d'information qui définit le <Dial_Plan_1_>paramètre (Admin Login > Advanced > Voice > Ext (n)) à (S0 <:18005551212>).
<flat-profile> <Dial_Plan_1_> (S0 <:18005551212>) </Dial_Plan_1_> </flat-profile>
Les évasions de caractères numériques, utilisant des valeurs décimales et hexadécimales (par exemple (et)), sont traduites.
Le firmware du téléphone ne prend en charge que les caractères ASCII.

Personnage spécial	Séquence d'échappement XML
& (esperluette)	ET
< (moins de)	<
> (supérieur à)	>
« (apostrophe)	«
» (guillemets doubles)	«

Compression de profil ouvert

La méthode de compression prise en charge est l'algorithme GZIP Deflate (RFC1951). L'utilitaire gzip et la bibliothèque de compression qui implémentent le même algorithme (zlib) sont disponibles sur Internet.

Pour identifier la compression, le téléphone s'attend à ce que le fichier compressé contienne un en-tête compatible avec Gzip. L'invocation de l'utilitaire gzip sur le profil Open d'origine génère l'en-tête. Le téléphone inspecte l'en-tête du fichier téléchargé pour déterminer le format du fichier.

Par exemple, si profile.xml est un profil valide, le fichier profile.xml.gz est également accepté. L'une des commandes suivantes peut générer ce type de profil :

>gzip profile.xml

Remplace le fichier d'origine par un fichier compressé.

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

Laisse le fichier d'origine en place et produit un nouveau fichier compressé.

Chiffrement du profil ouvert

Le cryptage par clé symétrique peut être utilisé pour crypter un profil de configuration ouvert, que le fichier soit compressé ou non. La compression, si elle est appliquée, doit être appliquée avant le cryptage.

Le serveur d'approvisionnement utilise le protocole HTTPS pour gérer l'approvisionnement initial du téléphone après le déploiement. Le précryptage des profils de configuration hors ligne permet d'utiliser le protocole HTTP pour les resynchroniser ultérieurement. Cela réduit la charge du serveur HTTPS lors de déploiements à grande échelle.

Le téléphone prend en charge deux méthodes de cryptage pour les fichiers de configuration :

Chiffrement AES-256-CBC

Chiffrement du contenu HTTP basé sur la RFC 8188 avec chiffrement AES-128-GCM

La clé ou le matériel de saisie (IKM) doit être préapprovisionné dans l'unité plus tôt. Le bootstrap de la clé secrète peut être effectué en toute sécurité en utilisant le HTTPS.

Le nom du fichier de configuration ne nécessite pas de format spécifique, mais un nom de fichier qui se termine par l'extension .cfg indique normalement un profil de configuration.

Chiffrement AES-256-CBC

Le téléphone prend en charge le cryptage AES-256-CBC pour les fichiers de configuration.

L'outil de cryptage OpenSSL, disponible en téléchargement sur différents sites Internet, peut effectuer le cryptage. La prise en charge du cryptage AES 256 bits peut nécessiter une recompilation de l'outil pour activer le code AES. Le firmware a été testé par rapport à la version openssl-1.1.1d.

Pour un fichier crypté, le profil attend du fichier qu'il ait le même format que celui généré par la commande suivante :

# 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

Un -k minuscule précède la clé secrète, qui peut être n'importe quelle phrase en texte brut, et qui est utilisée pour générer un sel 64 bits aléatoire. Avec le secret spécifié par l'argument -k, l'outil de cryptage dérive un vecteur initial aléatoire de 128 bits et la véritable clé de cryptage 256 bits.

Lorsque cette forme de cryptage est utilisée sur un profil de configuration, le téléphone doit être informé de la valeur de la clé secrète pour déchiffrer le fichier. Cette valeur est spécifiée comme qualificatif dans l'URL du profil. La syntaxe est la suivante, en utilisant une URL explicite :

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

Cette valeur est programmée à l'aide de l'un des paramètres Profile_Rule.

Plusieurs paramètres d'approvisionnement font l'objet d'une extension macro en interne avant d'être évalués. Cette étape de pré-évaluation permet de contrôler plus facilement les activités de resynchronisation et de mise à niveau du téléphone.

Ces groupes de paramètres font l'objet d'un développement macro avant d'être évalués :

Resync_Trigger_*

Profile_Rule*

Log_XXX_MSG

Upgrade_Rule

Dans certaines conditions, certains paramètres généraux (GPP_*) font également l'objet d'une extension macro, comme indiqué explicitement dans la section Arguments de resynchronisation facultatifs ci-dessous.

Lors du développement des macros, le contenu des variables nommées remplace les expressions de la forme $NAME et $ (NAME). Ces variables incluent des paramètres généraux, plusieurs identifiants de produits, certains chronomètres d'événements et des valeurs d'état d'approvisionnement. Pour la liste complète, voir Variables d'extension des macros sous Paramètres d'approvisionnement.

Dans l'exemple suivant, l'expression $ (MAU) est utilisée pour insérer l'adresse MAC 000E08012345.

L'administrateur saisit : $ (MAU) config.cfg

L'extension de macros qui en résulte pour un appareil dont l'adresse MAC est 000E08012345 est la suivante : 000E08012345config.cfg

Si le nom d'une macro n'est pas reconnu, il n'est pas développé. Par exemple, le nom STRANGE n'est pas reconnu comme un nom de macro valide, alors que MAU est reconnu comme un nom de macro valide.

L'administrateur saisit : $Strange$Mau.cfg

L'extension macro qui en résulte pour un appareil dont l'adresse MAC est 000E08012345 est la suivante : $Strange000E08012345.cfg

L'expansion des macros n'est pas appliquée de manière récursive. Par exemple, « $$MAU » devient « $MAU » (le $$ est développé), et ne donne pas d'adresse MAC.

Le contenu des paramètres spéciaux, GPP_SA à GPP_SD, est mappé aux expressions macro $SA à $SD. Ces paramètres ne sont que des macros étendues en tant qu'argument des options --key, --uid et --pwd d'une URL de resynchronisation.

Les expressions conditionnelles peuvent déclencher des événements de resynchronisation et sélectionner d'autres URL pour les opérations de resynchronisation et de mise à niveau.

Les expressions conditionnelles consistent en une liste de comparaisons, séparées par l'opérateur et. Toutes les comparaisons doivent être satisfaisantes pour que la condition soit vraie.

Chaque comparaison peut porter sur l'un des trois types de littéraux suivants :

Valeurs entières

Numéros de version du logiciel ou du matériel

Cordes entre guillemets doubles

Numéros de version

La version logicielle du visiophone Cisco 8875 utilise ce format (où BN est le numéro de version) :

TÉLÉPHONES yyyy. 1-0-1-0001 - BN

où yyyy indique le modèle ou la série de téléphones ; 1 est la version majeure ; 0 est la version mineure ; 1-0001 est la version micro ; et BN est le numéro de version.

La chaîne de comparaison doit utiliser le même format. Sinon, il en résultera une erreur d'analyse du format.

Lorsque vous comparez la version du logiciel, la version majeure, la version mineure et la version micro sont comparées dans l'ordre, et les chiffres les plus à gauche ont priorité sur les derniers. Lorsque les numéros de version sont identiques, les numéros de version sont comparés.

Exemples de numéro de version valide

PHONEOS-8875.1-0-1-0001-19

Comparaison

Les chaînes entre guillemets peuvent être comparées pour des raisons d'égalité ou d'inégalité. Les nombres entiers et les numéros de version peuvent également être comparés arithmétiquement. Les opérateurs de comparaison peuvent être exprimés sous forme de symboles ou d'acronymes. Les acronymes sont pratiques pour exprimer la maladie dans un profil au format ouvert.

Opérateur

Syntaxe alternative

Description

Applicable aux opérandes de type entier et de version

Applicable aux opérandes sous forme de chaîne entre guillemets

=

eq

égal à

Oui

Oui

!=

un

pas égal à

Oui

Oui

<

lt

moins de

Oui

Non

<=

le

inférieur ou égal à

Oui

Non

>

gt

supérieur à

Oui

Non

>=

âge

supérieur ou égal à

Oui

Non

AND

et

Oui

Oui

Il est important de placer les variables macro entre guillemets doubles là où une chaîne littérale est attendue. Ne le faites pas là où un numéro ou un numéro de version est attendu.

Lorsqu'elles sont utilisées dans le contexte des paramètres Profile_Rule* et Upgrade_Rule, les expressions conditionnelles doivent être incluses dans la syntaxe « (expr) ? » comme dans cet exemple de règle de mise à niveau. N'oubliez pas de remplacer BN par le numéro de version du firmware vers lequel vous souhaitez effectuer la mise à niveau.

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

N'utilisez pas la syntaxe précédente entre parenthèses pour configurer les paramètres Resync_Trigger_*.

Opérateur	Syntaxe alternative	Description	Applicable aux opérandes de type entier et de version	Applicable aux opérandes sous forme de chaîne entre guillemets
=	eq	égal à	Oui	Oui
!=	un	pas égal à	Oui	Oui
<	lt	moins de	Oui	Non
<=	le	inférieur ou égal à	Oui	Non
>	gt	supérieur à	Oui	Non
>=	âge	supérieur ou égal à	Oui	Non
AND		et	Oui	Oui

Utilisez la syntaxe d'URL standard pour spécifier comment récupérer les fichiers de configuration et le chargement du microprogramme dans les paramètres Profile_Rule* et Upgrade_Rule, respectivement. La syntaxe est la suivante :

chemin de fichier [scheme ://] [server [:port]]

Où le schéma correspond à l'une de ces valeurs :

tftp

http

https

Si le schéma est omis, le TFTP est utilisé. Le serveur peut être un nom d'hôte reconnu par le DNS ou une adresse IP numérique. Le port est le numéro de port UDP ou TCP de destination. Le chemin du fichier doit commencer par le répertoire racine (/) ; il doit s'agir d'un chemin absolu.

S'il manque un serveur, c'est le serveur TFTP spécifié via DHCP (option 66) qui est utilisé.

Pour les règles de mise à niveau, le serveur doit être spécifié.

S'il manque un port, c'est le port standard du schéma spécifié qui est utilisé. TFTP utilise le port UDP 69, HTTP utilise le port TCP 80, HTTPS utilise le port TCP 443.

Un chemin de fichier doit être présent. Il ne fait pas nécessairement référence à un fichier statique, mais peut indiquer un contenu dynamique obtenu via CGI.

L'extension des macros s'applique aux URL. Voici des exemples d'URL valides :

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

Lorsque vous utilisez l'option DHCP 66, la syntaxe vide n'est pas prise en charge par les règles de mise à niveau. Cela ne s'applique qu'à la règle de profil*.

Chiffrement du contenu HTTP basé sur la RFC 8188

Le téléphone prend en charge le cryptage du contenu HTTP basé sur la RFC 8188 et le chiffrement AES-128-GCM pour les fichiers de configuration. Grâce à cette méthode de cryptage, n'importe quelle entité peut lire les en-têtes des messages HTTP. Cependant, seules les entités qui connaissent le matériel de saisie (IKM) peuvent lire la charge utile. Lorsque le téléphone est approvisionné avec l'IKM, le téléphone et le serveur d'approvisionnement peuvent échanger des fichiers de configuration en toute sécurité, tout en permettant à des éléments du réseau tiers d'utiliser les en-têtes des messages à des fins d'analyse et de surveillance.

Le paramètre de configuration XML IKM_HTTP_Encrypt_Content contient l'IKM du téléphone. Pour des raisons de sécurité, ce paramètre n'est pas accessible sur la page Web d'administration du téléphone. Il n'est pas non plus visible dans le fichier de configuration du téléphone, auquel vous pouvez accéder depuis l'adresse IP du téléphone ou depuis les rapports de configuration du téléphone envoyés au serveur d'approvisionnement.

Si vous souhaitez utiliser le cryptage basé sur la RFC 8188, assurez-vous de ce qui suit :

Approvisionnez le téléphone avec l'IKM en le spécifiant à l'aide du paramètre XML IKM_HTTP_Encrypt_Content dans le fichier de configuration envoyé par le serveur d'approvisionnement au téléphone.

Si ce cryptage est appliqué aux fichiers de configuration envoyés par le serveur d'approvisionnement au téléphone, assurez-vous que l'en-tête HTTP Content-Encoding du fichier de configuration contient la valeur aes128gcm.

En l'absence de cet en-tête, la méthode AES-256-CBC est prioritaire. Le téléphone applique le déchiffrement AES-256-CBC si une clé AES-256-CBC est présente dans une règle de profil, quel que soit l'IKM.

Si vous voulez que le téléphone applique ce cryptage aux rapports de configuration qu'il envoie au serveur d'approvisionnement, assurez-vous qu'aucune clé AES-256-CBC n'est spécifiée dans la règle des rapports.

Arguments de resynchronisation facultatifs

Les arguments facultatifs, key, uid et pwd, peuvent précéder les URL saisies dans les paramètres Profile_Rule*, placés collectivement entre crochets.

clé
uid et pwd

L'option --key indique au téléphone que le fichier de configuration qu'il reçoit du serveur d'approvisionnement est chiffré selon le protocole AES-256-CBC, sauf si l'en-tête Content-Encoding du fichier indique un cryptage aes128gcm. La clé elle-même est spécifiée sous forme de chaîne après le terme --key. La clé peut être placée entre guillemets doubles («) en option. Le téléphone utilise la clé pour déchiffrer le fichier de configuration.

Exemples d'utilisation

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

Les arguments facultatifs entre crochets sont développés par macro. Les paramètres à usage spécial, GPP_SA à GPP_SD, sont des macros étendues en macrovariables, $SA à $SD, uniquement lorsqu'ils sont utilisés comme arguments d'option clés. Consultez ces exemples :

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

Dans les profils au format ouvert, l'argument de --key doit être le même que celui de l'option -k fournie à openssl.

Les options uid et pwd peuvent être utilisées pour spécifier l'identifiant utilisateur et le mot de passe qui seront envoyés en réponse aux problèmes d'authentification HTTP Basic et Digest lorsque l'URL spécifiée est demandée. Les arguments facultatifs entre crochets sont développés par macro. Les paramètres à usage spécial, GPP_SA à GPP_SD, sont des macros étendues en macrovariables, $SA à $SD, uniquement lorsqu'ils sont utilisés comme arguments d'option clés. Consultez ces exemples :

GPP_SA = MyUserID GPP_SB = MySecretPassword

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

s'étendrait ensuite à :

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

Types de données

Ces types de données sont utilisés avec les paramètres du profil de configuration :

{a, b, c,...} —Un choix entre a, b, c,...

Bool : valeur booléenne « oui » ou « non ».

CADscript, un mini-script qui spécifie les paramètres de cadence d'un signal. Jusqu'à 127 caractères.

Syntaxe : S ₁ [; S ₂], où :

_{_{S _i =D _i (on _{i,1 /off i,1} [, on _i,2 /off _{i,2 [, on i,3} /off _i,3 _{[, on i,4} /off _{i,4 [, on i,5} _{/off _i,5} [, on _{i,6 /off i,6}]]]]) et est _connue sous le nom de section.}}

on _{i, j} et off _{i, j} sont la durée d'activation/désactivation en secondes d'un segment. i = 1 ou 2, et j = 1 à 6.

D _i est la durée totale de la section en secondes.

Toutes les durées peuvent comporter jusqu'à trois décimales pour obtenir une résolution de 1 ms. Le caractère générique « * » signifie une durée infinie. Les segments d'une section sont joués dans l'ordre et répétés jusqu'à ce que la durée totale soit jouée.

Exemple 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

Exemple 2 : Bague distinctive (courte, courte, courte, longue) :

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 : syntaxe de script utilisée pour spécifier les plans de numérotation des lignes 1 et 2.

Float <n>: une valeur à virgule flottante avec un maximum de n décimales.

FQDN : nom de domaine complet. Il peut contenir jusqu'à 63 caractères. Les exemples sont les suivants :
SIP.Cisco.com : 5060 ou 109.12.14. 12:12345
SIP.Cisco.com ou 109.12.14.12

FreqScript, un mini-script qui précise les paramètres de fréquence et de niveau d'une tonalité. Contient jusqu'à 127 caractères.

Syntaxe : F ₁ @L ₁ [, F ₂ @L ₂ [, F ₃ @L ₃ [, F ₄ @L ₄ [, F ₅ @L ₅ [, F ₆ @L ₆]]]]], où :

F ₁ à F ₆ sont les fréquences en Hz (entiers non signés uniquement).

L ₁ à L ₆ sont les niveaux correspondants en dBm (avec une décimale au maximum).

Les espaces blancs avant et après la virgule sont autorisés mais déconseillés.

Exemple 1 : Tonalité d'attente des appels :

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

Exemple 2 : Tonalité du cadran :

350@-19,440@-19 Number of Frequencies = 2 Frequency 1 = 350 Hz at –19 dBm Frequency 2 = 440 Hz at –19 dBm

IP : Adresse IPv4 valide au format x.x.x.x, où x est compris entre 0 et 255. Exemple : 10.1.2.100.

ID utilisateur : nom d'utilisateur tel qu'il apparaît dans une URL ; 63 caractères maximum.

Téléphone : une chaîne de numéro de téléphone, telle que 14081234567, *69, *72, 345678 ; ou une URL générique, telle que 1234 @10 .10.10. 100:5068 ou jsmith@Cisco.com. La chaîne peut contenir jusqu'à 39 caractères.

PHTMPLT, un modèle de numéro de téléphone. Chaque modèle peut contenir un ou plusieurs motifs séparés par une virgule (,). Les espaces blancs au début de chaque motif sont ignorés. « ? » et « * » représentent des caractères génériques. Pour représenter littéralement, utilisez %xx. Par exemple, %2a représente *. Le modèle peut contenir jusqu'à 39 caractères. Exemples : « 1408*, 1510* », « 1408123 ? ? ? ? , 555 ? 1. ».

Port : numéro de port TCP/UDP (0-65535). Il peut être spécifié au format décimal ou hexadécimal.

ProvisioningRulesyntax : syntaxe de script utilisée pour définir les règles de resynchronisation de la configuration et de mise à niveau du microprogramme.

PWRLevel : niveau de puissance exprimé en dBm avec une décimale, par exemple —13,5 ou 1,5 (dBm).

RSCTMPLT—Un modèle de code d'état de réponse SIP, tel que « 404, 5* », « 61 ? » , « 407, 408, 487, 481 ». Il peut contenir jusqu'à 39 caractères.

Sig <n>: valeur signée sur n bits. Il peut être spécifié au format décimal ou hexadécimal. Un signe « - » doit précéder les valeurs négatives. Le signe + avant une valeur positive est facultatif.

Star Codes : code d'activation pour un service supplémentaire, tel que *69. Le code peut contenir jusqu'à 7 caractères.

Str <n>: chaîne générique contenant un maximum de n caractères non réservés.

Heure <n>: durée en secondes, avec n décimales au maximum. Les décimales supplémentaires sont ignorées.

ToneScript : un mini-script qui spécifie les paramètres de fréquence, de niveau et de cadence d'une tonalité de progression d'appel. Le script peut contenir jusqu'à 127 caractères.

Syntaxe : FreqScript ; Z ₁ [; Z ₂].

_{_{_{_{_{_{_{_{La section Z _{1 est similaire à la section S 1} d'un CADscript, sauf que chaque segment activé/désactivé est suivi d'un paramètre de composantes de fréquence : Z ₁ = D ₁ (on i,1 /off i,1 /f _{i,1 [, on i,2 /off i,2 /f i,2 /f i,2 [, on i,3 /off i,3 [, on i,4 /off i,4 [, on i,5 /off i,4 [, on i,5 /off i,4} _{[, on i,5 /off _i,4 [, on i,5 /off _i,4 [, on i,5 /off i,4 [, on i,5} _{/off i,4 [, on i,5 /off _i,4 [, on i,5 /off _i,4 [, on i,5 /off i,4 [, on i,5} /off i,4 [, on _i,5 /off _{i,4 [, on _{i,5 /off 5, /f, i,5} [, activé, /off, i,6} /f}}}}}}}} _i,6]]]]]) où :

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

1 < n _k < 6 indique les composantes de fréquence du FreqScript qui sont utilisées dans ce segment.

Si plus d'une composante de fréquence est utilisée dans un segment, les composantes sont additionnées.

Exemple 1 : Tonalité du cadran :

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

Exemple 2 : ton bégaiement :

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

<n>Uns : valeur de n bits non signée, où n = 8, 16 ou 32. Elle peut être spécifiée au format décimal ou hexadécimal, par exemple 12 ou 0x18, à condition que la valeur puisse tenir sur n bits.

Tenez compte de ces points :

<Par Name>représente le nom d'un paramètre de configuration. Dans un profil, la balise correspondante est créée en remplaçant l'espace par un trait de soulignement « _ », comme Par_Name.
Un champ de valeur par défaut vide implique une chaîne vide < « » >.
Le téléphone continue d'utiliser les dernières valeurs configurées pour les tags qui ne figurent pas dans un profil donné.
Les modèles sont comparés dans l'ordre indiqué. Le premier match, qui n'est pas le plus proche, est sélectionné. Le nom du paramètre doit correspondre exactement.
Si plusieurs définitions sont données pour un paramètre dans un profil, la dernière définition de ce type dans le fichier est celle qui prend effet sur le téléphone.
Une spécification de paramètre dont la valeur est vide force le paramètre à revenir à sa valeur par défaut. Pour spécifier une chaîne vide à la place, utilisez la chaîne vide « » comme valeur de paramètre.

Cisco AI Assistant

Merci pour votre commentaire.