기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
Microsoft Teams 통합
Microsoft Teams 작업 커넥터를 사용하여 자연어를 통해 Amazon Quick에서 직접 메시지를 보내고, 채널을 관리하고, 회의를 예약하고, 팀 협업을 관리할 수 있습니다.
이 통합을 설정하려면 두 단계가 필요합니다. 먼저 Microsoft Entra에 애플리케이션을 등록하고 해당 권한을 구성합니다. 그런 다음 Amazon Quick에서 통합을 생성하고 Entra 앱에 연결합니다. Amazon Quick에서 지원하는 인증 방법에 대한 자세한 내용은 섹션을 참조하세요인증 방법.
시작하기 전 준비 사항
통합을 설정하기 전에 다음 사항이 있는지 확인합니다.
-
Teams 액세스 권한이 있는 Microsoft 365 계정.
-
최소한 Application Developer 권한이 있는 Microsoft Entra 관리자 센터에
액세스합니다. -
구독 요구 사항은 섹션을 참조하세요콘솔에서 통합 설정.
Microsoft Entra 구성
Amazon Quick을 구성하기 전에 Microsoft Entra에서 앱 등록을 생성합니다. Amazon Quick 콘솔로 이동하기 전에 Entra에서 다음 단계를 모두 완료합니다.
앱 등록에 대한 자세한 내용은 Microsoft 설명서의 Microsoft 자격 증명 플랫폼에 애플리케이션 등록
애플리케이션 등록
-
왼쪽 탐색 창에서 Entra ID를 선택한 다음 앱 등록을 선택합니다.
-
새 등록을 선택합니다.
-
이름에 통합을 설명하는 이름을 입력합니다.
-
지원되는 계정 유형에서이 조직 디렉터리에서만 계정을 선택합니다.
-
리디렉션 URI에서 웹을 선택하고를 입력합니다
https://.{region}.quicksight.aws.amazon.com/sn/oauthcallback{region}을 Amazon Quick 인스턴스가 배포된 AWS 리전으로 바꿉니다. -
등록을 선택합니다.
-
개요 페이지에서 애플리케이션(클라이언트) ID와 디렉터리(테넌트) ID를 복사합니다. Amazon Quick 구성에는 이러한 값이 필요합니다.
클라이언트 보안 암호 생성
Amazon Quick에서 Microsoft Entra로 인증하려면 클라이언트 보안 암호가 필요합니다. 이 보안 암호는 앱 등록을 위한 암호 역할을 합니다.
-
앱 등록에서 인증서 및 보안 암호를 선택합니다.
-
새 클라이언트 암호를 선택합니다.
-
설명을 입력하고 만료 기간을 선택합니다.
-
추가를 선택합니다.
-
값을 즉시 복사합니다. 이 값은 한 번만 표시됩니다.
중요
보안 암호 ID가 아닌 보안 암호 값을 복사합니다. 값은 인증에 사용되는 더 긴 문자열입니다.
API 권한 구성
Microsoft Graph는이 통합에 대해 두 가지 권한 유형을 지원합니다. 위임된 권한을 통해 앱은 로그인한 사용자를 대신하여 작업할 수 있습니다. 애플리케이션 권한을 사용하면 앱이 로그인한 사용자 없이 작동할 수 있습니다. 자세한 내용은 Microsoft 설명서의 Microsoft 그래프 권한 개요를
-
앱 등록에서 API 권한을 선택합니다.
-
권한 추가를 선택한 다음 Microsoft 그래프를 선택합니다.
-
인증 방법을 기반으로 위임된 권한 또는 애플리케이션 권한을 선택하고 아래 해당 표의 권한을 추가합니다.
-
[테넌트 이름]에 대한 관리자 동의 부여를 선택하여 권한을 승인합니다.
사용자 인증(위임된 권한)의 경우:
Entra 앱 등록에 다음을 위임 권한으로 추가합니다. 전체 권한 참조는 Microsoft 설명서의 Microsoft Graph 권한 참조
| 권한 | 설명 |
|---|---|
Chat.ReadWrite |
앱이 로그인한 사용자의 채팅 메시지를 읽고 쓸 수 있도록 허용합니다. |
ChatMessage.Send |
앱이 로그인한 사용자를 대신하여 채팅 메시지를 보내도록 허용합니다. |
Team.ReadBasic.All |
앱이 로그인한 사용자를 대신하여 팀의 이름과 설명을 읽을 수 있도록 허용합니다. |
Channel.ReadBasic.All |
앱이 로그인한 사용자를 대신하여 채널 이름과 설명을 읽을 수 있도록 허용합니다. |
Channel.Create |
앱이 로그인한 사용자를 대신하여 모든 팀에 채널을 생성할 수 있도록 허용합니다. |
ChannelMessage.Read.All |
앱이 로그인한 사용자를 대신하여 모든 채널 메시지를 읽을 수 있도록 허용합니다. |
ChannelMessage.Send |
앱이 로그인한 사용자를 대신하여 채널에서 메시지를 보내도록 허용합니다. |
ChannelMember.ReadWrite.All |
앱이 로그인한 사용자를 대신하여 채널에서 멤버를 추가하고 제거할 수 있습니다. |
TeamMember.ReadWrite.All |
앱이 로그인한 사용자를 대신하여 모든 팀에서 멤버를 추가하고 제거할 수 있도록 허용합니다. |
User.Read.All |
앱이 로그인한 사용자를 대신하여 모든 사용자의 전체 프로필 속성 세트를 읽을 수 있도록 허용합니다. |
OnlineMeetings.ReadWrite |
앱이 로그인한 사용자를 대신하여 온라인 회의를 읽고 생성할 수 있도록 허용합니다. |
OnlineMeetingTranscript.Read.All |
앱이 로그인한 사용자를 대신하여 온라인 회의의 모든 기록을 읽을 수 있도록 허용합니다. |
Calendars.ReadWrite |
앱이 로그인한 사용자를 대신하여 사용자 일정에서 이벤트를 읽고 쓸 수 있도록 허용합니다. |
offline_access |
사용자가 다시 로그인할 필요 없이 앱이 액세스 토큰을 새로 고칠 수 있도록 허용합니다. 이렇게 하면 사용자가 재인증해야 하는 빈도가 줄어듭니다. |
서비스 인증(애플리케이션 권한)의 경우:
Entra 앱 등록에 다음을 애플리케이션 권한으로 추가합니다.
| 권한 | 설명 |
|---|---|
Chat.Read.All |
앱이 로그인한 사용자 없이 조직의 모든 채팅 메시지를 읽을 수 있도록 허용합니다. |
Chat.Send |
앱이 로그인한 사용자 없이 채팅 메시지를 보내도록 허용합니다. |
Team.ReadBasic.All |
앱이 로그인한 사용자 없이 모든 팀의 이름과 설명을 읽을 수 있도록 허용합니다. |
Channel.ReadBasic.All |
앱이 로그인한 사용자 없이 모든 채널 이름과 설명을 읽을 수 있도록 허용합니다. |
ChannelMessage.Read.All |
앱이 로그인한 사용자 없이 모든 채널 메시지를 읽을 수 있도록 허용합니다. |
ChannelMessage.Send |
앱이 로그인한 사용자 없이 모든 채널에 메시지를 보낼 수 있도록 허용합니다. |
ChannelMember.ReadWrite.All |
앱이 로그인한 사용자 없이 모든 채널에서 멤버를 추가 및 제거할 수 있습니다. |
TeamMember.ReadWrite.All |
앱이 로그인한 사용자 없이 모든 팀에서 멤버를 추가 및 제거할 수 있습니다. |
User.Read.All |
앱이 로그인한 사용자 없이 모든 사용자의 전체 프로필 속성 세트를 읽을 수 있도록 허용합니다. |
OnlineMeetingTranscript.Read.All |
앱이 로그인한 사용자 없이 온라인 회의의 모든 기록을 읽을 수 있도록 허용합니다. |
중요
서비스 인증을 사용하면 모든 작업이 서비스 계정으로 실행됩니다. 이 통합에 액세스할 수 있는 모든 사용자는 서비스 계정이 액세스할 수 있는 모든 팀 및 채널에서 작업을 수행할 수 있습니다. 조직의 보안 요구 사항에 맞게 애플리케이션 권한 범위를 적절하게 지정합니다.
자격 증명 기록
Microsoft Entra 관리자 센터를 떠나기 전에 다음 값이 있는지 확인합니다. Amazon Quick 구성에 필요합니다.
| 값 | 찾을 수 있는 위치 |
|---|---|
| 애플리케이션(클라이언트) ID | 앱 등록 개요 페이지 |
| 디렉터리(테넌트) ID | 앱 등록 개요 페이지 |
| 클라이언트 시크릿 값 | 인증서 및 보안 암호 페이지 |
Amazon Quick에서 통합 설정
Entra 구성을 완료한 후 Amazon Quick에서 통합을 생성합니다.
-
Amazon Quick 콘솔에서 통합을 선택합니다.
-
추가 기능 탭을 선택합니다.
-
Microsoft Teams를 선택하고 추가(더하기 "+") 버튼을 선택합니다.
-
통합 세부 정보를 입력합니다.
-
이름 - Teams 통합에 대한 설명 이름입니다.
-
설명(선택 사항) - 통합의 목적입니다.
-
-
연결 유형을 선택하고 연결 설정을 입력합니다.
-
사용자 인증(OAuth)에서 다음 필드를 구성합니다.
기본 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 -
https://{region}.quicksight.aws.amazon.com/sn/oauthcallback
-
서비스 인증에서 다음 필드를 구성합니다.
클라이언트 ID - Entra 앱 등록의 애플리케이션(클라이언트) ID입니다.
클라이언트 보안 암호 - Entra 앱 등록의 클라이언트 보안 암호 값입니다.
토큰 URL -
https://login.microsoftonline.com/{tenant-id}/oauth2/v2.0/token범위 -
.default
-
-
Create and continue를 선택합니다.
-
통합을 공유할 사용자를 선택합니다.
-
다음을 선택합니다.
사용 가능한 작업
통합을 설정한 후 다음 작업을 사용할 수 있습니다.
| 카테고리 | 작업 | 설명 |
|---|---|---|
| Chats | 채팅 나열 | 채팅 대화를 봅니다. |
| Chats | 채팅 생성 | 새 채팅 대화를 시작합니다. |
| Chats | 채팅 메시지 전송 | 채팅으로 메시지를 보냅니다. |
| 팀 | 팀 나열 | 멤버인 팀을 봅니다. |
| 팀 | 팀원 나열 | 팀 구성원을 봅니다. |
| 팀 | 팀원 추가 | 팀원을 팀에 추가합니다. |
| 채널 | 채널 나열 | 팀의 채널을 봅니다. |
| 채널 | 채널 생성 | 팀에서 새 채널을 생성합니다. |
| 채널 | 채널 메시지 나열 | 채널에서 메시지를 봅니다. |
| 채널 | 채널 메시지 전송 | 채널에 메시지를 게시합니다. |
| 채널 | 채널 멤버 나열 | 채널의 멤버를 봅니다. |
| 채널 | 채널 멤버 추가 | 채널에 멤버를 추가합니다. |
| Users | 사용자 목록 표시 | 조직의 사용자를 봅니다. |
| 회의 | 온라인 회의 나열 | 예약된 온라인 회의를 봅니다. |
| 회의 | 온라인 회의 생성 | 새 온라인 회의를 예약합니다. |
| 회의 | 회의 트랜스크립트 나열 | 회의의 트랜스크립트를 봅니다. |
| 캘린더 | 일정 이벤트 나열 | 일정에서 이벤트를 봅니다. |
| 캘린더 | 일정 이벤트 생성 | 새 일정 이벤트를 생성합니다. |
관리 및 문제 해결
통합을 편집, 공유 또는 삭제하려면 섹션을 참조하세요기존 통합 관리.
인증 문제
-
잘못된 앱 등록 - 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와 일치하는 사용자 계정이 테넌트에 있는지 확인합니다.
