Integrations configuration settings

plans-img 모든 플랜 에서 사용 가능

deployment-img Cloud 와 self-hosted 배포판

자체 호스팅 및 클라우드 관리자는 시스템 콘솔 > 통합 에서 다음 구성 설정에 액세스할 수 있습니다. 자체 호스팅된 관리자는 다음 표에 설명된대로 config.json 파일을 편집할 수도 있습니다.

통합 관리

들어오는 웹훅 활성화

통합을 구축하는 개발자는 공개 및 비공개 채널을 위해 웹훅 URL을 생성할 수 있습니다. 웹훅을 작성하고 샘플을 보거나 구축한 통합을 커뮤니티에 알리려면 문서 페이지 를 참조하세요.

True : 들어오는 웹훅이 허용됩니다. 웹훅 URL은 외부 응용 프로그램에서 사용할 수 있으며 여러분이 액세스할 수 있는 모든 공개 또는 비공개 채널에 게시글을 작성할 수 있습니다.

False : Mattermost 제품 메뉴의 통합 > 들어오는 웹훅 섹션이 숨겨지고 모든 들어오는 웹훅이 비활성화됩니다.

Important

보안 참고: 이 기능을 활성화하면 사용자가 다른 사용자를 흉내 내려는 피싱 공격 을 시도할 수 있습니다. 이러한 공격을 방지하기 위해 웹훅에서 모든 게시물 옆에 BOT 태그가 나타납니다. 본인 책임 하에 활성화하세요.

이 기능의 config.json 설정은 옵션 true 및 false을 사용하여 "EnableIncomingWebhooks": true로 설정됩니다.

나가는 웹훅 사용 설정

통합을 구축하는 개발자는 공개 채널에 대한 웹훅 토큰을 생성할 수 있습니다. 트리거 단어는 외부 통합에 새로운 메시지 이벤트를 전달하는 데 사용됩니다. 보안상의 이유로 나가는 웹훅은 공개 채널에서만 사용할 수 있습니다. 웹훅을 작성하고 샘플을 보려면 문서 페이지 를 참조하세요.

True : 나가는 웹훅이 허용됩니다. Mattermost 제품 메뉴에서 통합 을 선택하여 나가는 웹훅을 관리할 수 있습니다.

False : Mattermost 제품 메뉴의 통합 > 나가는 웹훅 이 숨겨지며 모든 나가는 웹훅이 비활성화됩니다.

Important

보안 주의: 이 기능을 활성화하면 사용자가 다른 사용자를 흉내내는 피싱 공격 을 시도할 수 있습니다. 이러한 공격을 방지하기 위해 웹훅에서 게시된 모든 게시물 옆에는 BOT 태그가 나타납니다. 사용 시 리스크를 감수하십시오.

이 기능의 config.json 설정은 ``”EnableOutgoingWebhooks”: true``이며 ``true``와 ``false``의 옵션이 있습니다.

사용자 정의 슬래시 명령 활성화

슬래시 명령은 외부 통합에 이벤트를 전달하고 Mattermost로부터 응답을 받습니다.

True : 사용자가 주 메뉴 > 통합 > 명령 에서 사용자 정의 슬래시 명령을 생성할 수 있습니다.

False : 슬래시 명령은 통합 사용자 인터페이스에서 숨겨집니다.

이 기능의 config.json 설정은 옵션 true 및 false을 사용하여 "EnableCommands": false로 설정됩니다.

OAuth 2.0 서비스 제공자 활성화

True : Mattermost가 OAuth 2.0 서비스 제공자로 작동하여 외부 응용 프로그램에서 API 요청을 인가할 수 있습니다.

False : Mattermost가 OAuth 2.0 서비스 제공자로 작동하지 않습니다.

이 기능의 config.json 설정은 옵션 true 및 false을 사용하여 "EnableOAuthServiceProvider": true로 설정됩니다.

Note

클라우드 관리자는 이 구성 설정을 수정할 수 없습니다.

통합 요청 시간 초과

외부 통합 HTTP 요청에 대기하는 시간(타임아웃)으로, 사용자 정의 슬래시 명령, 외부 웹훅, 대화형 메시지, 그리고 대화형 대화 상자 를 포함합니다. HTTP 응답을 생성하는 데 시간이 오래 걸리거나 지연된 응답이 발생하는 경우 이 값을 증가시키십시오.

이 기능의 config.json 설정은 "OutgoingIntegrationRequestsDefaultTimeout": 30 입니다.

통합에서 사용자 이름 무시 활성화

True웹훅, 슬래시 명령, OAuth 2.0 앱 등의 통합에 의해

다른 통합은 게시하는 사용자 이름을 변경할 수 있습니다. 사용자

이름이 없는 경우 게시의 사용자 이름은 False 설정의 경우와 동일합니다.

False : 사용자 정의 슬래시 명령이 슬래시 명령을 사용한 사용자의 사용자 이름으로만 게시할 수 있습니다. OAuth 2.0 앱은 통합을 설정한 사용자의 사용자 이름으로만 게시할 수 있습니다. 들어오는 웹훅 및 나가는 웹훅의 경우 사용자 이름은 “웹훅”입니다. 자세한 내용은 https://developers.mattermost.com/integrate/other-integrations/ 을 참조하세요.

이 기능의 config.json 설정은 ``”EnablePostUsernameOverride”: false``이며 옵션은 ``true``와 ``false``입니다.

Enable integrations to override profile picture icons

True : 웹훅, 슬래시 명령어 및 기타 통합, 예를 들어 Zapier 와 같은 통합은 게시하는 프로필 이미지를 변경할 수 있습니다.

False : 웹훅, 슬래시 명령어 및 OAuth 2.0 앱은 설정된 계정의 프로필 이미지만 사용하여 게시할 수 있습니다. 자세한 내용은 https://developers.mattermost.com/integrate/other-integrations/를 참조하세요.

이 기능의 config.json 설정은 ``”EnablePostIconOverride”: false``이며 옵션은 ``true``와 ``false``입니다.

개인 액세스 토큰 사용 가능하게 하기

True : 사용자는 프로필 > 보안 에서 개인 액세스토큰 을 생성할 수 있습니다. 이를 사용하여 API에 인증하고 계정에 대한 완전한 액세스 권한을 부여할 수 있습니다.

개인 액세스 토큰을 생성할 수 있는 사용자 또는 토큰 ID로 사용자를 검색할 수 있는 사용자를 관리하려면 시스템 콘솔 > 사용자 페이지로 이동하세요.

False : 서버에서 개인 액세스 토큰이 비활성화됩니다.

이 기능의 config.json 설정은 ``”EnableUserAccessTokens”: false``이며 옵션은 ``true``와 ``false``입니다.

봇 계정

시스템 콘솔에서 통합 > 봇 계정 으로 이동하여 다음 구성 설정에 액세스하세요.

봇 계정 생성 활성화

True: (클라우드 배포의 기본값) 사용자는 통합 > 봇 계정 에서 통합을 위한 봇 계정을 생성할 수 있습니다. 봇 계정은 사용자 계정과 유사하지만 로그인에 사용할 수 없습니다. 자세한 내용은 문서 를 참조하세요.

False: (셀프 호스팅 배포의 기본값) 봇 계정은 사용자 인터페이스나 RESTful API를 통해 생성할 수 없습니다. 플러그인은 여전히 봇 계정을 생성하고 관리할 수 있습니다.

이 기능의 config.json 설정은 ``”EnableBotAccountCreation”: false``이며 옵션은 ``true``와 ``false``입니다.

소유자 비활성화 시 봇 계정 비활성화

True: 사용자가 비활성화되면 해당 사용자가 관리하는 모든 봇 계정이 비활성화됩니다. 봇 계정을 다시 활성화하려면 통합 > 봇 계정 으로 이동하세요.

False: 사용자가 비활성화되면 해당 사용자가 관리하는 모든 봇 계정이 활성 상태로 유지됩니다.

이 기능의 config.json 설정은 ``”DisableBotsWhenOwnerIsDeactivated”: false``이며 옵션은 ``true``와 ``false``입니다.

GIF (베타)

시스템 콘솔에서 통합 > GIF (베타) 로 이동하여 다음 구성 설정에 액세스하세요.

GIF 선택기 활성화

True: 사용자가 Gfycat 통합을 통해 이모지 선택기에서 GIF를 선택할 수 있습니다.

False: 이모지 선택기에서 GIF를 선택할 수 없습니다.

이 기능의 config.json 설정은 ``”EnableGifPicker”: true``이며 옵션은 ``true``와 ``false``입니다.

Note

링크 미리보기 가 활성화되어야 GIF 링크 미리보기를 표시할 수 있습니다. 방화벽 뒤에서 액세스가 제한된 Mattermost 배포에서는 이 기능이 작동하려면 포트 443을 https://api.gfycat.com/v1 및 https://gfycat.com/<id> (모든 요청 유형에 대해) 양쪽으로 열어야 합니다.

Gfycat API 키

공백인 경우 Gfycat에서 제공하는 기본 API 키를 사용합니다. 또한 https://developers.gfycat.com/signup/#/ 에서 고유한 API 키를 요청할 수 있습니다. 이메일로 받은 클라이언트 ID를 이 필드에 입력하세요.

이 기능의 config.json 설정은 ``”GfycatApiKey”: “2_KtH_W5”``이며 문자열 입력입니다.

Gfycat API 비밀

Gfycat에서 API 키에 대해 생성한 API 비밀입니다. 공백인 경우 Gfycat에서 제공하는 기본 API 비밀을 사용합니다.

이 기능의 config.json 설정은 ``”GfycatApiSecret”: “3wLVZPiswc3DnaiaFoLkDvB4X0IV6CpMkj4tf2inJRsBY6-FnkT08zGmppWFgeof”``이며 문자열 입력입니다.

CORS

시스템 콘솔에서 통합 > CORS 로 이동하여 다음 구성 설정에 액세스하세요.

허용된 출처에서 교차 출처 요청 활성화

특정 도메인에서 HTTP 교차 출처 요청을 활성화합니다.

  • 어떤 도메인에서든 CORS를 허용하려면 * 를 입력하십시오.

  • 특정 도메인 또는 여러 도메인을 공백으로 구분하여 입력하십시오.

  • 어떤 도메인에서든 CORS를 방지하려면 null 을 입력하십시오.

  • 비워두어 Mattermost 사이트 URL 을 사용하지 않고 비활성화하십시오.

이 설정을 활성화하기 전에 사이트 URL 을 입력했는지 확인하여 저장 후 시스템 콘솔 접근을 잃지 않도록 하십시오. 이 설정을 변경한 후 시스템 콘솔 접근을 잃으면 config.json 파일을 통해 사이트 URL을 설정할 수 있습니다.

이 기능의 config.json 설정은 ``”AllowCorsFrom”: “”``이며 문자열 입력입니다.

CORS 노출된 헤더

요청자가 액세스할 수 있는 헤더의 화이트리스트입니다.

이 기능의 config.json 설정은 ``”CorsExposedHeaders”: “”``이며 문자열 입력입니다.

CORS 자격 증명 허용

True: 검증을 통과한 요청은 Access-Control-Allow-Credentials 헤더를 포함합니다.

False: 요청은 Access-Control-Allow-Credentials 헤더를 포함하지 않습니다.

이 기능의 config.json 설정은 ``”CorsAllowCredentials”: false``이며 옵션은 ``true``와 ``false``입니다.

CORS 디버그

True: CORS를 사용하는 통합 개발 시 로그에 메시지를 출력합니다. 이 메시지에는 구조화된 키 값 쌍 "source": "cors" 가 포함됩니다.

False: 디버그 메시지를 로그에 출력하지 않습니다.

이 기능의 config.json 설정은 ``”CorsDebug”: false``이며 옵션은 ``true``와 ``false``입니다.