Integration mit der Bereitstellungs-API von Azure Communications Gateway (Vorschau)
In diesem Artikel wird erläutert, wann Sie die Integration mit der Bereitstellungs-API von Azure Communications Gateway (Vorschau) durchführen müssen. Außerdem bietet er eine allgemeine Übersicht über die ersten Schritte. Er richtet sich an Softwareentwickler, die für Telekommunikationsanbieter arbeiten.
Mit der Bereitstellungs-API können Sie Azure Communications Gateway mit den Details Ihrer Kunden und den Nummern konfigurieren, die Sie ihnen zugewiesen haben. Wenn Sie die Bereitstellungs-API für die Back-End-Dienstsynchronisierung verwenden, können Sie zudem die Umgebungen von Operator Connect und Teams Phone Mobile mit den Details Ihrer Unternehmenskunden und den Nummern bereitstellen, die Sie ihnen zuweisen. Diese Flow-Through-Bereitstellung ermöglicht es Ihnen, die Anforderung für Operator Connect und Teams Phone Mobile zu erfüllen, damit APIs zum Verwalten Ihrer Kunden und Nummern verwendet werden, nachdem Sie ihren Dienst gestartet haben.
Die Bereitstellungs-API ist eine REST-API.
Ob eine Integration in die Bereitstellungs-API erforderlich ist, hängt von dem von Ihnen ausgewählten Kommunikationsdienst ab.
| Kommunikationsdienst | Integration der Bereitstellungs-API | Zweck |
|---|---|---|
| Microsoft Teams Direct Routing | Unterstützt (als Alternative zum Nummernverwaltungsportal) | – Konfigurieren der Subdomäne, die den einzelnen Direct Routing-Kunden zugeordnet ist – Generieren von DNS-Einträgen, die für jeden Kunden spezifisch sind (wie für die Microsoft 365-Umgebung erforderlich) – Gibt an, dass Nummern für Direct Routing aktiviert sind – (Optional) Konfigurieren eines benutzerdefinierten Headers für Nachrichten in Ihrem Netzwerk |
| Telefonieanbieter | Empfohlen | - (Empfohlen) Flow-Through-Bereitstellung von Operator Connect-Kunden über die Interoperabilität mit Operator Connect-APIs (mithilfe der Back-End-Dienstsynchronisierung) – (Optional) Konfigurieren eines benutzerdefinierten Headers für Nachrichten in Ihrem Netzwerk |
| Teams Telefon für Mobilgeräte | Empfohlen | - (Empfohlen) Flow-Through-Bereitstellung von Teams Phone Mobile-Kunden über die Interoperabilität mit Operator Connect-APIs (mithilfe der Back-End-Dienstsynchronisierung) |
| Zoom Phone Cloud Peering | Unterstützt (als Alternative zum Nummernverwaltungsportal) | – Gibt an, dass Nummern für Zoom aktiviert sind – (Optional) Konfigurieren eines benutzerdefinierten Headers für Nachrichten in Ihrem Netzwerk |
| Vorschauversion von Azure Operator Call Protection | Unterstützt (als Alternative zum Nummernverwaltungsportal) | - Gibt an, dass Nummern für Azure Operator Call Protection aktiviert sind. - Automatische Bereitstellung von Azure Operator Call Protection. |
Tipp
Das Nummernverwaltungsportal von Azure Communications Gateway bietet eine gleichwertige Funktion für die manuelle Bereitstellung. Sie können das Nummernverwaltungsportal jedoch nicht für die Flow-Through-Bereitstellung von Operator Connect und Teams Phone Mobile verwenden, nachdem Sie Ihren Dienst gestartet haben.
Voraussetzungen
Sie müssen die Schritte unter Bereitstellen von Azure Communications Gateway abgeschlossen haben.
Sie müssen über Zugriff auf einen Computer mit einer IP-Adresse verfügen, die für den Zugriff auf die Bereitstellungs-API (Vorschauversion) berechtigt ist. Diese Positivliste von IP-Adressen (oder IP-Bereichen) wurde als Teil der Bereitstellung von Azure Communications Gateway konfiguriert.
Informieren über die Bereitstellungs-API (Vorschauversion) und Planen von Änderungen an Ihrem BSS-Client
Für die Integration mit der API müssen Sie einen BSS-Client erstellen (oder aktualisieren), der mit der Bereitstellungs-API kommunizieren kann. Die Bereitstellungs-API unterstützt für Clientanmeldeinformationen den M2M-Authentifizierungsflow von OAuth 2.0 (Machine-to-Machine). Ihr Client selbst führt die Authentifizierung sowie autorisierte API-Aufrufe ohne Benutzerinteraktion durch.
Verwenden Sie die Wichtigen Konzepte und Informationen zu den Beispielen in der -API-Referenz, um mehr über die verfügbaren Ressourcen, die über die API verfügbar sind, und die Anforderungen zu erfahren, die Ihre Organisation vornehmen muss.
- Kontoressourcen sind Beschreibungen der Kunden von Betreibern (in der Regel ein Unternehmen) und kundenspezifische Einstellungen für die Dienstbereitstellung.
- Nummernressourcen gehören zu einem Konto. Sie beschreiben Nummern, die Dienste, die die Nummern verwenden (wie Microsoft Teams Direct Routing), und jede zusätzliche nummernspezifische Konfiguration.
- RFI-Ressourcen (Request For Information, Anforderung für Informationen) sind Beschreibungen der Kunden eines Betreibers (in der Regel ein Unternehmen), die Interesse am Erhalt von Diensten des Betreibers über Operator Connect und Teams Phone Mobile geäußert haben.
Die Bereitstellungs-API hat einen Grenzwert von 100 Anforderungen pro Minute, der für alle Ressourcen gilt. Eine Batch-Anforderung zur Aktualisierung mehrerer Ressourcen zählt als eine Anforderung.
Konfigurieren Ihres BSS-Clients für die Herstellung einer Verbindung mit Azure Communications Gateway
Die Bereitstellungs-API (Vorschauversion) ist am Port 443 von provapi.<base-domain> verfügbar, wobei <base-domain> die Basisdomäne der Azure Communications Gateway-Ressource ist.
Tipp
So ermitteln Sie die Basisdomäne:
- Melden Sie sich beim Azure-Portal an.
- Navigieren Sie zur Übersicht Ihrer Azure Communications Gateway-Ressource, und wählen Sie Eigenschaften aus.
- Suchen Sie das Feld mit dem Namen Domäne.
Der DNS-Eintrag hat eine Gültigkeitsdauer (Time-To-Live, TTL) von 60 Sekunden. Wenn eine Region ausfällt, aktualisiert Azure den DNS-Eintrag so, dass er auf eine andere Region verweist. Dadurch erhalten Clients, die einen neuen DNS-Lookup durchführen, die Details der neuen Region. Es wird empfohlen, sicherzustellen, dass Clients 60 Sekunden nach einem Timeout oder einer 5xx-Antwort einen neuen DNS-Lookup durchführen und die Anforderung wiederholen können.
Verwenden Sie den Abschnitt Erste Schritte der API-Referenz, um Azure und Ihren BSS-Client so zu konfigurieren, dass der BSS-Client auf die Bereitstellungs-API zugreifen kann.
Die folgenden Schritte fassen die Azure-Konfiguration zusammen, die Sie benötigen. Alle Details, einschließlich der erforderlichen Konfigurationswerte, finden Sie im Abschnitt Erste Schritte der API-Referenz.
- Registrieren Sie Ihren BSS-Client im selben Azure-Mandanten wie Ihre Azure Communications Gateway-Bereitstellung. Bei diesem Prozess wird eine App-Registrierung erstellt.
- Weisen Sie sich selbst als Besitzer für die App-Registrierung zu.
- Konfigurieren Sie die App-Registrierung mit den Bereichen, die in der API-Referenz definiert sind. Diese Konfiguration teilt Azure mit, dass Ihre Anwendung auf die Bereitstellungs-API zugreifen darf.
- Erlauben Sie es der Anwendung als Administrator des Mandanten, die App-Rollen zu verwenden, die Sie zugewiesen haben.