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

# Zoom 통합
<a name="zoom-integration"></a>

Zoom 작업 커넥터를 사용하면 자연어를 통해 Amazon Quick에서 직접 Zoom 플랫폼에 액세스할 수 있습니다. Amazon Quick을 나가지 않고도 회의를 생성 및 관리하고, 녹음 및 회의 요약에 액세스하고, 웨비나 세부 정보를 보고, 연락처를 검색할 수 있습니다.

Amazon Quick은 Zoom에 대한 여러 인증 방법을 지원합니다. 조직의 보안 요구 사항에 가장 적합한 방법을 선택합니다.
+ **기본 OAuth 앱** AWS- 관리형 OAuth 애플리케이션을 사용합니다. 추가 자격 증명은 필요하지 않습니다. 사용자는 Zoom 계정으로 직접 인증합니다.
+ **사용자 지정 OAuth 앱** - Zoom App Marketplace에 등록된 고객 관리형 OAuth 애플리케이션을 사용합니다. 이 옵션을 사용하면 조직에서 OAuth 구성을 완전히 제어할 수 있습니다.

Amazon Quick에서 지원하는 인증 방법에 대한 자세한 내용은 섹션을 참조하세요[인증 방법](quick-action-auth.md).

## 시작하기 전 준비 사항
<a name="zoom-integration-prerequisites"></a>

통합을 설정하기 전에 다음 사항이 있는지 확인합니다.
+ 사용하려는 회의, 레코딩 및 웨비나에 액세스할 수 있는 활성 Zoom 계정입니다.
+ **사용자 지정 OAuth 앱**의 경우: [Zoom 웹 사이트에서 Zoom App Marketplace](https://marketplace.zoom.us/)에 액세스하여 앱을 생성합니다.
+ Amazon Quick 구독 요구 사항은 섹션을 참조하세요[콘솔에서 통합 설정](integration-console-setup-process.md).

## 확대/축소 구성
<a name="zoom-source-setup"></a>

**기본 OAuth 앱** 인증을 사용하는 경우이 섹션을 건너뛰고 로 이동합니다[Amazon Quick에서 커넥터 설정](#zoom-quicksuite-setup).

사용자 지정 OAuth 앱 인증의 경우 Amazon Quick을 구성하기 전에 Zoom App Marketplace에서 다음 단계를 완료합니다.

### Zoom 앱 생성(사용자 지정 OAuth 앱)
<a name="zoom-register-oauth"></a>

Zoom App Marketplace에서 앱을 생성하여 Amazon Quick에 필요한 클라이언트 자격 증명을 가져옵니다. 자세한 내용은 Zoom 개발자 웹 사이트의 [OAuth](https://developers.zoom.us/docs/integrations/oauth/)를 참조하세요.

1. [Zoom 웹 사이트에서 Zoom App Marketplace](https://marketplace.zoom.us/)에 로그인하고 앱 생성 포털로 이동합니다.

1. 새로운 애플리케이션을 생성합니다. 사용자 기반 OAuth의 경우 **일반**을 선택하고 service-to-service 인증의 경우 **Server-to-Server 간 OAuth**를 선택합니다.

1. **기본 정보** 탭의 **앱 자격 증명**에 다음 값을 기록합니다. Amazon Quick을 구성할 때 필요합니다.
   + **클라이언트 ID**
   + **클라이언트 보안 암호(client secret)**

1. **OAuth 정보** 섹션의 **승인된 리디렉션 URI**에 Amazon Quick 콜백 URL을 추가합니다. `https://{{{region}}}.quicksight.aws.amazon.com/sn/oauthcallback` 

1. **범위** 탭을 선택하고 **\+ 범위 추가를** 선택하여 통합에 필요한 권한을 선택합니다. 권장 범위는 섹션을 참조하세요[권장 범위](#zoom-oauth-scopes).

### 권장 범위
<a name="zoom-oauth-scopes"></a>

Zoom에 연결할 때 다음 범위가 요청됩니다. 사용자 지정 Zoom 앱을 생성할 때 범위 탭에서 이러한 **범위를** 추가합니다.


**확대/축소 권장 범위**  

| Scope | 설명 | 
| --- | --- | 
| meeting:read:list\_meetings | 회의를 나열합니다. | 
| meeting:read:meeting | 회의 세부 정보를 읽습니다. | 
| meeting:read:summary | 회의 요약을 읽습니다. | 
| meeting:read:list\_past\_participants | 과거 회의 참가자를 나열합니다. | 
| meeting:read:list\_past\_instances | 과거 회의 인스턴스를 나열합니다. | 
| meeting:write:meeting | 회의를 생성합니다. | 
| meeting:update:meeting | 회의를 업데이트합니다. | 
| meeting:delete:meeting | 회의를 삭제합니다. | 
| meeting:write:registrant | 회의 등록자를 추가합니다. | 
| cloud\_recording:read:list\_user\_recordings | 사용자 레코딩을 나열합니다. | 
| cloud\_recording:read:list\_recording\_files | 레코딩 파일을 나열합니다. | 
| cloud\_recording:delete:meeting\_recording | 회의 레코딩을 삭제합니다. | 
| webinar:read:webinar | 웨비나 세부 정보를 읽습니다. | 
| webinar:read:list\_webinars | 웨비나를 나열합니다. | 
| webinar:read:list\_past\_participants | 과거 웨비나 참가자를 나열합니다. | 
| webinar:read:list\_registrants | 웨비나 등록자를 나열합니다. | 
| webinar:write:registrant | 웨비나 등록자를 추가합니다. | 
| user:read:user | 사용자 정보를 읽습니다. | 
| user:read:settings | 사용자 설정을 읽습니다. | 
| user:read:list\_collaboration\_devices | 공동 작업 디바이스를 나열합니다. | 
| contact:read:list\_contacts | 연락처를 나열합니다. | 

**참고**  
화이트보드 및 마켓플레이스 기능에 대한 추가 범위도 요청됩니다. 위에 나열된 범위는 기본 회의, 녹음, 웨비나, 사용자 및 연락 작업을 다룹니다.

## Amazon Quick에서 커넥터 설정
<a name="zoom-quicksuite-setup"></a>

### 사용 가능 탭에서 연결
<a name="zoom-quick-connect"></a>

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

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

1. **사용 가능** 탭에서 확대/**축소**를 찾아 **연결을** 선택합니다.

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

대신 사용자 지정 OAuth 앱으로 커넥터를 구성하려면 아래 설명과 같이 **팀에 대해 생성** 탭을 사용합니다.

### 팀에 대해 생성 탭에서 생성
<a name="zoom-full-setup"></a>

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

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

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

1. 를 찾아 확대/**축소**를 선택합니다.
**참고**  
Zoom 커넥터가 이미 있는 경우 기존 커넥터와 함께 대화 상자가 나타납니다. 기존 커넥터를 사용하려면 선택합니다. 새로 생성하려면 **아니요, 새로 생성을** 선택합니다.

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

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

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

   1. **기본 OAuth 앱**의 경우:

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

   1. **사용자 지정 OAuth 앱**의 경우 다음 필드를 구성합니다.
      + **기본 URL**(선택 사항) - Zoom API 기본 URL입니다. 예시: `https://api.zoom.us`
      + **클라이언트 ID** - Zoom 앱의 클라이언트 ID입니다.
      + **클라이언트 보안 암호** - Zoom 앱의 클라이언트 보안 암호입니다.
      + **토큰 URL** - 토큰 엔드포인트입니다. 예시: `https://zoom.us/oauth/token`
      + **권한 부여 URL** - 권한 부여 엔드포인트입니다. 예시: `https://zoom.us/oauth/authorize`
      + **리디렉션 URL** - Amazon Quick 콜백 URL로 미리 채워집니다.

1. **다음**을 선택합니다.

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

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

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

1. **게시**를 선택합니다.

## 사용 가능한 작업
<a name="zoom-integration-actions"></a>

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


**사용 가능한 작업 확대/축소**  

| 카테고리 | 작업 | 설명 | 
| --- | --- | --- | 
| 회의 | 회의 나열 | 사용자의 회의를 나열합니다. | 
| 회의 | 회의 가져오기 | 특정 회의에 대한 세부 정보를 검색합니다. | 
| 회의 | 회의 생성 | 새 회의를 생성합니다. | 
| 회의 | 회의 업데이트 | 기존 회의를 업데이트합니다. | 
| 회의 | 회의 요약 가져오기 | 회의에 대한 AI 생성 요약을 검색합니다. | 
| 회의 | 회의 요약 템플릿 나열 | 사용 가능한 회의 요약 템플릿을 나열합니다. | 
| 회의 | 지난 회의 참가자 가져오기 | 지난 회의에서 참가자를 검색합니다. | 
| 회의 | 과거 회의 인스턴스 나열 | 반복 회의의 인스턴스를 나열합니다. | 
| 회의 | 회의 등록자 생성 | 회의에 등록자를 추가합니다. | 
| Recordings | 레코딩 나열 | 사용자의 모든 레코딩을 나열합니다. | 
| Recordings | 회의 레코딩 가져오기 | 특정 회의에 대한 레코딩을 검색합니다. | 
| Recordings | 보관된 파일 나열 | 아카이브된 레코딩 파일을 나열합니다. | 
| 웨비나 | 웨비나 나열 | 사용자에 대한 웨비나를 나열합니다. | 
| 웨비나 | 웨비나 가져오기 | 특정 웨비나에 대한 세부 정보를 검색합니다. | 
| 웨비나 | 웨비나 참가자 나열 | 웨비나 참가자를 나열합니다. | 
| 연락처 | 회사 연락처 검색 | 회사 디렉터리에서 연락처를 검색합니다. | 
| Devices | 디바이스 나열 | Zoom 디바이스를 나열합니다. | 
| Reports | 일일 사용 보고서 가져오기 | 일일 사용 보고서를 검색합니다. | 
| Users | 사용자 가져오기 | 인증된 사용자에 대한 정보를 검색합니다. | 

**참고**  
사용할 수 있는 작업은 Zoom 계정에 대해 구성된 권한과 인증된 사용자가 액세스할 수 있는 데이터에 따라 달라집니다.

## 관리 및 문제 해결
<a name="zoom-integration-troubleshooting"></a>

커넥터를 편집, 공유 또는 삭제하려면 섹션을 참조하세요[기존 통합 관리](integration-workflows.md#managing-existing-integrations).

### 인증 문제
<a name="zoom-troubleshooting-auth"></a>
+ **로그인 실패(기본 OAuth 앱 또는 사용자 지정 OAuth 앱)** - Zoom 계정이 활성 상태이고 Zoom 웹 사이트에서 [zoom.us](https://zoom.us) 직접 로그인할 수 있는지 확인합니다. 사용자 지정 OAuth 앱의 경우 Zoom 앱의 리디렉션 URI가 Amazon Quick 콜백 URL과 일치하는지 확인합니다.
+ **잘못된 클라이언트 자격 증명(사용자 지정 OAuth 앱)** - 클라이언트 ID와 클라이언트 보안 암호가 Zoom 앱의 값과 일치하는지 확인합니다. Zoom App Marketplace의 앱 설정에서 자격 증명을 볼 수 있습니다.
+ **권한 부족 **- Zoom 앱에 대해 구성된 범위에 사용하려는 작업에 필요한 권한이 포함되어 있는지 확인합니다. [권장 범위](#zoom-oauth-scopes)을(를) 참조하세요.