이메일 OAuth 프로필 및 Microsoft 365 클라이언트 사용자 인증 정보

이메일 OAuth 프로필을 사용하면 Contact Center AI Platform (CCAI Platform)에서 이메일 계정의 OAuth 설정을 관리할 수 있습니다. 모든 OAuth IMAP 계정에 단일 전역 OAuth 구성을 사용하는 대신 별도의 이메일 OAuth 프로필을 만들고 각 이메일 계정을 사용해야 하는 프로필에 연결할 수 있습니다.

Microsoft 365의 경우 이메일 OAuth 프로필은 클라이언트 사용자 인증 정보 부여 유형을 지원합니다. 이 부여 유형은 개별 사용자 로그인에 의존하는 대신 애플리케이션 수준에서 인증합니다. 액세스가 관리자 사용자 한 명의 비밀번호, 동의 세션 또는 고용 상태에 의존하지 않으므로 support@company.com과 같은 공유 편지함에 특히 유용합니다.

이 페이지에서는 클라이언트 사용자 인증 정보를 사용하여 Microsoft 365의 이메일 OAuth 프로필을 설정하는 방법을 보여줍니다.

승인 코드와 클라이언트 사용자 인증 정보 비교

CCAI Platform은 이메일 계정에 승인 코드 및 클라이언트 사용자 인증 정보 OAuth 권한 유형을 지원합니다. 다음 표에서는 이러한 부여 유형을 비교합니다.

부여 유형 용도 작동 방식
승인 코드 사용자별 편지함 관리자 또는 편지함 사용자가 Microsoft OAuth 동의 흐름을 통해 로그인합니다.
클라이언트 사용자 인증 정보 공유 또는 애플리케이션 관리 Microsoft 365 편지함 CCAI Platform은 대화형 사용자 로그인 없이 액세스를 요청하기 위해 앱 등록, 클라이언트 보안 비밀번호, 인스턴스 수준 권한을 사용합니다.

각 이메일 OAuth 프로필은 하나의 부여 유형을 사용합니다. 조직에 다른 지원금 유형, 프로바이더 또는 편지함 구성이 필요한 경우 별도의 이메일 OAuth 프로필을 만들고 각 이메일 계정을 적절한 프로필에 연결합니다.

시작하기 전에

다음 항목이 있는지 확인합니다.

  • Microsoft 365 인스턴스

  • Microsoft Entra 관리자 액세스

  • 이메일 설정을 관리할 수 있는 권한이 있는 CCAI Platform 관리자 계정

  • 로컬에 설치된 PowerShell

  • ExchangeOnlineManagement PowerShell 모듈이 설치됨

  • 디렉터리의 Microsoft 인스턴스 ID

또한 CCAI Platform에서 액세스해야 하는 편지함을 알아야 합니다.

Microsoft Entra 앱 등록 만들기

CCAI Platform은 Microsoft Entra 앱 등록을 사용하여 Microsoft 365 이메일 액세스에 대한 OAuth 토큰을 요청합니다.

Microsoft Entra 앱 등록을 만들려면 다음 단계를 따르세요.

  1. Microsoft Azure에서 Microsoft Entra ID > 앱 등록 으로 이동합니다.

  2. 새 등록 을 선택합니다.

  3. CCAI Platform 이메일 OAuth와 같이 앱의 명확한 이름을 입력합니다.

  4. 등록을 완료합니다.

  5. 애플리케이션 (클라이언트) ID 를 복사합니다.

  6. 디렉터리 (테넌트) ID 를 복사합니다.

이메일 OAuth 프로필을 만들 때 이 값을 사용합니다.

클라이언트 보안 비밀번호 만들기

클라이언트 보안 비밀번호를 만들려면 다음 단계를 따르세요.

  1. 앱 등록에서 인증서 및 보안 비밀 로 이동합니다.

  2. 새 클라이언트 보안 비밀번호를 만듭니다.

  3. 보안 비밀 값을 즉시 복사합니다.

Microsoft API 권한 추가

앱에는 Exchange Online을 통해 이메일에 액세스하고 이메일을 보낼 수 있는 권한이 필요합니다.

Microsoft API 권한을 추가하려면 다음 단계를 따르세요.

  1. 앱 등록에서 API 권한 으로 이동합니다.

  2. 권한 추가 를 선택합니다.

  3. Office 365 Exchange Online 을 선택합니다.

  4. 애플리케이션 권한 을 선택합니다.

  5. 필요한 권한을 추가합니다.

    • IMAP.AccessAsApp

    • SMTP.SendAsApp

  6. CCAI Platform에서 드롭다운에 사용 가능한 Microsoft 365 편지함을 표시하려면 인스턴스의 사용자 또는 편지함을 나열하는 데 필요한 Microsoft Graph 애플리케이션 권한을 추가합니다.

  7. 조직에 대해 관리자 동의 부여 를 선택합니다.

계속하기 전에 권한이 부여된 것으로 표시되는지 확인합니다.

편지함에 대한 앱 액세스 권한 부여

앱에 인스턴스 수준 권한이 있으면 CCAI Platform에서 연결해야 하는 특정 편지함에 대한 액세스 권한을 부여합니다.

편지함에 대한 앱 액세스 권한을 부여하려면 다음 단계를 따르세요.

  1. PowerShell을 엽니다.

  2. Exchange Online에 연결합니다.

    Connect-ExchangeOnline -Organization TENANT_ID
    

    TENANT_ID를 Microsoft 365 디렉터리(테넌트) ID로 바꿉니다.

  3. Exchange에 서비스 주 구성원을 등록합니다.

    New-ServicePrincipal `
        -AppId APPLICATION_CLIENT_ID `
        -ObjectId OBJECT_ID
    

    다음을 바꿉니다.

    • APPLICATION_CLIENT_ID: Microsoft Entra 앱 등록의 애플리케이션 (클라이언트) ID

    • OBJECT_ID: 엔터프라이즈 애플리케이션 의 객체 ID

  4. 편지함 액세스 권한을 부여합니다.

    Add-MailboxPermission `
        -Identity EMAIL_ADDRESS `
        -User SERVICE_PRINCIPAL_ID `
        -AccessRights FullAccess
    

    다음을 바꿉니다.

    • EMAIL_ADDRESS: CCAI Platform에서 액세스해야 하는 편지함의 이메일 주소

    • SERVICE_PRINCIPAL_ID: 서비스 주 구성원 ID

CCAI Platform에서 이메일 OAuth 프로필 만들기

Microsoft 365 클라이언트 사용자 인증 정보 구성의 이메일 OAuth 프로필을 만들려면 다음 단계를 따르세요.

  1. CCAI Platform 포털에서 설정 > 개발자 설정을 클릭합니다. 설정 메뉴가 표시되지 않으면 메뉴를 클릭합니다.

  2. 이메일 계정 관리 창으로 이동한 다음 이메일 계정 관리 를 클릭합니다. 이메일 계정 관리 페이지가 표시됩니다.

  3. 이메일 OAuth 탭을 클릭합니다.

  4. 프로필 추가 를 클릭합니다.

  5. 이름 필드에 프로필 이름을 입력합니다.

  6. 부여 유형 목록에서 클라이언트 사용자 인증 정보 를 선택합니다.

  7. 토큰 URL 필드에 인스턴스의 Microsoft OAuth 토큰 엔드포인트를 입력합니다.

  8. 클라이언트 ID 필드에 Microsoft Entra의 애플리케이션 (클라이언트) ID를 입력합니다.

  9. 클라이언트 보안 비밀번호 필드에 Microsoft Entra의 클라이언트 보안 비밀번호 값을 입력합니다.

  10. 대상 필드에 대상을 입력합니다.

  11. 범위 필드에 범위를 입력합니다.

  12. 상태 필드에 상태를 입력합니다.

  13. 액세스 유형 필드에 액세스 유형을 입력합니다.

  14. 저장 을 클릭합니다.

이메일 계정을 OAuth 프로필에 연결하려면 다음 단계를 따르세요.

  1. CCAI Platform 포털에서 설정 > 개발자 설정을 클릭합니다. 설정 메뉴가 표시되지 않으면 메뉴를 클릭합니다.

  2. 이메일 계정 관리 창으로 이동한 다음 이메일 계정 관리 를 클릭합니다. 이메일 계정 관리 페이지가 표시됩니다.

  3. 이메일 계정 목록 탭을 클릭합니다.

  4. 수정할 이메일 계정에서 를 클릭한 다음 이메일 계정을 클릭합니다.

  5. 이메일 서비스 목록에서 OAuth IMAP 을 선택합니다.

  6. OAuth 프로필 목록에서 이전 절차에서 만든 OAuth 프로필을 선택합니다.

  7. 링크 를 클릭합니다.

  8. 이메일 ID 목록에서 편지함을 선택합니다.

  9. 저장 을 클릭합니다.

연결하면 CCAI Platform에서 선택한 OAuth 프로필로 인증할 수 있는지 확인됩니다. 편지함 선택은 이메일 계정에서 사용해야 하는 편지함을 CCAI Platform에 알려줍니다.

CCAI Platform에서 Microsoft의 편지함 목록을 가져올 수 없는 경우 양식이 수동 이메일 주소 입력으로 대체됩니다. 편지함 주소를 수동으로 입력한 다음 계정을 저장합니다.

문제 해결

문제 해결 방법
편지함 목록이 로드되지 않음 Microsoft 앱에 필요한 Microsoft Graph 권한과 관리자 동의가 있는지 확인합니다. 드롭다운을 사용할 수 없는 경우 편지함을 수동으로 입력할 수 있습니다.
인증 오류로 인해 연결 실패 클라이언트 ID, 클라이언트 보안 비밀번호, 인스턴스 ID, 토큰 URL이 올바른지 확인합니다. 클라이언트 보안 비밀번호가 만료되지 않았는지도 확인합니다.
편지함에서 이메일을 보내거나 받을 수 없음 앱에 Exchange Online의 편지함 권한이 있고 이메일 계정이 올바른 이메일 OAuth 프로필에 연결되어 있는지 확인합니다.

달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.

최종 업데이트: 2026-11-11(UTC)