.. _fr-module010: ======================================================================================= SCOPTEL Logiciel PBX IP — Système de provisionnement automatique (‘APS’) ======================================================================================= .. only:: pdf .. contents:: .. only:: html `Version PDF `_ Contexte -------------- * L’APS (système de provisionnement automatique ou « Automatic Provisioning System ») est utilisé pour créer les fichiers de configuration nécessaires pour de nombreux terminaux SIP. L’APS assigne des noms d’utilisateur et des mots de passe SIP, des options réseau, des paramètres de temps, des paramètres de qualité de service, des plans de numérotation, des politiques de mise à niveau du micrologiciel, la programmation des touches programmables, la programmation de touches DSS/BLF (voyants d’occupation), les paramètres de sécurité, les modes DTMF et LDAP. * Les modèles peuvent être configurés pour simplifier les tâches fastidieuses de paramétrages de configurations pour autant de points de terminaux SIP que requis. * Les extensions devant être assignées à une adresse MAC doivent déjà exister et doivent donc être créées avant d’essayer de les assigner au matériel utilisant un APS (système d’approvisionnement automatique). * Voici une liste des fournisseurs reconnus : * Yealink * Aastra * Polycom * Cisco * Sipura/Linksys/Cisco * Panasonic SIP et SIP DECT * Les téléphones VtechHospitality * Snom * CyberdataIntercoms * Grandstream * SpectraLink * Alcatel * AudioCodes * LG-Ericsson Sécurité ------------ * Les pirates balaient régulièrement les adresses IP à la recherche de ports ouverts et, s’ils trouvent une adresse IP vulnérable à l’analyse par force brute, ils exécuteront une analyse de provisionnement à distance en utilisant les 6 premiers chiffres des identifiants de fournisseurs populaires comme Polycom, Yealink et ensuite les 6 derniers chiffres des adresses MAC à 12 chiffres par force brute. * Par exemple, un serveur SCOPTEL utilisant le port d’écoute HTTP par défaut de 5555 peut être attaqué en utilisant cette méthode. D’autres fournisseurs sont également vulnérables sur le port d’écoute HTTP qu’ils utilisent pour fournir à distance des services à des téléphones IP. * Le TFTP est particulièrement vulnérable sur le port UDP 69, car aucun chemin spécifique n’est requis pour le fichier MAC.cfgfile. Seule la variable .cfgvariable est nécessaire pour recueillir le fichier MAC.cfgfile. TFTP devrait être bloqué sur le pare-feu dans la mesure du possible. * Si vous avez activé Telephony>Configuration>Security>Flood Protection et le service SCOPTEL Firewall and Telephony Flood Protection (Fail2ban), l’adresse IP de l’attaquant distant sera blacklistée par le pare-feu quand une attaque de type force brute est détectée. * Mais si l’attaquant distant connaît une adresse MAC valide sur le réseau, alors ce fichier MAC.cfgfile peut être facilement récupéré à moins que l’authentification HTTP ne soit configurée. La méthode exacte ne sera pas publiée ici, car elle ne doit pas être de notoriété publique. * Voir : https://blog.scopserv.com/2018/10/securing-configuration-files-with-http-authentication/ Le mappage IP/DNS expliqué -------------------------- L’objectif du mappage IP/DNS est de remplacer une adresse IP « factice » (dummy) ou une adresse IP statique par un FQDN (nom de domaine complet). * Les FQDN sont très avantageux pour les raisons suivantes : * Un fichier DNS A public peut aider un téléphone VoIP distant à contacter l’adresse IP publique du serveur SCOPTEL afin d’enregistrer son compte SIP et de mettre à jour ses paramètres de provisionnement. * Un fichier DNS A local peut aider un téléphone VoIP distant à contacter l’adresse IP publique du serveur SCOPTEL afin d’enregistrer son compte SIP et de mettre à jour ses paramètres de provisionnement. * Si les adresses LAN ou WAN du serveur changent, les configurations APS n’ont pas besoin d’être modifiées. * Seuls les enregistrements DNS A nécessiteront des modifications et puisque le téléphone utilisera toujours les recherches DNS pour se réenregistrer ou se reconfigurer, les temps d’indisponibilité sont réduits au minimum. * Dans l’un ou l’autre de ces scénarios, le téléphone est toujours configuré avec le même FQDN et si l’enregistrement DNS A doit être modifié sur le mappage IP/DNS. Ajouter un nouveau système de provisionnement ----------------------------------------------- * À partir de From Configuration > Telephony > Provisioning, cliquer sur « Add a New Provisioning System » (Ajouter un nouveau système de provisionnement). .. image:: ../assets/trainings/Module10ScopTELAutomaticProvisioningSystem1.png Le mappage IP/DNS ----------------- * Dans la liste déroulante Tenant, choisir Tenant>All (Global) pour que tous les locataires puissent utiliser le même mappage IP/DNS. Ou sélectionner le locataire spécifique (Tenant) pour qui le mappage IP/DNS doit être limité. * Dans cet exemple, l’adresse IP source 1.1.1.1.1 est une adresse fictive qui sera remplacée par master88.commzilla.net dans les fichiers /tftpboot/.cfg. * Une fois l’édition terminée, ajouter l’objet (« Add the object ») et continuer à ajouter des modèles basés sur le matériel, puis ajouter des objets basés sur l’adresse MAC en utilisant les modèles. * Ce remplacement est automatiquement effectué pour toutes les instances de la version 1.1.1.1 dans n’importe quel modèle ou objet APS basé sur MAC comme indiqué dans ces exemples : .. image:: ../assets/trainings/Module10ScopTELAutomaticProvisioningSystem2.png .. image:: ../assets/trainings/Module10ScopTELAutomaticProvisioningSystem3.png Ajout d’un nouveau modèle de document (« Template ») basé sur le Matériel ---------------------------------------------------------------------------- * À partir de From Configuration > Telephony > Provisioning, cliquer sur « Add a New Provisioning System » (Ajouter un nouveau système de provisionnement). * Dans la liste déroulante Tenant, choisir Tenant>All (Global) pour que tous les locataires puissent utiliser le même mappage IP/DNS. Ou sélectionner le locataire spécifique (Tenant) auquel restreindre le modèle de document du vendeur. * Dans la liste déroulante Modèle de téléphone (« Phone Model »), sélectionner le matériel correspondant aux téléphones à déployer. * S’assurer de cocher la case « Create Template ». * Donner à ce modèle de document (« Template ») un nom significatif. * Cliquer sur l’onglet Provisioning .. image:: ../assets/trainings/Module10ScopTELAutomaticProvisioningSystem4.png Généralités ----------- * Utiliser le sélecteur de liste déroulante pour choisir la version de micrologiciel installée sur l’appareil afin que ce modèle de document (« template ») puisse écrire des fichiers compatibles. * Utiliser la liste déroulante pour choisir la méthode de synchronisation préférée. * URL de provisionnement : entrer le chemin d’accès complet vers le serveur de provisionnement dans le format suivant : < http_protocol >://:< Listen_on_Port >/< TFTP_Alias >/ * Exemple : http://master 88.commzilla.net:5555/tftpboot/ * URL du micrologiciel : * URL de provisionnement : entrer le chemin d’accès complet vers le serveur de provisionnement dans le format suivant : < http_protocol >://:Listen_on_Port >/< TFTP_Alias >/< firmware_filename > * Exemple : http://master88.commzilla.net:5555/tftpboot/T48-35.83.0.50.rom * Cliquez sur l’onglet Server .. image:: ../assets/trainings/Module10ScopTELAutomaticProvisioningSystem5.png Serveur --------- * Dans les cases « Registrar », entrez l’adresse IP fictive créée pour le mappage IP/DNS * Cliquer sur l’onglet Network .. image:: ../assets/trainings/Module10ScopTELAutomaticProvisioningSystem6.png Réseau (Network) ------------------- * Il est recommandé d’utiliser l’option NAT pour que rport puisse être activé. * STUN Server : non recommandé * Activer « Link Layer Discovery Protocol (LLDP) », un protocole optionnel standard ouvert de couche 2 qui permet une adhésion automatique au VLAN. * Activer « Link Layer Discovery Protocol (LLDP) », un protocole Cisco Layer 2 optionnel qui permet une adhésion automatique au VLAN. * Cliquer sur l’onglet « Date and Time » (Date et heure), lorsque terminé. .. image:: ../assets/trainings/Module10ScopTELAutomaticProvisioningSystem7.png « Date and Time » (Date et heure) ---------------------------------- Modifier la configuration de « Date and Time » (Date et heure) si requis * Cliquer sur « Phone Options » .. image:: ../assets/trainings/Module10ScopTELAutomaticProvisioningSystem8.png Phone Options (Options téléphoniques) -------------------------------------- Modifier les paramètres comme : * « Phone Language » (langue du téléphone) pour l’utilisateur final. * « Country Tone » (tonalité du pays) * « Set Custom Tones » (configurer des tonalités spécifiques) * N’importe quelle autre option spécifique * Cliquer sur n’importe quelle touche DSS .. image:: ../assets/trainings/Module10ScopTELAutomaticProvisioningSystem9.png Les touches DSS vs les touches programmables ----------------------------------------------------------------- .. image:: ../assets/trainings/Module10ScopTELAutomaticProvisioningSystem10.png Touches DSS ------------ * Les Touches DSS sont les * Activer Enable Enhanced DSS Keys (EDK)(EDK) pour activer les fonctions SCOPTEL PBX dans les listes déroulantes. * La recommandation du type d’opération (« Deal Type ») est le Transfert Assisté (« Attended Transfer ») pour les fonctionnalités PBX appropriées. * Le type de module d’extension (« Expansion Module ») et le nombre de modules d’extension attribués (« Number of Expansion modules ») dépendent du matériel supplémentaire et sont optionnels. * La touche 1 est utilisée pour l’affectation de poste. Laisser l’étiquette vide (« Label ») et la liste déroulante Ligne définie sur Line 1. NOTE : chaque touche de ligne peut traiter 8 appels simultanés. Il n’est pas nécessaire d’avoir plus d’une assignation de clé (« Key Assignment ») par la poste. Les touches restantes peuvent être attribuées pour les BLF (voyants d’occupation), les événements clés (« Key Events »), les numéros abrégés (« Speed Dials »), les fonctions (« Features »), les événements DTMF (« tonalités multifréquences »), les recherches d’annuaires (« Directory lookups »), etc... * Cliquer sur les Touches programmables (« Programmable Keys »), lorsque vous avez terminé les modifications. .. image:: ../assets/trainings/Module10ScopTELAutomaticProvisioningSystem11.png Touches programmables --------------------- * Les touches programmables peuvent être réaffectées à partir de leurs réglages d’usine (« Factory Settings »). * Cliquer sur l’onglet Security lorsque terminé. .. image:: ../assets/trainings/Module10ScopTELAutomaticProvisioningSystem12.png Sécurité ----------- * il est recommandé de changer le mot de passe de l’administrateur * Il est assez commun pour les utilisateurs de subir des appels fantômes (« ghost calls ») sur leurs téléphones. Cela se produit lorsqu’un pare-feu lie le port de signalisation SIP par défaut udp / 5060 du téléphone avec l’interface publique du pare-feu en tant que ALG SIP mal implémenté. * Les outils publics comme http://blog.sipvicious.org/ sont souvent utilisés pour analyser les adresses IP publiques sur le port 5060 à la recherche de périphériques à faible sécurité qu’ils peuvent exploiter. Quand cela se produit, des appels des fantômes (« ghost calls ») sont souvent vus et entendus. Afin de prévenir cela, il est recommandé de : * Désactiver l’option « Allow Direct IP Call » (Permettre les Appels IP directs) * Activer l’option « Accept SIP Trust Server Only » * Pour l’affectation des touches de ligne (Line Keys), utiliser un port UDP non standard entre les valeurs udp / 10000 - 20000. * REMARQUE : le port SIP local ne peut être configuré dans aucun modèle et doit être affecté à la configuration APS MAC. * Cliquer sur l’onglet « Multicast Paging » (radiomessagerie multidiffusion) lorsque terminé. .. image:: ../assets/trainings/Module10ScopTELAutomaticProvisioningSystem13.png .. image:: ../assets/trainings/Module10ScopTELAutomaticProvisioningSystem14.png Radiomessagerie multidiffusion (« Multicast Paging ») ------------------------------------------------------- * La radiomessagerie multidiffusion dépasse le cadre de ce document. * Se référer à : https://blog.scopserv.com/2018/02/how-to-setup-paging-in-SCOPTEL/ * Lorsque la configuration du « Multicast Paging » est terminé, cliquez sur l’onglet Services PBX. .. image:: ../assets/trainings/Module10ScopTELAutomaticProvisioningSystem15.png Services PBX --------------- * Les services PBX permettent de configurer l’URL pour les téléphones afin de créer des répertoires de recherche internes (« Directory Lookup »). * * Cliquer sur l’onglet LDAP lorsque terminé. .. image:: ../assets/trainings/Module10ScopTELAutomaticProvisioningSystem16.png LDAP ------- * La configuration LDAP dépasse le cadre de ce document. * Se référer à : https://blog.scopserv.com/2012/08/setting-up-an-ldap-directory-server-on-SCOPTEL-pbx/ * Une fois le modèle terminé, cliquer sur le bouton « Add » .. image:: ../assets/trainings/Module10ScopTELAutomaticProvisioningSystem17.png Ajout d’une adresse MAC et attribution d’une extension -------------------------------------------------------- * À partir de From Configuration > Telephony > Provisioning, cliquer sur « Add a New Provisioning System » (Ajouter un nouveau système de provisionnement). .. image:: ../assets/trainings/Module10ScopTELAutomaticProvisioningSystem18.png Assignation d’une adresse MAC ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ * Il est essentiel de choisir le sélecteur de Locataire (« Tenant ») pour choisir un Locataire dédié. Il est impossible d’utiliser choisir Tenant « All » (Global) (Locataire « Tous » [Global]). * Utiliser le sélecteur de liste déroulante « Phone Model » pour trouver le matériel correspondant à votre déploiement téléphonique. * Choisir parmi un modèle déjà configuré * Entrer l’adresse MAC unique de votre matériel dans le champ Adresse MAC (« MAC Address »). * Cliquer sur « Lines » (Lignes) lorsque terminé. .. image:: ../assets/trainings/Module10ScopTELAutomaticProvisioningSystem19.png Lignes (« Lines ») ------------------- * Dans l’exemple de modèle, une seule touche DSS a reçu une affectation de ligne 1 (« Line »), nous ne configurerons donc que la ligne 1. * Utilisez le sélecteur de liste déroulante pour assigner un poste (extension) non assigné. * Entrer le texte de l’étiquette (affichage du téléphone ou «  Label, [Affichage du téléphone »]) devant être affiché à l’écran LCD du téléphone. * Pour prendre en charge les mises à jour de la ligne connectée P - Asserted CallerID (Identifiant de l’appelant confirmé P), la sélection par défaut de la source d’identification de l’appelant sur PAI — FROM doit être modifiée. * Le port SIP local peut être changé pour n’importe quelle valeur spécifique, entre 10 000 et 20 000, pour réduire la probabilité d’appels fantômes. * Le chiffrage vocal SRTP peut être activé de manière optionnelle, mais certaines configurations prérequises doivent en ce cas être effectuées à l’avance. Consulter le : https://blog.scopserv.com/2016/09/how-to-use-the-SCOPTEL-certificate-manager-to-enable-tls-encryption/ * * Cliquer sur l’onglet « PBX Services » (Services PBX) lorsque terminé. .. image:: ../assets/trainings/Module10ScopTELAutomaticProvisioningSystem20.png Services PBX -------------- * En utilisant le sélecteur de liste déroulante, choisissez le poste (Extension) assigné à la ligne 1. * Cliquer sur Add (Ajouter) lorsque terminé. .. image:: ../assets/trainings/Module10ScopTELAutomaticProvisioningSystem21.png Approvisionnement ------------------- * La sécurité est un élément critique, avant de procéder, consulter : https://blog.scopserv.com/2018/10/securing-configuration-files-with-http-authentication/ * L’adresse du serveur SIP est utilisée pour le code de la fonction d’approvisionnement automatique (« Auto Provisioning Feature Code ») dans les paramètres de téléphonie (« Telephony Settings ») : Configuration>Provisioning. Il doit s’agir d’une adresse physiquement assignée au serveur * L’adresse du serveur TFTP doit être une adresse physiquement affectée au serveur et doit être l’adresse liée à l’interface exécutant DHCP. * Le nom d’hôte du serveur doit avoir un enregistrement DNS A correspondant sur le serveur DNS supportant ce réseau. * Si l’option « Enable Auto - Create support if configuration doesn't exist » (Activer support autocréation si la configuration n’existe pas) est activée lorsque la détection DHCP détecte un périphérique supporté, son adresse MAC sera ajoutée à la liste d’adresses MAC APS. Si cette option est activée, la configuration de la liste blanche (« White List ») doit être considérée comme obligatoire pour des raisons de sécurité. * Les périphériques pris en charge sont : Aastra Snom Polycom Yealink .. image:: ../assets/trainings/Module10ScopTELAutomaticProvisioningSystem22.png En plus de la configuration manuelle des adresses MAC pour les périphériques SIP pris en charge, SCOPTEL prend également en charge plusieurs méthodes de déploiement de masse * Importation texte des adresses MAC à partir d’un fichier * Balayage réseau des adresses IP sélectionnées sur des sous-réseaux sélectionnés * Détection DHCP de nouveaux périphériques lorsque le serveur DHCP SCOPTEL est le seul serveur DHCP sur la Configuration minimale requise pour LAN SCOPTEL * SCOPSERV_yum install nmap (si nmap n’est pas déjà installé) * SCOPSERV-network-2.6.4-1.nodist. SCOPSERV.noarch.rpm * SCOPSERV-server-2.6.4-1.nodist. SCOPSERV.noarch.rpm * SCOPSERV-telephony 25-2.6.52-1.el5.SCOPSERV.noarch.rpm Importation texte des adresses MAC à partir d’un fichier ---------------------------------------------------------- * À partir de la page principale de l’APS, cliquer sur Importer MAC * Entrer une liste d’adresses MAC ou copiez et collez à partir d’un fichier ASCII. * Cliquer sur Next * Une nouvelle liste de périphériques SIP apparaît, indiquant que l’ID du fournisseur de MAC correspond au matériel pris en charge (dans ce cas, 3 nouveaux téléphones Polycom). * Appuyer sur **Next**. .. image:: ../assets/trainings/Module10ScopTELAutomaticProvisioningSystem23.png .. image:: ../assets/trainings/Module10ScopTELAutomaticProvisioningSystem24.png * Comme le système ne peut pas connaître le numéro de modèle de chaque appareil, sélectionner un numéro de modèle correspondant dans la liste pour chaque adresse MAC en utilisant les sélections de la liste déroulante. * Cliquer sur Next * Cliquer sur Finish pour ajouter les nouveaux MAC à la liste APS. .. image:: ../assets/trainings/Module10ScopTELAutomaticProvisioningSystem25.png .. image:: ../assets/trainings/Module10ScopTELAutomaticProvisioningSystem26.png Balayage réseau des adresses IP sélectionnées sur des sous-réseaux sélectionnés ---------------------------------------------------------------------------------- * Cette méthode n’ajoutera que les adresses MAC non configurées à la liste APS. * Cliquer sur Network Auto - Discovery (Scan) .. image:: ../assets/trainings/Module10ScopTELAutomaticProvisioningSystem27.png * Entrer la première adresse IP disponible sur un sous-réseau valide (normalement la première adresse IP dans un pool DHCP). * Entrer la dernière adresse IP disponible sur un sous-réseau valide (normalement la dernière adresse IP dans un pool DHCP). * Choisir l’interface réseau qui dessert le sous-réseau valide. * Choisir le locataire désiré * Entrer l’adresse IP du serveur SIP (généralement l’adresse IP de l’interface réseau desservant le sous-réseau local). * Cliquer sur Next .. image:: ../assets/trainings/Module10ScopTELAutomaticProvisioningSystem28.png * La nouvelle fenêtre affichera une liste des adresses MAC détectées. .. image:: ../assets/trainings/Module10ScopTELAutomaticProvisioningSystem32.png Ajout automatique des périphériques pris en charge via les classes DHCP --------------------------------------------------------------------------- Prérequis ^^^^^^^^^^^^^^^^^^^^^^ Prérequis du module Network (Réseau) +++++++++++++++++++++++++++++++++++++ * Network>DHCP Server doit être activé et bien configuré. En créant des classes DHCP, une liste par défaut des périphériques pris en charge sera ajoutée par l’ID fournisseur connu (« Known Vendor ID »). * Chaque classe utilisera les options de provisionnement par défaut pour chaque fournisseur de matériel pris en charge. * Ceci simplifie l’édition d’options comme l’option TFTP 66 ou 150, selon le fournisseur. .. image:: ../assets/trainings/Module10ScopTELAutomaticProvisioningSystem34.png Après avoir créé les classes par défaut, les classes doivent être ajoutées au sous-réseau DHCP. .. image:: ../assets/trainings/Module10ScopTELAutomaticProvisioningSystem35.png * Commettre les changements Réseau. * Redémarrer le Service de serveur DHCP pour activer les changements .. image:: ../assets/trainings/Module10ScopTELAutomaticProvisioningSystem36.png Prérequis du module Telephony (Téléphonie) +++++++++++++++++++++++++++++++++++++++++++++ * Telephony>Configuration>Channels>SIP Channel>Auto-Create Peers=yes * MISE EN GARDE La création automatique des pairs (« Auto-Create Peers ») peut être vulnérables aux attaques SIP malveillantes, de sorte que le serveur ne doit pas avoir de ports SIP exposés au public (appliquer le pare-feu à vos ports SIP vers des sous-réseaux externes et suivre les meilleures pratiques de sécurité SCOPSERV). .. image:: ../assets/trainings/Module10ScopTELAutomaticProvisioningSystem37.png * Telephony>Configuration>Provisioning * Pour des raisons de sécurité, remplacez le NIP de Unprovisioned Feature (« fonction non approvisionnée ») par un nombre complexe. * Entrer l’adresse du serveur SIP requise pour l’enregistrement * Sauvegarder puis commettre (« Commit ») les changements .. image:: ../assets/trainings/Module10ScopTELAutomaticProvisioningSystem38.png UTILISATION ^^^^^^^^^^^^ * Brancher un périphérique SIP pris en charge dans le sous-réseau vocal. * Attendre que ce dernier démarre (il peut redémarrer après avoir téléchargé sa configuration du serveur pour la première fois). * Une fois le téléphone démarré, son adresse MAC devrait apparaître dans la liste APS comme périphérique non approvisionné (« unprovisioned device »). * Une fois que le téléphone affiche UNPROV sur son écran, le processus d’enregistrement peut commencer. * Composer n’importe quel numéro de téléphone pour entendre l’invite du mot de passe * Entrer le code NIP d’approvisionnement défini dans Telephony>Configuration>Provisioning à l’aide du clavier. * Entrer un numéro de poste défini, mais non attribué à l’aide du clavier lorsqu’invité. * Modifier l’adresse MAC dans la liste APS et les paramètres nécessaires comme le modèle utilisé, le nom, les affectations des touches programmables, etc. * Commit (Commettre) * Redémarrer le téléphone pour télécharger les configurations finales