Eseguire l'integrazione con l'API di provisioning di Gateway di comunicazione di Azure (anteprima)
Questo articolo illustra quando è necessario eseguire l'integrazione con l'API di provisioning di Gateway di comunicazione di Azure (anteprima) e offre una panoramica generale delle attività iniziali. È destinato agli sviluppatori di software che lavorano per gli operatori di telecomunicazioni.
L'API di provisioning consente di configurare Il gateway di comunicazione di Azure con i dettagli dei clienti e i numeri assegnati. Se si usa l'API di provisioning per la sincronizzazione del servizio back-end, è anche possibile effettuare il provisioning degli ambienti Connessione con operatore e Teams Telefono Mobile con i dettagli dei clienti aziendali e i numeri allocati. Questo provisioning di flusso consente di soddisfare il requisito Connessione con operatore e Teams Telefono Mobile di usare le API per gestire i clienti e i numeri dopo aver avviato il servizio.
L'API di provisioning è un'API REST.
L'integrazione con l'API di provisioning dipende dal servizio di comunicazione scelto.
| Servizio di comunicazione | Integrazione dell'API di provisioning | Scopo |
|---|---|---|
| Routing diretto di Microsoft Teams | Supportato (in alternativa al portale di gestione dei numeri) | - Configurazione del sottodominio associato a ogni cliente di instradamento diretto. - Generazione di record DNS specifici per ogni cliente (come richiesto dall'ambiente Microsoft 365). - Indica che i numeri sono abilitati per l'instradamento diretto. - (Facoltativo) Configurazione di un'intestazione personalizzata per i messaggi nella rete. |
| Operatore Connect | Consigliato | - (Scelta consigliata) Provisioning di Connessione con operatore clienti tramite interoperabilità con API Connessione con operatore (tramite la sincronizzazione del servizio back-end). - (Facoltativo) Configurazione di un'intestazione personalizzata per i messaggi nella rete. |
| Teams Phone Mobile | Consigliato | - (Scelta consigliata) Provisioning di Teams Telefono clienti per dispositivi mobili tramite l'interoperabilità con le API Connessione con operatore (usando la sincronizzazione del servizio back-end). |
| Zoom Telefono peering cloud | Supportato (in alternativa al portale di gestione dei numeri) | - Indica che i numeri sono abilitati per Zoom. - (Facoltativo) Configurazione di un'intestazione personalizzata per i messaggi nella rete. |
| Anteprima della protezione delle chiamate dell'operatore di Azure | Supportato (in alternativa al portale di gestione dei numeri) | - Indica che i numeri sono abilitati per Protezione chiamata operatore di Azure. - Provisioning automatico della protezione delle chiamate dell'operatore di Azure. |
Suggerimento
Il portale di gestione dei numeri di Gateway di comunicazione di Azure offre una funzione equivalente per il provisioning manuale. Tuttavia, non è possibile usare il portale di gestione dei numeri per il provisioning completo di Connessione con operatore e Teams Telefono Mobile dopo l'avvio del servizio.
Prerequisiti
È necessario aver completato Deploy Azure Communications Gateway .You must have completed Deploy Azure Communications Gateway.
È necessario avere accesso a un computer con un indirizzo IP autorizzato ad accedere all'API di provisioning (anteprima). Questo elenco di indirizzi IP consentiti (o intervalli) è stato configurato come parte della distribuzione di Gateway di comunicazione di Azure.
Informazioni sull'API di provisioning (anteprima) e sulla pianificazione delle modifiche del client BSS
Per eseguire l'integrazione con l'API, è necessario creare (o aggiornare) un client BSS in grado di contattare l'API di provisioning. L'API di provisioning supporta un flusso di autenticazione delle credenziali client OAuth 2.0 da computer a computer. Il client esegue l'autenticazione e effettua chiamate API autorizzate come se stesso, senza l'interazione degli utenti.
Usare i concetti chiave e le informazioni sugli esempi in Informazioni di riferimento sulle API per ottenere informazioni sulle risorse disponibili tramite l'API e le richieste che l'organizzazione deve effettuare.
- Le risorse dell'account sono descrizioni dei clienti degli operatori (in genere, un'azienda) e le impostazioni per cliente per il provisioning dei servizi.
- Le risorse numerice appartengono a un account. Descrivono i numeri, i servizi usati dai numeri (ad esempio, l'instradamento diretto di Microsoft Teams) e qualsiasi configurazione aggiuntiva per numero.
- Le risorse di richiesta di informazioni (RFI) sono descrizioni dei clienti degli operatori (in genere un'azienda) che hanno espresso interesse a ricevere un servizio dall'operatore tramite Connessione con operatore e Teams Telefono Mobile.
L'API di provisioning ha un limite di frequenza di 100 richieste al minuto, applicate in tutte le risorse. Una richiesta batch per aggiornare più risorse viene conteggiato come una richiesta.
Configurare il client BSS per connettersi al gateway di comunicazione di Azure
L'API di provisioning (anteprima) è disponibile sulla porta 443 di provapi.<base-domain>, dove <base-domain> è il dominio di base della risorsa gateway di comunicazione di Azure.
Suggerimento
Per trovare il dominio di base:
- Accedere al portale di Azure.
- Passare alla panoramica della risorsa gateway di comunicazione di Azure e selezionare Proprietà.
- Trovare il campo denominato Dominio.
Il record DNS ha una durata (TTL) di 60 secondi. Quando un'area ha esito negativo, Azure aggiorna il record DNS per fare riferimento a un'altra area, in modo che i client che effettuano una nuova ricerca DNS ricevano i dettagli della nuova area. È consigliabile assicurarsi che i client possano effettuare una nuova ricerca DNS e ripetere una richiesta di 60 secondi dopo un timeout o una risposta 5xx.
Usare la sezione Introduzione del riferimento api per configurare Azure e il client BSS per consentire al client BSS di accedere all'API di provisioning.
La procedura seguente riepiloga la configurazione di Azure necessaria. Per informazioni dettagliate, inclusi i valori di configurazione necessari, vedere la sezione Introduzione di Informazioni di riferimento sulle API.
- Registrare il client BSS nello stesso tenant di Azure della distribuzione di Gateway di comunicazione di Azure. Questo processo crea una registrazione dell'app.
- Assegnare se stessi come proprietario per la registrazione dell'app.
- Configurare la registrazione dell'app con gli ambiti definiti nella guida di riferimento all'API. Questa configurazione indica ad Azure che l'applicazione è autorizzata ad accedere all'API di provisioning.
- Gli amministratori del tenant consentono all'applicazione di usare i ruoli dell'app assegnati.