View a markdown version of this page

Microsoft Outlook 통합 - Amazon Quick
시작하기 전 준비 사항Microsoft Entra 구성Amazon Quick에서 커넥터 설정사용 가능한 작업관리 및 문제 해결Microsoft 365에 대한 관리자 동의

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

Microsoft Outlook 통합

Microsoft Outlook 작업 커넥터를 사용하면 자연어를 통해 Amazon Quick에서 직접 Outlook의 이메일, 일정 및 연락처 APIs에 액세스할 수 있습니다.

Amazon Quick은 Microsoft Outlook에 대한 여러 인증 방법을 지원합니다. 조직의 보안 요구 사항에 가장 적합한 방법을 선택합니다.

  • 기본 OAuth 앱 AWS- 관리형 OAuth 애플리케이션을 사용합니다. 추가 자격 증명은 필요하지 않습니다. 사용자는 Microsoft 계정으로 직접 인증합니다.

  • 사용자 지정 OAuth 앱 - Microsoft Entra에 등록된 고객 관리형 애플리케이션을 사용합니다. 이 옵션을 사용하면 조직에서 OAuth 구성을 완전히 제어할 수 있습니다. 사용자는 로그인한 사용자를 대신하여 인증합니다(위임된 권한).

  • Service-to-Service OAuth - 사용자 상호 작용(애플리케이션 권한) 없이 server-to-server 인증에 클라이언트 자격 증명을 사용합니다. 자동화된 워크플로에 적합합니다.

Amazon Quick에서 지원하는 인증 방법에 대한 자세한 내용은 섹션을 참조하세요인증 방법.

시작하기 전 준비 사항

통합을 설정하기 전에 다음 사항이 있는지 확인합니다.

  • Outlook 또는 Exchange Online에 액세스할 수 있는 Microsoft 365 계정.

  • 사용자 지정 OAuth 앱 또는 Service-to-Service OAuth의 경우: 최소한 Application Developer 권한이 있는 Microsoft 웹 사이트의 Microsoft Entra 관리자 센터에 액세스합니다.

  • Amazon Quick 구독 요구 사항은 섹션을 참조하세요콘솔에서 통합 설정.

Microsoft Entra 구성

기본 OAuth 앱 인증을 사용하는 경우이 섹션을 건너뛰고 로 이동합니다Amazon Quick에서 커넥터 설정.

Amazon Quick을 구성하기 전에 Microsoft Entra에서 앱 등록을 생성합니다. Amazon Quick 콘솔로 이동하기 전에 Entra에서 다음 단계를 모두 완료합니다.

앱 등록에 대한 자세한 내용은 Microsoft 설명서의 Microsoft 자격 증명 플랫폼에 애플리케이션 등록을 참조하세요.

애플리케이션 등록

  1. Microsoft Entra 관리자 센터를 엽니다.

  2. 왼쪽 탐색 창에서 Entra ID를 선택한 다음 앱 등록을 선택합니다.

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

  4. 이름에 통합을 설명하는 이름을 입력합니다.

  5. 지원되는 계정 유형에서이 조직 디렉터리에서만 계정을 선택합니다.

  6. 리디렉션 URI에서 웹을 선택하고를 입력합니다https://{region}.quicksight.aws.amazon.com/sn/oauthcallback. {region}을 Amazon Quick 인스턴스가 배포된 AWS 리전으로 바꿉니다.

  7. 등록을 선택합니다.

  8. 개요 페이지에서 애플리케이션(클라이언트) ID와 디렉터리(테넌트) ID를 복사합니다. Amazon Quick 구성에는 이러한 값이 필요합니다.

클라이언트 보안 암호 생성

Amazon Quick에서 Microsoft Entra로 인증하려면 클라이언트 보안 암호가 필요합니다. 이 보안 암호는 앱 등록을 위한 암호 역할을 합니다.

  1. 앱 등록에서 인증서 및 보안 암호를 선택합니다.

  2. 새 클라이언트 암호를 선택합니다.

  3. 설명을 입력하고 만료 기간을 선택합니다.

  4. 추가를 선택합니다.

  5. 값을 즉시 복사합니다. 이 값은 한 번만 표시됩니다.

중요

보안 암호 ID가 아닌 보안 암호 값을 복사합니다. 값은 인증에 사용되는 더 긴 문자열입니다.

API 권한 구성

Microsoft Graph는이 통합에 대해 두 가지 권한 유형을 지원합니다. 위임된 권한을 통해 앱은 로그인한 사용자를 대신하여 작업할 수 있습니다. 애플리케이션 권한을 사용하면 앱이 로그인한 사용자 없이 작동할 수 있습니다. 자세한 내용은 Microsoft 설명서의 Microsoft 그래프 권한 개요를 참조하세요.

  1. 앱 등록에서 API 권한을 선택합니다.

  2. 권한 추가를 선택한 다음 Microsoft 그래프를 선택합니다.

  3. 인증 방법을 기반으로 위임된 권한 또는 애플리케이션 권한을 선택하고 아래 해당 표의 권한을 추가합니다.

  4. [테넌트 이름]에 대한 관리자 동의 부여를 선택하여 권한을 승인합니다.

사용자 인증(위임된 권한)의 경우:

Entra 앱 등록에 다음을 위임 권한으로 추가합니다. 전체 권한 참조는 Microsoft 설명서의 Microsoft Graph 권한 참조를 참조하세요.

Outlook 작업 통합 - 위임된 권한
권한 설명
Mail.ReadWrite 앱이 사용자 사서함에서 이메일을 생성, 읽기, 업데이트 및 삭제할 수 있도록 허용합니다.
Mail.Send 앱이 조직의 사용자로 메일을 보내도록 허용합니다.
Calendars.ReadWrite 앱이 사용자 일정에서 이벤트를 생성, 읽기, 업데이트 및 삭제할 수 있도록 허용합니다.
Calendars.ReadWrite.Shared 앱이 위임 및 공유 일정을 포함하여 사용자에게 액세스 권한이 있는 모든 일정에서 이벤트를 생성, 읽기, 업데이트 및 삭제할 수 있도록 허용합니다.
User.Read 사용자가 앱에 로그인하고 앱이 로그인한 사용자의 프로필을 읽을 수 있도록 허용합니다.
User.Read.All 앱이 조직 내 다른 사용자의 전체 프로필 속성 세트를 읽을 수 있도록 허용합니다.
Contacts.Read 앱이 사용자 연락처를 읽을 수 있도록 허용합니다.
Place.Read.All 앱이 일정 이벤트 및 기타 애플리케이션에 대한 회사 장소(회의실 및 회의실 목록)를 읽을 수 있도록 허용합니다.
MailboxSettings.Read 앱이 사용자의 사서함 설정을 읽을 수 있도록 허용합니다.
offline_access 사용자가 다시 로그인할 필요 없이 앱이 액세스 토큰을 새로 고칠 수 있도록 허용합니다. 이렇게 하면 사용자가 재인증해야 하는 빈도가 줄어듭니다.
참고

User.Read.All 및는 관리자의 동의가 Place.Read.All 필요합니다. 관리자가 동의를 부여해야 사용자가 인증할 수 있습니다.

서비스 인증(애플리케이션 권한)의 경우:

Entra 앱 등록에 다음을 애플리케이션 권한으로 추가합니다.

Outlook 작업 통합 - 애플리케이션 권한
권한 설명
Mail.ReadWrite 앱이 모든 사서함에서 메일을 생성, 읽기, 업데이트 및 삭제할 수 있도록 허용합니다.
Mail.Send 앱이 사용자로 메일을 보내도록 허용합니다.
Calendars.ReadWrite 앱이 모든 일정의 이벤트를 생성, 읽기, 업데이트 및 삭제할 수 있도록 허용합니다.
User.Read.All 앱이 사용자 프로필을 읽을 수 있도록 허용합니다.
Contacts.Read 앱이 모든 사서함의 모든 연락처를 읽을 수 있도록 허용합니다.
Place.Read.All 앱이 일정 이벤트 및 기타 애플리케이션에 대한 회사 장소(회의실 및 회의실 목록)를 읽을 수 있도록 허용합니다.
MailboxSettings.Read 앱이 사용자의 사서함 설정을 읽을 수 있도록 허용합니다.
중요

서비스 인증을 사용하면 모든 작업이 서비스 계정으로 실행됩니다. 이 통합에 액세스할 수 있는 모든 사용자는 서비스 계정이 액세스할 수 있는 모든 사서함에서 작업을 수행할 수 있습니다. 조직의 보안 요구 사항에 맞게 애플리케이션 권한의 범위를 적절하게 지정합니다.

자격 증명 기록

Microsoft Entra 관리자 센터를 떠나기 전에 다음 값이 있는지 확인합니다. Amazon Quick 구성에 필요합니다.

Microsoft Entra의 필수 자격 증명
값 찾을 수 있는 위치
애플리케이션(클라이언트) ID 앱 등록 개요 페이지
디렉터리(테넌트) ID 앱 등록 개요 페이지
클라이언트 시크릿 값 인증서 및 보안 암호 페이지

Amazon Quick에서 커넥터 설정

사용 가능 탭에서 연결

기본 OAuth 앱 인증을 사용하려면 추가 구성 없이 사용 가능 탭에서 직접 연결할 수 있습니다.

  1. Amazon Quick 콘솔에서 커넥터를 선택합니다.

  2. 사용 가능 탭에서 Microsoft Outlook을 찾아 연결을 선택합니다.

  3. Microsoft 로그인 흐름을 완료하고 요청된 권한을 부여합니다.

대신 사용자 지정 OAuth 앱 또는 Service-to-Service OAuth로 커넥터를 구성하려면 아래 설명된 대로 팀에 대해 생성 탭을 사용합니다.

팀에 대해 생성 탭에서 생성

필요한 Entra 구성을 완료한 후 Amazon Quick에서 커넥터를 생성합니다.

  1. Amazon Quick 콘솔에서 커넥터를 선택합니다.

  2. 팀에 대해 생성 탭을 선택합니다.

  3. Microsoft Outlook을 찾아 선택합니다.

    참고

    Microsoft Outlook 커넥터가 이미 있는 경우 기존 커넥터와 함께 대화 상자가 나타납니다. 기존 커넥터를 사용하려면 선택합니다. 새로 생성하려면 아니요, 새로 생성을 선택합니다.

  4. 커넥터의 이름을 입력합니다. 선택적으로 + 설명 추가를 선택하여 설명을 추가합니다.

  5. 연결 유형에서 퍼블릭 네트워크를 선택합니다.

  6. OAuth 구성에서 다음 인증 방법 중 하나를 선택하고 필수 필드를 구성합니다.

    1. 기본 OAuth 앱의 경우:

      추가 자격 증명은 필요하지 않습니다. 다음을 선택하여 계속 진행합니다.

    2. 사용자 지정 OAuth 앱(위임된 권한이 있는 사용자 인증)에서 다음 필드를 구성합니다.

      • 기본 URL(선택 사항) - Microsoft Graph API 기본 URL입니다. 예시: https://graph.microsoft.com/v1.0

      • 클라이언트 ID - Entra 앱 등록의 애플리케이션(클라이언트) ID입니다.

      • 클라이언트 보안 암호 - Entra 앱 등록의 클라이언트 보안 암호 값입니다.

      • 토큰 URL - 토큰 엔드포인트입니다. 예시: https://login.microsoftonline.com/{tenant-id}/oauth2/v2.0/token

      • 권한 부여 URL - 권한 부여 엔드포인트입니다. 예시: https://login.microsoftonline.com/{tenant-id}/oauth2/v2.0/authorize

      • 리디렉션 URL - Amazon Quick 콜백 URL로 미리 채워집니다.

    3. Service-to-Service OAuth(애플리케이션 권한이 있는 서비스 인증)에서 다음 필드를 구성합니다.

      • 기본 URL(선택 사항) - Microsoft Graph API 기본 URL입니다. 예시: https://graph.microsoft.com/v1.0

      • 클라이언트 ID - Entra 앱 등록의 애플리케이션(클라이언트) ID입니다.

      • 클라이언트 보안 암호 - Entra 앱 등록의 클라이언트 보안 암호 값입니다.

      • 토큰 URL - 토큰 엔드포인트입니다. 예시: https://login.microsoftonline.com/{tenant-id}/oauth2/v2.0/token

      참고

      클라이언트 자격 증명 토큰 요청(https://graph.microsoft.com/.default)의 범위는 Amazon Quick에서 자동으로 설정합니다. 수동으로 구성할 필요가 없습니다.

  7. 다음을 선택합니다.

  8. 기본 OAuth 앱 또는 사용자 지정 OAuth 앱을 선택한 경우 Microsoft 권한 부여 창이 열립니다. 요청된 권한을 검토하고 수락을 선택합니다.

    동의 대화 상자 대신 오류가 표시되면 조직에서 타사 앱 액세스를 제한할 수 있습니다. Microsoft 365에 대한 관리자 동의을(를) 참조하세요.

  9. 검토 페이지에서 커넥터에 사용할 수 있는 작업을 검토합니다. 다음을 선택합니다.

  10. 게시 페이지에서 커넥터에 액세스할 수 있는 사용자를 선택합니다. 조직의 모든 사람에 대해 액세스를 활성화하거나 특정 팀 또는 그룹을 검색할 수 있습니다.

  11. 게시를 선택합니다.

사용 가능한 작업

커넥터를 설정한 후 다음 작업을 사용할 수 있습니다.

Microsoft Outlook 사용 가능한 작업
카테고리 작업 설명
이메일 사용자 메일 나열 사서함에 이메일을 나열합니다.
이메일 폴더 메시지 나열 특정 메일 폴더의 메시지를 나열합니다.
이메일 이메일 보기 ID별로 이메일 세부 정보를 검색합니다.
이메일 사용자 이메일 전송 새 이메일 메시지를 보냅니다.
이메일 이메일에 회신 기존 이메일에 회신합니다.
이메일 사용자 이메일 전달 다른 수신자에게 이메일을 전달합니다.
이메일 이메일 업데이트 이메일 속성을 편집합니다.
이메일 이메일 삭제 사서함에서 이메일을 제거합니다.
이메일 이메일을 폴더로 이동 이메일을 다른 폴더로 이동합니다.
이메일 이메일 첨부 파일 나열 이메일의 첨부 파일을 나열합니다.
이메일 첨부 파일 가져오기 ID별로 첨부 파일 세부 정보 및 콘텐츠를 검색합니다.
캘린더 일정 이벤트 나열 일정의 이벤트를 나열합니다.
캘린더 일정 보기 나열 지정된 날짜 범위의 회의를 나열합니다.
캘린더 일정 이벤트 생성 새 회의 또는 약속을 생성합니다.
캘린더 일정 이벤트 업데이트 기존 이벤트를 수정합니다.
캘린더 일정 이벤트 삭제 일정에서 이벤트를 제거합니다.
캘린더 회의 시간 찾기 참석자 가용성에 따라 회의 시간을 제안합니다.
연락처 연락처 나열 연락처를 나열합니다.
Users 사용자 목록 표시 조직의 사용자를 나열합니다.
Settings 사서함 설정 가져오기 사서함 구성을 읽습니다.
Places 장소 나열 회의실 및 회의실 목록을 나열합니다.

관리 및 문제 해결

통합을 편집, 공유 또는 삭제하려면 섹션을 참조하세요기존 통합 관리.

인증 문제

  • 잘못된 앱 등록 - Microsoft Entra의 앱 등록에 필요한 API 권한이 포함되어 있고 관리자 동의가 부여되었는지 확인합니다.

  • 만료된 클라이언트 보안 암호 - 인증서 및 보안 암호에서 클라이언트 보안 암호가 만료되었는지 확인하고 필요한 경우 새 보안 암호를 생성합니다.

  • 잘못된 리디렉션 URI - Microsoft Entra의 리디렉션 URI가와 일치하는지 확인합니다https://{region}.quicksight.aws.amazon.com/sn/oauthcallback.

일반적인 오류 메시지

  • Access denied. You do not have permission to perform this action - 인증된 사용자에게 필요한 권한이 없습니다. 관리자에게 문의하여 적절한 권한을 확인하고 부여합니다.

  • AADSTS50020: User account from identity provider does not exist in tenant - 사용자 계정이 올바른 Microsoft Entra 테넌트에 구성되지 않았습니다. 앱 등록의 디렉터리(테넌트) ID와 일치하는 사용자 계정이 테넌트에 있는지 확인합니다.

기본 OAuth 앱 인증 방법을 사용하는 경우 Amazon Quick은 로그인한 사용자를 대신하여 AWS관리형 애플리케이션을 사용하여 Microsoft Outlook에 액세스합니다. 대부분의 사용자는 추가 단계 없이 설정을 완료할 수 있습니다. 그러나 Microsoft 365 테넌트가 타사 앱 액세스를 제한하는 경우 Microsoft 365 관리자는 사용자가 연결하기 전에 일회성 동의를 부여해야 합니다.

커넥터 설정 중에 로그인할 때 오류가 발생하면 조직에서 타사 앱 액세스를 제한할 수 있습니다. Microsoft 365 관리자와 다음 정보를 공유합니다.

  • 수행할 작업: Amazon Quick Microsoft Outlook 통합 애플리케이션에 대한 관리자 동의 부여.

  • 이유: 사용자를 대신하여 작업을 수행하려면 Amazon Quick에 Outlook 이메일, 일정 및 연락처 데이터에 대한 위임된 액세스 권한이 필요합니다.

관리자는 다음 방법 중 하나로 동의를 부여할 수 있습니다.

  • 동의 대화 상자 - 글로벌 관리자 또는 권한 있는 역할 관리자가 커넥터 설정 흐름을 시작합니다. Microsoft 로그인 대화 상자에서 조직을 대신하여 동의 확인란을 선택하고 수락을 선택합니다.

  • Microsoft Entra 관리자 센터를 통해 - Microsoft 웹 사이트의 Microsoft Entra 관리자 센터에 로그인합니다. 엔터프라이즈 애플리케이션을 선택하고 Amazon Quick 애플리케이션을 찾은 다음 권한을 선택하고 조직에 관리자 동의 부여를 선택합니다.

동의가 부여되면 조직의 모든 사용자가 개별 동의 메시지가 표시되지 않고 연결할 수 있습니다.

참고

테넌트가 사용자 동의를 제한하는지 확인하려면 Microsoft Entra 관리자 센터로 이동하여 엔터프라이즈 애플리케이션, 동의 및 권한, 사용자 동의 설정을 선택합니다. 설정이 사용자 동의 허용 안 함인 경우 관리자가 동의를 부여해야 사용자가 커넥터를 사용할 수 있습니다.