Office365 Oauth를 사용하여 Webex Connect 이메일 앱 구성

소개

이 문서에서는 OAuth 2.0(Open Authorization)을 사용하는 Office365용 전자 메일 앱을 구성하는 단계를 설명합니다.

기고자: Andrius Suchanka 및 Bhushan Suresh, Cisco TAC 엔지니어

사전 요구 사항

요구 사항

다음 주제에 대한 지식을 보유하고 있으면 유용합니다.

• Webex Contact Center(WxCC) 2.0
• 이메일 흐름이 구성된 Webex Connectportal 
• MS Azure 액세스
• MS Office365 액세스

사용되는 구성 요소

이 문서의 정보는 다음 소프트웨어 버전을 기반으로 합니다.

• WxCC 2.0
• Cisco Webex Connect
• Microsoft Azure
• Microsoft Office365

이 문서의 정보는 특정 랩 환경의 디바이스를 토대로 작성되었습니다. 이 문서에 사용된 모든 디바이스는 초기화된(기본) 컨피그레이션으로 시작되었습니다. 현재 네트워크가 작동 중인 경우 모든 명령의 잠재적인 영향을 미리 숙지하시기 바랍니다.

구성

1단계: Webex Connect에서 이메일 앱 컨피그레이션 시작

Webex Connect 플랫폼에서 이메일 앱 컨피그레이션을 시작합니다. 

- Webex Connect 테넌트에 로그인합니다.

- 'Assets(자산)->Apps(앱)'로 이동하여 'Configure New App(새 앱 구성)'을 클릭하고 'Email'(이메일)을 선택합니다. 인증 유형으로 'OAuth 2.0'을 선택하고, 이후 컨피그레이션 단계로 '전달 주소'와 '콜백 URL'을 복사하여 저장합니다.

Microsoft 측의 컨피그레이션으로 이동합니다.

2단계: Microsoft Azure에서 앱 만들기

'Microsoft ID 플랫폼으로 응용 프로그램 등록' 문서에 따라 Azure 포털에서 앱을 등록합니다.

-https://portal.azure.com에 로그인합니다.

- 'Azure Active Directory'로 이동하여 '앱 등록'을 선택하고 '새 등록'을 클릭합니다.

- 애플리케이션 이름을 제공하고, 적절한 계정 유형을 선택하고, 테넌트 이름으로 웹 '리디렉션 URI'를 입력하고(1단계에서 https://yourwebexconnectname.us.webexconnect.io/callback as 확인), 앱을 등록합니다.

-앱이 등록되면 'Authentication'으로 이동하여 'Implicit grand and hybrid flows'로 스크롤하고 'Access tokens' 옵션을 선택한 후 저장합니다.

- 'Certificates & secrets(인증서 및 암호)'로 이동하여 'Client Secrets(클라이언트 암호)'를 선택하고 'New client secret(새 클라이언트 암호)'를 클릭한 다음 설명 및 유효성 길이를 추가합니다.

- 클라이언트 암호 값을 복사하여 나중에 사용할 수 있도록 저장합니다.

-검색 필드 입력 'office 365'에서 'API 사용 권한'으로 이동하여 '사용 권한 추가'를 클릭하고 '내 조직에서 사용하는 API'를 선택한 후 'Office 365 Exchange Online'을 선택합니다. '응용 프로그램 사용 권한'을 선택하고 '메일' 섹션을 확장한 다음 'Mail.Send'를 선택하고 '사용 권한 추가'를 클릭합니다.

-상기 권한이 추가되면 관리자 동의를 받아야 합니다. '관리자 동의 부여'를 클릭합니다.

-추가 컨피그레이션을 사용하려면 'Overview(개요)'로 이동하여 'Application (client) ID'(애플리케이션 (클라이언트) ID' 및 'Directory (테넌트) ID'(디렉토리 (테넌트) ID)'(을)를 기록해 두십시오.

참고: Azure에서 '엔터프라이즈 응용 프로그램'에 대한 '동의 및 권한' 아래 앱에 대한 사용자 동의가 허용되는지 확인하십시오(기본 설정).

3단계: Office365에서 사서함 사용자 구성

-https://admin.microsoft.com에 로그인합니다.

-Users(사용자)->Active Users(활성 사용자)로 이동합니다.

- Webex Connect와의 통합을 위해 사서함이 있는 사용자 선택;

-특정 사용자를 선택한 후 'Mail'(메일 앱)로 이동하고 'Email apps(이메일 앱)'에서 'Manage email apps(이메일 앱 관리)'를 클릭한 후 'Authenticated SMTP(인증된 SMTP)'가 선택되었는지 확인하고 'Save changes(변경 사항 저장)'를 클릭합니다.

-'Email Forwarding'에서 'Manage email forwarding(이메일 전달 관리)'을 클릭하고 'Forward all emails sent to this mailbox(이 사서함으로 전송된 모든 이메일 전달)'를 선택한 다음 1단계에 나와 있는 것처럼 Webex Connect 앱 구성의 별칭으로 'Forwarding email address(이메일 주소 전달)'를 입력하고(필요한 경우 'Keep a copy of forwarded email in this mailbox'(이 사서함에 전달된 이메일의 복사본 유지)'를 선택하고 'Save changes(변경 사항 저장)'를 클릭합니다.

- Microsoft 365 Defender 포털에서 외부 이메일 주소로 아웃바운드 이메일 전달이 허용되는지 확인합니다.

-그렇지 않은 경우 - Microsoft 설명서에 따라 기존 안티스팸 정책을 만들거나 수정합니다.

아웃바운드 스팸 필터링 구성 - Office 365

참고: 전달이 'On'으로 설정된 안티스팸 정책을 저장하는 동안 'Enable-OrganizationCustomization' 관련 오류가 표시되면 Microsoft 문서 Enable-OrganizationCustomization에 설명된 대로 'Enable-OrganizationCustomization' cmdlet을 실행하십시오(cmdlet 변경이 적용되기까지 최대 24시간이 걸릴 수 있습니다).

참고 2: Exchange Online PowerShell에 연결하려면 Exchange Online PowerShell에 연결 - 기사를 검토하십시오.

4단계: Webex Connect에서 이메일 앱 구성

Webex Connect 이메일 앱 구성으로 다시 전환하고 필수 필드를 입력합니다.

- '이메일 ID'의 경우 3단계에서 Webex Connect 이메일 주소로 이메일 전달하도록 구성된 사서함을 사용합니다.

- SMTP 컨피그레이션에 대한 설정 사용:

SMTP Server: smtp.office365.com
Port: 587
Security: STARTTLS

- 'Username'의 경우 3단계에서 구성한 것과 동일한 사용자를 사용합니다.

- 'Client ID'의 경우 2단계에 표시된 대로 저장된 'Application (client) ID'를 사용합니다.

-Client Secret'의 경우 2단계에 표시된 대로 저장된 'Client Secret'을 사용합니다.

- '권한 부여 URL'에 대해 'https://login.microsoftonline.com/<your-azure-tenant-id>/oauth2/v2.0/authorize'를 사용합니다.

- 'offline_access https://outlook.office.com/SMTP.Send' for 'Scope' 사용;

- '액세스 토큰 URL' 및 '토큰 URL 새로 고침'의 경우 'https://login.microsoftonline.com/<your-azure-tenant-id>/oauth2/v2.0/token'을 사용하십시오.

-Generate Token(토큰 생성)을 클릭하고 'Username' 필드에 구성된 것과 동일한 사용자를 사용해야 합니다. 'Access Token(액세스 토큰)', 'Refresh Token(토큰 새로 고침)' 및 'Validity(유효성)' 필드가 채워져 있습니다.

-Save(저장)를 클릭한 다음 'Register to Webex Engage(Webex Engage에 등록)'를 클릭합니다.

다음을 확인합니다.

Office 365 사서함으로 전자 메일을 보내 확인합니다. 해당 이메일이 Webex Contact Center 에이전트에게 표시되고 Webex Contact Center 에이전트의 회신이 원래 발신자에 의해 수신된 경우 - 컨피그레이션에 성공합니다.

문제 해결

이메일 흐름이 계속 실패하면 Webex Connect 포털 페이지에서 Debug Console(디버그 콘솔)에 액세스하고 이메일 채널 및 타임스탬프를 사용하여 검색합니다 

이 섹션에는 Status(상태)와 함께 Incoming Message(수신 메시지) 및 Outgoing Message(발신 메시지)가 있습니다.

실패에 대한 자세한 정보를 수집하려면 메시지 ID를 선택합니다 

메시지 ID를 선택하면 Error & Warnings 섹션에 오류에 대한 자세한 내용이 표시됩니다

Cisco TAC를 활성화해야 하는 경우 다음 정보를 수집하십시오. 

• 이메일 채널의 자산 ID 
• 표시된 대로 디버그 로그에서 실패한 의 트랜잭션 ID 및 스크린샷