플러그인 구성 설정#

모든 플랜 에서 사용 가능

제품 메뉴를 선택하고 시스템 콘솔 을 선택한 다음 플러그인 을 선택하여 시스템 콘솔에서 다음 플러그인 구성 옵션을 검토하고 관리하세요:

플러그인 관리
통화
GitLab
GitHub
Jira
법적 보관
Microsoft 캘린더
MS Teams
성능 지표
협업 플레이북
사용자 만족도 설문
ServiceNow
Zoom
config.json 전용 설정

팁

자체 호스팅 Mattermost 배포를 관리하는 시스템 관리자는 다음 표에 설명된 대로 config.json 파일을 편집할 수 있습니다. 아래의 각 구성 값에는 JSON 인식 도구를 사용하여 config.json 파일에서 프로그래밍 방식으로 값에 접근할 수 있는 JSON 경로가 포함되어 있습니다. 예를 들어, Enable 값은 PluginSettings 아래에 있습니다.

jq 와 같은 도구를 사용하는 경우, cat config/config.json | jq '.PluginSettings.Enable' 를 입력하세요.
config.json 파일을 수동으로 작업할 때는 PluginSettings 와 같은 객체를 찾은 다음, 해당 객체 내에서 Enable 키를 찾으세요.

플러그인 관리#

플러그인 > 플러그인 관리 로 이동하여 시스템 콘솔에서 다음 구성 설정에 접근하세요.

플러그인 활성화#

true: (기본값) Mattermost 서버에서 플러그인을 활성화합니다. 자세한 내용은 Mattermost에서 플러그인 사용 문서를 참조하세요.
false: Mattermost 서버에서 플러그인을 비활성화합니다.

시스템 구성 경로: 플러그인 > 플러그인 관리
config.json 설정: PluginSettings > Enable > true
환경 변수: MM_PLUGINSETTINGS_ENABLE

참고

대규모 배포에서 이 구성 설정을 비활성화하면 다음과 같은 영역에서 서버 성능이 향상될 수 있습니다:

리소스 소비: 플러그인은 CPU, 메모리, 디스크와 같은 시스템 리소스를 소비합니다. 플러그인을 비활성화하면 이러한 리소스가 해제되어 핵심 Mattermost 애플리케이션이 더 효율적으로 실행될 수 있습니다.
복잡성 감소: 각 플러그인은 추가적인 로직과 처리 요구사항을 추가할 수 있습니다. 활성 플러그인 수를 줄이면 시스템의 복잡성과 잠재적 장애 지점이 감소합니다.
더 빠른 로드 시간: 플러그인을 비활성화하면 시스템이 초기화하고 관리해야 할 구성 요소가 줄어들어 서버 시작이 더 빨라지고 사용자 상호작용 중 지연 시간이 줄어들 수 있습니다.
안정성: 일부 플러그인에는 Mattermost 인스턴스의 전반적인 성능과 안정성에 영향을 미칠 수 있는 버그나 성능 문제가 있을 수 있습니다. 문제가 있거나 활용도가 낮은 플러그인을 비활성화하면 시스템의 안정성이 향상될 수 있습니다.
유지 관리 및 업데이트: 관리하는 플러그인 수를 줄이면 유지 관리 및 업데이트와 관련된 오버헤드가 감소하여 더 원활한 운영과 가동 중단 시간 감소에 기여할 수 있습니다.
그러나 플러그인은 Mattermost를 다른 서비스 및 워크플로우와 통합하는 데 필수적인 경우가 많습니다. 성능 개선과 조직 및 사용자의 요구사항 사이의 균형을 맞추는 것이 중요합니다.

플러그인 서명 필요#

참고

자체 호스팅 배포에서만 사용 가능

true: (기본값) 관리형 및 비관리형 플러그인에 대한 플러그인 서명 검증을 활성화합니다.
false: 관리형 및 비관리형 플러그인에 대한 플러그인 서명 검증을 비활성화합니다.

시스템 구성 경로: 플러그인 > 플러그인 관리
config.json 설정: PluginSettings > RequirePluginSignature > true
환경 변수: MM_PLUGINSETTINGS_REQUIREPLUGINSIGNATURE

참고

사전 패키지된 플러그인은 서명 검증의 대상이 아닙니다. Marketplace를 통해 설치된 플러그인은 다운로드 시점에 항상 서명 검증의 대상이 됩니다.
이 구성을 활성화하면 시스템 콘솔에서 플러그인 파일 업로드 가 비활성화됩니다.

자동 사전 패키지 플러그인#

true: (기본값) Mattermost는 활성화된 사전 패키지 플러그인을 자동으로 설치하고 업그레이드합니다. 새 버전이 설치된 경우 변경 사항이 적용되지 않습니다.
false: Mattermost는 사전 패키지 플러그인을 자동으로 설치하거나 업그레이드하지 않습니다. 오프라인 상태에서도 Marketplace에서 사전 패키지 플러그인을 수동으로 설치할 수 있습니다.

시스템 구성 경로: 플러그인 > 플러그인 관리
config.json 설정: PluginSettings > AutomaticPrepackagedPlugins > true
환경 변수: MM_PLUGINSETTINGS_AUTOMATICPREPACKAGEDPLUGINS

플러그인 업로드#

참고

자체 호스팅 배포에서만 사용 가능

true: 로컬 컴퓨터에서 Mattermost 서버로 플러그인을 업로드할 수 있습니다.
false: (기본값) 로컬 컴퓨터에서 Mattermost 서버로 플러그인 업로드를 비활성화합니다.

시스템 구성 경로: 플러그인 > 플러그인 관리
config.json 설정: PluginSettings > EnableUploads > false
환경 변수: MM_PLUGINSETTINGS_ENABLEUPLOADS

참고

플러그인 업로드가 활성화된 상태에서 플러그인 파일을 업로드할 때 Received invlaid response from the server 오류가 발생하면 일반적으로 MaxFileSize 설정이 플러그인 파일 업로드를 지원하기에 충분하지 않다는 것을 의미합니다. 추가 프록시 설정 업데이트가 필요할 수도 있습니다.
플러그인 서명 필요 설정이 활성화되면 플러그인 파일 업로드 기능이 비활성화됩니다.

Marketplace 활성화#

true: (기본값) 모든 시스템 관리자를 위해 Mattermost 서버에서 플러그인 Marketplace를 활성화합니다.
false: 모든 시스템 관리자를 위해 Mattermost 서버에서 플러그인 Marketplace를 비활성화합니다.

시스템 구성 경로: 플러그인 > 플러그인 관리
config.json 설정: PluginSettings > EnableMarketplace > true
환경 변수: MM_PLUGINSETTINGS_ENABLEMARKETPLACE

원격 Marketplace 활성화#

true: (기본값) Mattermost는 Marketplace URL 에 설정된 엔드포인트에 연결을 시도합니다. 연결이 실패하면 오류가 표시되고 Marketplace에는 사전 패키지된 플러그인과 설치된 플러그인만 표시됩니다.
false: Mattermost는 원격 Marketplace에 연결을 시도하지 않습니다. Marketplace에는 사전 패키지된 플러그인과 설치된 플러그인만 표시됩니다. Mattermost 서버가 인터넷에 연결할 수 없는 경우 이 설정을 사용하세요.

시스템 구성 경로: 플러그인 > 플러그인 관리
config.json 설정: PluginSettings > EnableRemoteMarketplace > true
환경 변수: MM_PLUGINSETTINGS_ENABLEREMOTEMARKETPLACE

참고

구성된 원격 marketplace URL에 접근하려면 Mattermost v9.1부터 이 구성 설정 값을 true 로 설정하세요.
Mattermost v9.0의 경우 구성된 원격 marketplace URL에 접근하려면 MM_FEATUREFLAGS_STREAMLINEDMARKETPLACE 기능 플래그를 false 로 설정하고 이 구성 설정을 true 로 설정해야 합니다.
각 Mattermost 호스트는 MarketplaceURL에 설정된 엔드포인트에 대한 네트워크 액세스 권한이 있어야 합니다.

Marketplace URL#

이 설정은 원격 Marketplace의 URL을 저장합니다.

문자열 입력. 기본값은 https://api.integrations.mattermost.com 입니다.

시스템 구성 경로: 플러그인 > 플러그인 관리
config.json 설정: PluginSettings > MarketplaceURL
환경 변수: MM_PLUGINSETTINGS_MARKETPLACEURL

설치된 플러그인 상태#

이 설정은 설치된 플러그인과 활성화 또는 비활성화 상태의 목록입니다.

config.json 설정은 객체입니다. 객체 키는 플러그인 ID(예: com.mattermost.apps)입니다. 각 키는 true 또는 false``로 설정할 수 있는 ``Enable 키가 포함된 객체에 매핑됩니다.

시스템 구성 경로: 플러그인 > 플러그인 관리
config.json 설정: PluginSettings > PluginStates
환경 변수: MM_PLUGINSETTINGS_PLUGINSTATES

플러그인 설정#

이 설정은 플러그인별 데이터를 포함합니다.

config.json 설정은 객체입니다. 객체 키는 플러그인 ID(예: com.mattermost.apps)입니다. 각 키는 플러그인별 데이터가 포함된 객체에 매핑됩니다.

시스템 구성 경로: 플러그인 > 플러그인 관리
config.json 설정: PluginSettings > Plugins
환경 변수: MM_PLUGINSETTINGS_PLUGINS

통화#

모든 플랜 에서 사용 가능

클라우드 및 자체 호스팅 배포

플러그인 > 통화 로 이동하여 시스템 콘솔에서 다음 구성 설정에 액세스하세요.

플러그인 활성화#

true: (기본값) Mattermost 워크스페이스에서 통화 플러그인을 활성화합니다.
false: Mattermost 워크스페이스에서 통화 플러그인을 비활성화합니다.

시스템 구성 경로: 플러그인 > 통화
config.json 설정: PluginSettings > PluginStates > com.mattermost.calls > Enable
환경 변수: MM_PLUGINSETTINGS_PLUGINSTATES_COM_MATTERMOST_CALLS

RTC 서버 주소 (UDP)#

참고

자체 호스팅 배포에서만 사용 가능

이 설정은 RTC 서버가 UDP 연결을 수신하는 IP 주소를 제어합니다. 모든 통화 UDP 트래픽은 이 IP를 통해 제공됩니다.

이 설정을 변경하려면 플러그인을 재시작해야 적용됩니다. 설정하지 않으면 (기본값) 서비스는 사용 가능한 모든 인터페이스에서 수신합니다.

시스템 구성 경로: 플러그인 > 통화
config.json 설정: PluginSettings Plugins > com.mattermost.calls > udpserveraddress
환경 변수: 해당 없음

참고

이 설정은 독립 실행형 rtcd 서비스를 통해 통화를 실행하지 않을 때만 적용됩니다.

RTC 서버 주소 (TCP)#

참고

자체 호스팅 배포에서만 사용 가능

이 설정은 RTC 서버가 TCP 연결을 수신하는 IP 주소를 제어합니다. 모든 통화 TCP 트래픽은 이 IP를 통해 제공됩니다.

이 설정을 변경하려면 플러그인을 재시작해야 적용됩니다. 설정하지 않으면 (기본값) 서비스는 사용 가능한 모든 인터페이스에서 수신합니다.

시스템 구성 경로: 플러그인 > 통화
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > tcpserveraddress
환경 변수: 해당 없음

참고

이 설정은 플러그인 버전 0.17부터 사용 가능하며, 독립 실행형 rtcd 서비스를 통해 통화를 실행하지 않을 때만 적용됩니다.

RTC 서버 포트 (UDP)#

참고

자체 호스팅 배포에서만 사용 가능

이 설정은 RTC 서버가 수신하는 UDP 포트를 제어합니다. 모든 통화 UDP 트래픽은 이 포트를 통해 제공됩니다.

이 설정을 변경하려면 플러그인을 재시작해야 적용됩니다.

기본값은 8443 입니다.

시스템 구성 경로: 플러그인 > 통화
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > udpserverport
환경 변수: 해당 없음

참고

이 설정은 독립 실행형 rtcd 서비스를 통해 통화를 실행하지 않을 때만 적용됩니다.

RTC 서버 포트 (TCP)#

참고

자체 호스팅 배포에서만 사용 가능

이 설정은 RTC 서버가 수신하는 TCP 포트를 제어합니다. 모든 통화 TCP 트래픽은 이 포트를 통해 제공됩니다.

이 설정을 변경하려면 플러그인을 재시작해야 적용됩니다.

기본값은 8443 입니다.

시스템 구성 경로: 플러그인 > 통화
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > tcpserverport
환경 변수: 해당 없음

참고

이 설정은 플러그인 버전 0.17부터 사용 가능하며, 독립 실행형 rtcd 서비스를 통해 통화를 실행하지 않을 때만 적용됩니다.

특정 채널에서 활성화#

Mattermost v7.7부터 관리자는 이 설정을 구성할 수 없으며, 숨겨져 있고 항상 활성화되어 있습니다

참고

자체 호스팅 배포에서만 사용 가능

true: 채널 관리자는 특정 채널에서 통화를 활성화하거나 비활성화할 수 있습니다. DM/GM의 참가자도 통화를 활성화하거나 비활성화할 수 있습니다.
false: 시스템 관리자만 특정 채널에서 통화를 활성화하거나 비활성화할 수 있습니다.

시스템 구성 경로: 플러그인 > 통화
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > allowenablecalls
환경 변수: 해당 없음

테스트 모드#

이 설정은 Mattermost v7.7까지 ‘모든 채널에서 활성화’라고 불렸습니다. 코드에서는 defaultenabled로, 제품 내에서는 ‘테스트 모드’로 이름이 변경되었습니다.

참고

자체 호스팅 배포에서만 사용 가능

false: 테스트 모드가 활성화되어 시스템 관리자만 채널에서 통화를 시작할 수 있습니다.
true: 라이브 모드가 활성화되어 모든 팀원이 채널에서 통화를 시작할 수 있습니다.

시스템 구성 경로: 플러그인 > 통화
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > defaultenabled
환경 변수: 해당 없음

참고

시스템 관리자로서 통화가 예상대로 작동하는지 확인하기 위해 이 설정을 사용하세요. false 일 때, 통화를 시작하려는 사용자는 시스템 관리자에게 문의하라는 메시지가 표시되고, 시스템 관리자는 라이브 모드로 전환하기 전에 통화가 예상대로 작동하는지 확인하라는 메시지가 표시됩니다.

ICE 호스트 재정의#

참고

자체 호스팅 배포에서만 사용 가능

이 설정은 통화 연결 시 클라이언트에 알려지는 호스트 주소를 재정의하는 데 사용할 수 있습니다. 허용되는 형식은 다음과 같습니다:

단일 IP 주소 (예: 10.0.0.1).
단일 호스트명 또는 FQDN (예: calls.myserver.tld).
(v0.17.0부터) 쉼표로 구분된 externalAddr/internalAddr 매핑 목록 (예: 10.0.0.1/172.0.0.1,10.0.0.2/172.0.0.2).

이는 선택적 필드입니다. 이 설정을 변경하려면 플러그인을 재시작해야 적용됩니다.

시스템 구성 경로: 플러그인 > 통화
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > icehostoverride

참고

이 설정은 독립 실행형 rtcd 서비스를 통해 통화를 실행하지 않을 때만 적용됩니다.
네트워크 인프라(예: NAT 장치 뒤의 인스턴스)에 따라 클라이언트가 연결할 수 있도록 이 필드를 클라이언트가 접근하는 외부 IP로 설정해야 할 수 있습니다. 비어 있거나 설정되지 않은 경우, RTC 서비스는 STUN을 통해 인스턴스의 공용 IP를 찾으려고 시도합니다.
이 설정에서 호스트명(예: 도메인 이름)을 지정할 수 있지만, 클라이언트에는 IP 주소가 전달됩니다. 이는 Mattermost 인스턴스에서 DNS 확인이 발생하여 클라이언트가 보는 것과 다른 IP 주소가 결과로 나올 수 있으며, 이로 인해 연결이 실패할 수 있습니다. 확실하지 않은 경우, IP 주소를 직접 사용하거나 호스트 측의 확인이 클라이언트의 것과 일치하는지 확인하는 것을 권장합니다.

ICE 호스트 포트 재정의#

참고

자체 호스팅 배포에서만 사용 가능

이 설정은 통화 연결 시 클라이언트에 알려지는 ICE 호스트 후보에 사용되는 포트를 재정의하는 데 사용할 수 있습니다.

이는 RTC 서버 앞에 추가 네트워크 구성 요소(예: NLB)가 있어 통화 트래픽을 다른 포트로 라우팅할 수 있는 경우에 유용할 수 있습니다. 이 설정을 변경하려면 플러그인을 재시작해야 적용됩니다.

시스템 구성 경로: 플러그인 > 통화
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > icehostportoverride
환경 변수: 해당 없음

참고

이 값은 UDP 및 TCP 호스트 후보 모두에 적용됩니다.

RTCD 서비스 URL#

참고

Enterprise 플랜에서만 사용 가능

자체 호스팅 배포에서만 사용 가능

통화를 호스팅할 실행 중인 rtcd 서비스 인스턴스의 URL입니다.

설정된 경우(비어 있지 않은 경우) 모든 통화는 이 외부 서비스에서 처리됩니다.

이는 선택적 필드입니다. 이 설정을 변경하려면 플러그인을 재시작해야 적용됩니다.

시스템 구성 경로: 플러그인 > 통화
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > rtcdserviceurl
환경 변수: MM_CALLS_RTCD_URL

참고

클라이언트는 서비스에 처음 연결할 때 자체 등록하고 인증 키를 데이터베이스에 저장합니다. 클라이언트 ID가 명시적으로 제공되지 않은 경우 Mattermost 설치의 진단 ID가 사용됩니다.
서비스 URL은 http://clientID:authKey@hostname 형식의 인증 정보를 지원합니다. 또는 이러한 인증 정보는 Mattermost 서버의 환경 변수 재정의를 통해 전달될 수 있으며, 구체적으로는 MM_CALLS_RTCD_CLIENT_ID``와 ``MM_CALLS_RTCD_AUTH_KEY 를 사용합니다.

최대 통화 참가자 수#

참고

자체 호스팅 배포에서만 사용 가능

이 설정은 단일 통화에 참여할 수 있는 참가자 수를 제한합니다.

기본값은 0 입니다(제한 없음).

시스템 구성 경로: 플러그인 > 통화
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > maxcallparticipants
환경 변수: MM_CALLS_MAX_PARTICIPANTS

참고

이 설정은 선택 사항이지만 권장되는 최대 참가자 수는 50 명입니다. 통화 참가자 제한은 인스턴스 리소스에 크게 의존합니다. 자세한 내용은 Calls self-hosted deployment 문서를 참조하세요.

ICE 서버 구성#

참고

자체 호스팅 배포에서만 사용 가능

이 설정은 서비스에서 사용할 ICE 서버(STUN/TURN) 목록을 JSON 형식으로 저장합니다.

이는 선택 사항입니다. 이 설정을 변경하려면 플러그인을 재시작해야 할 수 있습니다.

기본값은 [{"urls": ["stun:stun.global.calls.mattermost.com:3478"]}] 입니다

시스템 구성 경로: 플러그인 > 통화
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > iceserversconfigs
환경 변수: 해당 없음

참고

위의 STUN 및 TURN 서버를 포함하는 구성은 클라이언트에 전송되어 로컬 후보를 생성하는 데 사용됩니다.
플러그인을 통해 통화를 호스팅하는 경우(rtcd service 를 사용하지 않는 경우) ICE Host Override 옵션을 통해 제공되지 않을 때 인스턴스의 공용 IP를 찾는 데 구성된 STUN 서버를 사용할 수도 있습니다.

예시

[
 {
    "urls":[
       "stun:stun.global.calls.mattermost.com:3478"
    ]
 },
 {
    "urls":[
       "turn:turn.example.com:3478"
    ],
    "username":"webrtc",
    "credentials":"turnpassword"
 }
]

예시 (생성된 TURN 자격 증명 사용)

[{
        "urls": ["turn:turn.example.com:443"]
}]

참고

TURN 생성 자격 증명이 작동하려면 아래의 TURN static auth secret 설정을 통해 비밀을 제공해야 합니다.

TURN static auth secret#

참고

자체 호스팅 배포에서만 사용 가능

TURN 서버용 단기 자격 증명을 생성하는 데 사용되는 정적 비밀입니다.

이는 선택 사항입니다.

시스템 구성 경로: 플러그인 > 통화
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > turnstaticauthsecret
환경 변수: 해당 없음

TURN 자격 증명 만료#

참고

자체 호스팅 배포에서만 사용 가능

TURN 서버용으로 생성된 단기 자격 증명의 만료 시간(분)입니다.

기본값은 1440 (1일)입니다.

시스템 구성 경로: 플러그인 > 통화
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > turncredentialsexpirationminutes
환경 변수: 해당 없음

서버 측 TURN#

참고

자체 호스팅 배포에서만 사용 가능

true: RTC 서버가 서버 시작 연결에 대해 구성된 TURN 후보를 사용합니다.
false: TURN은 클라이언트 측에서만 사용됩니다.

이 설정을 변경하려면 플러그인을 재시작해야 적용됩니다.

시스템 구성 경로: 플러그인 > 통화
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > serversideturn
환경 변수: 해당 없음

통화 녹화 활성화#

참고

Enterprise 플랜에서만 사용 가능

자체 호스팅 배포에서만 사용 가능

true: 통화 호스트가 미팅 비디오와 오디오를 녹화할 수 있습니다.
false: (기본값) 호스트가 통화 녹화 기능을 사용할 수 없습니다.

녹화에는 참가자의 오디오 트랙과 공유된 화면 비디오를 포함한 전체 통화 창 보기가 포함됩니다. 녹화는 Mattermost에 저장됩니다.

이 설정을 변경하려면 플러그인을 재시작해야 적용됩니다.

시스템 구성 경로: 플러그인 > 통화
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > enablerecordings

작업 서비스 URL#

참고

Enterprise 플랜에서만 사용 가능

자체 호스팅 배포에서만 사용 가능

녹화와 관련된 모든 처리가 이루어지는 실행 중인 작업 서비스의 URL입니다. 생성된 녹화 파일은 Mattermost에 저장됩니다.

이것은 필수 필드입니다. 이 설정을 변경하려면 플러그인을 재시작해야 적용됩니다.

시스템 구성 경로: 플러그인 > 통화
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > jobserviceurl
환경 변수: MM_CALLS_JOB_SERVICE_URL

참고

클라이언트는 서비스에 처음 연결할 때 자체 등록하고 인증 키를 데이터베이스에 저장합니다. 클라이언트 ID가 명시적으로 제공되지 않은 경우 Mattermost 설치의 진단 ID가 사용됩니다.
서비스 URL은 http://clientID:authKey@hostname 형식의 인증 정보를 지원합니다. 또는 이러한 인증 정보는 Mattermost 서버의 환경 변수 재정의를 통해 전달될 수 있으며, 구체적으로는 MM_CALLS_JOB_SERVICE_CLIENT_ID 와 MM_CALLS_JOB_SERVICE_AUTH_KEY 를 사용합니다.
Calls v0.25부터는 MM_CALLS_RECORDER_SITE_URL 또는 MM_CALLS_TRANSCRIBER_SITE_URL 환경 변수를 각각 설정하여 작업이 연결에 사용하는 사이트 URL을 재정의할 수 있습니다. 이는 작업이 Mattermost에 구성된 공개 사이트 URL을 통해 연결되는 것을 방지하고, 결과적으로 공개 네트워크를 우회할 수 있도록 도움이 됩니다.

최대 통화 녹화 시간#

참고

Enterprise 플랜에서만 사용 가능

자체 호스팅 배포에서만 사용 가능

통화 녹화의 최대 시간(분)입니다.

기본값은 60 입니다. 최대값은 180 입니다. 이것은 필수 값입니다.

시스템 구성 경로: 플러그인 > 통화
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > maxrecordingduration
환경 변수: 해당 없음

통화 녹화 품질#

참고

Enterprise 플랜에서만 사용 가능

자체 호스팅 배포에서만 사용 가능

통화 녹화의 오디오 및 비디오 품질입니다. 사용 가능한 옵션은 Low, Medium, High 입니다.

기본값은 Medium 입니다. 이것은 필수 값입니다.

시스템 구성 경로: 플러그인 > 통화
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > recordingquality

참고

품질 설정은 작업 서비스의 성능과 녹화 파일 크기에 영향을 미칩니다. 자세한 내용은 배포 섹션 을 참조하세요.

통화 자막 활성화 (베타)#

참고

Enterprise 플랜에서만 사용 가능

자체 호스팅 배포에서만 사용 가능

true: 통화의 자동 자막 생성을 활성화합니다.
false: (기본값) 통화 자막 기능이 비활성화됩니다.

자막은 통화 참가자들의 오디오 트랙에서 생성되며, 녹화가 종료되면 결과 파일이 통화 스레드에 첨부됩니다. 자막은 선택적으로 녹화 파일 비디오 플레이어 위에 렌더링됩니다.

시스템 구성 경로: 플러그인 > 통화
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > enabletranscriptions

참고

이 설정은 플러그인 버전 0.22부터 사용 가능합니다. 통화 자막은 통화 녹화 가 활성화되어 있어야 합니다.

자막 생성 모델 크기#

참고

Enterprise 플랜에서만 사용 가능

자체 호스팅 배포에서만 사용 가능

사용할 음성-텍스트 변환 모델 크기입니다. 더 무거운 모델은 처리 시간과 리소스 사용량을 희생하여 더 정확한 결과를 생성합니다. 사용 가능한 옵션은 Tiny, Base, Small 입니다.

기본값은 Base 입니다. 이것은 필수 값입니다.

시스템 구성 경로: 플러그인 > 통화
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > transcribermodelsize

참고

이 설정은 플러그인 버전 0.22부터 사용할 수 있습니다. 모델 크기 설정은 작업 서비스의 성능에 영향을 미칩니다. 자세한 내용은 통화 녹화, 자막, 실시간 자막 구성 문서를 참고하세요.

통화 자막 생성 스레드#

참고

Enterprise 플랜에서만 사용 가능

자체 호스팅 배포에서만 사용 가능

통화 후 자막 생성기에 사용되는 스레드 수입니다. 이 값은 [1, numCPUs] 범위 내여야 합니다.

기본값은 2입니다. 필수 값입니다.

시스템 구성 경로: 플러그인 > 통화
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > transcribernumthread

참고

통화 자막 생성 스레드 설정은 작업 서비스의 성능에 영향을 미칩니다. 자세한 내용은 통화 녹화, 자막, 실시간 자막 구성 문서를 참고하세요. 이 설정은 플러그인 버전 0.26.2부터 사용할 수 있습니다.

실시간 자막 활성화 (베타)#

참고

Enterprise 플랜에서만 사용 가능

자체 호스팅 배포에서만 사용 가능

true: 통화의 실시간 자막을 활성화합니다.
false: (기본값) 실시간 자막 기능이 비활성화됩니다.

실시간 자막은 통화 참가자의 오디오 트랙에서 생성되며, 생성된 자막은 [cc] 옵션을 클릭하여 통화 클라이언트에서 선택적으로 표시할 수 있습니다.

시스템 구성 경로: 플러그인 > 통화
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > enablelivecaptions

참고

이 설정은 플러그인 버전 0.26.2부터 사용할 수 있습니다. 실시간 자막을 사용하려면 통화 녹화 및 통화 자막 기능이 활성화되어 있어야 합니다.

실시간 자막: 모델 크기#

참고

Enterprise 플랜에서만 사용 가능

자체 호스팅 배포에서만 사용 가능

실시간 자막에 사용할 음성-텍스트 변환 모델의 크기입니다. 더 큰 모델은 더 정확한 결과를 제공할 수 있지만, 실시간 자막 기능은 변환기가 10초 분량의 오디오를 2초 이내에 처리해야 합니다. 따라서 최대 base 크기까지를 권장합니다. 선택 가능한 옵션은 Tiny, Base, Small 입니다.

Tiny 가 기본값입니다. 필수 값입니다.

시스템 구성 경로: 플러그인 > 통화
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > livecaptionsmodelsize

참고

이 설정은 플러그인 버전 0.26.2부터 사용할 수 있습니다. 모델 크기 설정은 작업 서비스의 성능에 영향을 미칩니다. 자세한 내용은 성능 및 확장성 권장사항 문서를 참고하세요.

실시간 자막: 통화당 사용되는 변환기 수#

참고

Enterprise 플랜에서만 사용 가능

자체 호스팅 배포에서만 사용 가능

각 통화에 대해 별도로 할당되는 실시간 자막 변환기의 수입니다. 각 변환기는 한 번에 하나의 오디오 스트림만 변환합니다. LiveCaptionsNumTranscribers * LiveCaptionsNumThreadsPerTranscriber의 곱은 [1, numCPUs] 범위 내여야 합니다.

기본값은 1입니다. 필수 값입니다.

시스템 구성 경로: 플러그인 > 통화
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > livecaptionsnumtranscribers

참고

이 설정은 플러그인 버전 0.26.2부터 사용할 수 있습니다. 실시간 자막 변환기 수 설정은 작업 서비스의 성능에 영향을 미칩니다. 자세한 내용은 성능 및 확장성 권장사항 문서를 참고하세요.

실시간 자막: 변환기당 스레드 수#

참고

Enterprise 플랜에서만 사용 가능

자체 호스팅 배포에서만 사용 가능

실시간 자막 변환기당 스레드 수입니다. LiveCaptionsNumTranscribers * LiveCaptionsNumThreadsPerTranscriber 의 곱은 [1, numCPUs] 범위 내여야 합니다.

기본값은 2입니다. 필수 값입니다.

시스템 구성 경로: 플러그인 > 통화
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > livecaptionsnumthreadspertranscriber

참고

이 설정은 플러그인 버전 0.26.2부터 사용할 수 있습니다. 실시간 자막 변환기당 스레드 수 설정은 작업 서비스의 성능에 영향을 미칩니다. 자세한 내용은 성능 및 확장성 권장사항 문서를 참고하세요.

실시간 자막 언어#

참고

Enterprise 플랜에서만 사용 가능

자체 호스팅 배포에서만 사용 가능

실시간 자막 변환기에 전달되는 언어입니다. ‘en’과 같은 2글자 ISO 639 Set 1 언어 코드여야 합니다.

비어 있으면 기본값으로 ‘en’(영어)으로 설정됩니다.

시스템 구성 경로: 플러그인 > 통화
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > livecaptionslanguage

(실험적) IPv6 활성화#

참고

자체 호스팅 배포에서만 사용 가능

true: RTC 서비스가 듀얼 스택 모드로 작동하여 IPv4 외에도 IPv6 연결을 수신하고 후보를 생성합니다.
false: (기본값) RTC 서비스는 IPv4 연결만 수신합니다.

이 설정을 변경하려면 플러그인을 재시작해야 적용됩니다.

시스템 구성 경로: 플러그인 > 통화
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > enableipv6
환경 변수: 해당 없음

참고

이 설정은 플러그인 버전 0.17부터 사용 가능하며, 독립 실행형 rtcd 서비스를 통해 통화를 실행하지 않을 때만 적용됩니다.

통화 벨소리 활성화#

true: 벨소리 기능이 활성화됩니다. 통화가 시작되면 직접 메시지 및 그룹 메시지 참가자는 데스크톱 앱 알림과 벨소리 알림을 받습니다.
false: (기본값) 벨소리 기능이 비활성화됩니다.

시스템 구성 경로: 플러그인 > 통화
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > enableringing
환경 변수: 해당 없음

AV1 활성화 (실험적)#

true: 화면 공유 트랙을 인코딩하기 위해 AV1 코덱을 사용할 수 있는 기능을 활성화합니다. AV1 인코딩을 지원하는 클라이언트를 통해 화면 공유 품질이 향상될 수 있습니다.
false: (기본값) 화면 공유 트랙에 대해 AV1 코덱이 비활성화됩니다.

시스템 구성 경로: 플러그인 > 통화
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > enableAV1
환경 변수: 해당 없음

참고

이 실험적 구성 설정과 화면 공유를 위한 시뮬캐스트 활성화 실험적 구성 설정을 동시에 활성화하지 마세요.

DC 시그널링 활성화 (실험적)#

true: 클라이언트는 미디어 트랙(음성, 화면)의 시그널링을 위해 WebRTC 데이터 채널을 사용합니다. 이는 특히 네트워크 연결이 좋지 않은 경우 더 효율적이고 경쟁 상태가 덜 발생하는 프로세스를 만들 수 있습니다.
false: (기본값) 클라이언트는 미디어 트랙 시그널링을 위해 WebSockets를 사용합니다.

시스템 구성 경로: 플러그인 > 통화
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > enabledcsignaling
환경 변수: 해당 없음

참고

전용 WebRTC 서비스를 통해 통화를 호스팅할 때 이 기능이 작동하려면 rtcd service 버전 v0.18.0 이상이 필요합니다.
이 실험적 구성 설정은 WebRTC 기반 통화의 설정 일부를 시스템이 처리하는 방식을 결정하므로 활성화할 때 주의하세요. 이 구성 설정을 활성화하면 특정 상황에서 통화 설정이 조금 더 빠르거나 안정적일 수 있습니다.

GitLab#

모든 플랜 에서 사용 가능

클라우드 및 자체 호스팅 배포

사용 가능한 Mattermost 구성 옵션 에 대한 Mattermost에 GitLab 연결 제품 문서를 참조하세요.

GitHub#

모든 플랜 에서 사용 가능

클라우드 및 자체 호스팅 배포

사용 가능한 Mattermost 구성 옵션 에 대한 Mattermost에 GitHub 연결 제품 문서를 참조하세요.

Jira#

모든 플랜 에서 사용 가능

클라우드 및 자체 호스팅 배포

사용 가능한 Mattermost 구성 옵션 에 대한 Mattermost에 Jira 연결 제품 문서를 참조하세요.

법적 보관#

Enterprise 플랜 에서 사용 가능

클라우드 및 자체 호스팅 배포

자세한 내용은 법적 보관 제품 문서를 참조하세요.

Microsoft Calendar#

모든 플랜 에서 사용 가능

클라우드 및 자체 호스팅 배포

사용 가능한 Mattermost 구성 옵션 에 대한 Mattermost에 Microsoft Calendar 연결 제품 문서를 참조하세요.

Microsoft Teams Meetings#

모든 플랜 에서 사용 가능

클라우드 및 자체 호스팅 배포

사용 가능한 Mattermost 구성 옵션 에 대한 Mattermost에 Microsoft Teams Meetings 연결 제품 문서를 참조하세요.

MS Teams#

모든 플랜 에서 사용 가능

클라우드 및 자체 호스팅 배포

Mattermost for Microsoft Teams는 Teams에서 Mattermost로 실시간 채팅 알림을 전달하여 Mattermost와 Teams가 혼합된 환경에서 정보 격차를 해소할 수 있게 해줍니다.

팁

Mattermost가 조직이 Microsoft 도구를 통해 더 많은 가치를 얻을 수 있도록 도와주는 방법을 알아보려면 Mattermost for Microsoft Teams 데이터시트 를 다운로드하세요.

시스템 콘솔에서 플러그인 > MS Teams 로 이동하여 다음 구성 설정에 접근하세요.

Mattermost Academy Learn about integrating with Microsoft Teams

플러그인 활성화#

모든 Mattermost 팀에 대해 Microsoft Teams용 Mattermost 플러그인을 활성화합니다.

true: Mattermost 워크스페이스에서 MS Teams 플러그인을 활성화합니다.
false: (기본값) MS Teams 플러그인을 비활성화합니다.

시스템 구성 경로: 플러그인 > MS Teams
config.json 설정: 해당 없음
환경 변수: 해당 없음

참고

Microsoft Teams 채팅과 직접 메시지 및 그룹 메시지를 동기화할 Mattermost 팀을 지정하려면 Enabled Teams 구성 옵션을 사용하세요.

테넌트 ID#

Azure 포털에서 Microsoft Teams 테넌트 ID를 지정하세요.

시스템 구성 경로: 플러그인 > MS Teams
config.json 설정: 해당 없음
환경 변수: 해당 없음

클라이언트 ID#

Azure 포털에서 등록된 OAuth 앱의 Microsoft Teams 클라이언트 ID를 지정하세요.

시스템 구성 경로: 플러그인 > MS Teams
config.json 설정: 해당 없음
환경 변수: 해당 없음

클라이언트 시크릿#

Azure 포털에서 등록된 OAuth 앱의 클라이언트 시크릿을 지정하세요.

영숫자 값.

시스템 구성 경로: 플러그인 > MS Teams
config.json 설정: 해당 없음
환경 변수: 해당 없음

저장 암호화 키#

새로운 암호화 시크릿을 재생성하세요. 이 암호화 시크릿은 OAuth 토큰을 암호화하고 복호화하는 데 사용됩니다.

영숫자 값.

시스템 구성 경로: 플러그인 > MS Teams
config.json 설정: 해당 없음
환경 변수: 해당 없음

참고

새 키를 생성하려면 재생성 을 선택하세요.

웹훅 시크릿#

Microsoft Teams가 Mattermost로 메시지를 보내는 데 사용할 웹훅 시크릿을 생성하세요.

시스템 구성 경로: 플러그인 > MS Teams
config.json 설정: 해당 없음
환경 변수: 해당 없음

참고

새 키를 생성하려면 재생성 을 선택하세요.

평가 API 결제 모델 사용#

테스트 목적으로만 활성화하세요. 실제 환경에서 작동하기에 충분한 메시지 알림을 지원하려면 결제 모델이 필요합니다.

true: 평가 API 결제 모델을 활성화합니다.
false: (기본값) 평가 API 결제 모델을 비활성화합니다.

시스템 구성 경로: 플러그인 > MS Teams
config.json 설정: 해당 없음
환경 변수: 해당 없음

알림 동기화#

Microsoft Teams에서 채팅 또는 그룹 채팅을 받을 때 Mattermost에 연결된 사용자에게 알림을 보냅니다.

true: (기본값) 이 기능을 활성화한 모든 연결된 사용자에 대해 채팅 메시지 알림을 동기화합니다.
false: 알림을 동기화하지 않습니다.

시스템 구성 경로: 플러그인 > MS Teams
config.json 설정: 해당 없음
환경 변수: 해당 없음

한 번에 완전히 다운로드할 수 있는 첨부 파일의 최대 크기#

메모리에 로드할 수 있는 첨부 파일의 최대 크기(MiB 단위)를 지정하세요. 이 값보다 큰 첨부 파일은 Microsoft Teams에서 Mattermost로 스트리밍됩니다.

숫자 값입니다. 기본값은 20 MiB입니다.

시스템 구성 경로: 플러그인 > MS Teams
config.json 설정: 해당 없음
환경 변수: 해당 없음

파일 스트리밍을 위한 버퍼 크기#

Microsoft Teams에서 Mattermost로 첨부 파일을 스트리밍할 때 사용할 버퍼 크기(MiB 단위)를 지정하세요.

숫자 값입니다. 기본값은 20 MiB입니다.

시스템 구성 경로: 플러그인 > MS Teams
config.json 설정: 해당 없음
환경 변수: 해당 없음

성능 지표#

Enterprise 플랜 에서 사용 가능

클라우드 및 자체 호스팅 배포

사용 가능한 Mattermost 구성 옵션 에 대해 성능 지표 모니터링 제품 문서를 참조하세요.

협업 플레이북#

Enterprise 플랜 에서 사용 가능

클라우드 및 자체 호스팅 배포

Mattermost에서 협업 플레이북을 사용하여 반복 가능한 팀 기반 프로세스에 구조화, 모니터링, 자동화를 제공할 수 있습니다.Mattermost 플랫폼과 통합되어 있습니다.

시스템 콘솔에서 플러그인 > 협업 플레이북 으로 이동하여 다음 설정을 확인할 수 있습니다.

플러그인 활성화#

true: (기본값) Mattermost 워크스페이스에서 협업 플레이북을 활성화합니다.
false: Mattermost 워크스페이스에서 협업 플레이북을 비활성화합니다.

시스템 설정 경로: 플러그인 > 협업 플레이북
config.json 설정:
환경 변수:

활성화된 팀#

모든 Mattermost 팀 또는 선택한 팀에 대해 협업 플레이북을 활성화할 수 있습니다.

시스템 설정 경로: 플러그인 > 협업 플레이북
config.json 설정:
환경 변수:

실험적 기능 활성화#

true: Mattermost 워크스페이스에서 실험적 플레이북 기능을 활성화합니다.
false: Mattermost 워크스페이스에서 실험적 플레이북 기능을 비활성화합니다.

시스템 설정 경로: 플러그인 > 협업 플레이북
config.json 설정:
환경 변수:

사용자 만족도 설문조사#

모든 플랜 에서 사용 가능

클라우드 및 자체 호스팅 배포

이 플러그인은 Mattermost가 사용자 만족도 설문조사를 전송하여 피드백을 수집하고 제품 품질을 직접 Mattermost 사용자로부터 향상시킬 수 있도록 합니다. Mattermost 서비스를 통해 수집된 정보의 수집 및 사용에 대한 자세한 내용은 Mattermost 개인정보 처리방침 을 참조하세요.

시스템 콘솔에서 플러그인 > 사용자 만족도 설문조사 로 이동하여 다음 설정을 확인할 수 있습니다.

플러그인 활성화#

true: (기본값) Mattermost 워크스페이스에서 Mattermost 사용자 만족도 설문조사 플러그인을 활성화합니다.
false: Mattermost 워크스페이스에서 Mattermost 사용자 만족도 설문조사 플러그인을 비활성화합니다.

시스템 설정 경로: 플러그인 > 사용자 만족도 설문조사
config.json 설정: PluginSettings.PluginStates.com.mattermost.user-survey.Enable
환경 변수: 해당 없음

사용자 만족도 설문조사 활성화#

true: 모든 사용자에게 분기마다 설문조사가 전송됩니다. 결과는 Mattermost, Inc.에서 제품 개선을 위해 사용됩니다. false: (기본값) 사용자 만족도 설문조사가 비활성화됩니다.	시스템 설정 경로: 플러그인 > 사용자 만족도 설문조사 `config.json` 설정: `PluginSettings.Plugins.com.mattermost.user-survey.systemconsolesetting.EnableSurvey` 환경 변수: 해당 없음
참고: Mattermost가 정보를 수집 및 사용하는 방법에 대한 자세한 내용은 Mattermost 개인정보 보호정책 을 참고하세요.

ServiceNow#

모든 플랜 에서 사용 가능

클라우드 및 자체 호스팅 배포

사용 가능한 Mattermost 구성 옵션 은 ServiceNow를 Mattermost에 연결하기 제품 문서를 참고하세요.

Zoom#

모든 플랜 에서 사용 가능

클라우드 및 자체 호스팅 배포

사용 가능한 Mattermost 구성 옵션 은 Zoom을 Mattermost에 연결하기 제품 문서를 참고하세요.

config.json 전용 설정#

모든 플랜 에서 사용 가능

셀프 호스팅 배포

서명 공개 키 파일#

이 설정은 시스템 콘솔에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

서버에 내장된 Mattermost 플러그인 서명 키 외에도 여기에 지정된 각 공개 키는 플러그인 서명을 검증하는 데 신뢰됩니다.

이 기능의 config.json 설정은 서명 파일의 상대 또는 절대 경로로 구성된 문자열 배열 입력이 있는 "SignaturePublicKeyFiles": {} 입니다.

Chimera OAuth 프록시 URL#

이 설정은 시스템 콘솔에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

Mattermost 플러그인이 사전 생성된 OAuth 애플리케이션과 연결하는 데 사용하는 Chimera URL을 지정하세요.

이 기능의 config.json 설정은 문자열 입력이 있는 "ChimeraOAuthProxyUrl": {} 입니다.

플러그인 구성 설정#

플러그인 관리#

플러그인 활성화#

플러그인 서명 필요#

자동 사전 패키지 플러그인#

플러그인 업로드#

Marketplace 활성화#

원격 Marketplace 활성화#

Marketplace URL#

설치된 플러그인 상태#

플러그인 설정#

통화#

플러그인 활성화#

RTC 서버 주소 (UDP)#

RTC 서버 주소 (TCP)#

RTC 서버 포트 (UDP)#

RTC 서버 포트 (TCP)#

특정 채널에서 활성화#

테스트 모드#

ICE 호스트 재정의#

ICE 호스트 포트 재정의#

RTCD 서비스 URL#

최대 통화 참가자 수#

ICE 서버 구성#

TURN static auth secret#

TURN 자격 증명 만료#

서버 측 TURN#

화면 공유 허용#

화면 공유를 위한 동시 전송 활성화 (실험적)#

통화 녹화 활성화#

작업 서비스 URL#

최대 통화 녹화 시간#

통화 녹화 품질#

통화 자막 활성화 (베타)#

자막 생성 모델 크기#

통화 자막 생성 스레드#

실시간 자막 활성화 (베타)#

실시간 자막: 모델 크기#

실시간 자막: 통화당 사용되는 변환기 수#

실시간 자막: 변환기당 스레드 수#

실시간 자막 언어#

(실험적) IPv6 활성화#

통화 벨소리 활성화#

AV1 활성화 (실험적)#

DC 시그널링 활성화 (실험적)#

GitLab#

GitHub#

Jira#

법적 보관#

Microsoft Calendar#

Microsoft Teams Meetings#

MS Teams#

플러그인 활성화#

테넌트 ID#

클라이언트 ID#

클라이언트 시크릿#

저장 암호화 키#

웹훅 시크릿#

평가 API 결제 모델 사용#

알림 동기화#

한 번에 완전히 다운로드할 수 있는 첨부 파일의 최대 크기#

파일 스트리밍을 위한 버퍼 크기#

성능 지표#

협업 플레이북#

플러그인 활성화#

활성화된 팀#

실험적 기능 활성화#

사용자 만족도 설문조사#

플러그인 활성화#

사용자 만족도 설문조사 활성화#

ServiceNow#

Zoom#

config.json 전용 설정#

서명 공개 키 파일#

Chimera OAuth 프록시 URL#