Gestion des règles avec les "Manipulation Sets"

Bonjour !

Dans la leçon précédente, nous avons acquis une compétence chirurgicale : l'utilisation des conditions pour appliquer nos règles de manipulation uniquement sur des appels spécifiques. Nous savons maintenant comment cibler un flux d'appel précis avec la logique "SI... ALORS...".

Cependant, un scénario d'interopérabilité réel, comme l'intégration avec Microsoft Teams ou un opérateur SIP, nécessite rarement une seule règle. Vous pourriez avoir besoin de modifier le From, d'ajouter un P-Asserted-Identity, et de supprimer un en-tête non standard, le tout pour le même appel. Comment gérer cet ensemble de règles de manière propre et efficace ?

C'est l'objectif de notre leçon d'aujourd'hui. Nous allons apprendre à créer une "Manipulation Set", qui agit comme un conteneur ou un dossier pour regrouper plusieurs règles de manipulation connexes. C'est l'étape qui nous permet de passer de règles individuelles à des politiques de manipulation cohérentes et organisées.

Pourquoi Regrouper les Règles ? Le Concept de "Manipulation Set"

Imaginez votre configuration SBC sans organisation : des dizaines de règles de manipulation dans une seule longue liste. Le dépannage deviendrait un cauchemar. Les "Manipulation Sets" résolvent ce problème en introduisant une structure logique.

Regrouper les règles dans un "Set" vous apporte trois avantages majeurs :

• Organisation : Toutes les règles relatives à un pair SIP (ex: "Règles pour Teams", "Règles pour Opérateur Orange") sont rassemblées au même endroit.
• Lisibilité : Il est beaucoup plus simple de comprendre l'ensemble des modifications appliquées à un flux d'appel donné.
• Application simplifiée : Au lieu d'appliquer dix règles une par une, vous appliquerez un seul "Set" qui les contient toutes. Nous verrons comment faire cela dans la prochaine leçon.

AudioCodes structure cela avec une hiérarchie parent-enfant :

• Le Parent : Message Manipulation Sets. C'est le conteneur. Il a simplement un nom et un index pour l'identifier.
• Les Enfants : Message Manipulations. Ce sont les règles individuelles que vous avez apprises à créer. Chaque règle est "placée" à l'intérieur d'un "Set" parent.

Pour bien comprendre cette relation, je vous propose de consulter la documentation officielle.

Cas Pratique : Création d'un "Manipulation Set" pour Microsoft Teams

Mettons cela en pratique avec un scénario concret lié à vos objectifs : l'intégration de Microsoft Teams.

Le besoin : Pour tous les appels entrants depuis Teams, nous devons effectuer deux actions pour assurer la compatibilité avec nos systèmes internes (par exemple, un PBX ou le centre de contact NICE) :

1. Ajouter un en-tête P-Asserted-Identity pour identifier l'appelant, si cet en-tête est manquant.
2. Supprimer un en-tête propriétaire X-MS-Info que nos équipements ne comprennent pas et qui pourrait causer des erreurs.

Ces deux règles doivent s'appliquer sous la même condition : l'appel doit provenir de Teams. Comme vu dans la leçon précédente, une condition fiable pour cela est header.contact.url.host contains 'pstnhub.microsoft.com'.

Nous allons donc créer un "Set" pour héberger ces deux règles.

Étape 1 : Créer le "Manipulation Set" (le conteneur)

La première étape est de créer le "dossier" qui contiendra nos règles.

Pour notre scénario, voici comment nous le configurerions :

1. Naviguez vers Setup menu > Signaling & Media tab > Message Manipulation folder > Message Manipulation Sets.
2. Cliquez sur New.
3. Remplissez les champs :
   • Index : 1 (ou tout autre index disponible)
   • Name : Teams_Inbound_Interop
4. Cliquez sur Apply.

Et voilà ! Notre conteneur est prêt.

Étape 2 : Ajouter les Règles au "Set"

Maintenant que le "Set" Teams_Inbound_Interop existe, nous allons y ajouter nos deux règles.

1. Dans la table Message Manipulation Sets, sélectionnez la ligne de notre nouveau set (Index 1).
2. Cliquez sur le lien Message Manipulations qui apparaît sous la table. L'interface vous amène à la table des règles, mais elle est maintenant filtrée pour ne montrer que les règles appartenant à ce set.
3. Cliquez sur New pour créer notre première règle.

Règle n°1 : Ajouter P-Asserted-Identity

4. Cliquez sur Apply. Puis, cliquez à nouveau sur New pour la seconde règle.

Règle n°2 : Supprimer X-MS-Info

Ici, nous réutilisons la condition de la règle précédente, comme nous l'avons appris dans la leçon passée.

5. Cliquez sur Apply.

Vous avez maintenant un Manipulation Set nommé Teams_Inbound_Interop qui contient deux règles, s'exécutant l'une après l'autre si la condition initiale est remplie. C'est une configuration propre, lisible et prête à être déployée.

Visualiser la Place du "Manipulation Set"

Où ce "Set" que nous venons de créer s'insère-t-il dans le flux de traitement d'un appel sur le SBC ? Le diagramme suivant nous donne une vue d'ensemble.

Notre Manipulation Set "Teams_Inbound_Interop" est un de ces blocs "Message Manipulations". Pour qu'il soit actif sur les appels entrants de Teams, il devra être associé à l'IP Group qui représente Microsoft Teams. Cette association est précisément ce que nous apprendrons dans la leçon suivante.

Conclusion

Aujourd'hui, nous avons franchi une étape essentielle vers une configuration de niveau professionnel. Vous ne gérez plus des règles isolées, mais des ensembles de politiques cohérentes.

Points clés à retenir :

• Un Manipulation Set est un conteneur qui permet de regrouper plusieurs Message Manipulation Rules (MMR).
• Cette organisation repose sur une structure parent-enfant : le "Set" est le parent, les règles sont les enfants.
• La création se fait en deux temps :
  1. D'abord, créer le Message Manipulation Set et lui donner un nom descriptif.
  2. Ensuite, ajouter les règles de manipulation à l'intérieur de ce set.
• Cette méthode rend la configuration plus organisée, lisible et plus facile à maintenir et à déployer.

Prochaine Étape

Nous avons maintenant un paquet de règles bien emballé, notre Manipulation Set. Mais pour l'instant, il est inactif, attendant sur une étagère de la configuration. Dans la prochaine leçon, nous verrons comment appliquer ce "Manipulation Set" à une règle de routage ou, plus communément, à un IP Group, afin de l'activer et de commencer enfin à modifier le trafic SIP.