Le support technique de 3CX répond : capture du trafic SIP sur le serveur de l'ATS

Cet article traite des bases de la capture et de l'analyse du trafic SIP généré par le système téléphonique 3CX. Il s'adresse aux administrateurs système débutants ou aux utilisateurs ordinaires chargés de la maintenance de la téléphonie. Pour approfondir le sujet, nous recommandons de suivre le cours avancé 3CX.

3CX V16 permet de capturer le trafic SIP directement via l'interface web du serveur et de le sauvegarder au format standard PCAP de Wireshark. Vous pouvez joindre le fichier de capture lorsque vous contactez le support technique ou le télécharger pour une analyse autonome.

Si 3CX fonctionne sous Windows, vous devez installer Wireshark sur le serveur 3CX vous-même. Sinon, lors de la tentative de capture, le message suivant apparaîtra.


Dans les systèmes Linux, l'outil tcpdump est installé automatiquement lors de l'installation ou de la mise à jour de 3CX.

Capture de trafic

Pour commencer la capture, allez dans la section de l'interface Accueil > Événements SIP et choisissez l'interface sur laquelle vous souhaitez effectuer la capture. Vous pouvez également capturer le trafic sur toutes les interfaces en même temps, sauf sur les interfaces de tunneling IPv6.

Dans 3CX pour Linux, vous pouvez capturer le trafic pour le localhost (lo). Cette capture est utilisée pour analyser les connexions des clients SIP via la technologie 3CX Tunnel et Session Border Controller.

Le bouton « Capturer le trafic » lance Wireshark sous Windows ou tcpdump sous Linux. À ce moment-là, il est nécessaire de reproduire rapidement le problème, car la capture charge le processeur et prend beaucoup de place sur le disque.  


Faites attention aux paramètres d'appel suivants :

• Le numéro d'où l'appel a été passé, vers lequel il a été passé, et d'autres numéros / participants à l'appel.
• L'heure exacte de survenue du problème selon l'horloge du serveur 3CX.
• Le chemin de l'appel.

Essayez de ne pas cliquer sur d'autres endroits de l'interface, à part le bouton « Arrêter ». Évitez également de naviguer vers d'autres liens dans cette fenêtre du navigateur. Sinon, la capture du trafic continuera en arrière-plan et entraînera une charge supplémentaire sur le serveur.

Obtention du fichier de capture

Le bouton « Arrêter » interrompt la capture et sauvegarde le fichier de capture. Vous pouvez télécharger le fichier sur votre ordinateur pour l'analyser avec l'outil Wireshark ou générer un fichier spécial pour le support technique., qui inclura cette capture et d'autres informations de débogage. Après le téléchargement ou l'inclusion dans le package de support technique, le fichier de capture est automatiquement supprimé du serveur 3CX pour des raisons de sécurité.

Sur le serveur 3CX, le fichier se trouve à l'emplacement suivant :

• Windows : C:ProgramData3CXInstance1DataLogsdump.pcap
• Linux : /var/lib/3cxpbx/Instance/Data/Logs/dump.pcap

Pour éviter une surcharge du serveur ou une perte de paquets lors de la capture, la période de capture est limitée à 2 millions de paquets. Après cela, la capture s'arrête automatiquement. Si vous avez besoin d'une capture plus longue, utilisez l'outil Wireshark séparé, comme décrit ci-dessous.

Capture de trafic avec l'outil Wireshark

Si vous êtes intéressé par une analyse plus approfondie du trafic réseau, capturez-le manuellement. Téléchargez l'outil Wireshark pour votre système d'exploitation. d'ici. Après avoir installé l'outil sur le serveur 3CX, allez dans la section Capture > Interfaces. Tous les interfaces réseau du système d'exploitation y seront affichés. Les adresses IP des interfaces peuvent s'afficher au format IPv6. Pour voir l'adresse IPv4, cliquez sur l'adresse IPv6.

Choisissez l'interface à capturer et cliquez sur le bouton Options. Décochez Capture Traffic in promiscuous mode, et laissez les autres paramètres inchangés.

Vous devez maintenant reproduire le problème. Lorsque le problème est reproduit, arrêtez la capture (menu Capture > Stop). Vous pouvez extraire les messages SIP dans le menu Telephony > SIP Flows.

Bases de l'analyse du trafic - message SIP INVITE

Examinons les principaux champs du message SIP INVITE, qui est envoyé pour établir un appel VoIP, c'est-à-dire constitue le point de départ pour l'analyse. En général, un SIP INVITE contient de 4 à 6 champs avec des informations utilisées par les appareils SIP terminaux (téléphones, passerelles) et les opérateurs de télécommunications. Comprendre le contenu de l'INVITE et les messages suivants aide souvent à identifier la source du problème. En outre, connaître les champs INVITE est utile lors de la connexion des opérateurs SIP à 3CX ou lors de l'intégration de 3CX avec d'autres PABX SIP.

Dans le message INVITE, les utilisateurs (ou appareils SIP) sont identifiés par URI. En général, un SIP URI est le numéro de téléphone de l'utilisateur + l'adresse du serveur SIP. Le SIP URI est très similaire à une adresse e-mail et s'écrit sous la forme sip:x@y:Port.

Request-Line-URI :

Request-Line-URI - le champ contient le destinataire de l'appel. Il contient la même information que dans le champ To, mais sans le nom affiché de l'utilisateur (Display Name).

Via:

Via — chaque serveur SIP (proxy) qui traite la requête INVITE ajoute en tête de la liste Via son adresse IP et le port sur lequel le message a été reçu. Ensuite, le message est transmis le long du chemin. Lorsque le destinataire final répond à la requête INVITE, tous les nœuds de transit « consultent » l'en-tête Via et retournent le message à l'expéditeur par le même chemin. Dans ce cas, le proxy SIP de transit supprime ses données de l'en-tête.

De :

De — l'en-tête indique l'initiateur de la requête du point de vue du serveur SIP. L'en-tête est formé de la même manière qu'une adresse e-mail (user@domain, où user est le numéro d'extension de l'utilisateur 3CX, et domain est l'adresse IP locale ou le domaine SIP du serveur 3CX). Comme pour l'en-tête To, l'en-tête From contient un URI et, optionnellement, un nom affiché pour l'utilisateur Display Name. L'en-tête From permet de comprendre comment traiter cette requête SIP.

La norme SIP RFC 3261 stipule que si le nom affiché Display Name n'est pas transmis, le téléphone IP ou la passerelle VoIP (UAC) doivent utiliser le nom affiché « Anonyme », par exemple, De : « Anonyme » .

À :

À — cet en-tête indique le destinataire de la requête. Cela peut être soit le destinataire final de l'appel, soit un intermédiaire. Généralement, l'en-tête contient un URI SIP, mais d'autres schémas sont possibles (cf. RFC 2806 [9]). Cependant, l'URI SIP doit être pris en charge dans toutes les implémentations du protocole SIP, quel que soit le fabricant de matériel. L'en-tête To peut également contenir un nom affiché Display Name, par exemple, À : « Nom Prénom » .)

En général, le champ To contient un URI SIP indiquant le premier (suivant) proxy SIP qui traitera la requête. Ce n'est pas nécessairement le destinataire final de la requête.

Contact :

Contact — l'en-tête contient un URI SIP par lequel l'expéditeur de la requête INVITE peut être joint. C'est un en-tête obligatoire qui doit contenir un seul URI SIP. Il fait partie de la communication bidirectionnelle correspondant à la requête SIP INVITE initiale. Il est très important que l'en-tête Contact contienne des informations correctes (y compris l'adresse IP) par lesquelles l'expéditeur de la requête attend une réponse. L'URI Contact est également utilisé dans les communications ultérieures, déjà après l'établissement de la session de communication.

Autoriser :

Allow — le champ contient une liste de paramètres (méthodes SIP) séparés par des virgules. Ils décrivent les capacités du protocole SIP prises en charge par cet expéditeur (dispositif). Liste complète des méthodes : ACK, BYE, CANCEL, INFO, INVITE, NOTIFY, OPTIONS, PRACK, REFER, REGISTER, SUBSCRIBE, UPDATE. Les méthodes SIP sont décrites plus en détail. ici.

Source : habr.com