Hacktoberfest is here! Contribute, collaborate & earn rewards.
통합 구성 설정#
제품 
메뉴를 선택하고 시스템 콘솔 을 선택한 다음 통합 을 선택하여 시스템 콘솔에서 다음 통합 구성 옵션을 검토하고 관리하세요:
팁
자체 호스팅 Mattermost 배포를 관리하는 시스템 관리자는 다음 표에 설명된 대로 config.json 파일을 편집할 수 있습니다. 아래의 각 구성 값에는 JSON 인식 도구를 사용하여 config.json 파일에서 프로그래밍 방식으로 값에 접근하기 위한 JSON 경로가 포함되어 있습니다. 예를 들어, EnableIncomingWebhooks 값은 ServiceSettings 아래에 있습니다.
jq 와 같은 도구를 사용하는 경우 다음을 입력하세요:
cat config/config.json | jq '.ServiceSettings.EnableIncomingWebhooks'config.json파일을 수동으로 작업할 때는ServiceSettings와 같은 객체를 찾은 다음 해당 객체 내에서EnableIncomingWebhooks키를 찾으세요.
통합 관리#
통합 > 통합 관리 로 이동하여 시스템 콘솔에서 다음 구성 설정에 접근하세요.
인커밍 웹훅 활성화#
통합을 구축하는 개발자는 공개 채널과 비공개 채널용 웹훅 URL을 생성할 수 있습니다. 웹훅 생성, 샘플 확인, 구축한 통합을 커뮤니티에 알리는 방법에 대해 알아보려면 incoming webhooks 개발자 문서를 참조하세요.
True: 인커밍 웹훅이 허용됩니다. 인커밍 웹훅을 관리하려면 Mattermost 제품 메뉴에서 통합 을 선택하세요. 생성된 웹훅 URL은 외부 애플리케이션에서 접근 가능한 모든 공개 또는 비공개 채널에 게시물을 생성하는 데 사용할 수 있습니다.
False: Mattermost 제품 메뉴의 통합 > 인커밍 웹훅 섹션이 숨겨지고 모든 인커밍 웹훅이 비활성화됩니다.
중요
보안 참고사항: 이 기능을 활성화하면 사용자가 다른 사용자를 가장하여 phishing attacks 를 수행할 수 있습니다. 이러한 공격을 방지하기 위해 웹훅의 모든 게시물 옆에 BOT 태그가 표시됩니다. 위험을 감수하고 활성화하세요.
이 기능의 |
아웃고잉 웹훅 활성화#
통합을 구축하는 개발자는 공개 채널용 웹훅 토큰을 생성할 수 있습니다. 트리거 단어는 외부 통합에 새 메시지 이벤트를 발생시키는 데 사용됩니다. 보안상의 이유로 아웃고잉 웹훅은 공개 채널에서만 사용할 수 있습니다. 웹훅 생성 및 샘플 확인 방법에 대해 알아보려면 outgoing webhooks 개발자 문서를 참조하세요.
True: 아웃고잉 웹훅이 허용됩니다. 아웃고잉 웹훅을 관리하려면 Mattermost 제품 메뉴에서 통합 을 선택하세요.
False: Mattermost 제품 메뉴의 통합 > 아웃고잉 웹훅 이 숨겨지고 모든 아웃고잉 웹훅이 비활성화됩니다.
중요
보안 참고사항: 이 기능을 활성화하면 사용자가 다른 사용자를 가장하여 phishing attacks 를 수행할 수 있습니다. 이러한 공격을 방지하기 위해 웹훅의 모든 게시물 옆에 BOT 태그가 표시됩니다. 위험을 감수하고 활성화하세요.
이 기능의 |
참고
대규모 배포에서 이 구성 설정을 비활성화하면 다음과 같은 영역에서 서버 성능이 향상될 수 있습니다:
네트워크 트래픽 감소: 아웃고잉 웹훅은 외부 서비스에 네트워크 요청을 생성합니다. 이를 비활성화하면 해당 요청과 관련된 트래픽 및 리소스 사용량이 감소합니다.
서버 부하 감소: 웹훅 이벤트 처리 및 외부 서비스와의 연결 관리는 서버 리소스를 사용합니다. 아웃고잉 웹훅을 비활성화하면 서버 작업량이 감소하여 다른 중요한 작업에 더 많은 리소스를 할당할 수 있습니다.
응답 시간 개선: 아웃고잉 웹훅이 활성화되면 서버는 외부 서비스의 응답을 기다리며, 외부 서비스가 느리거나 응답하지 않는 경우 성능이 저하될 수 있습니다. 이를 비활성화하면 이러한 의존성이 제거되어 사용자 요청에 대한 응답 시간이 빨라집니다.
메모리 사용량 감소: 웹훅은 요청 및 응답에 대한 데이터를 처리하고 저장하기 위해 메모리가 필요합니다. 이를 비활성화하면 메모리가 확보되어 전반적인 서버 성능을 향상시키는 데 사용할 수 있습니다.
오류 처리 단순화: 아웃고잉 웹훅 실패에 대한 오류 및 재시도 관리는 복잡성과 오버헤드를 추가할 수 있습니다. 아웃고잉 웹훅을 비활성화하면 오류 처리가 단순화되고 관련된 처리 오버헤드가 감소합니다.
그러나 아웃고잉 웹훅은 Mattermost를 다른 서비스 및 워크플로우와 통합하는 데 필수적입니다. 성능 개선과 조직 및 사용자의 요구사항 사이의 균형을 맞추는 것이 중요합니다.
사용자 정의 슬래시 명령어 활성화#
슬래시 명령어는 Mattermost로 응답을 다시 보내는 외부 통합으로 이벤트를 전송합니다.
True: 사용자가 메인 메뉴 > 통합 > 명령어 에서 사용자 정의 슬래시 명령어를 생성할 수 있습니다.
False: 슬래시 명령어가 통합 사용자 인터페이스에서 숨겨집니다.
이 기능의 |
OAuth 2.0 서비스 제공자 활성화#
True: Mattermost가 OAuth 2.0 서비스 제공자 역할을 하여 외부 애플리케이션의 API 요청을 승인할 수 있습니다.
False: Mattermost가 OAuth 2.0 서비스 제공자로 작동하지 않습니다.
이 기능의 |
참고
클라우드 관리자는 이 구성 설정을 수정할 수 없습니다.
통합 요청 시간 초과#
외부 통합 HTTP 요청의 시간 초과 전 대기 시간(초)으로, custom slash commands, outgoing webhooks, interactive messages, interactive dialogs 가 포함됩니다. HTTP 응답을 생성하는 데 시간이 걸리거나 지연으로 인해 응답이 지연되는 외부 통합이 있는 경우 이 값을 늘리세요.
이 기능의 |
사용자 이름 재정의를 위한 통합 활성화#
True: 웹훅, 슬래시 명령어, OAuth 2.0 앱 및 기타 통합에서 게시하는 사용자 이름을 변경할 수 있습니다. 사용자 이름이 없는 경우 게시물의 사용자 이름은 False 설정과 동일합니다.
False: (기본값) 사용자 정의 슬래시 명령어는 슬래시 명령어를 사용한 사용자의 사용자 이름으로만 게시할 수 있습니다. OAuth 2.0 앱은 통합을 설정한 사용자의 사용자 이름으로만 게시할 수 있습니다. 인바운드 웹훅과 아웃바운드 웹훅의 경우 사용자 이름은 “webhook”입니다. 자세한 내용은 https://developers.mattermost.com/integrate/other-integrations/ 를 참조하세요.
이 기능의 |
프로필 사진 아이콘 재정의를 위한 통합 활성화#
True: 웹훅, 슬래시 명령어 및 기타 통합에서 게시하는 프로필 사진을 변경할 수 있습니다.
False: (기본값) 웹훅, 슬래시 명령어 및 OAuth 2.0 앱은 설정된 계정의 프로필 사진으로만 게시할 수 있습니다. 자세한 내용은 https://developers.mattermost.com/integrate/other-integrations/ 를 참조하세요.
이 기능의 |
개인 액세스 토큰 활성화#
True: 사용자는 프로필 > 보안 에서 통합을 위한 개인 액세스 토큰 <https://developers.mattermost.com/integrate/admin-guide/admin-personal-access-token/> 을 생성할 수 있습니다. 이 토큰은 API 인증에 사용되며 계정에 대한 전체 액세스 권한을 부여합니다.
개인 액세스 토큰을 생성할 수 있는 사용자를 관리하거나 토큰 ID로 사용자를 검색하려면 시스템 콘솔 > 사용자 페이지로 이동하세요.
False: 서버에서 개인 액세스 토큰이 비활성화됩니다.
이 기능의 |
봇 계정#
통합 > 봇 계정 으로 이동하여 시스템 콘솔에서 다음 구성 설정에 접근할 수 있습니다.
봇 계정 생성 활성화#
True: (클라우드 배포의 기본값) 사용자는 통합 > 봇 계정 에서 통합을 위한 봇 계정을 생성할 수 있습니다. 봇 계정은 로그인에 사용할 수 없다는 점을 제외하고는 사용자 계정과 유사합니다. 자세한 내용은 문서 를 참조하세요.
False: (자체 호스팅 배포의 기본값) 사용자 인터페이스나 RESTful API를 통해 봇 계정을 생성할 수 없습니다. 플러그인은 여전히 봇 계정을 생성하고 관리할 수 있습니다.
이 기능의 |
소유자가 비활성화될 때 봇 계정 비활성화#
True: 사용자가 비활성화되면 해당 사용자가 관리하는 모든 봇 계정이 비활성화됩니다. 봇 계정을 다시 활성화하려면 통합 > 봇 계정 으로 이동하세요.
False: 사용자가 비활성화되어도 해당 사용자가 관리하는 모든 봇 계정은 활성 상태로 유지됩니다.
이 기능의 |
GIF#
통합 > GIF 로 이동하여 시스템 콘솔에서 다음 구성 설정에 접근하세요.
GIF 선택기 활성화#
True: GIPHY 통합을 통해 사용자가 이모지 선택기에서 GIF를 선택할 수 있습니다.
False: 이모지 선택기에서 GIF를 선택할 수 없습니다.
이 기능의 |
중요
GIF 링크 미리보기를 표시하려면 링크 미리보기 를 활성화해야 합니다. 방화벽 뒤에서 접근이 제한된 Mattermost 배포는 이 기능이 작동하려면 포트 443(모든 요청 유형)을 열어야 합니다.
CORS#
통합 > CORS 로 이동하여 시스템 콘솔에서 다음 구성 설정에 접근하세요.
다음에서 교차 출처 요청 활성화#
특정 도메인에서 HTTP 교차 출처 요청을 활성화합니다.
모든 도메인에서 CORS를 허용하려면
*를 입력하세요.특정 도메인이나 공백으로 구분된 여러 도메인을 입력하세요.
모든 도메인에서 CORS를 방지하려면
null을 입력하세요.비활성화하고 Mattermost 사이트 URL 을 대신 사용하려면 비워두세요.
참고
저장 후 시스템 콘솔에 대한 접근 권한을 잃지 않도록 이 설정을 활성화하기 전에 사이트 URL 을 입력했는지 확인하세요. 이 설정을 변경한 후 시스템 콘솔에 대한 접근 권한을 잃은 경우 config.json 파일을 통해 사이트 URL을 설정할 수 있습니다.
이 기능의 |
CORS 노출 헤더#
요청자가 접근할 수 있는 헤더의 허용 목록입니다.
이 기능의 |
CORS 자격 증명 허용#
True: 유효성 검사를 통과한 요청에는 Access-Control-Allow-Credentials 헤더가 포함됩니다.
False: 요청에 Access-Control-Allow-Credentials 헤더가 포함되지 않습니다.
이 기능의 |
CORS 디버그#
True: CORS를 사용하는 통합을 개발할 때 도움이 되도록 로그에 메시지를 출력합니다. 이 메시지에는 구조화된 키-값 쌍 "source": "cors" 가 포함됩니다.
False: 디버그 메시지가 로그에 출력되지 않습니다.
이 기능의 |
임베딩#
통합 > 임베딩 으로 이동하여 시스템 콘솔에서 다음 구성 설정에 접근할 수 있습니다.
프레임 상위 요소#
iFrame을 통해 Mattermost 웹 클라이언트를 임베딩할 수 있는 도메인의 공백으로 구분된 목록을 입력하세요. 임베딩을 비활성화하려면 비워두세요. 기본값은 비어 있습니다.
이 기능의 |
참고
iFrame을 통해 Mattermost를 임베딩하면 조직의 기존 도구와 워크플로우에 원활한 협업 통합을 제공할 수 있습니다. 그러나 보안을 침해하지 않고 iframe과 상위 도메인 간의 통신을 허용하기 위해 올바른 구성이 설정되어 있는지 확인해야 합니다.