Configurer un client test pour le routage direct Microsoft Teams avec Azure Communications Gateway

  • Article

Le test de Microsoft Teams Direct Routing nécessite certains numéros de test dans un client Microsoft 365, comme si vous fournissiez un service à un vrai client. Nous appelons ce locataire (que vous contrôlez) un locataire client test, correspondant à votre client test (auquel vous attribuez les numéros de test). La configuration d’un client test nécessite une configuration dans le locataire du client test et sur Azure Communications Gateway. Cet article explique comment configurer cette configuration. Vous pouvez ensuite configurer les utilisateurs et les numéros de test dans le locataire et démarrer les tests.

Conseil

Lorsque vous intégrez un vrai client, vous devrez généralement lui demander de modifier la configuration de son locataire, car votre organisation n'aura pas l'autorisation. Vous devrez toujours apporter des modifications à la configuration sur Azure Communications Gateway.

Pour plus d'informations sur la façon dont Azure Communications Gateway et Microsoft Teams utilisent la configuration du locataire pour acheminer les appels, consultez Prise en charge de plusieurs clients avec le modèle multitenant Microsoft Teams.

Cet article offre des conseils détaillés équivalant aux étapes suivantes dans la Documentation Microsoft Teams pour configurer un contrôleur SBC pour plusieurs tenants.

  • Inscription d’un nom de sous-domaine dans le tenant client.
  • Configuration de jonctions dérivées dans le tenant client (notamment un basculement).

Prérequis

Vous devez disposer d’un locataire Microsoft 365 que vous pouvez utiliser en tant que client test. Vous devez disposer d'au moins un numéro que vous pouvez attribuer à ce client test.

Vous devez effectuer les procédures suivantes.

Vous devez approvisionner Azure Communications Gateway avec les informations de votre client locataire de test pendant cette procédure.

  • Pour utiliser le portail de gestion des numéros (préversion) d’Azure Communications Gateway pour l’approvisionnement (recommandé), vous devez disposer d’un accès Lecteur à la ressource Azure Communications Gateway et des rôles ProvisioningAPI.ReadUser et ProvisioningAPI.WriteUser pour l’application d’entreprise AzureCommunicationsGateway.
  • Pour utiliser l’API d’approvisionnement d’Azure Communications Gateway (préversion), vous devez être en mesure d’effectuer des requêtes à l’aide d’un client intégré à l’API. Vous devez également avoir accès aux Informations de référence sur l’API.

Vous devez être en mesure de vous connecter au Centre d’administration Microsoft 365 pour votre client de test en tant qu’administrateur général.

Vous devez être en mesure de configurer le tenant avec au moins deux comptes d’utilisateur ou de ressources sous licence pour Microsoft Teams. Pour obtenir plus d’informations sur les licences appropriées, voir la Documentation Microsoft Teams.

  • Vous devez avoir deux comptes d’utilisateur ou de ressources pour activer les domaines Azure Communications Gateway que vous ajoutez à Microsoft 365 en suivant cet article. Les déploiements de labo nécessitent un compte.
  • Au moins un compte d’utilisateur est nécessaire que vous utilisez plus tard pour les tests lorsque vous effectuez l’opération pour Configurer des numéros test pour Microsoft Teams Direct Routing avec Azure Communications Gateway. Vous pouvez réutiliser l’un des comptes utilisés pour activer les domaines ou vous pouvez utiliser un compte avec l’un des autres noms de domaine pour ce tenant.

Choisir une étiquette de sous-domaine DNS à utiliser pour identifier le client

Azure Communications Gateway a des noms de domaine par région pour la connexion au routage direct Microsoft Teams. Vous devez configurer des sous-domaines de ces noms de domaine pour votre client de test. Le Système téléphonique Microsoft et Azure Communications Gateway utilisent ce sous-domaine pour faire correspondre les appels aux locataires.

  1. Déterminez les noms de domaine par région pour la connexion au routage direct Microsoft Teams. Ceux-ci utilisent le format 1-r<region-number>.<base-domain-name>. Le nom de domaine de base est le domaine sur votre ressource Azure Communications Gateway dans le Portail Azure.
  2. Choisissez une étiquette DNS pour identifier le client de test.
    • L’étiquette doit comporter huit caractères maximum et ne peut contenir que des lettres, des chiffres, des traits de soulignement et des tirets.
    • Vous ne devez pas utiliser de sous-domaines génériques ou de sous-domaines avec plusieurs étiquettes.
    • Par exemple, vous pouvez allouer l’étiquette test.

    Important

    Les sous-domaines clients complets (y compris les noms de domaine par région) doivent comporter 48 caractères maximum. Microsoft Entra ID ne prend pas en charge les noms de domaine contenant plus de 48 caractères. Par exemple, le sous-domaine client contoso1.1-r1.a1b2c3d4e5f6g7h8.commsgw.azure.com contient 48 caractères.

  3. Utilisez cette étiquette pour créer un sous-domaine de client de chaque nom de domaine par région pour votre Azure Communications Gateway.
  4. Notez l’étiquette que vous choisissez et les sous-domaines clients correspondants.

Par exemple :

  • Votre nom de domaine de base peut être <deployment-id>.commsgw.azure.com, où <deployment-id> est généré automatiquement et est unique au déploiement.
  • Vos noms de domaine par région sont donc les suivants :
    • 1-r1.<deployment-id>.commsgw.azure.com
    • 1-r2.<deployment-id>.commsgw.azure.com
  • Si vous allouez l’étiquette test, cette étiquette combinée aux noms de domaine par région crée les sous-domaines clients suivants pour votre client test :
    • test.1-r1.<deployment-id>.commsgw.azure.com
    • test.1-r2.<deployment-id>.commsgw.azure.com

Important

Les noms de domaine par région pour la connexion au routage direct Microsoft Teams sont différents des noms de domaine par région pour la connexion à votre réseau.

Conseil

Les déploiements de laboratoire ont un nom de domaine par région. Par conséquent, votre client test uniquement a un sous-domaine client.

Commencez à inscrire les sous-domaines dans le locataire client et à obtenir des valeurs TXT DNS

Pour router les appels vers un tenant client, celui-ci doit être configuré avec les sous-domaines clients alloués dans Choisir une étiquette de sous-domaine DNS à utiliser pour identifier le client. Microsoft 365 vous demande ensuite (en tant qu'opérateur) de créer des enregistrements DNS qui utilisent un code de vérification dans le tenant client.

  1. Connectez-vous au Centre d’administration Microsoft 365 pour le client en tant qu’administrateur général.
  2. À l’aide de Ajouter un sous-domaine au locataire client et vérifiez-le :
    1. Inscrivez le premier sous-domaine client (par exemple test.1-r1.<deployment-id>.commsgw.azure.com).
    2. Démarrez le processus de vérification à l’aide d’enregistrements TXT.
    3. Notez la valeur TXT que Microsoft 365 fournit.
  3. (Déploiements en production uniquement) Répétez l’étape précédente pour le deuxième sous-domaine client.

Important

N’effectuez pas encore le processus de vérification. Vous devez d’abord Configurer le client sur Azure Communications Gateway et générer des enregistrements DNS.

Configurer le client sur Azure Communications Gateway et générer des enregistrements DNS

Azure Communications Gateway inclut un serveur DNS. Vous devez utiliser Azure Communications Gateway pour créer les enregistrements DNS requis pour vérifier les sous-domaines clients. Pour générer les enregistrements, provisionnez les détails du locataire client et les valeurs TXT DNS sur Azure Communications Gateway.

Vous pouvez utiliser le portail de gestion des numéros (préversion) ou l’API d’approvisionnement (préversion) d’Azure Communications Gateway.

  1. Sur la page de vue d’ensemble de votre ressource Communications Gateway, recherchez la section Gestion des numéros dans la barre latérale.
  2. Sélectionnez Comptes.
  3. Sélectionnez Créer un compte.
  4. Entrez un Nom de compte et cochez la case Activer le routage direct Teams.
  5. Définissez 'ID de locataire Teams sur l’ID de votre client locataire de test.
  6. Si vous le souhaitez, sélectionnez Activer le filtrage des appels. Ce filtrage veille à ce que les clients ne puissent passer des appels de routage direct qu’à partir des numéros que vous leur avez attribués.
  7. Définissez le sous-domaine sur l’étiquette du sous-domaine que vous avez choisi dans Choisir une étiquette de sous-domaine DNS à utiliser pour identifier le client (par exemple, test).
  8. Définissez les champs de région de jeton de sous-domaine sur les valeurs TXT obtenues dans Commencez à inscrire les sous-domaines dans le client locataire et obtenez des valeurs TXT DNS.
  9. Sélectionnez Créer.
  10. Vérifiez que les enregistrements DNS ont été générés.
    1. Dans le volet Comptes, sélectionnez le nom du compte dans la liste.
    2. Vérifiez que l’état du sous-domaine approvisionné est approvisionné.

Terminez la vérification des domaines dans le locataire client

Lorsque vous avez utilisé Azure Communications Gateway pour générer les enregistrements DNS pour les sous-domaines client, vérifiez les sous-domaines dans le Centre d'administration Microsoft 365 pour votre locataire client.

  1. Connectez-vous au Centre d’administration Microsoft 365 pour le client en tant qu’administrateur général.
  2. Sélectionnez Paramètres>Domaines.
  3. Terminez la vérification des noms de domaine clients en suivant Ajouter un sous-domaine au locataire client et vérifiez-le.

Activer les domaines dans le tenant client

Pour activer les sous-domaines clients dans Microsoft 365, configurez au moins un compte d’utilisateur ou compte de ressources sous licence pour Microsoft Teams pour chaque nom de domaine. Pour obtenir plus d’informations sur les licences que vous pouvez utiliser, ainsi que des instructions, consultez Activer le nom de sous-domaine.

Important

Vérifiez que les comptes utilisent les sous-domaines clients (par exemple, test.1-r1.<deployment-id>.commsgw.azure.com) au lieu de tout nom de domaine existant dans le tenant.

Configurer le routage des appels du client pour utiliser Azure Communications Gateway

Dans le locataire client, configurez une stratégie de routage des appels (également appelée stratégie de routage vocal) avec une route vocale qui achemine les appels vers Azure Communications Gateway.

Important

Vous devez utiliser PowerShell pour définir les passerelles PSTN pour la route vocal, car le Centre d’administration Microsoft Teams ne prend pas en charge l’ajout de jonctions dérivées. Vous pouvez utiliser le Centre d’administration Microsoft Teams pour toute autre configuration de route vocale.

Pour définir les passerelles PSTN pour une route vocale, utilisez la commande PowerShell suivante.

Set-CsOnlineVoiceRoute -id "<voice-route-id>" -OnlinePstnGatewayList <customer-subdomain-1>, <customer-subdomain-2>

Étape suivante

Configurer les numéros de test