Verbinden des Azure Communications-Gateways mit Operator Connect oder Teams Phone Mobile

Nachdem Sie Azure Communications Gateway bereitgestellt und mit Ihrem Kernnetzwerk verbunden haben, müssen Sie es mit dem Microsoft-Telefonsystem verbinden. Sie müssen auch in die Umgebungen "Operator Connect" oder "Teams Phone Mobile" integriert werden.

In diesem Artikel wird beschrieben, wie Sie das Azure Communications Gateway für Operator Connect und Teams Phone Mobile einrichten. Nachdem Sie die Schritte in diesem Artikel abgeschlossen haben, können Sie sich auf den Livedatenverkehr mit Operator Connect, Teams Phone Mobile und Azure Communications Gateway vorbereiten.

Tipp

In diesem Artikel wird davon ausgegangen, dass Ihr Onboarding-Team für Azure Communications Gateway von Microsoft Sie auch bei der Einrichtung von Operator Connect und/oder Teams Phone Mobile unterstützt. Wenn Sie einen anderen Onboarding-Partner für Operator Connect oder Teams Phone Mobile ausgewählt haben, müssen Sie diese bitten, Änderungen in den Operator Connect und/oder Teams Phone Mobile Umgebungen vorzunehmen.

Voraussetzungen

Sie müssen das Azure Communications Gateway bereitstellen.

Sie benötigen Zugriff auf ein Benutzerkonto mit der Rolle des globalen Microsoft Entra-Administrators.

Sie müssen Testnummern für die Dienstüberprüfung zuweisen. Diese Nummern werden von den Programmen Operator Connect und Teams Phone Mobile für kontinuierliche Anruftests verwendet. Produktivsysteme benötigen sechs Nummern für jeden Dienst. Lab-Bereitstellungen benötigen drei Nummern für jeden Dienst.

Wenn Sie den Dienst ausgewählt haben, den Sie als Teil der Bereitstellung des Azure Communications Gateways einrichten, haben Sie bereits Nummern für den Dienst zugewiesen.
Wählen Sie andernfalls die Telefonnummern jetzt (im E.164-Format und einschließlich Landesvorwahl) und Namen aus, um sie zu identifizieren. Wir empfehlen Namen wie OC1 und OC2 (für Operator Connect) sowie TPM1 und TPM2 (für Teams Phone Mobile).

Sie müssen auch mindestens eine Testnummer für jeden Dienst für Integrationstests zuweisen.

Wenn Sie Microsoft Teams Phone Mobile einrichten möchten und sie beim Bereitstellen des Azure Communications Gateways nicht ausgewählt haben, wählen Sie Folgendes aus:

Die Nummer, die in Teams Phone Mobile für den Zugriff auf die Voicemail Interactive Voice Response (IVR) von nativen Wähltastaturen verwendet wird.
Die Methode zum Weiterleiten von Anrufen über Teams Phone Mobile an das Microsoft Phone System. Wählen Sie zwischen:
- Integriertes MCP (MCP im Azure Communications Gateway).
- Vor-Ort-MCP.
- Eine andere Methode zum Weiterleiten von Aufrufen.

Aktivieren Sie Operator Connect oder Teams Phone Mobile Unterstützung

Hinweis

Wenn Sie beim Bereitstellen des Azure Communications Gateways die Option "Operator Connect" oder "Teams Phone Mobile" ausgewählt haben, überspringen Sie diesen Schritt, und wechseln Sie zu "Hinzufügen der Project Synergy-Anwendung zu Ihrem Azure-Mandanten".

Melden Sie sich beim Azure-Portal an.
Suchen Sie in der Suchleiste oben auf der Seite nach Ihrer Kommunikationsgateway-Ressource, und wählen Sie sie aus.
Wählen Sie in der seitlichen Menüleiste unter Kommunikationsdienste die Option Operator Connect oder Teams Phone Mobile (je nach Bedarf) aus, um eine Seite für den Dienst zu öffnen.
Wählen Sie "Telefonverbindungseinstellungen" oder "Teams Phone Mobile"-Einstellungen aus.
Füllen Sie die Felder aus, und wählen Sie dann Überprüfen + erstellen und Erstellen aus.
Wählen Sie die Seite "Übersicht" für Ihre Ressource aus.
Wählen Sie "Testzeilen hinzufügen" aus, und fügen Sie die Dienstüberprüfungszeilen hinzu, die Sie in den Voraussetzungen ausgewählt haben. Legen Sie den Testzweck auf "Automatisiert" fest.

Von Bedeutung

Fügen Sie die Zahlen für Integrationstests nicht hinzu. Sie konfigurieren Zahlen für Integrationstests, wenn Sie Integrationstests durchführen und sich auf den Livedatenverkehr vorbereiten.
Warten Sie, bis Die Ressource aktualisiert wird. Wenn Ihre Ressource bereit ist, ändert sich das Feld Bereitstellungsstatus in der Ressourcenübersicht zu "Abgeschlossen". Wir empfehlen, regelmäßig zu überprüfen, ob das Feld "Bereitstellungsstatus" auf "Abgeschlossen" steht. Dieser Schritt kann bis zu zwei Wochen dauern.

Hinzufügen der Project Synergy-Anwendung zu Ihrem Azure-Mandanten

Bevor Sie diesen Schritt starten, überprüfen Sie, ob das Feld "Bereitstellungsstatus " für Ihre Ressource "Abgeschlossen" ist.

Hinweis

Dieser Schritt und der nächste Schritt (Zuweisen eines Administratorbenutzers zur Project Synergy-Anwendung) richten Sie als Operator in den Umgebungen Teams Phone Mobile und Operator Connect ein. Wenn Sie das Onboarding bereits durchlaufen haben, wechseln Sie zu " Suchen der Anwendungs-ID für Ihre Azure Communication Gateway-Ressource".

Die Telefonieprogramme "Operator Connect" und "Teams Phone Mobile" erfordern, dass Ihr Microsoft Entra-Mandant eine Microsoft-Anwendung namens Project Synergy enthält. Operator Connect und Teams Phone Mobile erben Berechtigungen und Identitäten von Ihrem Microsoft Entra-Mandanten über die Project Synergy-Anwendung. Die Project Synergy-Anwendung ermöglicht außerdem die Konfiguration von Operator Connect oder Teams Phone Mobile und das Zuweisen von Benutzern und Gruppen zu bestimmten Rollen.

So fügen Sie die Project Synergy-Anwendung hinzu:

Überprüfen Sie, ob das Microsoft Entra ID (Microsoft.Entra)-Modul in PowerShell installiert ist. Installieren Sie es bei Bedarf.
1. Öffnen Sie PowerShell.
2. Führen Sie den folgenden Befehl aus, und überprüfen Sie, ob Microsoft.Entra in der Ausgabe angezeigt wird.
```
Get-Module -ListAvailable
```
3. Wenn Microsoft.Entra nicht in der Ausgabe erscheint, installieren Sie das Modul.
  1. Schließen Sie das aktuelle PowerShell-Fenster.
  2. Öffnen Sie PowerShell als Administrator.
  3. Führen Sie den folgenden Befehl aus.
```
Install-Module Microsoft.Entra
```
  4. Schließen Sie Ihr PowerShell-Administratorfenster.
Melden Sie sich beim Azure-Portal als globaler Microsoft Entra-Administrator an.
Wählen Sie Microsoft Entra ID aus.
Wählen Sie Eigenschaften aus.
Scrollen Sie nach unten zum Feld "Mandanten-ID". Ihre Mandanten-ID befindet sich im Feld. Notieren Sie sich Ihre Mandanten-ID.
Öffnen Sie PowerShell.

Führen Sie das folgende Cmdlet aus, und ersetzen Sie <TenantID> durch die Mandanten-ID, die Sie in Schritt 5 notiert haben.

Connect-Entra -TenantId <TenantID> -Scopes 'Application.ReadWrite.All'
New-EntraServicePrincipal -AppId eb63d611-525e-4a31-abd7-0cb33f679599 -DisplayName "Operator Connect"

Zuweisen eines Administratorbenutzers zur Project Synergy-Anwendung

Der Benutzer, der Das Azure Communications Gateway einrichte, muss über die Administratorbenutzerrolle in der Project Synergy-Anwendung verfügen. Weisen Sie diese Rolle im Azure-Portal zu.

Wechseln Sie im Azure-Portal zur Microsoft Entra-ID und dann zu Enterprise-Anwendungen mithilfe des linken Seitenmenüs. Alternativ können Sie in der Suchleiste nach Unternehmensanwendungen suchen. sie befindet sich unter der Unterüberschrift "Dienste ".
Legen Sie den Anwendungstypfilter mithilfe des Dropdownmenüs auf "Alle Anwendungen " fest.
Wählen Sie Anwenden.
Suchen Sie mithilfe der Suchleiste nach Project Synergy . Die Anwendung sollte angezeigt werden.
Wählen Sie Ihre Project Synergy-Anwendung aus.
Wählen Sie "Benutzer und Gruppen " im linken Menü aus.
Wählen Sie "Benutzer/Gruppe hinzufügen" aus.
Geben Sie den Benutzer an, der das Azure Communications-Gateway einrichten soll, und geben Sie ihm die Administratorrolle .

Vorsicht

Ändern Sie keine der folgenden Operator Connect-Konfigurationen in Ihrem Mandanten (ob über das Operator Connect-Konfigurationsportal oder über Operator Connect-APIs).

Aufrufen von Profilen mit einem CommsGwSuffix im Konfigurationsportal oder NameSuffix auf den Operator Connect-APIs
Trunks mit FQDNs, die mit .commsgw.azure.com enden

Wir verwalten diese Konfiguration für Sie. Die Bearbeitung dieser Konfiguration führt wahrscheinlich zu Problemen mit Ihrem Azure Communications Gateway-Dienst.

Suchen der Anwendungs-ID für Ihre Azure Communication Gateway-Ressource

Jede Azure Communications Gateway-Ressource empfängt automatisch eine vom System zugewiesene verwaltete Identität, die azure Communications Gateway zum Herstellen einer Verbindung mit der Operator Connect-API verwendet. Sie müssen die Anwendungs-ID der verwalteten Identität finden, damit Sie das Azure Communications Gateway mit der Operator Connect-API verbinden können, indem Sie Anwendungsrollen für Azure Communications Gateway einrichten und die Anwendungs-IDs für Das Azure Communications-Gateway zu Operator Connect hinzufügen.

Melden Sie sich beim Azure-Portal an.
Wenn Sie den Namen Ihrer Kommunikationsgateway-Ressource noch nicht kennen, suchen Sie nach Kommunikationsgateways , und notieren Sie sich den Namen der Ressource.
Suchen Sie nach dem Namen Ihrer Kommunikationsressource. Unter der Unterüberschrift "Microsoft Entra ID " sollte eine Unternehmensanwendung mit diesem Wert angezeigt werden. Möglicherweise müssen Sie " Suche fortsetzen" in der Microsoft Entra-ID auswählen, um sie zu finden.
Wählen Sie die Unternehmensanwendung aus.
Überprüfen Sie, ob der Name dem Namen Ihrer Kommunikationsgatewayressource entspricht.
Notieren Sie sich die Anwendungs-ID.

Einrichten von Anwendungsrollen für das Azure Communications Gateway

Azure Communications Gateway enthält Dienste, die in Ihrem Auftrag auf die Operator Connect-API zugreifen müssen. Um diesen Zugriff zu aktivieren, müssen Sie bestimmten Anwendungsrollen die vom System zugewiesene verwaltete Identität für das Azure Communications Gateway unter der Project Synergy Enterprise-Anwendung gewähren. Sie haben die Project Synergy Enterprise-Anwendung in Fügen Sie die Project Synergy-Anwendung zu Ihrem Azure-Mandanten hinzu erstellt.

Sie müssen diesen Schritt einmal für jede Azure Communications Gateway-Ressource ausführen, die Sie für Operator Connect oder Teams Phone Mobile verwenden möchten.

Von Bedeutung

Die Gewährung von Berechtigungen besteht aus zwei Teilen: Konfigurieren der vom System zugewiesenen verwalteten Identität für das Azure Communications Gateway mit den entsprechenden Rollen (diesem Schritt) und Hinzufügen der Anwendungs-ID der verwalteten Identität zur Umgebung "Telefonanbieter" oder "Teams Phone Mobile". Sie fügen die Anwendungs-ID später zur Umgebung "Operator Connect" oder "Teams Phone Mobile" hinzu, in Fügen Sie die Anwendungs-IDs für das Azure Communications-Gateway zu Operator Connect hinzu.

Führen Sie die folgenden Schritte im Mandanten aus, der Ihre Project Synergy-Anwendung enthält.

Überprüfen Sie, ob das Microsoft Graph(Microsoft.Graph)-Modul in PowerShell installiert ist. Installieren Sie es bei Bedarf.
1. Öffnen Sie PowerShell.
2. Führen Sie den folgenden Befehl aus, und überprüfen Sie, ob Microsoft.Graph in der Ausgabe angezeigt wird.
```
Get-Module -ListAvailable
```
3. Wenn Microsoft.Graph nicht in der Ausgabe erscheint, installieren Sie das Modul.
  1. Schließen Sie das aktuelle PowerShell-Fenster.
  2. Öffnen Sie PowerShell als Administrator.
  3. Führen Sie den folgenden Befehl aus.
```
Install-Module -Name Microsoft.Graph -Scope CurrentUser
```
  4. Schließen Sie Ihr PowerShell-Administratorfenster.
Melden Sie sich beim Azure-Portal als globaler Microsoft Entra-Administrator an.
Wählen Sie Microsoft Entra ID aus.
Wählen Sie Eigenschaften aus.
Scrollen Sie nach unten zum Feld "Mandanten-ID". Ihre Mandanten-ID befindet sich im Feld. Notieren Sie sich Ihre Mandanten-ID.
Öffnen Sie PowerShell.
Führen Sie das folgende Cmdlet aus, und ersetzen Sie <TenantID> durch die Mandanten-ID, die Sie in Schritt 5 notiert haben.
```
Connect-MgGraph -Scopes "Application.Read.All", "AppRoleAssignment.ReadWrite.All" -TenantId "<TenantID>"
```
Wenn Sie aufgefordert werden, Berechtigungen für Microsoft Graph-Befehlszeilentools zu erteilen, wählen Sie "Annehmen " aus, um Berechtigungen zu erteilen.
Führen Sie das folgende Cmdlet aus, und ersetzen Sie <CommunicationsGatewayName> durch den Namen Ihrer Azure Communications Gateway-Ressource.
```
$acgName = "<CommunicationsGatewayName>"
```

Führen Sie die folgenden PowerShell-Befehle aus. Diese Befehle fügen die folgenden Rollen für das Azure Communications Gateway hinzu: TrunkManagement.Read, , TrunkManagement.Write, partnerSettings.Read, NumberManagement.Read, NumberManagement.Write, . Data.ReadData.Write

# Get the Service Principal ID for Project Synergy (Operator Connect)
$projectSynergyApplicationId = "eb63d611-525e-4a31-abd7-0cb33f679599"
$projectSynergyEnterpriseApplication = Get-MgServicePrincipal -Filter "AppId eq '$projectSynergyApplicationId'" # "Application.Read.All"

# Required Operator Connect - Project Synergy Roles
$trunkManagementRead = "72129ccd-8886-42db-a63c-2647b61635c1"
$trunkManagementWrite = "e907ba07-8ad0-40be-8d72-c18a0b3c156b"
$partnerSettingsRead = "d6b0de4a-aab5-4261-be1b-0e1800746fb2"
$numberManagementRead = "130ecbe2-d1e6-4bbd-9a8d-9a7a909b876e"
$numberManagementWrite = "752b4e79-4b85-4e33-a6ef-5949f0d7d553"
$dataRead = "eb63d611-525e-4a31-abd7-0cb33f679599"
$dataWrite = "98d32f93-eaa7-4657-b443-090c23e69f27"
$requiredRoles = $trunkManagementRead, $trunkManagementWrite, $partnerSettingsRead, $numberManagementRead, $numberManagementWrite, $dataRead, $dataWrite

# Locate the Azure Communications Gateway resource by name
$acgServicePrincipal = Get-MgServicePrincipal -Filter ("displayName eq '$acgName'")

# Assign the required roles to the managed identity of the Azure Communications Gateway resource
$currentAssignments = Get-MgServicePrincipalAppRoleAssignment -ServicePrincipalId $acgServicePrincipal.Id
foreach ($appRoleId in $requiredRoles) {
    $assigned = $currentAssignments | Where-Object { $_.AppRoleId -eq $AppRoleId }
    if (-not $assigned) {
        $params = @{
            principalId = $acgServicePrincipal.Id
            resourceId = $projectSynergyEnterpriseApplication.Id
            appRoleId = $appRoleId
        }
        New-MgServicePrincipalAppRoleAssignment -ServicePrincipalId $acgServicePrincipal.Id -BodyParameter $params
    }
}

# Check the assigned roles
Get-MgServicePrincipalAppRoleAssignment -ServicePrincipalId $acgServicePrincipal.Id

Um die aktuelle Sitzung zu beenden, trennen Sie die Verbindung mit Microsoft Graph.
```
Disconnect-MgGraph
```

Bereitstellen zusätzlicher Informationen für Ihr Onboarding-Team

Hinweis

Dieser Schritt ist erforderlich, um Sie als Betreiber in den Microsoft Teams Phone Mobile and Operator Connect-Umgebungen einzurichten. Überspringen Sie diesen Schritt, wenn Sie das Onboarding abgeschlossen haben.

Bevor Ihr Onboardingteam Ihren Wechsel zu Operator Connect und/oder Teams Phone Mobile abschließen kann, müssen Sie ihnen zusätzliche Informationen bereitstellen.

Warten Sie, bis Ihr Onboardingteam Ihnen ein Formular zur Verfügung stellt, um die zusätzlichen Informationen zu sammeln.
Füllen Sie das Formular aus, und übergeben Sie es Ihrem Onboarding-Team.
Warten Sie, bis Ihr Onboardingteam bestätigt, dass der Onboardingprozess abgeschlossen ist.

Wenn Sie noch nicht über ein Onboarding-Team verfügen, wenden Sie sich an azcog-enablement@microsoft.com, indem Sie Ihre Azure-Abonnement-ID und Kontaktdetails bereitstellen.

Testen des Zugriffs auf ihr Operator Connect-Portal

Von Bedeutung

Warten Sie vor dem Testen des Operator Connect-Portalzugriffs, bis Ihr Onboardingteam bestätigt, dass der Onboardingprozess abgeschlossen ist.

Wechseln Sie zur Homepage von Operator Connect , und überprüfen Sie, ob Sie sich anmelden können.

Hinzufügen der Anwendungs-IDs für das Azure Kommunikationsgateway zu Operator Connect.

Sie müssen das Azure Communications-Gateway innerhalb der Umgebung "Operator Connect" oder "Teams Phone Mobile" aktivieren. Für diesen Prozess ist die Konfiguration Ihrer Umgebung mit zwei Anwendungs-IDs erforderlich:

Die Anwendungs-ID der vom System zugewiesenen verwalteten Identität, die Sie in "Suchen der Anwendungs-ID für Ihre Azure Communication Gateway-Ressource" gefunden haben. Diese Anwendungs-ID ermöglicht Azure Communications Gateway die Verwendung der Rollen, die Sie in " Einrichten von Anwendungsrollen für Azure Communications Gateway" eingerichtet haben.
Eine Standardanwendungs-ID für eine automatisch erstellte AzureCommunicationsGateway-Unternehmensanwendung. Diese ID ist immer 8502a0ec-c76d-412f-836c-398018e2312b.

So fügen Sie die Anwendungs-IDs hinzu:

Melden Sie sich beim Operator Connect-Portal an.
Fügen Sie eine neue Anwendungs-ID hinzu, die Sie für die verwaltete Identität gefunden haben.
Fügen Sie eine zweite Anwendungs-ID für den Wert 8502a0ec-c76d-412f-836c-398018e2312bhinzu.

Registrieren Sie den Domänennamen Ihrer Bereitstellung in Microsoft Entra

Microsoft Teams sendet nur Datenverkehr an Domänen, die Sie bestätigen, dass Sie besitzen. Ihre Azure Communications Gateway-Bereitstellung empfängt automatisch einen automatisch generierten vollqualifizierten Domänennamen (FQDN). Sie müssen diesen Domänennamen ihrem Microsoft Entra-Mandanten als benutzerdefinierten Domänennamen hinzufügen, die Details für Ihr Onboarding-Team freigeben und dann den Domänennamen überprüfen. Dieser Vorgang bestätigt, dass Sie der Besitzer der Domäne sind.

Navigieren Sie zur Übersicht Ihrer Azure Communications Gateway-Ressource, und wählen Sie "Eigenschaften" aus. Suchen Sie das Feld namens "Domäne". Dieser Name ist der Domänenname Ihrer Bereitstellungsumgebung.
Führen Sie das folgende Verfahren aus: Fügen Sie Ihren benutzerdefinierten Domänennamen zur Microsoft Entra-ID hinzu.
Teilen Sie Ihre DNS TXT-Eintragsinformationen mit Ihrem Onboarding-Team. Warten Sie, bis Ihr Onboardingteam bestätigt, dass der DNS-TXT-Eintrag ordnungsgemäß konfiguriert wurde.
Führen Sie das folgende Verfahren aus: Überprüfen Sie Ihren benutzerdefinierten Domänennamen.

Nächster Schritt

Vorbereitung für Echtzeitverkehr mit Operator Connect und Teams Phone Mobile

Last updated on 2024-03-22

Freigeben über

Verbinden des Azure Communications-Gateways mit Operator Connect oder Teams Phone Mobile

Voraussetzungen

Aktivieren Sie Operator Connect oder Teams Phone Mobile Unterstützung

Hinzufügen der Project Synergy-Anwendung zu Ihrem Azure-Mandanten

Zuweisen eines Administratorbenutzers zur Project Synergy-Anwendung

Suchen der Anwendungs-ID für Ihre Azure Communication Gateway-Ressource

Einrichten von Anwendungsrollen für das Azure Communications Gateway

Bereitstellen zusätzlicher Informationen für Ihr Onboarding-Team

Testen des Zugriffs auf ihr Operator Connect-Portal

Hinzufügen der Anwendungs-IDs für das Azure Kommunikationsgateway zu Operator Connect.

Registrieren Sie den Domänennamen Ihrer Bereitstellung in Microsoft Entra

Nächster Schritt

Zusätzliche Ressourcen