Microsoft Teams를 Mattermost에 연결하기#

plans-img Enterprise 플랜 에서 사용 가능

deployment-img Cloudself-hosted 배포

Mattermost와 Microsoft Teams가 혼합된 환경에서 Microsoft Teams의 실시간 채팅 알림을 Mattermost로 전달하여 정보 격차를 해소하세요.

Mattermost Academy Learn about integrating with Microsoft Teams

배포#

설정은 Microsoft Teams에서 시작하여 Mattermost에서 완료됩니다.

Azure에서 OAuth 애플리케이션 설정하기#

  1. 관리자 Azure 계정을 사용하여 portal.azure.com 에 로그인하세요.

  2. 앱 등록 으로 이동하세요.

  3. 페이지 상단에서 새 등록 을 선택하세요.

Azure에서 새 앱 등록을 생성하세요.
  1. 다음 값으로 양식을 작성하세요:

  • 이름: Mattermost MS Teams

  • 지원되는 계정 유형: 기본값 (단일 테넌트)

  • 플랫폼: Web

  • 리디렉션 URI: https://(MM_SITE_URL)/plugins/com.mattermost.msteams-sync/oauth-redirect

(MM_SITE_URL) 을 Mattermost 서버의 사이트 URL로 대체하세요. 양식을 제출하려면 등록 을 선택하세요.

Azure에서 새 Mattermost 앱을 등록하세요.
  1. 이 화면에서 Mattermost에서 플러그인을 구성하는 데 나중에 필요한 애플리케이션(클라이언트) ID디렉토리(테넌트) ID 를 기록하세요.

나중에 사용할 중요한 ID를 기록하세요.
  1. 왼쪽 창에서 인증서 및 비밀 로 이동하세요.

  2. 새 클라이언트 비밀 을 선택하세요. 설명을 입력하고 추가 를 선택하세요. 클라이언트 비밀 생성 후, 비밀 ID가 아닌 새 비밀 값을 복사하세요. 이 값은 나중에 Mattermost 시스템 콘솔에서 사용할 것입니다.

Azure에서 클라이언트 비밀 세부 정보를 입력하세요.
  1. 왼쪽 창에서 API 권한 으로 이동하세요.

  2. 권한 추가 를 선택한 다음 오른쪽 창에서 Microsoft Graph 를 선택하세요.

Azure에서 Mattermost 앱의 API 권한을 관리하세요.
  1. 위임된 권한 을 선택하고 아래로 스크롤하여 다음 권한을 선택하세요:

  • Chat.Read

  • ChatMessage.Read

  • Files.Read.All

  • offline_access

  • User.Read

  1. 양식을 제출하려면 권한 추가 를 선택하세요.

  2. 다음으로 권한 추가 > Microsoft Graph > 애플리케이션 권한 을 통해 애플리케이션 권한을 추가하세요.

  3. 다음 권한을 선택하세요:

  • Chat.Read.All

  • Presence.Read.All

  1. 양식을 제출하려면 권한 추가 를 선택하세요.

  2. 애플리케이션에 대한 권한을 부여하려면 관리자 동의 부여… 를 선택하세요.

측정된 API가 활성화되어 있는지 확인하세요(그리고 관련된 유료 구독이 있는지)#

채팅 알림을 구독하려면 OAuth 앱을 유료 Azure 구독과 연결해야 합니다. 이 설정을 완료하려면 https://learn.microsoft.com/en-us/graph/metered-api-setup 에서 지침을 따르세요.

중요

측정된 API를 구성하지 않으면 월별 변경 사항이 제한된 평가 모델 (Mattermost에서 구성 가능)을 사용해야 합니다. 속도 제한으로 인해 메시지 수신이 중단될 수 있으므로 실제 프로덕션 환경에서 평가 모델 구성을 사용하지 않는 것을 강력히 권장합니다. 자세한 내용은 이 Microsoft 문서 를 참조하세요.

Azure 내부 구성이 모두 완료되었습니다.

Mattermost에서 Microsoft Teams 통합 설치 및 구성#

중요

이 설치 지침은 v9.8.0(또는 그 이상)을 실행 중이고 PostgreSQL을 사용하도록 구성된 Mattermost 인스턴스가 이미 있다고 가정합니다. 이 Mattermost 통합은 MySQL 데이터베이스를 지원하지 않습니다.

  1. 시스템 관리자로 Mattermost 워크스페이스 에 로그인하세요.

  2. Mattermost에서 제품 메뉴 제품 메뉴 아이콘을 사용하여 채널과 협업 플레이북 사이를 탐색하세요. 에서 앱 마켓플레이스 를 선택하세요.

  3. MS Teams를 검색하거나 스크롤하여 설치 를 선택하세요.

  4. 설치가 완료되면 구성 을 선택하세요. 시스템 콘솔로 이동합니다.

  5. 위에서 Azure에서 OAuth 앱 설정 시 얻은 값으로 Tenant ID, Client ID, Client Secret 을 구성하세요.

추가 구성 옵션은 Microsoft Teams 플러그인 구성 설정 문서를 참조하세요.

참고

  • Mattermost v9.11.2(ESR)와 Mattermost Cloud v10부터 이 플러그인의 v2.0이 Mattermost 서버에 사전 패키지로 포함됩니다. Mattermost 배포가 v9.11.2 이전 버전인 경우 최신 플러그인 바이너리 릴리스 를 다운로드하여 시스템 콘솔 > 플러그인 관리 를 통해 서버에 업로드하세요.

  • 웹훅 시크릿과 암호화 키는 한 번만 표시되므로 복사본을 만드는 것을 권장합니다.

성능 모니터링#

Prometheus와 Grafana를 사용하여 이 플러그인에 대한 성능 모니터링성능 알림 을 설정할 수 있습니다.

  • 모니터링을 통해 데이터베이스 호출, HTTP 요청, API 지연 시간을 포함한 플러그인의 전반적인 상태를 사전에 검토할 수 있습니다.

  • 알림을 통해 통합이 오프라인 상태가 되는 등의 문제가 발생할 때 이를 감지하고 조치를 취할 수 있습니다.

Mattermost Cloud 배포를 위한 유용한 시작점으로 Grafana 대시보드가 GitHub 에서 제공됩니다. 이 대시보드는 Mattermost Cloud에서 사용하도록 설계되었으며, 지정된 namespace 로 필터링됩니다.

Microsoft Teams에 연결된 Mattermost 인스턴스의 Grafana 모니터링 대시보드 예시.

참고

자체 호스팅 Mattermost 배포에는 수정이 필요합니다. 도움을 받는 방법에 대한 자세한 내용은 아래 Get help 섹션을 참조하세요.

사용#

Microsoft Teams 동기화 사용을 시작하려면 연결된 Microsoft Teams 내에서 협업 제품 문서를 참조하세요.

업그레이드#

새 버전이 출시될 때마다 이 통합을 업데이트하는 것을 권장합니다. 일반적으로 업데이트는 원활하게 이루어지며 Mattermost의 사용자 경험을 방해하지 않습니다. 최신 릴리스, 사용 가능한 릴리스 및 호환성 고려사항은 Releases page 를 방문하세요.

자주 묻는 질문#

Mattermost의 이메일 주소가 Microsoft Teams의 이메일 주소와 일치하지 않습니다. 그래도 연결할 수 있나요?#

아니요. 현재는 동일한 이메일 주소를 가진 계정만 연결할 수 있습니다. Mattermost 계정과 일치하는 이메일 주소를 지정하세요.

다른 이메일 주소를 가진 Microsoft Teams 계정에 Mattermost 계정을 연결하는 것이 워크스페이스에 필요한 경우, 피드백을 공유할 수 있는 GitHub issue 가 열려 있습니다.

휴지 상태와 전송 중인 암호화는 어떻게 처리되나요?#

Mattermost 구성에 저장된 구성된 클라이언트 시크릿은 Microsoft Graph API에 대한 앱 전용 액세스에 사용됩니다. 사용자가 통합을 통해 Microsoft Teams에 연결하면, 결과적인 액세스 토큰은 암호화되어 Mattermost 데이터베이스에 저장되어 연결된 사용자를 대신하여 액세스에 사용됩니다. 통합과 Microsoft Graph API 간의 모든 통신은 TLS를 통해 이루어집니다.

알림이 활성화되면 연결된 사용자가 받은 채팅과 파일 첨부물이 해당 사용자와 통합에서 생성된 봇 계정 간의 다이렉트 메시지 채널에 게시물로 저장됩니다.

데이터베이스나 네트워크 보안 관련 고려사항이 있나요?#

Mattermost 인스턴스에 적용되는 것 이상의 통합 특정 사항은 없습니다.

준수 관련 고려사항(GDPR, PCI 등)이 있나요?#

Mattermost 인스턴스에 적용되는 것 이상의 통합 특정 사항은 없습니다.

이 통합은 어떻게 구성되어 있나요?#

이 통합은 Microsoft Graph API의 변경 알림을 구독합니다. 이러한 변경 알림은 Microsoft Teams 내의 새로운 채팅이나 업데이트된 채팅에 대해 Mattermost에 알립니다. 변경 알림을 수신하면, 통합은 앱 전용 액세스(클라이언트 시크릿을 통해)와 위임된 액세스(연결된 사용자를 통해)를 조합하여 이러한 채팅의 내용을 가져와 Mattermost 내에서 적절하게 표시합니다.

도움 받기#

Mattermost 고객은 Mattermost support case 를 열 수 있습니다. 버그를 보고하려면 Mattermost for Microsoft Teams Sync plugin repository 에 GitHub 이슈를 열어주세요.

질문, 피드백 및 도움이 필요하시면 Mattermost Community ServerIntegrations and Apps channel 에 참여하시면 도움을 받으실 수 있습니다.