S’intégrer à l’API Provisionnement d’Azure Communications Gateway (préversion)
Cet article explique quand vous devez vous intégrer à l’API Provisionnement d’Azure Communications Gateway (préversion) et fournit une vue d’ensemble générale de sa prise en main. Il est destiné aux développeurs de logiciels travaillant pour les opérateurs de télécommunications.
L’API Provisionnement vous permet de configurer Azure Communications Gateway avec les détails de vos clients et les numéros que vous leur avez attribués. Si vous utilisez l’API Provisionnement pour la synchronisation du service back-end, vous pouvez également provisionner les environnements Operator Connect et Teams Phone Mobile avec les détails de vos clients d’entreprise et les numéros que vous leur allouez. Ce provisionnement par flux vous permet de répondre à l’exigence d’Operator Connect et de Teams Phone Mobile d’utiliser des API pour gérer vos clients et vos numéros après le lancement de votre service.
L’API Provisionnement est une API REST.
Votre décision de vous intégrer à l’API d’approvisionnement dépend du service de communication choisi.
| Service de communication | Intégration de l’API Provisionnement | Objectif |
|---|---|---|
| Microsoft Teams Direct Routing | Pris en charge (comme alternative au portail de gestion des numéros) | - Configuration du sous-domaine associé à chaque client Direct Routing. - Génération d’enregistrements DNS spécifiques à chaque client (tel que requis par l’environnement Microsoft 365). - Indication du fait que les numéros sont activés pour Direct Routing. - (Facultatif) Configuration d’un en-tête personnalisé pour les messages envoyés à votre réseau. |
| Operator Connect | Recommandé | - (Recommandé) Provisionnement par flux des clients Operator Connect via l’interopérabilité avec les API Operator Connect (en utilisant la synchronisation du service back-end). - (Facultatif) Configuration d’un en-tête personnalisé pour les messages envoyés à votre réseau. |
| Teams Phone Mobile | Recommandé | - (Recommandé) Provisionnement par flux des clients Teams Phone Mobile via l’interopérabilité avec les API Operator Connect (en utilisant la synchronisation du service back-end). |
| Zoom Phone Cloud Peering | Pris en charge (comme alternative au portail de gestion des numéros) | - Indication du fait que les numéros sont activés pour Zoom. - (Facultatif) Configuration d’un en-tête personnalisé pour les messages envoyés à votre réseau. |
| Azure Operator Call Protection (préversion) | Pris en charge (comme alternative au portail de gestion des numéros) | - Indiquant que les numéros sont activés pour Azure Operator Call Protection. - Approvisionnement automatique d’Azure Operator Call Protection. |
Conseil
Le portail de gestion des numéros d’Azure Communications Gateway fournit une fonction équivalente pour l’approvisionnement manuel. Toutefois, vous ne pouvez pas utiliser le portail de gestion des numéros pour l’approvisionnement approfondi des opérateurs Connect et Teams Phone Mobile après avoir lancé votre service.
Prérequis
Vous devez avoir effectué Déployer Azure Communications Gateway.
Vous devez avoir accès à une machine avec une adresse IP autorisée à accéder à l’API d’approvisionnement (préversion). Cette liste verte d’adresses (ou de plages) IP a été configurée dans le cadre du déploiement d’Azure Communications Gateway.
En savoir plus sur l’API d’approvisionnement (préversion) et planifier les modifications apportées à votre client BSS
Pour s’intégrer à l’API, vous devez créer (ou mettre à jour) un client BSS qui peut contacter l’API Provisionnement. L’API Provisionnement prend en charge un flux d’authentification des informations d’identification du client OAuth 2.0 de machine à machine. Votre client s’authentifie et effectue des appels d’API autorisés en tant que lui-même, sans l’interaction des utilisateurs.
Utilisez les informations contenues dans Concepts clés et Exemples des Informations de référence sur l’API pour en savoir plus sur les ressources disponibles sur l’API et les demandes que votre organisation doit effectuer.
- Les ressources Compte sont des descriptions des clients d’opérateur (généralement une entreprise) et des paramètres par client pour le provisionnement de services.
- Les ressources Numéro appartiennent à un compte. Elles décrivent les numéros, les services utilisés par les numéros (par exemple Microsoft Teams Direct Routing) et les configurations supplémentaires par numéro.
- Les ressources Demande d’informations (RFI) sont des descriptions des clients d’opérateur (généralement une entreprise) qui ont exprimé leur intérêt pour recevoir un service de l’opérateur via Operator Connect et Teams Phone Mobile.
L’API de provisionnement a une limite de débit de 100 requêtes par minute, appliquée sur toutes les ressources. Une demande de traitement par lots pour mettre à jour plusieurs ressources compte comme une seule requête.
Configurer votre client BSS pour se connecter à Azure Communications Gateway
L’API d’approvisionnement (préversion) est disponible sur le port 443 de provapi.<base-domain>, où <base-domain> est le domaine de base de la ressource de passerelle Azure Communications.
Conseil
Pour trouver le domaine de base :
- Connectez-vous au portail Azure.
- Accédez à la Vue d’ensemble de votre ressource Azure Communications Gateway, puis sélectionnez Propriétés.
- Recherchez le champ nommé Domaine.
L’enregistrement DNS a une durée de vie (TTL) de 60 secondes. Lorsqu’une région subit une défaillance, Azure met à jour l’enregistrement DNS pour qu’il fasse référence à une autre région, afin que les clients effectuant une nouvelle recherche DNS reçoivent les détails de la nouvelle région. Nous vous recommandons de veiller à ce que les clients puissent effectuer une nouvelle recherche DNS et réessayer une requête 60 secondes après l’expiration du délai ou une réponse 5xx.
Utilisez la section Prise en main des Informations de référence sur l’API pour configurer Azure et votre client BSS afin de permettre au client BSS d’accéder à l’API Provisionnement.
Les étapes suivantes résument la configuration Azure dont vous avez besoin. Consultez la section Prise en main des Informations de référence sur l’API pour plus d’informations, y compris les valeurs requises pour la configuration.
- Inscrivez votre client BSS dans le même locataire Azure que votre déploiement d’Azure Communications Gateway. Ce processus crée une inscription d’application.
- Attribuez-vous vous-même en tant que propriétaire pour l’inscription d’application.
- Configurez l’inscription d’application avec les étendues définies dans les Informations de référence sur l’API. Cette configuration indique à Azure que votre application est autorisée à accéder à l’API Provisionnement.
- En tant qu’administrateur du locataire, autorisez l’application à utiliser les rôles d’application que vous avez attribués.