Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Cet article explique quand vous devez intégrer l’API d’approvisionnement d’Azure Communications Gateway (préversion) et fournit une vue d’ensemble générale de la prise en main. C’est pour les développeurs de logiciels travaillant pour les opérateurs de télécommunications.
L’API d’approvisionnement 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 d’approvisionnement pour la synchronisation de service principal, vous pouvez également approvisionner les environnements Opérateur 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 aux exigences opérateur Connect et 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 d’approvisionnement est une API REST.
L’intégration à l’API d’approvisionnement dépend de votre service de communication choisi.
| Service de communication | Intégration de l’API d’approvisionnement | Objectif |
|---|---|---|
| Routage direct Microsoft Teams | Pris en charge (comme alternative au portail de gestion des numéros) | - Configuration du sous-domaine associé à chaque client de routage direct. - Génération d’enregistrements DNS spécifiques à chaque client (comme requis par l’environnement Microsoft 365). - Indiquant que les nombres sont activés pour le routage direct. - (Facultatif) Configuration d’un en-tête personnalisé pour les messages sur votre réseau. |
| Connexion de l’opérateur | Recommended | - (Recommandé) Approvisionnement par flux des clients Operator Connect via l’interopérabilité avec les API Operator Connect (à l’aide de la synchronisation de service principal). - (Facultatif) Configuration d’un en-tête personnalisé pour les messages sur votre réseau. |
| Teams Téléphone Mobile | Recommended | - (Recommandé) Approvisionnement par flux des clients Teams Phone Mobile via l’interopérabilité avec les API Operator Connect (à l’aide de la synchronisation de service principal). |
| Zoom Phone Cloud Peering | Pris en charge (comme alternative au portail de gestion des numéros) | - Indiquant que les nombres sont activés pour Zoom. - (Facultatif) Configuration d’un en-tête personnalisé pour les messages sur votre réseau. |
Conseil / Astuce
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 le provisionnement fluide via Operator Connect et Teams Phone Mobile après le lancement de votre service.
Prerequisites
Vous devez avoir terminé le déploiement d’Azure Communications Gateway.
Vous devez avoir accès à un ordinateur dont l’adresse IP est autorisée à accéder à l’API de provisionnement (préversion). Cette liste verte d’adresses IP (ou plages) a été configurée dans le cadre du déploiement d’Azure Communications Gateway.
En savoir plus sur l'API de provisionnement (aperçu) et préparez les changements de votre client BSS.
Pour l’intégrer à l’API, vous devez créer (ou mettre à jour) un client BSS qui peut contacter l’API d’approvisionnement. L’API d’approvisionnement prend en charge un flux d’authentification des informations d’identification du client OAuth 2.0 machine à machine. Votre client authentifie et effectue des appels d’API autorisés comme lui-même, sans l’interaction des utilisateurs.
Utilisez les concepts clés et les informations d’exemples dans la référence de l’API pour en savoir plus sur les ressources disponibles sur l’API et les demandes que votre organisation doit effectuer.
- Les ressources de compte sont des descriptions des clients d’opérateur (généralement, une entreprise) et des paramètres par client pour l’approvisionnement de services.
- Nombre de ressources appartiennent à un compte. Ils décrivent les nombres, les services dont les nombres se servent (par exemple, Microsoft Teams Direct Routing) et toute configuration supplémentaire par numéro.
- Les ressources RFI (Request for Information) sont des descriptions des clients d’opérateur (généralement une entreprise) qui ont exprimé l’intérêt de recevoir le 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 de Provisioning (préversion) est accessible sur le port 443 de provapi.<base-domain>, où <base-domain> est le domaine de base de la ressource Azure Communications Gateway.
Conseil / Astuce
Pour rechercher 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 échoue, Azure met à jour l’enregistrement DNS pour faire 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 un délai d’expiration ou une réponse 5xx.
Utilisez la section Prise en main de la référence d’API pour configurer Azure et votre client BSS pour permettre au client BSS d’accéder à l’API d’approvisionnement.
Les étapes suivantes résument la configuration Azure dont vous avez besoin. Pour plus d’informations, consultez la section Prise en main de la référence de l’API, y compris les valeurs de configuration requises.
- Inscrivez votre client BSS dans le même abonnement Azure que votre déploiement Azure Communications Gateway. Ce processus crée une inscription d’application.
- Attribuez-vous en tant que propriétaire pour l’enregistrement de l'application.
- Configurez l’inscription de l’application avec les étendues définies dans la documentation de l’API. Cette configuration indique à Azure que votre application est autorisée à accéder à l’API d’approvisionnement.
- En tant qu’administrateur du locataire, autorisez l’application à utiliser les rôles d’application que vous avez attribués.