Operator Connect 또는 Teams Phone Mobile에 Azure Communications Gateway 연결

아티클
04/15/2024

Azure Communications Gateway를 배포하고 핵심 네트워크에 연결한 후에는 Microsoft Phone System에 연결해야 합니다. 또한 Operator Connect 또는 Teams Phone Mobile 환경에 온보딩해야 합니다.

이 문서에서는 Operator Connect 및 Teams Phone Mobile용 Azure Communications Gateway를 설정하는 방법을 설명합니다. 이 문서의 단계를 완료한 후에는 Operator Connect, Teams Phone Mobile 및 Azure Communications Gateway를 사용하여 라이브 트래픽을 준비할 수 있습니다.

팁

이 문서에서는 Microsoft의 Azure Communications Gateway 온보딩 팀도 Operator Connect 또는 Teams Phone Mobile에 온보딩한다고 가정합니다. Operator Connect 또는 Teams Phone Mobile에 서로 다른 온보딩 파트너를 선택한 경우 파트너에서 Operator Connect 또는 Teams Phone Mobile 환경에 대한 변경 내용을 정렬해 달라고 요청해야 합니다.

필수 조건

Azure Communications Gateway를 배포해야 합니다.

Microsoft Entra 전역 관리자 역할이 있는 사용자 계정에 액세스할 수 있어야 합니다.

"서비스 확인" 테스트 번호를 할당해야 합니다. 이러한 번호는 Operator Connect 및 Teams Phone Mobile 프로그램에서 지속적인 통화 테스트를 위해 사용됩니다. 프로덕션 배포에는 각 서비스에 대해 6개의 숫자가 필요합니다. 랩 배포에는 각 서비스에 대해 3개의 숫자가 필요합니다.

Azure Communications Gateway 배포의 일환으로 설정하는 서비스를 선택한 경우 서비스에 대한 번호가 이미 할당되어 있습니다.
그렇지 않은 경우 현재 전화 번호(E.164 형식 및 국가 번호 포함)와 이름을 선택하여 식별합니다. OC1 및 OC2(Operator Connect용) 및 TPM1 및 TPM2(Teams Phone Mobile용) 형식의 이름을 권장합니다.

또한 통합 테스트를 위해 각 서비스에 대해 하나 이상의 테스트 번호를 할당해야 합니다.

Teams Phone Mobile을 설정하고 Azure Communications Gateway를 배포할 때 선택하지 않은 경우 다음을 선택합니다.

Teams Phone Mobile에서 기본 전화 걸기가 IVR(Voicemail Interactive Voice Response)에 액세스하는 데 사용되는 번호입니다.
Teams Phone Mobile 통화를 Microsoft Phone System으로 라우팅하는 방법 다음 중에서 선택합니다.
- 통합 MCP(Azure Communications Gateway의 MCP).
- 온-프레미스 MCP.
- 호출을 라우팅하는 또 다른 방법입니다.

Operator Connect 또는 Teams Phone Mobile 지원 사용

참고 항목

Azure Communications Gateway를 배포할 때 Operator Connect 또는 Teams Phone Mobile을 선택한 경우 이 단계를 건너뛰고 Azure 테넌트에 Project Synergy 애플리케이션 추가로 이동합니다.

Azure Portal에 로그인합니다.
페이지 상단의 검색 창에서 Communications Gateway 리소스를 검색하고 선택합니다.
사이드 메뉴 모음에서 Communications Services에서 Operator Connect 또는 Teams Phone Mobile(해당하는 경우)을 선택하여 서비스 페이지를 엽니다.
Operator Connect 설정 또는 Teams Phone Mobile 설정을 선택합니다.
필드를 채우고 검토 + 만들기, 만들기를 차례로 선택합니다.
리소스에 대한 개요 페이지를 선택합니다.
테스트 라인 추가를 선택하고 필수 구성 요소에서 선택한 서비스 확인 라인을 추가합니다. 테스트 용도를 자동화됨으로 설정합니다.

Important

통합 테스트용 번호를 추가하지 마세요. 통합 테스트를 수행하고 라이브 트래픽을 준비할 때 통합 테스트를 위한 번호를 구성합니다.
리소스가 업데이트될 때까지 기다립니다. 리소스가 준비되면 리소스 개요의 프로비전 상태 필드가 "완료"로 변경됩니다. 프로비전 상태 필드가 "완료"인지 주기적으로 확인하는 것이 좋습니다. 이 단계는 최대 2주가 걸릴 수 있습니다.

Azure 테넌트에 Project Synergy 애플리케이션 추가

이 단계를 시작하기 전에 리소스에 대한 프로비전 상태 필드가 "완료"인지 확인합니다.

참고 항목

이 단계와 다음 단계(Project Synergy 애플리케이션에 관리 사용자 할당)에서는 Teams 전화 모바일 및 운영자 연결 환경에서 사용자를 운영자로 설정합니다. 온보딩을 이미 수행한 경우 Azure Communication Gateway 리소스에 대한 애플리케이션 ID 찾기로 이동합니다.

Operator Connect 및 Teams Phone Mobile 프로그램을 사용하려면 Microsoft Entra 테넌트에 Project Synergy라는 Microsoft 애플리케이션이 있어야 합니다. Operator Connect 및 Teams Phone Mobile은 Project Synergy 애플리케이션을 통해 Microsoft Entra 테넌트에서 권한과 ID를 상속합니다. Project Synergy 애플리케이션을 사용하면 Operator Connect 또는 Teams Phone Mobile을 구성하고 사용자 및 그룹을 특정 역할에 할당할 수도 있습니다.

Project Synergy 애플리케이션을 추가하려면 다음을 수행합니다.

Microsoft Entra ID(AzureAD) 모듈이 PowerShell에 설치되어 있는지 확인합니다. 필요한 경우 설치합니다.
1. PowerShell을 엽니다.
2. 다음 명령을 실행하고 출력에 AzureAD가 표시되는지 확인합니다.
```
Get-Module -ListAvailable
```
3. 출력에 AzureAD이(가) 표시되지 않으면 모듈을 설치합니다.
  1. 현재 PowerShell 창을 닫습니다.
  2. 관리자 권한으로 PowerShell을 엽니다.
  3. 다음 명령을 실행합니다.
```
Install-Module AzureAD
```
  4. PowerShell 관리 창을 닫습니다.
Microsoft Entra 전역 관리자 권한으로 Azure Portal에 로그인합니다.
Microsoft Entra ID를 선택합니다.
속성을 선택합니다.
테넌트 ID 필드로 스크롤합니다. 테넌트 ID는 상자 안에 있습니다. 테넌트 ID를 기록해 두세요.
PowerShell을 엽니다.

다음 cmdlet을 실행하여 <TenantID>를 5단계에서 적어 둔 테넌트 ID로 바꿉니다.

Connect-AzureAD -TenantId "<TenantID>"
New-AzureADServicePrincipal -AppId eb63d611-525e-4a31-abd7-0cb33f679599 -DisplayName "Operator Connect"

Project Synergy 애플리케이션에 관리 사용자 할당

Azure Communications Gateway를 설정하는 사용자는 Project Synergy 애플리케이션에서 관리 사용자 역할이 필요합니다. Azure Portal에서 이 역할을 할당합니다.

Azure Portal에서 왼쪽 메뉴를 사용하여 Microsoft Entra ID와 Enterprise 애플리케이션으로 이동합니다. 또는 검색 창에서 Enterprise 애플리케이션을 검색할 수도 있습니다. 검색 창은 서비스 부제목 아래에 있습니다.
드롭다운 메뉴를 사용하여 애플리케이션 유형 필터를 모든 애플리케이션으로 설정합니다.
적용을 선택합니다.
검색 창을 사용하여 Project Synergy를 검색합니다. 애플리케이션이 나타날 것입니다.
Project Synergy 애플리케이션을 선택합니다.
왼쪽 메뉴에서 사용자 및 그룹을 선택합니다.
사용자/그룹 추가를 선택합니다.
Azure Communications Gateway를 설정할 사용자를 지정하고 관리자 역할을 부여합니다.

주의

Operator Connect 구성 포털이나 Opeator Connect API 여부와 관계 없이 테넌트에서 다음 Operator Connect 구성을 변경하지 마세요.

구성 포털에서 접미사를 사용하여 CommsGw 프로필 호출 또는 운영자 연결 API의 NameSuffix
.commsgw.azure.com으로 끝나는 FQDN이 있는 트렁크

이 구성은 Microsoft에서 관리합니다. 이 구성을 편집하면 Azure Communications Gateway 서비스에 이슈가 발생할 가능성이 높습니다.

Azure Communication Gateway 리소스에 대한 애플리케이션 ID 찾기

각 Azure Communications Gateway 리소스는 Azure Communications Gateway가 Operator Connect API에 연결하는 데 사용하는 시스템 할당 관리 ID를 자동으로 받습니다. Azure Communications Gateway에 대한 애플리케이션 역할 설정 및 Operator Connect에 Azure Communications Gateway에 대한 애플리케이션 ID 추가에서 Azure Communications Gateway를 Operator Connect 또는 API에 연결할 수 있도록 관리 ID의 애플리케이션 ID를 찾아야 합니다.

Azure Portal에 로그인합니다.
Communications Gateway 리소스의 이름을 아직 모르는 경우 Communications Gateway를 검색하고 리소스의 이름을 적어둡니다.
통신 리소스의 이름을 검색합니다. Microsoft Entra ID 하위 제목 아래에 해당 값이 있는 엔터프라이즈 애플리케이션이 표시되어야 합니다. Microsoft Entra ID에서 계속 검색을 선택해야 찾을 수 있습니다.
엔터프라이즈 애플리케이션을 선택합니다.
이름이 Communications Gateway 리소스의 이름과 일치하는지 확인합니다.
애플리케이션 ID를 기록해 둡니다.

Azure Communications Gateway에 대한 애플리케이션 역할 설정

Azure Communications Gateway에는 사용자 대신 Operator Connect API에 액세스해야 하는 서비스가 포함되어 있습니다. 이 액세스를 사용하도록 설정하려면 Project Synergy 엔터프라이즈 애플리케이션에서 Azure Communications Gateway에 대한 시스템 할당 관리 ID에 특정 애플리케이션 역할을 부여해야 합니다. Azure 테넌트에 Project Synergy 애플리케이션 추가에서 Project Synergy 엔터프라이즈 애플리케이션을 만들었습니다.

Operator Connect 또는 Teams Phone Mobile에 사용하려는 각 Azure Communications Gateway 리소스에 대해 이 단계를 한 번 수행해야 합니다.

Important

권한 부여는 적절한 역할로 Azure Communications Gateway에 대한 시스템 할당 관리 ID 구성(이 단계) 및 관리 ID의 애플리케이션 ID를 Operator Connect 또는 Teams Phone Mobile 환경에 추가하는 두 부분으로 구성됩니다. 나중에 Azure Communications Gateway에 대한 애플리케이션 ID를 Operator Connect에 추가에서 Operator Connect 또는 Teams Phone Mobile 환경에 애플리케이션 ID를 추가합니다.

Project Synergy 애플리케이션이 포함된 테넌트에서 다음 단계를 수행합니다.

Microsoft Graph(Microsoft.Graph) 모듈이 PowerShell에 설치되어 있는지 확인합니다. 필요한 경우 설치합니다.
1. PowerShell을 엽니다.
2. 다음 명령을 실행하고 출력에 Microsoft.Graph가 표시되는지 확인합니다.
```
Get-Module -ListAvailable
```
3. 출력에 Microsoft.Graph이(가) 표시되지 않으면 모듈을 설치합니다.
  1. 현재 PowerShell 창을 닫습니다.
  2. 관리자 권한으로 PowerShell을 엽니다.
  3. 다음 명령을 실행합니다.
```
Install-Module -Name Microsoft.Graph -Scope CurrentUser
```
  4. PowerShell 관리 창을 닫습니다.
전역 관리자 권한으로 Azure Portal에 로그인합니다.
Microsoft Entra ID를 선택합니다.
속성을 선택합니다.
테넌트 ID 필드로 스크롤합니다. 테넌트 ID는 상자 안에 있습니다. 테넌트 ID를 기록해 두세요.
PowerShell을 엽니다.
다음 cmdlet을 실행하여 <TenantID>를 5단계에서 적어 둔 테넌트 ID로 바꿉니다.
```
Connect-MgGraph -Scopes "Application.Read.All", "AppRoleAssignment.ReadWrite.All" -TenantId "<TenantID>"
```
Microsoft Graph 명령줄 도구에 대한 사용 권한을 부여하라는 메시지가 표시되면 수락을 선택하여 사용 권한을 부여합니다.
다음 cmdlet을 실행하여 <CommunicationsGatewayName>을(를) Azure Communications Gateway 리소스의 이름으로 바꿉니다.
```
$acgName = "<CommunicationsGatewayName>"
```

다음 PowerShell 명령을 실행합니다. 이러한 명령은 Azure Communications Gateway에 대한 TrunkManagement.Read, TrunkManagement.Write, partnerSettings.Read, NumberManagement.Read, NumberManagement.Write, Data.Read, Data.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

현재 세션을 종료하려면 Microsoft Graph에서 연결을 끊습니다.
```
Disconnect-MgGraph
```

온보딩 팀에 추가 정보 제공

참고 항목

이 단계는 Teams 전화 모바일 및 운영자 연결 환경에서 사용자를 운영자로 설정하는 데 필요합니다. 온보딩을 완료한 경우 이 단계를 건너뛰세요.

온보딩 팀이 Operator Connect 및/또는 Teams Phone Mobile 환경에 대한 온보딩을 완료하려면 몇 가지 추가 정보를 제공해야 합니다.

온보딩 팀이 추가 정보를 수집할 양식을 제공할 때까지 기다립니다.
양식을 작성하고 온보딩 팀에 제공합니다.
온보딩 팀이 온보딩 프로세스가 완료되었는지 확인할 때까지 기다립니다.

온보딩 팀이 아직 없는 경우 azcog-enablement@microsoft.com에 문의하여 Azure 구독 ID 및 연락처 세부 정보를 제공합니다.

Operator Connect 포털 액세스 테스트

Important

Operator Connect 포털 액세스를 테스트하기 전에 온보딩 팀이 온보딩 프로세스가 완료되었는지 확인할 때까지 기다립니다.

Operator Connect 홈페이지로 이동하고 로그인할 수 있는 확인합니다.

Operator Connect에 Azure Communications Gateway에 대한 애플리케이션 ID 추가

Operator Connect 또는 Teams Phone Mobile 환경 내에서 Azure Communications Gateway를 사용하도록 설정해야 합니다. 이 프로세스를 수행하려면 다음 두 개의 애플리케이션 ID를 사용하여 환경을 구성해야 합니다.

Azure Communication Gateway 리소스에 대한 애플리케이션 ID 찾기에서 찾은 시스템 할당 관리 ID입니다. 이 애플리케이션 ID를 통해 Azure Communications Gateway는 Azure Communications Gateway에 대한 애플리케이션 역할 설정에서 설정한 역할을 사용할 수 있습니다.
자동으로 생성된 AzureCommunicationsGateway 엔터프라이즈 애플리케이션에 대한 표준 애플리케이션 ID입니다. 이 ID는 항상 8502a0ec-c76d-412f-836c-398018e2312b입니다.

애플리케이션 ID를 추가하려면 다음을 수행합니다.

Operator Connect 포털에 로그인합니다.
관리 ID에 대해 찾은 애플리케이션 ID에 대한 새 애플리케이션 ID를 추가합니다.
값 8502a0ec-c76d-412f-836c-398018e2312b에 대한 두 번째 애플리케이션 ID를 추가합니다.

Active Directory에 배포 도메인 이름 등록

Microsoft Teams는 사용자가 소유한 것으로 확인된 도메인에만 트래픽을 보냅니다. Azure Communications Gateway 배포는 자동 생성된 FQDN(정규화된 도메인 이름)을 자동으로 받습니다. 이 도메인 이름을 사용자 지정 도메인 이름으로 Microsoft Entra 테넌트에 추가하고, 세부 정보를 온보딩 팀과 공유한 다음, 도메인 이름을 확인해야 합니다. 이 프로세스는 사용자가 도메인을 소유하고 있음을 확인합니다.

Azure Communications Gateway 리소스의 개요로 이동하고 속성을 선택합니다. 도메인이라는 필드를 찾습니다. 이 이름은 배포의 도메인 이름입니다.
Microsoft Entra ID에 사용자 지정 도메인 이름 추가 절차를 완료합니다.
DNS TXT 레코드 정보를 온보딩 팀과 공유합니다. 온보딩 팀이 DNS TXT 레코드가 올바르게 구성되었는지 확인할 때까지 기다립니다.
사용자 지정 도메인 이름 확인 절차를 완료합니다.

다음 단계

Operator Connect 및 Teams Phone Mobile로 라이브 트래픽 준비

다음을 통해 공유

Operator Connect 또는 Teams Phone Mobile에 Azure Communications Gateway 연결

필수 조건

Operator Connect 또는 Teams Phone Mobile 지원 사용

Azure 테넌트에 Project Synergy 애플리케이션 추가

Project Synergy 애플리케이션에 관리 사용자 할당

Azure Communication Gateway 리소스에 대한 애플리케이션 ID 찾기

Azure Communications Gateway에 대한 애플리케이션 역할 설정

온보딩 팀에 추가 정보 제공

Operator Connect 포털 액세스 테스트

Operator Connect에 Azure Communications Gateway에 대한 애플리케이션 ID 추가

Active Directory에 배포 도메인 이름 등록

다음 단계

피드백

추가 리소스