Configurer des séquences DTMF dans les espaces Cisco Meeting Server

Introduction

Ce document décrit les étapes de configuration des séquences DTMF pour permettre aux utilisateurs d'effectuer des actions sur les espaces Cisco Meeting Server (CMS).

Conditions préalables

Exigences

Cisco vous recommande de prendre connaissance des rubriques suivantes :

• Serveur de réunion Cisco
• DTMF

Composants utilisés

Les informations contenues dans ce document sont basées sur les versions de matériel et de logiciel suivantes :

• Cisco Meeting Server exécutant la version logicielle 3.8

The information in this document was created from the devices in a specific lab environment. All of the devices used in this document started with a cleared (default) configuration. Si votre réseau est en ligne, assurez-vous de bien comprendre l’incidence possible des commandes.

Informations générales

Il est possible de définir des séquences DTMF personnalisées dans CMS pour que les participants à l'espace les utilisent pour appeler des actions qui affectent l'espace et ses participants. Par exemple, une séquence DTMF peut être utilisée par un participant pour activer ou désactiver son propre son, pour démarrer ou arrêter la diffusion en continu de la téléconférence ou pour mettre fin à la téléconférence.

Un dtmfProfile définit les séquences DTMF à utiliser pour appeler chaque action spécifique disponible. En attribuant un dtmfProfile à system/profiles via l'API CMS, les séquences DTMF deviennent disponibles globalement. Les restrictions pour les actions DTMF peuvent être affinées en créant des callLegProfiles avec des autorisations différentes pour chacune des actions, et en les appliquant à différents niveaux de l'API.

Configurer

1. Créez un objet dtmfProfile et appliquez-le globalement

Pour créer l'objet dtmfProfile :

1. Connectez-vous à la page d'administration Web de CMS.

2. Accédez à Configuration > API.

3. Accédez à la section /api/v1/dtmfProfiles et développez-le.

4. Cliquez sur Create new.

5. Définissez les séquences DTMF à utiliser pour effectuer la ou les actions requises. Dans cet exemple, des séquences DTMF sont définies pour les actions toggleMuteSelfAudio et endCall.

6. Cliquez sur Créer.

Pour appliquer le dtmfProfile globalement :

1. Accédez à Configuration > API.

2. Accédez à la section /api/v1/system/profiles et développez-la.

3. Cliquez sur Afficher ou modifier.

4. Dans le paramètre dtmfProfile, cliquez sur Choose et sélectionnez l'objet précédemment créé.

5. Cliquez sur Modifier.

2. Ajuster les autorisations pour effectuer les actions DTMF

Le contrôle granulaire des autorisations pour exécuter l'action DTMF peut être obtenu en configurant callLegProfiles, qui peut être appliqué à différents niveaux dans l'API. Ce diagramme illustre tous les niveaux possibles :

Le niveau auquel le callLegProfile est appliqué détermine son étendue. Les profils affectés aux niveaux inférieurs remplacent ceux définis ci-dessus. Ces exemples illustrent comment ce principe peut être utilisé pour autoriser l'appel d'actions DTMF uniquement à certains espaces ou utilisateurs.

Autoriser les actions dans un espace spécifique uniquement

Un callLegProfile annulant les autorisations pour exécuter les actions DTMF peut être créé et appliqué au niveau /système/profils. Ensuite, un autre callLegProfile permettant les actions peut être créé et appliqué au niveau coSpace, limitant ainsi l'étendue des autorisations à un coSpace spécifique (ou un ensemble de coSpaces, s'il est appliqué à plusieurs).

1. Accédez à Configuration > API.

2. Accédez à la section /api/v1/callLegProfiles et développez-la.

3. Cliquez sur Create new.

4. Accédez aux actions qui doivent être interdites et définissez-les sur false.

5. Cliquez sur Créer.

Dans cet exemple, callLegProfile a été créé pour interdire la fin de la téléconférence en définissant endCallAllowed sur false :

6. Attribuez-le au système/profil pour interdire globalement l'action :

7. Créez un nouveau callLegProfile, cette fois pour autoriser l'action. Dans cet exemple, callLegProfile a été créé avec endCallAllowed défini sur true :

8. Accédez à Configuration > API > /api/v1/coSpaces et développez-le.

9. Recherchez le coSpace auquel vous souhaitez l'affecter et, sous callLegProfile, sélectionnez celui que vous avez créé pour autoriser les actions.

Comme ce callLegProfile est appliqué à un niveau API inférieur, il remplace le callLegProfile précédemment appliqué à /system/profiles, ce qui a pour résultat que les actions DTMF ne peuvent être invoquées qu'à partir de ce coSpace particulier.

Autoriser uniquement les utilisateurs disposant d'un mot de passe à effectuer les actions

L'étendue des autorisations peut être limitée à un groupe d'utilisateurs nécessitant des droits spéciaux, tels que les opérateurs vidéo. Un accessMethod peut être créé, avec son propre numéro de répertoire, pour accéder à un coSpace avec un callLegProfile spécifique en vigueur qui autorise les actions DTMF.

1. Accédez à Configuration > API > /api/v1/coSpaces et développez-le.

2. Dans la liste, sélectionnez le coSpace pour lequel vous souhaitez créer accessMethod.

3. dans la liste Objets associés, cliquez sur le lien /api/v1/coSpaces/<ID coSpace>/accessMethods :

4. Dans le champ uri, entrez un numéro que les utilisateurs disposant de privilèges peuvent composer dans cet espace.

5. Créez un code secret. Lorsque les utilisateurs privilégiés composent le numéro accessMethod, ils doivent entrer ce code suivi du signe # pour être autorisés à participer à la téléconférence.

6. Sous callLegProfile, sélectionnez celui qui permet de mettre fin à l'appel.

7. Le cas échéant, entrez un nom pour accessMethod afin de le rendre facilement reconnaissable à partir de l'explorateur d'API.

Dans cet exemple, un accessMethod avec le numéro 3001 est créé pour que les opérateurs vidéo l'utilisent lors de l'adhésion à coSpace (le numéro de répertoire 3000 a été attribué à coSpace, les utilisateurs réguliers composent ce numéro pour rejoindre des téléconférences sur cet espace). Il est protégé par un mot de passe et le callLegProfile qui permet de mettre fin à l'appel lui est attribué exclusivement.

8. Appliquez le callLegProfile qui interdit les actions est globalement en l'affectant à system/profiles.

Dans cet exemple, il n'est pas nécessaire d'affecter un callLegProfile à coSpace lui-même. Il hérite du profil appliqué globalement, et par conséquent les utilisateurs qui rejoignent la téléconférence en composant le numéro coSpace (3000) n'ont pas l'autorisation de mettre fin à l'appel via DTMF.

Grâce à cette configuration, les opérateurs vidéo peuvent se joindre à la téléconférence en composant le numéro accessMethod (3001) au lieu du numéro coSpace (3000). Leurs branches d'appel utilisent le callLegProfile qui permet l'application de l'action, par conséquent elles seules peuvent utiliser la séquence DTMF définie pour mettre fin à l'appel.

Informations connexes

Guide de référence de l'API CMS 3.8