Zoom을 Mattermost에 연결
Zoom을 Mattermost와 통합하여 회의 조정 및 앱 전환에 따른 마찰과 낭비 시간을 줄이세요. 설정은 Zoom에서 시작하여 Mattermost에서 구성으로 완료됩니다. Zoom 시스템 관리자가 Zoom에서 다음 단계를 수행해야 합니다.
Zoom을 Mattermost와 통합하여 회의 조정 및 앱 전환에 따른 마찰과 낭비 시간을 줄이세요. 팀이 Mattermost 채널에서 바로 자발적인 화상 통화를 시작하기 쉽게 만들어 보세요. Zoom 클라우드 녹화 및 전사본을 준비되면 바로 Mattermost에서 수신하세요.
배포#
설정은 Zoom에서 시작하여 Mattermost에서 구성으로 완료됩니다.
Zoom에서 OAuth 앱 등록#
Zoom 시스템 관리자가 Zoom에서 다음 단계를 수행해야 합니다.
Zoom은 OAuth 인증을 지원하며, 등록할 수 있는 OAuth Zoom 앱 유형은 계정 수준 과 사용자 수준 두 가지입니다. 조직의 보안 및 선호도에 따라 둘 중 하나를 사용할 수 있습니다.
- 계정 수준: Mattermost의 개별 사용자는 Mattermost 이메일을 확인하고 Zoom API를 통해 개인 회의 ID를 요청하여 인증됩니다. Mattermost와 Zoom 모두에서 사용자의 이메일 주소가 일치해야 합니다. 각 사용자가 개별적으로 권한을 부여하도록 하려면 대신 사용자 수준 Zoom 앱을 만드세요.
- 사용자 관리: Mattermost의 개별 사용자는 Mattermost 앱이 자신의 Zoom 계정에 접근하도록 권한을 부여해야 합니다. 관리자가 전체 Zoom 조직을 대신하여 접근을 승인하도록 하려면 대신 계정 수준 앱을 만드세요.
계정 수준 앱의 경우, 앱을 생성한 Zoom 계정과 연결된 Zoom 사용자만 이 통합을 사용할 수 있습니다. Zoom 계정 설정의 사용자 관리 섹션에서 사용자를 추가할 수 있습니다.
Mattermost용 계정 수준 Zoom 앱을 만들려면 다음 단계를 완료하세요.
- https://marketplace.zoom.us/ 로 이동하여 관리자로 로그인합니다.
- 오른쪽 상단에서 개발 을 선택한 다음 앱 빌드 를 선택합니다.
- 상단에서 개발 을 선택합니다. 마켓플레이스에 게시할 경우 프로덕션 을 선택하겠지만, 여기서는 그렇게 하지 않습니다.
- 왼쪽 상단의 편집 아이콘을 클릭하여 앱 이름을 편집할 수 있습니다.
- 앱 유형으로 관리자 관리 앱 을 선택합니다.
- 이제 클라이언트 ID 와 클라이언트 암호 를 확인할 수 있습니다. 플러그인을 사용하도록 Mattermost를 설정할 때 필요하므로 복사해 두세요.
- 유효한 OAuth 리다이렉트 URL \(`https://SITEURL/plugins/zoom/oauth2/complete`\) 을 입력하고 허용 목록 추가 아래에 동일한 URL을 추가합니다. `SITEURL` 은 Mattermost 서버 URL이어야 합니다.
- 앱에 사용자 스코프를 추가하려면 스코프 를 선택하고 다음 스코프를 추가합니다:
meeting:read:meeting(회의 세부 정보 검색),meeting:write:meeting(회의 생성 및 업데이트),user:read:user(사용자 프로필 정보 읽기),cloud_recording:read:recording(클라우드 녹화 파일 접근),archiving:read:list_archived_files(아카이브된 파일 목록 조회).
Mattermost용 사용자 관리 Zoom 앱을 만들려면 다음 단계를 완료하세요.
- https://marketplace.zoom.us/ 로 이동하여 관리자로 로그인합니다.
- 오른쪽 상단에서 개발 을 선택한 다음 앱 빌드 를 선택합니다.
- 상단에서 개발 을 선택합니다. 마켓플레이스에 게시할 경우 프로덕션 을 선택하겠지만, 여기서는 그렇게 하지 않습니다.
- 왼쪽 상단의 편집 아이콘을 클릭하여 앱 이름을 편집할 수 있습니다.
- 앱 유형으로 사용자 관리 앱 을 선택합니다.
- 이제 클라이언트 ID 와 클라이언트 암호 를 확인할 수 있습니다. 플러그인을 사용하도록 Mattermost를 설정할 때 필요하므로 복사해 두세요.
- 유효한 OAuth 리다이렉트 URL \(`https://SITEURL/plugins/zoom/oauth2/complete`\) 을 입력하고 허용 목록 추가 아래에 동일한 URL을 추가합니다. `SITEURL` 은 Mattermost 서버 URL이어야 합니다.
- 앱에 사용자 스코프를 추가하려면 스코프 를 선택하고 다음 스코프를 추가합니다:
meeting:read:meeting(회의 세부 정보 검색),meeting:write:meeting(회의 생성 및 업데이트),user:read:user(사용자 프로필 정보 읽기),cloud_recording:read:recording(클라우드 녹화 파일 접근),archiving:read:list_archived_files(아카이브된 파일 목록 조회).
웹훅 이벤트 구성#
Zoom 회의가 종료되면 채널에 공유된 원래 게시물이 자동으로 변경되어 회의가 종료되었으며 얼마나 지속되었는지를 표시할 수 있습니다. 이 기능을 활성화하려면 Mattermost 서버에 회의가 종료될 때마다 알리는 Zoom의 웹훅 구독을 만들어야 합니다. 그러면 Mattermost 서버가 원래 Zoom 메시지를 업데이트합니다.
- Zoom에서 앱을 편집하는 동안 왼쪽 기능 탭 아래에서 접근 을 선택합니다.
- 새 이벤트 구독 추가 를 선택하고
Zoom for Mattermost와 같은 이름을 지정합니다. - 이벤트 추가 버튼을 선택하고 모든 녹화 완료, 녹화 전사 파일 완료, 회의 시작, 회의 종료 를 추가합니다.
- 유효한 이벤트 알림 엔드포인트 URL
https://SITEURL/plugins/zoom/webhook?secret=WEBHOOKSECRET을 입력하고,SITEURL을 Mattermost URL로 변경합니다.WEBHOOKSECRET은 Mattermost 구성 중에 생성됩니다. - 저장 을 선택하여 웹훅 구성을 저장합니다.
- Zoom 웹훅 구성에서 이벤트 테스트 를 선택하여 웹훅이 활성 상태인지 확인합니다. Mattermost가 HTTP 200 응답을 반환하거나 Mattermost 플러그인 로그에 성공적인 전송이 표시되는지 확인합니다. 또한 UI에 표시된 시크릿 토큰 이 4단계의 이벤트 알림 엔드포인트 URL 에서 사용한
WEBHOOKSECRET값과 일치하는지 확인합니다. - 다음 섹션에서 사용하기 위해 페이지 상단의 시크릿 토큰 값을 복사합니다.
Mattermost 구성#
Mattermost 시스템 관리자가 Mattermost에서 다음 단계를 수행해야 합니다.
인앱 앱 마켓플레이스에서 Zoom 통합을 설치합니다:
웹훅 시크릿과 암호화 키의 복사본을 만들어 두는 것을 권장합니다. 한 번만 표시됩니다.
- Mattermost에서 제품 메뉴 를 열고 앱 마켓플레이스 를 선택합니다.
- Zoom을 검색하거나 스크롤하여 찾은 후 설치 를 선택합니다.
- 설치가 완료되면 구성 을 선택합니다. 시스템 콘솔로 이동합니다.
- Zoom 구성 페이지에서 다음과 같이 Zoom 상호 운용성을 활성화하고 구성한 다음 저장 을 선택합니다.
- 자체 호스팅 Zoom 배포의 경우,
https://YOUR-ZOOM.com및https://api.YOUR-ZOOM.com/v2와 같이 개인 클라우드 또는 온프레미스 Zoom 서버를 사용할 때의 Zoom URL 과 Zoom API URL 을 입력하고,YOUR-ZOOM을 Zoom 서버 URL로 변경합니다. Zoom의 벤더 호스팅 SaaS 서비스를 사용하는 경우 이 필드를 비워 두세요. - Mattermost용 계정 수준 Zoom 앱 을 만들었다면, 계정 수준 앱으로 OAuth 를 true 로 설정합니다. Mattermost용 사용자 수준 Zoom 앱을 만들었다면 이 값을 false 로 유지합니다.
- OAuth를 사용하여 사용자를 Zoom에 연결합니다. Zoom에서 OAuth 앱을 등록할 때 생성된 클라이언트 ID 와 클라이언트 암호 를 입력합니다.
- 저장 중 토큰 암호화 키 필드 옆의 재생성 을 선택하여 AES 암호화 키를 생성합니다. 이 값만 생성하면 되며, 다른 곳에서는 사용하지 않습니다.
- 웹훅 이벤트를 구성하는 경우, 웹훅 시크릿 필드 옆의 재생성 을 선택합니다. 이것이 Mattermost를 가리키는 웹훅 URL에서 사용할
WEBHOOKSECRET값입니다. - Zoom 웹훅 구성 페이지의 시크릿 토큰 을 플러그인 설정 Zoom 웹훅 시크릿 에 붙여넣습니다.
- (선택 사항) 회의 생성 제한 을 활성화하여 사용자가 공개 채널에서 회의를 만드는 것을 제한합니다.
- 저장 을 선택하여 변경 사항을 저장합니다.
활성화#
팀원들에게 Zoom 계정을 Mattermost에 연결 할 수 있음을 알립니다.
채널을 반복 Zoom 회의(매일, 매주 또는 Zoom의 반복 옵션을 사용하여 고정된 시간 없이 반복되도록 예약된 회의)에 구독하려면 /zoom subscription add [meeting ID] 슬래시 명령어를 사용하세요. 회의 ID는 Zoom 데스크톱 또는 웹 클라이언트에서 회의 세부 정보 페이지를 열거나 회의 초대 이메일에서 찾을 수 있습니다. 채널은 회의가 시작될 때 접근 링크와 함께 알림을 받습니다. 클라우드 녹화가 활성화되어 있고 회의가 녹화된 경우, 녹화 및 전사본은 준비되면 초기 메시지의 답글로 게시됩니다.
업그레이드#
새 버전이 출시될 때 이 통합을 업데이트하는 것을 권장합니다. 일반적으로 업데이트는 원활하게 이루어지며 Mattermost의 사용자 경험을 방해하지 않습니다. 최신 릴리스, 이전 릴리스 및 호환성 고려 사항은 릴리스 페이지 를 방문하세요.
사용#
Mattermost 내에서 Zoom 통화를 시작하려면 유료 Zoom 계정이 필요합니다. 처음 Zoom 회의를 만들 때 계정을 연결하라는 메시지가 표시될 수 있습니다. 자격 증명을 사용하여 Zoom 계정을 연결하는 지침을 따르세요.
오른쪽 창의 Zoom 아이콘을 선택하거나 채널이나 스레드에서 /zoom start 슬래시 명령어를 실행하여 통화를 시작합니다. 그러면 모든 채널 구성원이 회의에 참여할 수 있습니다. 회의 호스트는 통화를 시작한 사람입니다.
채널의 통화 초대를 선택하여 회의에 참여합니다.
/zoom settings 슬래시 명령어를 실행하여 회의 호스트로 Zoom 개인 회의 ID 사용 선호도를 설정합니다. 항상 개인 회의 ID를 사용하거나, 항상 새로운 고유 회의 ID를 사용하거나, 통화를 시작할 때마다 Mattermost가 선호도를 묻도록 설정할 수 있습니다.
/zoom subscription add [meeting ID] 로 Mattermost 채널을 반복 Zoom 회의에 구독합니다. 클라우드 녹화 및 전사본을 Mattermost에서 수신하려면 유료 Zoom 계정에서 활성화되어 있어야 합니다. 이를 활성화하려면 계정 소유자 또는 관리자로 Zoom 웹 포털 에 로그인하고, 계정 관리 > 계정 설정 으로 이동하여 녹화 탭을 선택하고 호스트가 클라우드에 세션을 녹화 및 저장하도록 허용 을 활성화합니다. 그런 다음 고급 클라우드 녹화 설정 에서 오디오 전사 체크박스를 선택합니다. 또는 사용자 수준에서 이러한 설정을 활성화하고 회의 호스트에게 녹화 권한을 할당합니다. 단계별 지침은 Zoom의 클라우드 녹화 설정 문서 와 오디오 전사 문서 를 참조하세요. 활성화되면 녹화된 회의에 대해 녹화 및 전사본이 준비되면 Mattermost에서 알림을 받습니다.
Mattermost RHS의 Zoom 버튼을 사용하여 새 회의를 만들면, 클라우드 녹화가 활성화되어 있고 회의가 녹화된 경우 녹화 및 전사본도 준비되면 초기 메시지의 답글로 게시됩니다.
추가 슬래시 명령어:
/zoom help- 사용 가능한 명령어 표시/zoom channel-settings- 현재 채널의 회의가 개인 회의 ID 또는 고유 회의 ID를 사용하는지 설정/zoom channel-settings list- 모든 채널 기본 설정 목록 조회/zoom subscription list- 구독된 모든 채널 목록 조회/zoom subscription add [meeting ID]- Mattermost 채널을 반복 Zoom 회의에 구독/zoom subscription remove [meeting ID]- Mattermost 채널의 반복 Zoom 회의 구독 취소
/zoom connect- Zoom 계정을 Mattermost에 연결/zoom disconnect- Zoom 계정을 Mattermost에서 연결 해제
커스터마이즈#
이 통합 에는 서버 및 웹 앱 부분이 모두 포함되어 있습니다.
- 서버:
/server디렉토리 내에서 통합의 서버 측을 구성하는 Go 파일을 찾을 수 있습니다. 다른 Go 애플리케이션과 마찬가지로 플러그인을 빌드합니다. - 웹 앱:
/webapp디렉토리 내에서 플러그인의 클라이언트 측을 구성하는 JS 및 React 파일을 찾을 수 있습니다. 필요에 따라 파일과 구성 요소를 수정합니다.npm run build를 실행하여 구문을 테스트합니다.
업그레이드#
새 버전이 출시될 때 이 통합을 업데이트하는 것을 권장합니다. 일반적으로 업데이트는 원활하게 이루어지며 Mattermost의 사용자 경험을 방해하지 않습니다. 최신 릴리스, 이전 릴리스 및 호환성 고려 사항은 릴리스 페이지 를 방문하세요.
도움 받기#
Mattermost 고객은 Mattermost 지원 케이스 를 열 수 있습니다. 버그를 보고하려면 Mattermost Zoom 플러그인 저장소 에서 GitHub 이슈를 열어주세요.
질문, 피드백 및 지원을 위해 Mattermost 커뮤니티 서버 의 공개 통합 및 앱 채널 에 참여하세요.
Mattermost Team Edition 및 Free 고객은 Mattermost 피어-투-피어 문제 해결 포럼 을 방문하여 글로벌 Mattermost 커뮤니티의 도움을 받을 수 있습니다.
