사용 가능 플랜: Entry, Professional, Enterprise, Enterprise Advanced

제품 메뉴를 선택하고 System Console을 선택한 후 Integrations를 선택하여 System Console에서 다음 통합 구성 옵션을 검토하고 관리하세요.

• 통합 관리
• 봇 계정
• GIF
• CORS

---

통합 관리#

System Console에서 Integrations > Integration Management로 이동하여 다음 구성 설정에 접근하세요.

수신 웹훅 활성화#

통합을 구축하는 개발자는 공개 채널 및 비공개 채널에 대한 웹훅 URL을 생성할 수 있습니다. 웹훅 생성, 샘플 보기, 구축한 통합에 대해 커뮤니티에 알리는 방법은 수신 웹훅 개발자 문서를 참조하세요.

True: 수신 웹훅이 허용됩니다. 수신 웹훅을 관리하려면 Mattermost Product 메뉴에서 Integrations를 선택하세요. 생성된 웹훅 URL은 외부 애플리케이션이 접근할 수 있는 공개 채널 또는 비공개 채널에 게시물을 만드는 데 사용할 수 있습니다.

False: Mattermost Product 메뉴의 Integrations > Incoming Webhooks 섹션이 숨겨지고 모든 수신 웹훅이 비활성화됩니다.

발신 웹훅 활성화#

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

True: 발신 웹훅이 허용됩니다. 발신 웹훅을 관리하려면 Mattermost Product 메뉴에서 Integrations를 선택하세요.

False: Mattermost Product 메뉴의 Integrations > Outgoing Webhooks가 숨겨지고 모든 발신 웹훅이 비활성화됩니다.

커스텀 슬래시 명령어 활성화#

슬래시 명령어는 외부 통합에 이벤트를 전송하고 외부 통합은 Mattermost에 응답을 다시 보냅니다.

True: 사용자가 Main Menu > Integrations > Commands에서 커스텀 슬래시 명령어를 만들 수 있습니다.

False: 슬래시 명령어가 Integrations 사용자 인터페이스에서 숨겨집니다.

OAuth 2.0 서비스 제공자 활성화#

True: Mattermost가 OAuth 2.0 서비스 제공자로 작동하여 외부 애플리케이션의 API 요청을 인가할 수 있습니다.

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

동적 클라이언트 등록 활성화#

True: 동적 클라이언트 등록(Dynamic Client Registration, DCR)을 활성화하여 애플리케이션이 POST /api/v4/oauth/apps/register 엔드포인트를 통해 관리자 개입 없이 프로그래밍 방식으로 OAuth 2.0 클라이언트를 등록할 수 있습니다.

False: 동적 클라이언트 등록이 비활성화됩니다. OAuth 2.0 애플리케이션은 System Console을 통해 수동으로 등록해야 합니다.

DCR 리다이렉트 URI 허용 목록#

OAuth 동적 클라이언트 등록(DCR)에 허용된 리다이렉트 URI의 쉼표로 구분된 목록입니다. 구성하면 DCR 엔드포인트(POST /api/v4/oauth/apps/register)를 통해 등록되는 OAuth 클라이언트 중 이 목록의 항목과 일치하는 리다이렉트 URI를 가진 클라이언트만 수락됩니다. 비워 두면 모든 리다이렉트 URI를 허용합니다.

System Console에서 URI를 쉼표로 구분된 목록으로 입력하세요. config.json에서 직접 또는 환경 변수를 통해 이 값을 설정할 때는 URI를 JSON 문자열 배열로 제공하세요(예: ["https://example.com/callback", "https://app.example.com/oauth"]).

이 설정은 동적 클라이언트 등록 활성화가 활성화된 경우에만 적용됩니다.

리다이렉트 URI는 URL 구성 요소별로 일치시킵니다. 패턴은 두 가지 와일드카드를 지원합니다.

• *는 /를 제외한 모든 문자와 일치합니다(예: 단일 경로 세그먼트 또는 호스트명 레이블).
• **는 /를 포함한 모든 문자와 일치합니다(예: 다중 세그먼트 경로).

와일드카드는 URL 구성 요소 내에서만 적용됩니다. 호스트 와일드카드는 호스트와 일치하고, 경로 와일드카드는 경로와 일치하며, 한 구성 요소의 와일드카드가 다른 구성 요소를 충족할 수 없습니다. 예를 들어 https://*.example.com/**는 https://app.example.com/callback과 일치하지만 https://attacker.example.net과는 일치하지 않습니다.

쿼리 문자열은 패턴에 명시적으로 포함된 경우에만 일치합니다. 쿼리 문자열이 없는 패턴(예: https://app.example.com/callback 또는 https://app.example.com/**)은 쿼리 문자열이 없는 리다이렉트 URI만 일치시킵니다. 쿼리 매개변수를 포함하는 리다이렉트 URI를 허용하려면 패턴에 쿼리 구성 요소를 포함하세요(예: https://app.example.com/callback?tenant=*). 쿼리 문자열이 있는 경우와 없는 경우 모두 콜백을 허용하려면 두 패턴을 모두 추가하세요.

통합 요청 타임아웃#

시간 초과 전에 커스텀 슬래시 명령어, 발신 웹훅, 인터랙티브 메시지, 인터랙티브 다이얼로그를 포함한 외부 통합 HTTP 요청을 기다리는 시간(초)입니다. 외부 통합이 HTTP 응답을 생성하는 데 시간이 걸리거나 지연 시간으로 인해 응답이 늦어지는 경우 이 값을 늘리세요.

통합이 사용자 이름을 재정의하도록 허용#

True: 웹훅, 슬래시 명령어, OAuth 2.0 앱 및 기타 통합이 게시하는 사용자 이름을 변경할 수 있습니다. 사용자 이름이 없으면 게시물의 사용자 이름은 False 설정과 동일합니다.

False: (기본값) 커스텀 슬래시 명령어는 슬래시 명령어를 사용한 사용자의 사용자 이름으로만 게시할 수 있습니다. OAuth 2.0 앱은 통합을 설정한 사용자의 사용자 이름으로만 게시할 수 있습니다. 수신 웹훅 및 발신 웹훅의 경우 사용자 이름은 "webhook"입니다. 자세한 내용은 https://docs.mattermost.com/developers/integrate/getting-started/를 참조하세요.

통합이 프로필 사진 아이콘을 재정의하도록 허용#

True: 웹훅, 슬래시 명령어 및 기타 통합이 게시 시 사용하는 프로필 사진을 변경할 수 있습니다.

False: (기본값) 웹훅, 슬래시 명령어 및 OAuth 2.0 앱은 설정된 계정의 프로필 사진으로만 게시할 수 있습니다. 자세한 내용은 https://docs.mattermost.com/developers/integrate/getting-started/를 참조하세요.

개인 액세스 토큰 활성화#

True: 사용자가 Profile > Security에서 통합을 위한 개인 액세스 토큰을 만들 수 있습니다. 개인 액세스 토큰은 API 인증에 사용할 수 있으며 계정에 대한 전체 접근 권한을 부여합니다.

개인 액세스 토큰을 만들 수 있는 사람을 관리하거나 토큰 ID로 사용자를 검색하려면 System Console > Users 페이지로 이동하세요.

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

수신 웹훅 채널 잠금 강제#

활성화하면 모든 수신 웹훅이 지정된 채널에 잠겨야 하며 다른 채널에 메시지를 게시할 수 없습니다. 이를 통해 관리자는 웹훅 보안에 대한 더 큰 제어권을 갖고 웹훅이 의도된 채널에만 게시할 수 있도록 보장합니다.

True: 수신 웹훅은 특정 채널에 잠겨야 합니다. 웹훅을 생성하거나 편집할 때 이 채널에 고정 옵션이 자동으로 활성화되며 비활성화할 수 없습니다.

False: (기본값) 수신 웹훅 생성자는 이 채널에 고정을 선택하여 웹훅을 특정 채널에 잠글지, 아니면 웹훅 생성자가 구성원인 공개 채널 또는 비공개 채널에 게시하도록 허용할지 선택할 수 있습니다.

---

봇 계정#

System Console에서 Integrations > Bot Accounts로 이동하여 다음 구성 설정에 접근하세요.

봇 계정 생성 활성화#

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

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

소유자가 비활성화되면 봇 계정 비활성화#

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

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

---

GIF#

System Console에서 Integrations > GIF로 이동하여 다음 구성 설정에 접근하세요.

GIF 선택기 활성화#

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

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

---

CORS#

다음 구성 설정은 셀프 호스팅 배포에만 적용됩니다. System Console에서 Integrations > CORS로 이동하여 다음 구성 설정에 접근하세요.

교차 출처 요청 허용 도메인#

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

• *를 입력하면 모든 도메인에서 CORS를 허용합니다.
• 특정 도메인이나 공백으로 구분된 여러 도메인을 입력합니다.
• null을 입력하면 모든 도메인에서 CORS를 방지합니다.
• 비워 두면 비활성화되고 Mattermost 사이트 URL이 사용됩니다.

CORS 노출 헤더#

요청자가 접근할 수 있는 헤더의 허용 목록입니다.

CORS 자격 증명 허용#

True: 유효성 검사를 통과한 요청에 Access-Control-Allow-Credentials 헤더가 포함됩니다.

False: 요청에 Access-Control-Allow-Credentials 헤더가 포함되지 않습니다.

CORS 디버그#

True: CORS를 사용하는 통합을 개발할 때 도움이 되도록 로그에 메시지를 출력합니다. 이러한 메시지에는 구조화된 키-값 쌍 "source": "cors"가 포함됩니다.

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

---

임베딩#

다음 구성 설정은 셀프 호스팅 배포에만 적용됩니다. System Console에서 Integrations > Embedding으로 이동하여 다음 구성 설정에 접근하세요.

프레임 앵커#

iFrame을 통해 Mattermost 웹 클라이언트를 임베딩할 수 있는 도메인의 공백으로 구분된 목록을 입력하세요. 임베딩을 허용하지 않으려면 비워 두세요. 임베딩을 비활성화하려면 비워 두세요. 기본값은 비어 있습니다.