Normalisation E.164 et formatage du header 'Contact' avec les MMR

Bonjour et bienvenue dans cette leçon.

Dans la session précédente, nous avons établi la fondation de notre connexion avec Microsoft Teams en configurant le Proxy Set, l'IP Profile et l'IP Group. Votre SBC est maintenant capable de communiquer de manière sécurisée avec les serveurs de Microsoft, comme en témoigne le statut Online du Proxy Set. Cependant, à ce stade, aucun appel ne peut encore être acheminé.

L'objectif de cette leçon est de franchir une étape cruciale pour l'interopérabilité : configurer les manipulations de messages SIP (MMR). Microsoft a des exigences très strictes sur le format des messages SIP. Nous allons nous concentrer sur deux manipulations fondamentales requises pour le Direct Routing :

1. Normaliser le numéro de l'appelant au format international E.164.
2. Formatter correctement l'en-tête Contact pour assurer le routage correct des réponses SIP.

Sans ces adaptations, Microsoft rejettera systématiquement vos appels, souvent avec une erreur 403 Forbidden ou 404 Not Found. Cette leçon est donc au cœur de votre objectif de maîtrise du dépannage et de la configuration de projets.

---

1. Comprendre les "Message Manipulation Rules" (MMR)

Avant de configurer, il est essentiel de comprendre l'outil. Les MMR sont le "couteau suisse" de l'ingénieur VoIP sur un SBC AudioCodes. Elles permettent de modifier n'importe quelle partie d'un message SIP en temps réel, juste avant qu'il ne soit envoyé à sa destination.

Le schéma ci-dessous illustre où les différentes manipulations interviennent dans le flux de traitement d'un appel par le SBC.

La logique d'une règle de manipulation de message est simple et s'articule autour de quatre éléments :

• Condition : Le "SI". La règle ne s'applique que si cette condition est vraie (ex: SI le message est un INVITE et SI l'en-tête From contient "anonymous").
• Action Subject : Le "QUOI". La partie du message que l'on veut modifier (ex: l'en-tête Contact, la partie user de l'en-tête To, etc.).
• Action Type : Le "COMMENT". L'action à effectuer : Add (ajouter), Remove (supprimer), ou Modify (modifier).
• Action Value : La "VALEUR". La nouvelle valeur à utiliser pour l'action.

Pour maîtriser pleinement la syntaxe, il existe un guide de référence complet que je vous invite à explorer. C'est un document dense mais fondamental.

---

2. Normaliser le Numéro Appelant au Format E.164

Pourquoi ? Microsoft Teams exige que l'identité de l'appelant, transportée dans les en-têtes P-Asserted-Identity et From, soit un numéro de téléphone au format E.164 complet (ex: +33123456789). Un PBX interne envoie souvent des numéros courts (ex: 4001) ou des formats nationaux (ex: 0123456789). Le SBC doit donc effectuer cette "traduction".

Comment ? Nous utiliserons une règle de manipulation pour détecter le format du numéro entrant et le transformer. La méthode la plus puissante pour cela est d'utiliser les expressions régulières (Regex).

Imaginons un scénario : un appel provient de votre PBX interne. L'en-tête From contient un numéro national français à 10 chiffres.
From: "Utilisateur Interne" <sip:0123456789@192.168.10.20>

Nous voulons le transformer en :
From: "Utilisateur Interne" <sip:+33123456789@sbc.votreentreprise.com>

Voici comment créer une règle pour cela :

1. Identifier le besoin : Remplacer le 0 initial par +33.
2. Créer la règle :
   • Condition : header.from.url.user regex (^0[1-9]\d{8}$)
     • header.from.url.user : Cible la partie "utilisateur" de l'URL dans l'en-tête From.
     • regex : Indique que nous utilisons une expression régulière.
     • (^0[1-9]\d{8}$) : Le motif. Il signifie : "commence par un 0, suivi d'un chiffre de 1 à 9, suivi de 8 autres chiffres, et se termine là". Les parenthèses capturent les 9 chiffres après le 0 dans une variable $1.
   • Action Subject : header.from.url.user
   • Action Type : Modify
   • Action Value : '+33' + $1
     • On concatène le préfixe +33 avec la valeur capturée par les parenthèses dans la condition ($1), ce qui correspond aux 9 derniers chiffres du numéro.

L'étude des expressions régulières est un sujet en soi, mais extrêmement puissant pour le troubleshooting.

---

3. Formatter l'En-tête Contact

Pourquoi ? L'en-tête Contact est vital. Il indique à Microsoft où renvoyer les messages SIP pour cet appel spécifique (ex: un BYE pour terminer l'appel). Pour le Direct Routing, cet en-tête doit contenir le FQDN public de votre SBC. Si l'adresse IP locale du SBC est envoyée, les serveurs de Microsoft ne sauront pas où répondre, et l'appel échouera.

Comment ? Bien que le paramètre Local Host Name de l'IP Group (configuré dans la leçon précédente) gère souvent ce point, il est bon de savoir comment le forcer avec une MMR. De plus, il est souvent nécessaire de nettoyer cet en-tête des paramètres non standards.

Par exemple, Microsoft peut inclure un paramètre ms-opaque dans le Contact. Si l'appel est ensuite routé vers un ITSP qui ne comprend pas ce paramètre, cela peut causer un échec. Une bonne pratique est de le supprimer.

Voyons comment créer cette règle de nettoyage, en nous basant sur des exemples de guides de configuration.

La création de cette règle est simple :

• Action Subject: Header.Contact.URL.Param.ms-opaque (cible spécifiquement le paramètre ms-opaque de l'URL de l'en-tête Contact).
• Action Type: Remove.
• Pas de Condition (s'applique à tous les messages correspondants).
• Pas de Action Value (car on supprime).

---

4. Appliquer les Règles via les Manipulation Sets

Une fois nos règles créées, elles ne sont pas encore actives. Il faut les regrouper dans un Manipulation Set (identifié par un ID numérique) et ensuite appliquer ce Set à un IP Group.

Un Set peut être appliqué :

• Inbound: sur les messages entrants depuis cet IP Group.
• Outbound: sur les messages sortants vers cet IP Group.

La vidéo ci-dessous montre ce processus de création et d'application.

Actions à réaliser (récapitulatif) :

1. Naviguez vers Setup > Signaling & Media > Message Manipulation > Message Manipulations.
2. Créez vos règles une par une (ex: normalisation E.164, nettoyage du Contact), en leur assignant le même Manipulation Set ID (ex: 10).
3. Naviguez vers Setup > Signaling & Media > Core Entities > IP Groups.
4. Éditez l'IP Group de Teams (Teams_IPGroup).
5. Dans le champ Outbound Message Manipulation Set, entrez l'ID de votre set (10). C'est "Outbound" car les manipulations s'appliquent aux appels sortant vers Teams.
6. Cliquez sur Apply et sauvegardez la configuration.

---

Conclusion

Aujourd'hui, vous avez appris à utiliser l'un des outils les plus puissants de l'AudioCodes SBC pour résoudre des problèmes d'interopérabilité complexes. En maîtrisant les MMR, vous passez de simple configurateur à véritable expert capable de débloquer des situations complexes.

Points clés à retenir :

• Les MMR sont indispensables pour adapter les messages SIP aux exigences strictes de partenaires comme Microsoft Teams.
• Les deux manipulations essentielles pour Teams sont la normalisation du numéro appelant au format E.164 (souvent dans From et P-Asserted-Identity) et le formatage de l'en-tête Contact avec le FQDN public du SBC.
• La syntaxe des MMR repose sur le quatuor Condition, Action Subject, Action Type, Action Value.
• Les expressions régulières (Regex) sont un outil avancé mais extrêmement efficace pour les manipulations complexes basées sur des motifs.
• Les règles sont regroupées dans des Manipulation Sets (via un ID) et activées en les appliquant aux directions Inbound ou Outbound d'un IP Group.

Aperçu de la prochaine leçon :
Maintenant que le SBC sait comment "formater" correctement les messages pour Teams, il nous reste à lui dire comment transmettre l'identité de l'appelant de manière formelle et comment router les appels. La prochaine leçon sera consacrée à la configuration de la transmission de l'identité de l'appelant via le header P-Asserted-Identity et à la mise en place des règles de routage des appels entrants et sortants.