InfoGrab Docs

플러그인 구성 설정

요약

제품 메뉴를 선택하고 System Console을 선택한 다음 Plugins를 선택하여 System Console에서 다음 플러그인 구성 옵션을 검토하고 관리합니다: 자체 호스팅 Mattermost 배포를 관리하는 시스템 관리자는 다음 표에서 설명한 대로 config.json 파일을 편집할 수 있습니다.

제품 메뉴를 선택하고 System Console을 선택한 다음 Plugins를 선택하여 System Console에서 다음 플러그인 구성 옵션을 검토하고 관리합니다:

Tip

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

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

#

플러그인 관리#

Plugins > Plugin Management로 이동하여 System Console에서 다음 구성 설정에 접근합니다.

  • true: (Default) Enables plugins on your Mattermost server.
  • false: Disables plugins on your Mattermost server.

플러그인 활성화#

- true: (Default) Enables plugins on your Mattermost server. See the Use plugins with Mattermost documentation for details. - false: Disables plugins on your Mattermost server.- System Config path: Plugins > Plugin Management - config.json setting: PluginSettings > Enable > true - Environment variable: MM_PLUGINSETTINGS_ENABLE
Note

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

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

플러그인 서명 요구#

- true: (Default) Enables plugin signature validation for managed and unmanaged plugins. - false: Disables plugin signature validation for managed and unmanaged plugins.- System Config path: Plugins > Plugin Management - config.json setting: PluginSettings > RequirePluginSignature > true - Environment variable: MM_PLUGINSETTINGS_REQUIREPLUGINSIGNATURE
Note
    • 이 설정은 자체 호스팅 배포에만 적용됩니다.
    • Mattermost 서버 v10.11부터 사전 패키지 플러그인은 시작 시 서명 유효성 검사가 필요합니다. 커스텀 사전 패키지 플러그인을 번들로 제공하는 배포판은 서명을 검증하기 위해 PluginSettings.SignaturePublicKeyFiles를 통해 커스텀 공개 키를 구성해야 합니다.
    • Mattermost 서버 v10.10 이하: 사전 패키지 플러그인은 서명 유효성 검사 대상이 아닙니다.
    • 마켓플레이스를 통해 설치된 플러그인은 다운로드 시 항상 서명 유효성 검사 대상입니다.
    • 이 구성을 활성화하면 System Console에서 플러그인 파일 업로드가 비활성화됩니다.
    • true: (Default) Mattermost automatically installs and upgrades any enabled pre-packaged plugins.
    • false: Mattermost does not automatically install or upgrade pre-packaged plugins.

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

- true: (Default) Mattermost automatically installs and upgrades any enabled pre-packaged plugins. If a newer version is installed, no changes are made. - false: Mattermost does not automatically install or upgrade pre-packaged plugins. Pre-packaged plugins may be installed manually from the Marketplace, even when offline.- System Config path: Plugins > Plugin Management - config.json setting: PluginSettings > AutomaticPrepackagedPlugins > true - Environment variable: MM_PLUGINSETTINGS_AUTOMATICPREPACKAGEDPLUGINS
Note

사전 패키지 플러그인 설치 동작: 시스템 관리자가 플러그인 파일(및 .sig 서명 파일)을 prepackaged_plugins 디렉터리에 넣으면 플러그인이 자동으로 설치되지 않습니다. 사전 패키징은 플러그인을 "오프라인" 설치를 위해 사용 가능하게 만듭니다. 플러그인은 시스템 관리자가 해당 플러그인이 활성화된 상태로 config.json을 사전 구성한 경우에만 자동으로 설치됩니다.

    • true: Enables system admins to upload plugins from the local computer to the Mattermost server.
    • false: (Default) Disables uploading of plugins from the local computer to the Mattermost server.

플러그인 업로드#

- true: Enables you to upload plugins from the local computer to the Mattermost server. - false: (Default) Disables uploading of plugins from the local computer to the Mattermost server.- System Config path: Plugins > Plugin Management - config.json setting: PluginSettings > EnableUploads > false - Environment variable: MM_PLUGINSETTINGS_ENABLEUPLOADS
Note
    • 이 설정은 자체 호스팅 배포에만 적용됩니다.
    • 플러그인 업로드가 활성화된 경우, 플러그인 파일 업로드 시 Received invlaid response from the server 오류는 일반적으로 MaxFileSize 구성 설정이 플러그인 파일 업로드를 지원하기에 충분히 크지 않다는 것을 나타냅니다. 추가 프록시 설정 업데이트도 필요할 수 있습니다.
    • 플러그인 서명 요구 구성 설정이 활성화된 경우 플러그인 파일 업로드 기능이 비활성화됩니다.
    • true: (Default) Enables the plugin Marketplace on your Mattermost server for all system admins.
    • false: Disables the plugin Marketplace on your Mattermost server for all system admins.

마켓플레이스 활성화#

- true: (Default) Enables the plugin Marketplace on your Mattermost server for all system admins. - false: Disables the plugin Marketplace on your Mattermost server for all system admins.- System Config path: Plugins > Plugin Management - config.json setting: PluginSettings > EnableMarketplace > true - Environment variable: MM_PLUGINSETTINGS_ENABLEMARKETPLACE
  • true: (Default) Mattermost attempts to connect to the endpoint set in MarketplaceURL.
  • false: Mattermost doesn't attempt to connect to a remote Marketplace, and shows only pre-packaged and installed plugins.

원격 마켓플레이스 활성화#

- true: (Default) Mattermost attempts to connect to the endpoint set in Marketplace URL. If the connection fails, an error is displayed, and the Marketplace only shows pre-packaged and installed plugins. - false: Mattermost does not attempt to connect to a remote Marketplace. The Marketplace shows only pre-packaged and installed plugins. Use this setting if your Mattermost server cannot connect to the Internet.- System Config path: Plugins > Plugin Management - config.json setting: PluginSettings > EnableRemoteMarketplace > true - Environment variable: MM_PLUGINSETTINGS_ENABLEREMOTEMARKETPLACE
Note
    • Mattermost v9.1부터 구성된 원격 마켓플레이스 URL에 접근하려면 이 구성 설정 값을 true로 설정하세요.
    • Mattermost v9.0의 경우 구성된 원격 마켓플레이스 URL에 접근하려면 MM_FEATUREFLAGS_STREAMLINEDMARKETPLACE 기능 플래그를 false로 설정하고 이 구성 설정을 true로 설정해야 합니다.
    • 각 Mattermost 호스트는 MarketplaceURL에 설정된 엔드포인트에 대한 네트워크 접근 권한이 있어야 합니다.

마켓플레이스 URL#

This setting stores the URL for the remote Markeplace. String input. Default is https://api.integrations.mattermost.com- System Config path: Plugins > Plugin Management - config.json setting: PluginSettings > MarketplaceURL - Environment variable: MM_PLUGINSETTINGS_MARKETPLACEURL

설치된 플러그인 상태#

This setting is a list of installed plugins and their status as enabled or disabled. The config.json setting is an object. The object keys are plugin IDs, e.g. com.mattermost.apps. Each key maps to an object that contains an Enable key that can be set as true or false.- System Config path: Plugins > Plugin Management - config.json setting: PluginSettings > PluginStates - Environment variable: MM_PLUGINSETTINGS_PLUGINSTATES

플러그인 설정#

This setting contains plugin-specific data. The config.json setting is an object. The object keys are plugin IDs, e.g. com.mattermost.apps. Each key maps to an object that contains plugin-specific data.- System Config path: Plugins > Plugin Management - config.json setting: PluginSettings > Plugins - Environment variable: MM_PLUGINSETTINGS_PLUGINS

Calls#

Plugins > Calls로 이동하여 System Console에서 다음 구성 설정에 접근합니다.

  • true: (Default) Enables the calls plugin on your Mattermost workspace.
  • false: Disables the calls plugin on your Mattermost workspace.

플러그인 활성화#

- true: (Default) Enables the Calls plugin on your Mattermost workspace. - false: Disables the Calls plugin on your Mattermost workspace.- System Config path: Plugins > Calls - config.json setting: PluginSettings > PluginStates > com.mattermost.calls > Enable - Environment variable: MM_PLUGINSETTINGS_PLUGINSTATES_COM_MATTERMOST_CALLS

RTC 서버 주소 (UDP)#

This setting controls the IP address the RTC server listens for UDP connections. All calls UDP traffic will be served through this IP. Changing this setting requires a plugin restart to take effect. If left unset (default value) the service will listen on all the available interfaces.- System Config path: Plugins > Calls - config.json setting: PluginSettings Plugins > com.mattermost.calls > udpserveraddress - Environment variable: MM_CALLS_UDP_SERVER_ADDRESS
Note

이 설정은 자체 호스팅 배포에만 적용되며, 독립형 rtcd 서비스를 통해 통화를 실행하지 않는 경우에만 적용됩니다.

RTC 서버 주소 (TCP)#

This setting controls the IP address the RTC server listens for TCP connections. All calls TCP traffic will be served through this IP. Changing this setting requires a plugin restart to take effect. If left unset (default value) the service will listen on all the available interfaces.- System Config path: Plugins > Calls - config.json setting: PluginSettings > Plugins > com.mattermost.calls > tcpserveraddress - Environment variable: MM_CALLS_TCP_SERVER_ADDRESS
Note

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

RTC 서버 포트 (UDP)#

This setting controls the UDP port listened on by the RTC server. All calls UDP traffic will be served through this port. Changing this setting requires a plugin restart to take effect. Default is 8443.- System Config path: Plugins > Calls - config.json setting: PluginSettings > Plugins > com.mattermost.calls > udpserverport - Environment variable: MM_CALLS_UDP_SERVER_PORT
Note

이 설정은 독립형 rtcd 서비스를 통해 통화를 실행하지 않는 자체 호스팅 배포에만 적용됩니다.

RTC 서버 포트 (TCP)#

This setting controls the TCP port listened on by the RTC server. All calls TCP traffic will be served through this port. Changing this setting requires a plugin restart to take effect. Default is 8443.- System Config path: Plugins > Calls - config.json setting: PluginSettings > Plugins > com.mattermost.calls > tcpserverport - Environment variable: MM_CALLS_TCP_SERVER_PORT
Note

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

특정 채널에서 활성화#

Mattermost v7.7부터 관리자는 이 설정을 구성할 수 없으며 자체 호스팅 배포에서는 항상 활성화된 상태로 숨겨져 있습니다

- true: Channel admins can enable or disable calls on specific channels. Participants in DMs/GMs can also enable or disable calls. - false: Only system admins can enable or disable calls on specific channels.- System Config path: Plugins > Calls - config.json setting: PluginSettings > Plugins > com.mattermost.calls > allowenablecalls - Environment variable: MM_CALLS_ALLOW_ENABLE_CALLS

테스트 모드#

이 설정은 Mattermost v7.7 이전에는 "모든 채널에서 활성화"라고 불렸습니다. 코드에서 defaultenabled로, 제품 내에서는 테스트 모드로 이름이 변경되었으며 자체 호스팅 배포에만 적용됩니다.

- false: Test mode is enabled and only system admins can start calls in channels. - true: Live mode is enabled and all team members can start calls in channels.- System Config path: Plugins > Calls - config.json setting: PluginSettings > Plugins > com.mattermost.calls > defaultenabled - Environment variable: MM_CALLS_DEFAULT_ENABLED
Note

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

ICE 호스트 재정의#

This setting can be used to override the host addresses that get advertised to clients when connecting to calls. The accepted formats are the following: - A single IP address (e.g. 10.0.0.1). - A single hostname or FQDN (e.g. calls.myserver.tld). - (starting in v0.17.0) A comma separated list of externalAddr/internalAddr mappings (e.g. 10.0.0.1/172.0.0.1,10.0.0.2/172.0.0.2). This is an optional field. Changing this setting requires a plugin restart to take effect.- System Config path: Plugins > Calls - config.json setting: PluginSettings > Plugins > com.mattermost.calls > icehostoverride - Environment variable: MM_CALLS_ICE_HOST_OVERRIDE
Note
    • 이 설정은 독립형 rtcd 서비스를 통해 통화를 실행하지 않는 자체 호스팅 배포에만 적용됩니다.
    • 네트워크 인프라(예: NAT 장치 뒤의 인스턴스)에 따라 클라이언트가 연결하기 위해 이 필드를 클라이언트가 직접 접속하는 외부 IP로 설정해야 할 수 있습니다. 비어 있거나 설정되지 않은 경우 RTC 서비스는 STUN을 통해 인스턴스의 공인 IP를 찾으려고 시도합니다.
    • 이 설정에 호스트명(예: 도메인 이름)을 지정할 수 있지만 IP 주소가 클라이언트에 전달됩니다. 이는 Mattermost 인스턴스에서 DNS 해석이 발생하여 클라이언트가 보는 IP 주소와 다를 수 있어 연결 실패를 유발할 수 있음을 의미합니다. 확신이 없을 때는 IP 주소를 직접 사용하거나 호스트 측의 해석이 클라이언트 측과 일치하는지 확인하는 것을 권장합니다.

ICE 호스트 포트 재정의#

This setting can be used to override the port used in the ICE host candidates that get advertised to clients when connecting to calls. This can be useful in case there are additional network components (e.g. NLBs) in front of the RTC server that may route the calls traffic through a different port. Changing this setting requires a plugin restart to take effect.- System Config path: Plugins > Calls - config.json setting: PluginSettings > Plugins > com.mattermost.calls > icehostportoverride - Environment variable: MM_CALLS_ICE_HOST_PORT_OVERRIDE
Note
    • 이 설정은 자체 호스팅 배포에만 적용됩니다.
    • 이 값은 UDP 및 TCP 호스트 후보 모두에 적용됩니다.

RTCD 서비스 URL#

The URL to a running rtcd service instance that will host the calls. When set (non empty) all the calls will be handled by this external service. This is an optional field. Changing this setting requires a plugin restart to take effect.- System Config path: Plugins > Calls - config.json setting: PluginSettings > Plugins > com.mattermost.calls > rtcdserviceurl - Environment variable: MM_CALLS_RTCD_SERVICE_URL
Note
    • 이 설정은 자체 호스팅 배포에만 적용됩니다.
    • 환경 변수 MM_CALLS_RTCD_URL은 MM_CALLS_RTCD_SERVICE_URL을 선호하여 더 이상 사용되지 않습니다.
    • 클라이언트는 서비스에 처음 연결할 때 자동으로 등록되고 인증 키를 데이터베이스에 저장합니다. 클라이언트 ID가 명시적으로 제공되지 않으면 Mattermost 설치의 진단 ID가 사용됩니다.
    • 서비스 URL은 http://clientID:authKey@hostname 형식의 자격 증명을 지원합니다. 또는 이를 Mattermost 서버의 환경 재정의를 통해 전달할 수 있습니다: MM_CALLS_RTCD_CLIENT_ID 및 MM_CALLS_RTCD_AUTH_KEY.

최대 통화 참가자 수#

This setting limits the number of participants that can join a single call. Default is 0 (no limit).- System Config path: Plugins > Calls - config.json setting: PluginSettings > Plugins > com.mattermost.calls > maxcallparticipants - Environment variable: MM_CALLS_MAX_CALL_PARTICIPANTS
Note
    • 이 설정은 자체 호스팅 배포에만 적용됩니다.
    • 환경 변수 MM_CALLS_MAX_PARTICIPANTS는 MM_CALLS_MAX_CALL_PARTICIPANTS를 선호하여 더 이상 사용되지 않습니다.
    • 이 설정은 선택 사항이지만 권장되는 최대 참가자 수는 50명입니다. 통화 참가자 제한은 인스턴스 리소스에 크게 의존합니다. 자세한 내용은 Calls 배포 가이드 문서를 참조하세요.

ICE 서버 구성#

This setting stores a list of ICE servers (STUN/TURN) in JSON format to be used by the service. This is an optional field. Changing this setting may require a plugin restart to take effect. Default is [{"urls": ["stun:stun.global.calls.mattermost.com:3478"]}]- System Config path: Plugins > Calls - config.json setting: PluginSettings > Plugins > com.mattermost.calls > iceserversconfigs - Environment variable: MM_CALLS_ICE_SERVERS_CONFIGS
Note
    • 이 설정은 자체 호스팅 배포에만 적용됩니다.
    • STUN 및 TURN 서버가 포함된 위의 구성은 클라이언트에 전송되어 로컬 후보를 생성하는 데 사용됩니다.
    • 플러그인을 통해 통화를 호스팅하는 경우(즉, RTCD service를 사용하지 않는 경우) ICE Host Override 옵션을 통해 제공되지 않을 때 구성된 STUN 서버를 인스턴스의 공인 IP를 찾는 데 사용할 수 있습니다.

Example

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

Example (Using generated TURN credentials)

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

TURN 생성 자격 증명이 작동하려면 아래 TURN 정적 인증 시크릿 설정을 통해 시크릿을 제공해야 합니다.

TURN 정적 인증 시크릿#

A static secret used to generate short-lived credentials for TURN servers. This is an optional field.- System Config path: Plugins > Calls - config.json setting: PluginSettings > Plugins > com.mattermost.calls > turnstaticauthsecret - Environment variable: MM_CALLS_TURN_STATIC_AUTH_SECRET
Note

이 설정은 자체 호스팅 배포에만 적용됩니다.

TURN 자격 증명 만료#

The expiration, in minutes, of the short-lived credentials generated for TURN servers. Default is 1440 (one day).- System Config path: Plugins > Calls - config.json setting: PluginSettings > Plugins > com.mattermost.calls > turncredentialsexpirationminutes - Environment variable: MM_CALLS_TURN_CREDENTIALS_EXPIRATION_MINUTES
Note

이 설정은 자체 호스팅 배포에만 적용됩니다.

    • true: The RTC server will use the configured TURN candidates for server-initiated connections.
    • false: TURN will be used only on the client-side.

서버 측 TURN#

- true: The RTC server will use the configured TURN candidates for server-initiated connections. - false: TURN will be used only on the client-side. Changing this setting requires a plugin restart to take effect.- System Config path: Plugins > Calls - config.json setting: PluginSettings > Plugins > com.mattermost.calls > serversideturn - Environment variable: MM_CALLS_SERVER_SIDE_TURN
Note

이 설정은 자체 호스팅 배포에만 적용됩니다.

    • true: Call participants will be allowed to share their screen.
    • false: Call participants won't be allowed to share their screen.

화면 공유 허용#

- true: Call participants will be allowed to share their screen. - false: Call participants won't be allowed to share their screen. Changing this setting requires a plugin restart to take effect.- System Config path: Plugins > Calls - config.json setting: PluginSettings > Plugins > com.mattermost.calls > allowscreensharing - Environment variable: MM_CALLS_ALLOW_SCREEN_SHARING
Note

이 설정은 자체 호스팅 배포에만 적용됩니다.

    • true: Enables simulcast for screen sharing. This can help to improve screen sharing quality.
    • false: (Default) Disables simulcast for screen sharing.

화면 공유에 시뮬캐스트 활성화 (실험적)#

- true: Enables simulcast for screen sharing. This can help to improve screen sharing quality. - false: Disables simulcast for screen sharing.- System Config path: Plugins > Calls - config.json setting: PluginSettings > Plugins > com.mattermost.calls > enablesimulcast - Environment variable: MM_CALLS_ENABLE_SIMULCAST
Note
    • 이 실험적 설정은 자체 호스팅 배포에만 적용됩니다.
    • 이 기능은 Calls 플러그인 버전 >= v0.16.0 및 (사용하는 경우) rtcd 버전 >= v0.10.0이 필요합니다.
    • 이 실험적 구성 설정과 AV1 활성화 실험적 구성 설정을 동시에 활성화하는 것을 피하세요.
    • true: Allows call hosts to record meeting video and audio.
    • false: (Default) Call recording functionality is not available to hosts.

통화 녹음 활성화#

- true: Allows call hosts to record meeting video and audio. - false: (Default) Call recording functionality is not available to hosts. Recordings include the entire call window view along with participants' audio track and any shared screen video. Recordings are stored in Mattermost. Changing this setting requires a plugin restart to take effect.- System Config path: Plugins > Calls - config.json setting: PluginSettings > Plugins > com.mattermost.calls > enablerecordings - Environment variable: MM_CALLS_ENABLE_RECORDINGS
Note

이 설정은 자체 호스팅 배포에만 적용됩니다.

작업 서비스 URL#

The URL to a running job service where all the processing related to recordings happens. The recorded files produced are stored in Mattermost. This is a required field. Changing this setting requires a plugin restart to take effect.- System Config path: Plugins > Calls - config.json setting: PluginSettings > Plugins > com.mattermost.calls > jobserviceurl - Environment variable: MM_CALLS_JOB_SERVICE_URL
Note
    • 이 설정은 자체 호스팅 배포에만 적용됩니다.
    • 클라이언트는 서비스에 처음 연결할 때 자동으로 등록되고 인증 키를 데이터베이스에 저장합니다. 클라이언트 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을 통해 연결하여 공개 네트워크를 우회하는 것을 방지하는 데 도움이 될 수 있습니다.

최대 통화 녹음 시간#

The maximum duration of a call recording in minutes. The default is 60. The maximum is 180. This is a required value.- System Config path: Plugins > Calls - config.json setting: PluginSettings > Plugins > com.mattermost.calls > maxrecordingduration - Environment variable: MM_CALLS_MAX_RECORDING_DURATION
Note

이 설정은 자체 호스팅 배포에만 적용됩니다.

통화 녹음 품질#

The audio and video quality of call recordings. Available options are: Low, Medium and High. The default is Medium. This is a required value.- System Config path: Plugins > Calls - config.json setting: PluginSettings > Plugins > com.mattermost.calls > recordingquality - Environment variable: MM_CALLS_RECORDING_QUALITY
Note
    • 이 설정은 자체 호스팅 배포에만 적용됩니다.
    • 품질 설정은 작업 서비스의 성능과 녹음 파일 크기에 영향을 미칩니다. 자세한 내용은 Calls 배포 가이드 문서를 참조하세요.
    • true: Enables automatic transcriptions of calls.
    • false: (Default) Call transcriptions functionality is disabled.

통화 전사 활성화#

- true: Enables automatic transcriptions of calls. - false: (Default) Call transcriptions functionality is disabled. Transcriptions are generated from the call participants' audio tracks and the resulting files are attached to the call thread when the recording ends. Captions will be optionally rendered on top of the recording file video player.- System Config path: Plugins > Calls - config.json setting: PluginSettings > Plugins > com.mattermost.calls > enabletranscriptions - Environment variable: MM_CALLS_ENABLE_TRANSCRIPTIONS
Note
    • 이 설정은 자체 호스팅 배포에만 적용됩니다.
    • Mattermost 통화에서 통화 전사를 활성화하는 기능은 현재 베타 단계에 있습니다.
    • 이 서버 측 구성 설정은 플러그인 버전 0.22부터 사용 가능합니다.
    • 통화 전사를 사용하려면 통화 녹음이 활성화되어 있어야 합니다.

전사기 모델 크기#

The speech-to-text model size to use. Heavier models will produce more accurate results at the expense of processing time and resources usage. Available options are: Tiny, Base and Small. The default is Base. This is a required value.- System Config path: Plugins > Calls - config.json setting: PluginSettings > Plugins > com.mattermost.calls > transcribermodelsize - Environment variable: MM_CALLS_TRANSCRIBER_MODEL_SIZE
Note
    • 이 설정은 자체 호스팅 배포에만 적용됩니다.
    • 이 설정은 플러그인 버전 0.22부터 사용 가능합니다. 모델 크기 설정은 작업 서비스의 성능에 영향을 미칩니다. 자세한 내용은 Calls 배포 가이드 문서를 참조하세요.

통화 전사기 스레드#

The number of threads used by the post-call transcriber. This must be in the range [1, numCPUs]. The default is 2. This is a required value.- System Config path: Plugins > Calls - config.json setting: PluginSettings > Plugins > com.mattermost.calls > transcribernumthread - Environment variable: MM_CALLS_TRANSCRIBER_NUM_THREADS
Note
    • 이 설정은 자체 호스팅 배포에만 적용됩니다.
    • 통화 전사기 스레드 설정은 작업 서비스의 성능에 영향을 미칩니다. 자세한 내용은 Calls 배포 가이드 문서를 참조하세요. 이 설정은 플러그인 버전 0.26.2부터 사용 가능합니다.
    • true: Enables live captioning of calls.
    • false: (Default) Live captions functionality is disabled.

실시간 자막 활성화#

- true: Enables live captioning of calls. - false: (Default) Live captions functionality is disabled. Live captions are generated from the call participants' audio tracks and the resulting captions can be optionally displayed on the call clients by selecting the [cc] option.- System Config path: Plugins > Calls - config.json setting: PluginSettings > Plugins > com.mattermost.calls > enablelivecaptions - Environment variable: MM_CALLS_ENABLE_LIVE_CAPTIONS
Note
    • Mattermost 통화에서 실시간 통화 자막을 활성화하는 기능은 현재 베타 단계에 있습니다.
    • 이 서버 측 구성 설정은 플러그인 버전 0.26.2부터 사용 가능합니다.
    • 실시간 자막을 사용하려면 통화 녹음 및 통화 전사가 활성화되어 있어야 합니다.

실시간 자막: 모델 크기#

The speech-to-text model size to use for live captions. While heavier models can produce more accurate results, live captioning requires the transcriber to process up to ten seconds of audio within two seconds. Therefore a maximum of size `base` is recommended. Available options are: Tiny, Base and Small. The default is Tiny. This is a required value.- System Config path: Plugins > Calls - config.json setting: PluginSettings > Plugins > com.mattermost.calls > livecaptionsmodelsize - Environment variable: MM_CALLS_LIVE_CAPTIONS_MODEL_SIZE
Note
    • 이 설정은 자체 호스팅 배포에만 적용됩니다.
    • 이 설정은 플러그인 버전 0.26.2부터 사용 가능합니다. 모델 크기 설정은 작업 서비스의 성능에 영향을 미칩니다. 자세한 내용은 성능 및 확장성 권장 사항 문서를 참조하세요.

실시간 자막: 통화당 사용할 전사기 수#

The number of separate live captions transcribers for each call. Each transcribes one audio stream at a time. The product of LiveCaptionsNumTranscribers * LiveCaptionsNumThreadsPerTranscriber must be in the range [1, numCPUs]. The default is 1. This is a required value.- System Config path: Plugins > Calls - config.json setting: PluginSettings > Plugins > com.mattermost.calls > livecaptionsnumtranscribers - Environment variable: MM_CALLS_LIVE_CAPTIONS_NUM_TRANSCRIBERS
Note
    • 이 설정은 자체 호스팅 배포에만 적용됩니다.
    • 이 설정은 플러그인 버전 0.26.2부터 사용 가능합니다. 실시간 자막의 전사기 수 설정은 작업 서비스의 성능에 영향을 미칩니다. 자세한 내용은 성능 및 확장성 권장 사항 문서를 참조하세요.

실시간 자막: 전사기당 스레드 수#

The number of threads per live-captions transcriber. The product of LiveCaptionsNumTranscribers * LiveCaptionsNumThreadsPerTranscriber must be in the range [1, numCPUs]. The default is 2. This is a required value.- System Config path: Plugins > Calls - config.json setting: PluginSettings > Plugins > com.mattermost.calls > livecaptionsnumthreadspertranscriber - Environment variable: MM_CALLS_LIVE_CAPTIONS_NUM_THREADS_PER_TRANSCRIBER
Note
    • 이 설정은 자체 호스팅 배포에만 적용됩니다.
    • 이 설정은 플러그인 버전 0.26.2부터 사용 가능합니다. 실시간 자막의 전사기당 스레드 수 설정은 작업 서비스의 성능에 영향을 미칩니다. 자세한 내용은 성능 및 확장성 권장 사항 문서를 참조하세요.

실시간 자막 언어#

The language passed to the live captions transcriber. Should be a 2-letter ISO 639 Set 1 language code, e.g. 'en'. If blank, the lange will be set to 'en' (English) as default.- System Config path: Plugins > Calls - config.json setting: PluginSettings > Plugins > com.mattermost.calls > livecaptionslanguage - Environment variable: MM_CALLS_LIVE_CAPTIONS_LANGUAGE
Note

이 설정은 자체 호스팅 배포에만 적용됩니다.

    • true: The RTC service will work in dual-stack mode, listening for IPv6 connections and generating candidates in addition to IPv4 ones.
    • false: (False) The RTC service will only listen for IPv4 connections.

IPv6 활성화 (실험적)#

- true: The RTC service will work in dual-stack mode, listening for IPv6 connections and generating candidates in addition to IPv4 ones. - false: (Default) The RTC service will only listen for IPv4 connections. Changing this setting requires a plugin restart to take effect.- System Config path: Plugins > Calls - config.json setting: PluginSettings > Plugins > com.mattermost.calls > enableipv6 - Environment variable: MM_CALLS_ENABLE_IPV6
Note
    • 이 설정은 자체 호스팅 배포에만 적용됩니다.
    • 이 설정은 플러그인 버전 0.17부터 사용 가능하며, 독립형 rtcd 서비스를 통해 통화를 실행하지 않는 경우에만 적용됩니다.
    • true: Ringing functionality is enabled. Direct and group message participants receive a desktop app alert and a ringing notification when a call starts.
    • false: (False) Ringing functionality is disabled.

통화 벨소리 활성화#

- true: Ringing functionality is enabled. Direct and group message participants receive a desktop app alert and a ringing notification when a call starts. - false: (Default) Ringing functionality is disabled.- System Config path: Plugins > Calls - config.json setting: PluginSettings > Plugins > com.mattermost.calls > enableringing - Environment variable: MM_CALLS_ENABLE_RINGING
Note

Mattermost 통화에서 통화 벨소리를 활성화하는 기능은 베타 단계에 있습니다.

    • true: Enables the ability to use the AV1 codec to encode screen sharing tracks. This can result in improved screen sharing quality for clients that support it.
    • false: (False) AV1 codec is disabled for screen sharing tracks.

AV1 활성화 (실험적)#

- true: Enables the ability to use the AV1 codec to encode screen sharing tracks. Can result in improved screen sharing quality via clients that support AV1 encoding. - false: (Default) AV1 codec is disabled for screen sharing tracks.- System Config path: Plugins > Calls - config.json setting: PluginSettings > Plugins > com.mattermost.calls > enableAV1 - Environment variable: MM_CALLS_ENABLE_AV1
Note

이 실험적 구성 설정과 화면 공유에 시뮬캐스트 활성화 실험적 구성 설정을 동시에 활성화하는 것을 피하세요.

    • true: Clients will use WebRTC data channels for signaling of media tracks (i.e., voice, screen). This can result in a more efficient and less race-prone process, especially in case of poor network connections.
    • false: (False) Clients will use WebSockets for signaling media tracks.

DC 신호 활성화 (실험적)#

- true: Clients will use WebRTC data channels for signaling of media tracks (i.e., voice, screen). This can result in a more efficient and less race-prone process, especially in case of poor network connections. - false: (Default) Clients will use WebSockets for signaling media tracks.- System Config path: Plugins > Calls - config.json setting: PluginSettings > Plugins > com.mattermost.calls > enabledcsignaling - Environment variable: MM_CALLS_ENABLE_DC_SIGNALING

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

AI 에이전트#

Note

Mattermost Agents는 이전에 Mattermost Copilot으로 알려져 있었습니다.

Plugins > Agents로 이동하여 System Console에서 다음 Mattermost Agents 구성 설정에 접근합니다.

  • true: Enables the Agents plugin on your Mattermost workspace.
  • false: (Default) Disables the Agents plugin on your Mattermost workspace.

플러그인 활성화#

- true: Enables the Agents plugin on your Mattermost workspace. - false: (Default) Disables the Agents plugin.- System Config path: Plugins > Agents - config.json setting: N/A - Environment variable: N/A

표시 이름#

The bot's display name in Mattermost used to distinguish the bot from other bots in the system. String input.- System Config path: Plugins > Agents > Add an AI Bot - config.json setting: N/A - Environment variable: N/A

에이전트 사용자명#

The bot's username that can be used to @mention the bot in a channel. String input.- System Config path: Plugins > Agents > Add an AI Bot - config.json setting: N/A - Environment variable: N/A

에이전트 아바타#

Upload an image to use as the agent's avatar in Mattermost. Image upload interface.- System Config path: Plugins > Agents > Add an AI Bot - config.json setting: N/A - Environment variable: N/A

서비스#

Select the LLM service provider to use for AI assistance. Available options: OpenAI, OpenAI Compatible, Azure, Anthropic, and Ask Sage.- System Config path: Plugins > Agents > Add an AI Bot - config.json setting: N/A - Environment variable: N/A

사용자명#

The username used to authenticate with the Ask Sage LLM service. String input required.- System Config path: Plugins > Agents > Add an AI Bot - config.json setting: N/A - Environment variable: N/A

비밀번호#

The password used to authenticate with the Ask Sage LLM service. String input required. This value is encrypted when stored.- System Config path: Plugins > Agents > Add an AI Bot - config.json setting: N/A - Environment variable: N/A

API URL#

The endpoint that Mattermost will use to communicate with the LLM's API. Required for OpenAI Compatible and Azure LLM services. String input (URL format).- System Config path: Plugins > Agents > Add an AI Bot - config.json setting: N/A - Environment variable: N/A

API key#

The key used to authenticate requests to the LLM's API. Required for OpenAI, OpenAI Compatible, and Anthropic LLM services. String input. This value is encrypted when stored.- System Config path: Plugins > Agents > Add an AI Bot - config.json setting: N/A - Environment variable: N/A

조직 ID#

Ensures that requests are billed and processed under the correct organization, where applicable. Supported for OpenAI, OpenAI Compatible, and Azure LLM services. String input.- System Config path: Plugins > Agents > Add an AI Bot - config.json setting: N/A - Environment variable: N/A
  • true: Includes unique user identifiers in API requests to the LLM.
  • false: (Default) Does not include user identifiers in API requests.

사용자 ID 전송#

- true: Includes unique user identifiers in API requests to the LLM for analytics, personalization, and auditing purposes. - false: (Default) Does not include user identifiers. Review LLM data privacy policies before enabling this setting.- System Config path: Plugins > Agents > Add an AI Bot - config.json setting: N/A - Environment variable: N/A
Note

We recommend reviewing LLM data privacy policies to confirm whether transmitting user information is acceptable and secure within your organization's regulatory framework. Do not enable when you need to conform to strict privacy regulations (e.g., GDPR) that limit sharing user-identifiable data with external services.

기본 모델#

The specific LLM that will be used to process queries if no other model is explicitly selected. Supported for all LLM services. String input (model name).- System Config path: Plugins > Agents > Add an AI Bot - config.json setting: N/A - Environment variable: N/A

입력 토큰 제한#

The maximum number of tokens (chunks of text, including words, punctuation, or special characters) that the selected LLM can process in a single prompt or request. Numerical value. Directly impacts the size of user queries that can be handled.- System Config path: Plugins > Agents > Add an AI Bot - config.json setting: N/A - Environment variable: N/A

출력 토큰 제한#

The maximum number of tokens (chunks of text, including words, punctuation, or special characters) that the LLM can generate in its response to a query. Numerical value. Must be greater than 0 for Anthropic LLM services.- System Config path: Plugins > Agents > Add an AI Bot - config.json setting: N/A - Environment variable: N/A

스트리밍 타임아웃#

Determines how long the system will wait for a response from the LLM when using streaming (real-time) output mode. Supported for OpenAI, OpenAI Compatible, and Azure LLM services. Numerical value (in seconds). If the LLM takes longer than the configured timeout, the connection is terminated.- System Config path: Plugins > Agents > Add an AI Bot - config.json setting: N/A - Environment variable: N/A
Note

스트리밍은 LLM이 응답을 생성하면서 점진적으로 표시할 수 있게 하여 사용자에게 더 부드럽고 상호작용적인 경험을 제공합니다.

커스텀 지침#

Preset specific contextual or behavioral guidance for the LLM. Helps tailor the model's responses to align with your organization's needs, tone, or expectations. Supported for all LLM services. Text input. Instructions that the model will implicitly follow for every interaction, providing consistency and adaptability.- System Config path: Plugins > Agents > Add an AI Bot - config.json setting: N/A - Environment variable: N/A
Note

커스텀 지침에는 행동 지침, 어조 기본 설정, 상황별 기능 및 조직 기본 설정이 포함될 수 있습니다. 이를 통해 응답이 조직의 언어 및 어조 가이드라인을 준수하고 모델의 동작을 특정 역할이나 목적에 맞게 조정할 수 있습니다.

    • true: Enables the LLM to process and generate responses that incorporate image-related input or output.
    • false: (Default) Disables vision capabilities.

비전 활성화#

- true: Enables the LLM to process and generate responses that incorporate image-related input or output. Supported for OpenAI, OpenAI Compatible, Azure, and Anthropic LLM services. - false: (Default) Disables vision capabilities.- System Config path: Plugins > Agents > Add an AI Bot - config.json setting: N/A - Environment variable: N/A
Note

이 기능은 베타 단계에 있습니다. 활성화하면 LLM은 이미지 분석, 시각적 관련 지원, 시각적 출력과 같은 이미지 관련 입력이 포함된 프롬프트와 상호작용할 수 있습니다(지원되는 경우).

    • true: Enables the LLM to leverage additional tools or plugins to enhance its capabilities.
    • false: (Default) Disables tool capabilities.

도구 활성화#

- true: Enables the LLM to leverage additional tools or plugins to enhance its capabilities. Supported for OpenAI, OpenAI Compatible, Azure, and Anthropic LLM services. - false: (Default) Disables tool capabilities.- System Config path: Plugins > Agents > Add an AI Bot - config.json setting: N/A - Environment variable: N/A
Note

활성화하면 기본 쿼리 처리를 넘어서는 고급 기능을 통해 LLM이 데이터 검색, 외부 API와의 통합, 계산 수행 등의 특화된 작업을 수행할 수 있습니다(지원되는 경우).

채널 접근#

Determines whether the bot can consume the contents of a given channel and provide answers only from content available in the channel. Supported for all LLM services. Available options: Allow for all channels, Allow for selected channels, Block selected channels, and Block all channels.- System Config path: Plugins > Agents > Add an AI Bot - config.json setting: N/A - Environment variable: N/A

사용자 접근#

Determines whether users who chat with this bot can get private assistance about content across all channels the user has access to. Supported for all LLM services. Available options: Allow for all users, Allow for selected users, and Block selected users.- System Config path: Plugins > Agents > Add an AI Bot - config.json setting: N/A - Environment variable: N/A

기본 에이전트#

Select the default bot to use for AI functions when multiple agents are configured. Based on defined agents.- System Config path: Plugins > Agents > AI Functions - config.json setting: N/A - Environment variable: N/A

허용된 업스트림 호스트명#

Comma-separated list of hostnames that LLMs are allowed to contact when using tools. Supports wildcards like *.mydomain.com. Example: mattermost.atlassian.net to allow JIRA tool use.- System Config path: Plugins > Agents > AI Functions - config.json setting: N/A - Environment variable: N/A
  • true: Enables tracing of LLM requests and outputs full conversation data to the logs.
  • false: (Default) Disables LLM request tracing.

LLM 추적 활성화#

- true: Enables tracing of LLM requests and outputs full conversation data to the logs. Supported for all LLM services. - false: (Default) Disables LLM request tracing.- System Config path: Plugins > Agents > Debug - config.json setting: N/A - Environment variable: N/A
Note

이 설정은 디버깅 목적으로만 사용하세요. 활성화하면 민감한 대화 데이터가 로깅될 수 있습니다.

    • Composite: Enables experimental embedding search capabilities for semantic search across Mattermost content.
    • Disabled: (Default) Disables embedding search capabilities.

임베딩 검색 활성화#

- Composite: Enables experimental embedding search capabilities for semantic search across Mattermost content using pgvector and OpenAI-compatible endpoints. - Disabled: (Default) Disables embedding search capabilities.- System Config path: Plugins > Agents > Embedding Search - config.json setting: N/A - Environment variable: N/A
Note

임베딩 검색은 Enterprise 라이선스가 필요하며 실험적 기능으로 사용 가능합니다. PostgreSQL 데이터베이스에서 pgvector 확장을 활성화해야 합니다. 대규모 데이터셋에서는 성능이 다를 수 있습니다.

임베딩 공급자 유형#

Select the provider for generating embeddings for semantic search. Available options: OpenAI and OpenAI Compatible.- System Config path: Plugins > Agents > Embedding Search - config.json setting: N/A - Environment variable: N/A

API Key#

The API key used to authenticate requests to the embedding provider's API. Required for OpenAI Compatible embedding providers. String input. This value is encrypted when stored.- System Config path: Plugins > Agents > Embedding Search - config.json setting: N/A - Environment variable: N/A

모델#

The specific embedding model to use for generating vector representations of content. Must be compatible with the selected embedding provider. String input (model name).- System Config path: Plugins > Agents > Embedding Search - config.json setting: N/A - Environment variable: N/A

API URL#

The endpoint URL for the OpenAI-compatible embedding API. Required string input (URL format).- System Config path: Plugins > Agents > Embedding Search - config.json setting: N/A - Environment variable: N/A

차원#

The dimensionality of the embedding vectors, which must match the chosen embedding model. Common values include 1536 for OpenAI text-embedding-ada-002 and 3072 for text-embedding-3-large. Numerical input. Common values are 768, 1024, or 1536, depending on the model.- System Config path: Plugins > Agents > Embedding Search - config.json setting: N/A - Environment variable: N/A

청킹 전략#

The method used to split content into smaller chunks for embedding generation. Available options: Sentences, Paragraphs, Fixed Size. Choose based on your content type and search requirements.- System Config path: Plugins > Agents > Embedding Search - config.json setting: N/A - Environment variable: N/A

청크 크기#

The maximum size of each content chunk in characters. Recommended range is 512-1024 characters. The optimal value varies by chunking strategy. Numerical input.- System Config path: Plugins > Agents > Embedding Search - config.json setting: N/A - Environment variable: N/A

청크 중복#

The number of tokens that consecutive chunks share for better context continuity. Recommended range is 20-50 characters for Fixed Size chunking. Numerical input.- System Config path: Plugins > Agents > Embedding Search - config.json setting: N/A - Environment variable: N/A

최소 청크 크기 비율#

The minimum ratio for chunk size validation to ensure sentence and paragraph chunks meet size requirements. Used to filter out chunks that are too small releative to the configured chunk size. Numerical input (decimal ratio).- System Config path: Plugins > Agents > Embedding Search - config.json setting: N/A - Environment variable: N/A

모든 게시물 재인덱싱#

Select Reindex Posts to trigger a complete reindexing of all posts for embedding search. Use this control to rebuild the search index when changing embeddingproviders, models, or chunking configurations. Monitor indexing progress during the reindexing process.- System Config path: Plugins > Agents > Embedding Search - config.json setting: N/A - Environment variable: N/A

GitLab#

자세한 내용은 GitLab을 Mattermost에 연결 제품 문서를 참조하세요.

GitHub#

자세한 내용은 GitHub을 Mattermost에 연결 제품 문서를 참조하세요.

Jira#

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

법적 보존#

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

Microsoft 캘린더 통합#

사용 가능한 Mattermost 구성 옵션에 대해서는 Microsoft 캘린더 통합을 Mattermost에 연결 제품 문서를 참조하세요.

Microsoft Teams 회의#

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

MS Teams#

Microsoft Teams용 Mattermost는 Teams에서 Mattermost로 실시간 채팅 알림을 전달하여 Mattermost와 Teams가 혼합된 환경에서 사일로를 극복할 수 있게 합니다.

Tip

Microsoft Teams용 Mattermost 데이터시트를 다운로드하여 Mattermost가 조직에서 Microsoft 도구를 더 잘 활용하는 방법을 알아보세요.

Plugins > MS Teams로 이동하여 System Console에서 다음 구성 설정에 접근합니다.

  • true: Enables the MS Teams plugin on your Mattermost workspace.
  • false: Disables the MS Teams plugin on your Mattermost workspace.

플러그인 활성화#

Enable the Mattermost for Microsoft Teams plugin for all Mattermost teams. - true: Enables MS Teams plugin on your Mattermost workspace. - false: (Default) Disables the MS Teams plugin.- System Config path: Plugins > MS Teams - config.json setting: N/A - Environment variable: N/A
Note

Use the Enabled Teams configuration option to specify which Mattermost teams synchronize

direct and group messages with Microsoft Teams chats.

테넌트 ID#

Specify the Microsoft Teams Tenant ID from the Azure portal.- System Config path: Plugins > MS Teams - config.json setting: N/A - Environment variable: N/A

클라이언트 ID#

Specify the Microsoft Teams Client ID of your registered OAuth app in the Azure portal.- System Config path: Plugins > MS Teams - config.json setting: N/A - Environment variable: N/A

클라이언트 시크릿#

Specify the client secret of your registered OAuth app in Azure portal. Alpha-numeric value.- System Config path: Plugins > MS Teams - config.json setting: N/A - Environment variable: N/A

정지 암호화 키#

Regenerate a new encryption secret. This encryption secret will be used to encrypt and decrypt the OAuth token. Alpha-numeric value.- System Config path: Plugins > MS Teams - config.json setting: N/A - Environment variable: N/A
Note

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

웹훅 시크릿#

Generate the webhook secret that Microsoft Teams will use to send messages to Mattermost.- System Config path: Plugins > MS Teams - config.json setting: N/A - Environment variable: N/A
Note

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

    • true: Enables the evaluation API pay model. Enable this only for testing purposes. You need the pay model to be able to support enough message notifications to work in a real world scenario.
    • false: Disables the evaluation API pay model.

평가용 API 유료 모델 사용#

Enable this only for testing purposes. You need the pay model to be able to support enough message notifications to work in a real world scenario. - true: Enables the evaluation API pay model. - false: (Default) Disables the evaluation API pay model.- System Config path: Plugins > MS Teams - config.json setting: N/A - Environment variable: N/A
  • true: Users are required to connect their Mattermost and Microsoft Teams accounts.
  • false: Users aren't required to connect their Mattermost and Microsoft Teams accounts.

동기화 알림#

Notify connected users in Mattermost on receipt of a chat or group chat from Microsoft Teams. - true: (Default) Sync notifications of chat messages for any connected user that enables the feature. - false: Do not sync notifications.- System Config path: Plugins > MS Teams - config.json setting: N/A - Environment variable: N/A

첨부 파일 일회성 전체 다운로드를 위한 최대 크기#

Specify the maximum file size, in mebibytes (MiB), of attachments that can be loaded into memory. Attachment files larger than this value will be streamed from Microsoft Teams to Mattermost. Numerical value. Default is 20 MiB.- System Config path: Plugins > MS Teams - config.json setting: N/A - Environment variable: N/A

스트리밍 파일 버퍼 크기#

Specify the buffer size, in mebibytes (MiB), for streaming attachment files from Microsoft Teams to Mattermost. Numerical value. Default is 20 MiB.- System Config path: Plugins > MS Teams - config.json setting: N/A - Environment variable: N/A

성능 메트릭#

사용 가능한 Mattermost 구성 옵션은 성능 메트릭 모니터링 제품 문서를 참조하세요.

협업 플레이북#

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

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

  • true: (Default) Enables collaborative playbooks on your Mattermost workspace.
  • false: Disables collaborative playbooks on your Mattermost workspace.

플러그인 활성화#

- true: (Default) Enables collaborative Playbooks on your Mattermost workspace. - false: Disables collaborative Playbooks on your Mattermost workspace.- System Config path: Plugins > Collaborative playbooks - config.json setting: - Environment variable:

활성화된 팀#

Enable collaborative playbooks for all Mattermost teams, or for only selected teams.- System Config path: Plugins > Collaborative playbooks - config.json setting: - Environment variable:
  • true: Enables experimental playbooks features on your Mattermost workspace.
  • false: Disables experimental playbooks features on your Mattermost workspace.

실험적 기능 활성화#

- true: Enables experimental playbooks features on your Mattermost workspace. - false: Disables experimental playbooks features on your Mattermost workspace.- System Config path: Plugins > Collaborative playbooks - config.json setting: - Environment variable:

ServiceNow#

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

Zoom#

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

config.json 전용 설정#

다음 자체 호스팅 배포 설정은 config.json 파일에서만 구성할 수 있으며 시스템 콘솔에서는 사용할 수 없습니다.

서명 공개 키 파일#

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

서버에 내장된 Mattermost 플러그인 서명 키 외에도 여기에 지정된 각 공개 키는 플러그인 서명의 유효성을 검사하기 위해 신뢰됩니다.

Important

Mattermost v10.11부터 사전 패키지된 플러그인은 시작 시 서명 유효성 검사가 필요합니다. 사용자 지정 사전 패키지된 플러그인을 번들로 묶는 배포판은 서명된 플러그인의 올바른 유효성 검사를 보장하기 위해 사용자 지정 공개 키로 이 설정을 구성해야 합니다. 사용자 지정 플러그인 서명 키를 정의하려면 PluginSettings.SignaturePublicKeyFiles를 사용하세요.

사용자 지정 플러그인을 번들로 묶는 경우:

    • 플러그인 파일과 해당 .sig 서명 파일을 모두 prepackaged_plugins 디렉터리에 넣습니다.
    • 서명의 유효성을 검사하기 위해 이 구성 설정을 사용하여 사용자 지정 공개 키를 추가합니다.
This feature's config.json setting is "SignaturePublicKeyFiles": {} with string array input consisting of contents that are relative or absolute paths to signature files.

Chimera OAuth 프록시 URL#

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

Mattermost 플러그인이 미리 생성된 OAuth 애플리케이션에 연결하는 데 사용하는 Chimera URL을 지정합니다.

This feature's config.json setting is "ChimeraOAuthProxyUrl": {} with string input.

플러그인 구성 설정

원문 보기
요약

제품 메뉴를 선택하고 System Console을 선택한 다음 Plugins를 선택하여 System Console에서 다음 플러그인 구성 옵션을 검토하고 관리합니다: 자체 호스팅 Mattermost 배포를 관리하는 시스템 관리자는 다음 표에서 설명한 대로 config.json 파일을 편집할 수 있습니다.

제품 메뉴를 선택하고 System Console을 선택한 다음 Plugins를 선택하여 System Console에서 다음 플러그인 구성 옵션을 검토하고 관리합니다:

Tip

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

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

#

플러그인 관리#

Plugins > Plugin Management로 이동하여 System Console에서 다음 구성 설정에 접근합니다.

  • true: (Default) Enables plugins on your Mattermost server.
  • false: Disables plugins on your Mattermost server.

플러그인 활성화#

- true: (Default) Enables plugins on your Mattermost server. See the Use plugins with Mattermost documentation for details. - false: Disables plugins on your Mattermost server.- System Config path: Plugins > Plugin Management - config.json setting: PluginSettings > Enable > true - Environment variable: MM_PLUGINSETTINGS_ENABLE
Note

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

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

플러그인 서명 요구#

- true: (Default) Enables plugin signature validation for managed and unmanaged plugins. - false: Disables plugin signature validation for managed and unmanaged plugins.- System Config path: Plugins > Plugin Management - config.json setting: PluginSettings > RequirePluginSignature > true - Environment variable: MM_PLUGINSETTINGS_REQUIREPLUGINSIGNATURE
Note
    • 이 설정은 자체 호스팅 배포에만 적용됩니다.
    • Mattermost 서버 v10.11부터 사전 패키지 플러그인은 시작 시 서명 유효성 검사가 필요합니다. 커스텀 사전 패키지 플러그인을 번들로 제공하는 배포판은 서명을 검증하기 위해 PluginSettings.SignaturePublicKeyFiles를 통해 커스텀 공개 키를 구성해야 합니다.
    • Mattermost 서버 v10.10 이하: 사전 패키지 플러그인은 서명 유효성 검사 대상이 아닙니다.
    • 마켓플레이스를 통해 설치된 플러그인은 다운로드 시 항상 서명 유효성 검사 대상입니다.
    • 이 구성을 활성화하면 System Console에서 플러그인 파일 업로드가 비활성화됩니다.
    • true: (Default) Mattermost automatically installs and upgrades any enabled pre-packaged plugins.
    • false: Mattermost does not automatically install or upgrade pre-packaged plugins.

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

- true: (Default) Mattermost automatically installs and upgrades any enabled pre-packaged plugins. If a newer version is installed, no changes are made. - false: Mattermost does not automatically install or upgrade pre-packaged plugins. Pre-packaged plugins may be installed manually from the Marketplace, even when offline.- System Config path: Plugins > Plugin Management - config.json setting: PluginSettings > AutomaticPrepackagedPlugins > true - Environment variable: MM_PLUGINSETTINGS_AUTOMATICPREPACKAGEDPLUGINS
Note

사전 패키지 플러그인 설치 동작: 시스템 관리자가 플러그인 파일(및 .sig 서명 파일)을 prepackaged_plugins 디렉터리에 넣으면 플러그인이 자동으로 설치되지 않습니다. 사전 패키징은 플러그인을 "오프라인" 설치를 위해 사용 가능하게 만듭니다. 플러그인은 시스템 관리자가 해당 플러그인이 활성화된 상태로 config.json을 사전 구성한 경우에만 자동으로 설치됩니다.

    • true: Enables system admins to upload plugins from the local computer to the Mattermost server.
    • false: (Default) Disables uploading of plugins from the local computer to the Mattermost server.

플러그인 업로드#

- true: Enables you to upload plugins from the local computer to the Mattermost server. - false: (Default) Disables uploading of plugins from the local computer to the Mattermost server.- System Config path: Plugins > Plugin Management - config.json setting: PluginSettings > EnableUploads > false - Environment variable: MM_PLUGINSETTINGS_ENABLEUPLOADS
Note
    • 이 설정은 자체 호스팅 배포에만 적용됩니다.
    • 플러그인 업로드가 활성화된 경우, 플러그인 파일 업로드 시 Received invlaid response from the server 오류는 일반적으로 MaxFileSize 구성 설정이 플러그인 파일 업로드를 지원하기에 충분히 크지 않다는 것을 나타냅니다. 추가 프록시 설정 업데이트도 필요할 수 있습니다.
    • 플러그인 서명 요구 구성 설정이 활성화된 경우 플러그인 파일 업로드 기능이 비활성화됩니다.
    • true: (Default) Enables the plugin Marketplace on your Mattermost server for all system admins.
    • false: Disables the plugin Marketplace on your Mattermost server for all system admins.

마켓플레이스 활성화#

- true: (Default) Enables the plugin Marketplace on your Mattermost server for all system admins. - false: Disables the plugin Marketplace on your Mattermost server for all system admins.- System Config path: Plugins > Plugin Management - config.json setting: PluginSettings > EnableMarketplace > true - Environment variable: MM_PLUGINSETTINGS_ENABLEMARKETPLACE
  • true: (Default) Mattermost attempts to connect to the endpoint set in MarketplaceURL.
  • false: Mattermost doesn't attempt to connect to a remote Marketplace, and shows only pre-packaged and installed plugins.

원격 마켓플레이스 활성화#

- true: (Default) Mattermost attempts to connect to the endpoint set in Marketplace URL. If the connection fails, an error is displayed, and the Marketplace only shows pre-packaged and installed plugins. - false: Mattermost does not attempt to connect to a remote Marketplace. The Marketplace shows only pre-packaged and installed plugins. Use this setting if your Mattermost server cannot connect to the Internet.- System Config path: Plugins > Plugin Management - config.json setting: PluginSettings > EnableRemoteMarketplace > true - Environment variable: MM_PLUGINSETTINGS_ENABLEREMOTEMARKETPLACE
Note
    • Mattermost v9.1부터 구성된 원격 마켓플레이스 URL에 접근하려면 이 구성 설정 값을 true로 설정하세요.
    • Mattermost v9.0의 경우 구성된 원격 마켓플레이스 URL에 접근하려면 MM_FEATUREFLAGS_STREAMLINEDMARKETPLACE 기능 플래그를 false로 설정하고 이 구성 설정을 true로 설정해야 합니다.
    • 각 Mattermost 호스트는 MarketplaceURL에 설정된 엔드포인트에 대한 네트워크 접근 권한이 있어야 합니다.

마켓플레이스 URL#

This setting stores the URL for the remote Markeplace. String input. Default is https://api.integrations.mattermost.com- System Config path: Plugins > Plugin Management - config.json setting: PluginSettings > MarketplaceURL - Environment variable: MM_PLUGINSETTINGS_MARKETPLACEURL

설치된 플러그인 상태#

This setting is a list of installed plugins and their status as enabled or disabled. The config.json setting is an object. The object keys are plugin IDs, e.g. com.mattermost.apps. Each key maps to an object that contains an Enable key that can be set as true or false.- System Config path: Plugins > Plugin Management - config.json setting: PluginSettings > PluginStates - Environment variable: MM_PLUGINSETTINGS_PLUGINSTATES

플러그인 설정#

This setting contains plugin-specific data. The config.json setting is an object. The object keys are plugin IDs, e.g. com.mattermost.apps. Each key maps to an object that contains plugin-specific data.- System Config path: Plugins > Plugin Management - config.json setting: PluginSettings > Plugins - Environment variable: MM_PLUGINSETTINGS_PLUGINS

Calls#

Plugins > Calls로 이동하여 System Console에서 다음 구성 설정에 접근합니다.

  • true: (Default) Enables the calls plugin on your Mattermost workspace.
  • false: Disables the calls plugin on your Mattermost workspace.

플러그인 활성화#

- true: (Default) Enables the Calls plugin on your Mattermost workspace. - false: Disables the Calls plugin on your Mattermost workspace.- System Config path: Plugins > Calls - config.json setting: PluginSettings > PluginStates > com.mattermost.calls > Enable - Environment variable: MM_PLUGINSETTINGS_PLUGINSTATES_COM_MATTERMOST_CALLS

RTC 서버 주소 (UDP)#

This setting controls the IP address the RTC server listens for UDP connections. All calls UDP traffic will be served through this IP. Changing this setting requires a plugin restart to take effect. If left unset (default value) the service will listen on all the available interfaces.- System Config path: Plugins > Calls - config.json setting: PluginSettings Plugins > com.mattermost.calls > udpserveraddress - Environment variable: MM_CALLS_UDP_SERVER_ADDRESS
Note

이 설정은 자체 호스팅 배포에만 적용되며, 독립형 rtcd 서비스를 통해 통화를 실행하지 않는 경우에만 적용됩니다.

RTC 서버 주소 (TCP)#

This setting controls the IP address the RTC server listens for TCP connections. All calls TCP traffic will be served through this IP. Changing this setting requires a plugin restart to take effect. If left unset (default value) the service will listen on all the available interfaces.- System Config path: Plugins > Calls - config.json setting: PluginSettings > Plugins > com.mattermost.calls > tcpserveraddress - Environment variable: MM_CALLS_TCP_SERVER_ADDRESS
Note

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

RTC 서버 포트 (UDP)#

This setting controls the UDP port listened on by the RTC server. All calls UDP traffic will be served through this port. Changing this setting requires a plugin restart to take effect. Default is 8443.- System Config path: Plugins > Calls - config.json setting: PluginSettings > Plugins > com.mattermost.calls > udpserverport - Environment variable: MM_CALLS_UDP_SERVER_PORT
Note

이 설정은 독립형 rtcd 서비스를 통해 통화를 실행하지 않는 자체 호스팅 배포에만 적용됩니다.

RTC 서버 포트 (TCP)#

This setting controls the TCP port listened on by the RTC server. All calls TCP traffic will be served through this port. Changing this setting requires a plugin restart to take effect. Default is 8443.- System Config path: Plugins > Calls - config.json setting: PluginSettings > Plugins > com.mattermost.calls > tcpserverport - Environment variable: MM_CALLS_TCP_SERVER_PORT
Note

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

특정 채널에서 활성화#

Mattermost v7.7부터 관리자는 이 설정을 구성할 수 없으며 자체 호스팅 배포에서는 항상 활성화된 상태로 숨겨져 있습니다

- true: Channel admins can enable or disable calls on specific channels. Participants in DMs/GMs can also enable or disable calls. - false: Only system admins can enable or disable calls on specific channels.- System Config path: Plugins > Calls - config.json setting: PluginSettings > Plugins > com.mattermost.calls > allowenablecalls - Environment variable: MM_CALLS_ALLOW_ENABLE_CALLS

테스트 모드#

이 설정은 Mattermost v7.7 이전에는 "모든 채널에서 활성화"라고 불렸습니다. 코드에서 defaultenabled로, 제품 내에서는 테스트 모드로 이름이 변경되었으며 자체 호스팅 배포에만 적용됩니다.

- false: Test mode is enabled and only system admins can start calls in channels. - true: Live mode is enabled and all team members can start calls in channels.- System Config path: Plugins > Calls - config.json setting: PluginSettings > Plugins > com.mattermost.calls > defaultenabled - Environment variable: MM_CALLS_DEFAULT_ENABLED
Note

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

ICE 호스트 재정의#

This setting can be used to override the host addresses that get advertised to clients when connecting to calls. The accepted formats are the following: - A single IP address (e.g. 10.0.0.1). - A single hostname or FQDN (e.g. calls.myserver.tld). - (starting in v0.17.0) A comma separated list of externalAddr/internalAddr mappings (e.g. 10.0.0.1/172.0.0.1,10.0.0.2/172.0.0.2). This is an optional field. Changing this setting requires a plugin restart to take effect.- System Config path: Plugins > Calls - config.json setting: PluginSettings > Plugins > com.mattermost.calls > icehostoverride - Environment variable: MM_CALLS_ICE_HOST_OVERRIDE
Note
    • 이 설정은 독립형 rtcd 서비스를 통해 통화를 실행하지 않는 자체 호스팅 배포에만 적용됩니다.
    • 네트워크 인프라(예: NAT 장치 뒤의 인스턴스)에 따라 클라이언트가 연결하기 위해 이 필드를 클라이언트가 직접 접속하는 외부 IP로 설정해야 할 수 있습니다. 비어 있거나 설정되지 않은 경우 RTC 서비스는 STUN을 통해 인스턴스의 공인 IP를 찾으려고 시도합니다.
    • 이 설정에 호스트명(예: 도메인 이름)을 지정할 수 있지만 IP 주소가 클라이언트에 전달됩니다. 이는 Mattermost 인스턴스에서 DNS 해석이 발생하여 클라이언트가 보는 IP 주소와 다를 수 있어 연결 실패를 유발할 수 있음을 의미합니다. 확신이 없을 때는 IP 주소를 직접 사용하거나 호스트 측의 해석이 클라이언트 측과 일치하는지 확인하는 것을 권장합니다.

ICE 호스트 포트 재정의#

This setting can be used to override the port used in the ICE host candidates that get advertised to clients when connecting to calls. This can be useful in case there are additional network components (e.g. NLBs) in front of the RTC server that may route the calls traffic through a different port. Changing this setting requires a plugin restart to take effect.- System Config path: Plugins > Calls - config.json setting: PluginSettings > Plugins > com.mattermost.calls > icehostportoverride - Environment variable: MM_CALLS_ICE_HOST_PORT_OVERRIDE
Note
    • 이 설정은 자체 호스팅 배포에만 적용됩니다.
    • 이 값은 UDP 및 TCP 호스트 후보 모두에 적용됩니다.

RTCD 서비스 URL#

The URL to a running rtcd service instance that will host the calls. When set (non empty) all the calls will be handled by this external service. This is an optional field. Changing this setting requires a plugin restart to take effect.- System Config path: Plugins > Calls - config.json setting: PluginSettings > Plugins > com.mattermost.calls > rtcdserviceurl - Environment variable: MM_CALLS_RTCD_SERVICE_URL
Note
    • 이 설정은 자체 호스팅 배포에만 적용됩니다.
    • 환경 변수 MM_CALLS_RTCD_URL은 MM_CALLS_RTCD_SERVICE_URL을 선호하여 더 이상 사용되지 않습니다.
    • 클라이언트는 서비스에 처음 연결할 때 자동으로 등록되고 인증 키를 데이터베이스에 저장합니다. 클라이언트 ID가 명시적으로 제공되지 않으면 Mattermost 설치의 진단 ID가 사용됩니다.
    • 서비스 URL은 http://clientID:authKey@hostname 형식의 자격 증명을 지원합니다. 또는 이를 Mattermost 서버의 환경 재정의를 통해 전달할 수 있습니다: MM_CALLS_RTCD_CLIENT_ID 및 MM_CALLS_RTCD_AUTH_KEY.

최대 통화 참가자 수#

This setting limits the number of participants that can join a single call. Default is 0 (no limit).- System Config path: Plugins > Calls - config.json setting: PluginSettings > Plugins > com.mattermost.calls > maxcallparticipants - Environment variable: MM_CALLS_MAX_CALL_PARTICIPANTS
Note
    • 이 설정은 자체 호스팅 배포에만 적용됩니다.
    • 환경 변수 MM_CALLS_MAX_PARTICIPANTS는 MM_CALLS_MAX_CALL_PARTICIPANTS를 선호하여 더 이상 사용되지 않습니다.
    • 이 설정은 선택 사항이지만 권장되는 최대 참가자 수는 50명입니다. 통화 참가자 제한은 인스턴스 리소스에 크게 의존합니다. 자세한 내용은 Calls 배포 가이드 문서를 참조하세요.

ICE 서버 구성#

This setting stores a list of ICE servers (STUN/TURN) in JSON format to be used by the service. This is an optional field. Changing this setting may require a plugin restart to take effect. Default is [{"urls": ["stun:stun.global.calls.mattermost.com:3478"]}]- System Config path: Plugins > Calls - config.json setting: PluginSettings > Plugins > com.mattermost.calls > iceserversconfigs - Environment variable: MM_CALLS_ICE_SERVERS_CONFIGS
Note
    • 이 설정은 자체 호스팅 배포에만 적용됩니다.
    • STUN 및 TURN 서버가 포함된 위의 구성은 클라이언트에 전송되어 로컬 후보를 생성하는 데 사용됩니다.
    • 플러그인을 통해 통화를 호스팅하는 경우(즉, RTCD service를 사용하지 않는 경우) ICE Host Override 옵션을 통해 제공되지 않을 때 구성된 STUN 서버를 인스턴스의 공인 IP를 찾는 데 사용할 수 있습니다.

Example

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

Example (Using generated TURN credentials)

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

TURN 생성 자격 증명이 작동하려면 아래 TURN 정적 인증 시크릿 설정을 통해 시크릿을 제공해야 합니다.

TURN 정적 인증 시크릿#

A static secret used to generate short-lived credentials for TURN servers. This is an optional field.- System Config path: Plugins > Calls - config.json setting: PluginSettings > Plugins > com.mattermost.calls > turnstaticauthsecret - Environment variable: MM_CALLS_TURN_STATIC_AUTH_SECRET
Note

이 설정은 자체 호스팅 배포에만 적용됩니다.

TURN 자격 증명 만료#

The expiration, in minutes, of the short-lived credentials generated for TURN servers. Default is 1440 (one day).- System Config path: Plugins > Calls - config.json setting: PluginSettings > Plugins > com.mattermost.calls > turncredentialsexpirationminutes - Environment variable: MM_CALLS_TURN_CREDENTIALS_EXPIRATION_MINUTES
Note

이 설정은 자체 호스팅 배포에만 적용됩니다.

    • true: The RTC server will use the configured TURN candidates for server-initiated connections.
    • false: TURN will be used only on the client-side.

서버 측 TURN#

- true: The RTC server will use the configured TURN candidates for server-initiated connections. - false: TURN will be used only on the client-side. Changing this setting requires a plugin restart to take effect.- System Config path: Plugins > Calls - config.json setting: PluginSettings > Plugins > com.mattermost.calls > serversideturn - Environment variable: MM_CALLS_SERVER_SIDE_TURN
Note

이 설정은 자체 호스팅 배포에만 적용됩니다.

    • true: Call participants will be allowed to share their screen.
    • false: Call participants won't be allowed to share their screen.

화면 공유 허용#

- true: Call participants will be allowed to share their screen. - false: Call participants won't be allowed to share their screen. Changing this setting requires a plugin restart to take effect.- System Config path: Plugins > Calls - config.json setting: PluginSettings > Plugins > com.mattermost.calls > allowscreensharing - Environment variable: MM_CALLS_ALLOW_SCREEN_SHARING
Note

이 설정은 자체 호스팅 배포에만 적용됩니다.

    • true: Enables simulcast for screen sharing. This can help to improve screen sharing quality.
    • false: (Default) Disables simulcast for screen sharing.

화면 공유에 시뮬캐스트 활성화 (실험적)#

- true: Enables simulcast for screen sharing. This can help to improve screen sharing quality. - false: Disables simulcast for screen sharing.- System Config path: Plugins > Calls - config.json setting: PluginSettings > Plugins > com.mattermost.calls > enablesimulcast - Environment variable: MM_CALLS_ENABLE_SIMULCAST
Note
    • 이 실험적 설정은 자체 호스팅 배포에만 적용됩니다.
    • 이 기능은 Calls 플러그인 버전 >= v0.16.0 및 (사용하는 경우) rtcd 버전 >= v0.10.0이 필요합니다.
    • 이 실험적 구성 설정과 AV1 활성화 실험적 구성 설정을 동시에 활성화하는 것을 피하세요.
    • true: Allows call hosts to record meeting video and audio.
    • false: (Default) Call recording functionality is not available to hosts.

통화 녹음 활성화#

- true: Allows call hosts to record meeting video and audio. - false: (Default) Call recording functionality is not available to hosts. Recordings include the entire call window view along with participants' audio track and any shared screen video. Recordings are stored in Mattermost. Changing this setting requires a plugin restart to take effect.- System Config path: Plugins > Calls - config.json setting: PluginSettings > Plugins > com.mattermost.calls > enablerecordings - Environment variable: MM_CALLS_ENABLE_RECORDINGS
Note

이 설정은 자체 호스팅 배포에만 적용됩니다.

작업 서비스 URL#

The URL to a running job service where all the processing related to recordings happens. The recorded files produced are stored in Mattermost. This is a required field. Changing this setting requires a plugin restart to take effect.- System Config path: Plugins > Calls - config.json setting: PluginSettings > Plugins > com.mattermost.calls > jobserviceurl - Environment variable: MM_CALLS_JOB_SERVICE_URL
Note
    • 이 설정은 자체 호스팅 배포에만 적용됩니다.
    • 클라이언트는 서비스에 처음 연결할 때 자동으로 등록되고 인증 키를 데이터베이스에 저장합니다. 클라이언트 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을 통해 연결하여 공개 네트워크를 우회하는 것을 방지하는 데 도움이 될 수 있습니다.

최대 통화 녹음 시간#

The maximum duration of a call recording in minutes. The default is 60. The maximum is 180. This is a required value.- System Config path: Plugins > Calls - config.json setting: PluginSettings > Plugins > com.mattermost.calls > maxrecordingduration - Environment variable: MM_CALLS_MAX_RECORDING_DURATION
Note

이 설정은 자체 호스팅 배포에만 적용됩니다.

통화 녹음 품질#

The audio and video quality of call recordings. Available options are: Low, Medium and High. The default is Medium. This is a required value.- System Config path: Plugins > Calls - config.json setting: PluginSettings > Plugins > com.mattermost.calls > recordingquality - Environment variable: MM_CALLS_RECORDING_QUALITY
Note
    • 이 설정은 자체 호스팅 배포에만 적용됩니다.
    • 품질 설정은 작업 서비스의 성능과 녹음 파일 크기에 영향을 미칩니다. 자세한 내용은 Calls 배포 가이드 문서를 참조하세요.
    • true: Enables automatic transcriptions of calls.
    • false: (Default) Call transcriptions functionality is disabled.

통화 전사 활성화#

- true: Enables automatic transcriptions of calls. - false: (Default) Call transcriptions functionality is disabled. Transcriptions are generated from the call participants' audio tracks and the resulting files are attached to the call thread when the recording ends. Captions will be optionally rendered on top of the recording file video player.- System Config path: Plugins > Calls - config.json setting: PluginSettings > Plugins > com.mattermost.calls > enabletranscriptions - Environment variable: MM_CALLS_ENABLE_TRANSCRIPTIONS
Note
    • 이 설정은 자체 호스팅 배포에만 적용됩니다.
    • Mattermost 통화에서 통화 전사를 활성화하는 기능은 현재 베타 단계에 있습니다.
    • 이 서버 측 구성 설정은 플러그인 버전 0.22부터 사용 가능합니다.
    • 통화 전사를 사용하려면 통화 녹음이 활성화되어 있어야 합니다.

전사기 모델 크기#

The speech-to-text model size to use. Heavier models will produce more accurate results at the expense of processing time and resources usage. Available options are: Tiny, Base and Small. The default is Base. This is a required value.- System Config path: Plugins > Calls - config.json setting: PluginSettings > Plugins > com.mattermost.calls > transcribermodelsize - Environment variable: MM_CALLS_TRANSCRIBER_MODEL_SIZE
Note
    • 이 설정은 자체 호스팅 배포에만 적용됩니다.
    • 이 설정은 플러그인 버전 0.22부터 사용 가능합니다. 모델 크기 설정은 작업 서비스의 성능에 영향을 미칩니다. 자세한 내용은 Calls 배포 가이드 문서를 참조하세요.

통화 전사기 스레드#

The number of threads used by the post-call transcriber. This must be in the range [1, numCPUs]. The default is 2. This is a required value.- System Config path: Plugins > Calls - config.json setting: PluginSettings > Plugins > com.mattermost.calls > transcribernumthread - Environment variable: MM_CALLS_TRANSCRIBER_NUM_THREADS
Note
    • 이 설정은 자체 호스팅 배포에만 적용됩니다.
    • 통화 전사기 스레드 설정은 작업 서비스의 성능에 영향을 미칩니다. 자세한 내용은 Calls 배포 가이드 문서를 참조하세요. 이 설정은 플러그인 버전 0.26.2부터 사용 가능합니다.
    • true: Enables live captioning of calls.
    • false: (Default) Live captions functionality is disabled.

실시간 자막 활성화#

- true: Enables live captioning of calls. - false: (Default) Live captions functionality is disabled. Live captions are generated from the call participants' audio tracks and the resulting captions can be optionally displayed on the call clients by selecting the [cc] option.- System Config path: Plugins > Calls - config.json setting: PluginSettings > Plugins > com.mattermost.calls > enablelivecaptions - Environment variable: MM_CALLS_ENABLE_LIVE_CAPTIONS
Note
    • Mattermost 통화에서 실시간 통화 자막을 활성화하는 기능은 현재 베타 단계에 있습니다.
    • 이 서버 측 구성 설정은 플러그인 버전 0.26.2부터 사용 가능합니다.
    • 실시간 자막을 사용하려면 통화 녹음 및 통화 전사가 활성화되어 있어야 합니다.

실시간 자막: 모델 크기#

The speech-to-text model size to use for live captions. While heavier models can produce more accurate results, live captioning requires the transcriber to process up to ten seconds of audio within two seconds. Therefore a maximum of size `base` is recommended. Available options are: Tiny, Base and Small. The default is Tiny. This is a required value.- System Config path: Plugins > Calls - config.json setting: PluginSettings > Plugins > com.mattermost.calls > livecaptionsmodelsize - Environment variable: MM_CALLS_LIVE_CAPTIONS_MODEL_SIZE
Note
    • 이 설정은 자체 호스팅 배포에만 적용됩니다.
    • 이 설정은 플러그인 버전 0.26.2부터 사용 가능합니다. 모델 크기 설정은 작업 서비스의 성능에 영향을 미칩니다. 자세한 내용은 성능 및 확장성 권장 사항 문서를 참조하세요.

실시간 자막: 통화당 사용할 전사기 수#

The number of separate live captions transcribers for each call. Each transcribes one audio stream at a time. The product of LiveCaptionsNumTranscribers * LiveCaptionsNumThreadsPerTranscriber must be in the range [1, numCPUs]. The default is 1. This is a required value.- System Config path: Plugins > Calls - config.json setting: PluginSettings > Plugins > com.mattermost.calls > livecaptionsnumtranscribers - Environment variable: MM_CALLS_LIVE_CAPTIONS_NUM_TRANSCRIBERS
Note
    • 이 설정은 자체 호스팅 배포에만 적용됩니다.
    • 이 설정은 플러그인 버전 0.26.2부터 사용 가능합니다. 실시간 자막의 전사기 수 설정은 작업 서비스의 성능에 영향을 미칩니다. 자세한 내용은 성능 및 확장성 권장 사항 문서를 참조하세요.

실시간 자막: 전사기당 스레드 수#

The number of threads per live-captions transcriber. The product of LiveCaptionsNumTranscribers * LiveCaptionsNumThreadsPerTranscriber must be in the range [1, numCPUs]. The default is 2. This is a required value.- System Config path: Plugins > Calls - config.json setting: PluginSettings > Plugins > com.mattermost.calls > livecaptionsnumthreadspertranscriber - Environment variable: MM_CALLS_LIVE_CAPTIONS_NUM_THREADS_PER_TRANSCRIBER
Note
    • 이 설정은 자체 호스팅 배포에만 적용됩니다.
    • 이 설정은 플러그인 버전 0.26.2부터 사용 가능합니다. 실시간 자막의 전사기당 스레드 수 설정은 작업 서비스의 성능에 영향을 미칩니다. 자세한 내용은 성능 및 확장성 권장 사항 문서를 참조하세요.

실시간 자막 언어#

The language passed to the live captions transcriber. Should be a 2-letter ISO 639 Set 1 language code, e.g. 'en'. If blank, the lange will be set to 'en' (English) as default.- System Config path: Plugins > Calls - config.json setting: PluginSettings > Plugins > com.mattermost.calls > livecaptionslanguage - Environment variable: MM_CALLS_LIVE_CAPTIONS_LANGUAGE
Note

이 설정은 자체 호스팅 배포에만 적용됩니다.

    • true: The RTC service will work in dual-stack mode, listening for IPv6 connections and generating candidates in addition to IPv4 ones.
    • false: (False) The RTC service will only listen for IPv4 connections.

IPv6 활성화 (실험적)#

- true: The RTC service will work in dual-stack mode, listening for IPv6 connections and generating candidates in addition to IPv4 ones. - false: (Default) The RTC service will only listen for IPv4 connections. Changing this setting requires a plugin restart to take effect.- System Config path: Plugins > Calls - config.json setting: PluginSettings > Plugins > com.mattermost.calls > enableipv6 - Environment variable: MM_CALLS_ENABLE_IPV6
Note
    • 이 설정은 자체 호스팅 배포에만 적용됩니다.
    • 이 설정은 플러그인 버전 0.17부터 사용 가능하며, 독립형 rtcd 서비스를 통해 통화를 실행하지 않는 경우에만 적용됩니다.
    • true: Ringing functionality is enabled. Direct and group message participants receive a desktop app alert and a ringing notification when a call starts.
    • false: (False) Ringing functionality is disabled.

통화 벨소리 활성화#

- true: Ringing functionality is enabled. Direct and group message participants receive a desktop app alert and a ringing notification when a call starts. - false: (Default) Ringing functionality is disabled.- System Config path: Plugins > Calls - config.json setting: PluginSettings > Plugins > com.mattermost.calls > enableringing - Environment variable: MM_CALLS_ENABLE_RINGING
Note

Mattermost 통화에서 통화 벨소리를 활성화하는 기능은 베타 단계에 있습니다.

    • true: Enables the ability to use the AV1 codec to encode screen sharing tracks. This can result in improved screen sharing quality for clients that support it.
    • false: (False) AV1 codec is disabled for screen sharing tracks.

AV1 활성화 (실험적)#

- true: Enables the ability to use the AV1 codec to encode screen sharing tracks. Can result in improved screen sharing quality via clients that support AV1 encoding. - false: (Default) AV1 codec is disabled for screen sharing tracks.- System Config path: Plugins > Calls - config.json setting: PluginSettings > Plugins > com.mattermost.calls > enableAV1 - Environment variable: MM_CALLS_ENABLE_AV1
Note

이 실험적 구성 설정과 화면 공유에 시뮬캐스트 활성화 실험적 구성 설정을 동시에 활성화하는 것을 피하세요.

    • true: Clients will use WebRTC data channels for signaling of media tracks (i.e., voice, screen). This can result in a more efficient and less race-prone process, especially in case of poor network connections.
    • false: (False) Clients will use WebSockets for signaling media tracks.

DC 신호 활성화 (실험적)#

- true: Clients will use WebRTC data channels for signaling of media tracks (i.e., voice, screen). This can result in a more efficient and less race-prone process, especially in case of poor network connections. - false: (Default) Clients will use WebSockets for signaling media tracks.- System Config path: Plugins > Calls - config.json setting: PluginSettings > Plugins > com.mattermost.calls > enabledcsignaling - Environment variable: MM_CALLS_ENABLE_DC_SIGNALING

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

AI 에이전트#

Note

Mattermost Agents는 이전에 Mattermost Copilot으로 알려져 있었습니다.

Plugins > Agents로 이동하여 System Console에서 다음 Mattermost Agents 구성 설정에 접근합니다.

  • true: Enables the Agents plugin on your Mattermost workspace.
  • false: (Default) Disables the Agents plugin on your Mattermost workspace.

플러그인 활성화#

- true: Enables the Agents plugin on your Mattermost workspace. - false: (Default) Disables the Agents plugin.- System Config path: Plugins > Agents - config.json setting: N/A - Environment variable: N/A

표시 이름#

The bot's display name in Mattermost used to distinguish the bot from other bots in the system. String input.- System Config path: Plugins > Agents > Add an AI Bot - config.json setting: N/A - Environment variable: N/A

에이전트 사용자명#

The bot's username that can be used to @mention the bot in a channel. String input.- System Config path: Plugins > Agents > Add an AI Bot - config.json setting: N/A - Environment variable: N/A

에이전트 아바타#

Upload an image to use as the agent's avatar in Mattermost. Image upload interface.- System Config path: Plugins > Agents > Add an AI Bot - config.json setting: N/A - Environment variable: N/A

서비스#

Select the LLM service provider to use for AI assistance. Available options: OpenAI, OpenAI Compatible, Azure, Anthropic, and Ask Sage.- System Config path: Plugins > Agents > Add an AI Bot - config.json setting: N/A - Environment variable: N/A

사용자명#

The username used to authenticate with the Ask Sage LLM service. String input required.- System Config path: Plugins > Agents > Add an AI Bot - config.json setting: N/A - Environment variable: N/A

비밀번호#

The password used to authenticate with the Ask Sage LLM service. String input required. This value is encrypted when stored.- System Config path: Plugins > Agents > Add an AI Bot - config.json setting: N/A - Environment variable: N/A

API URL#

The endpoint that Mattermost will use to communicate with the LLM's API. Required for OpenAI Compatible and Azure LLM services. String input (URL format).- System Config path: Plugins > Agents > Add an AI Bot - config.json setting: N/A - Environment variable: N/A

API key#

The key used to authenticate requests to the LLM's API. Required for OpenAI, OpenAI Compatible, and Anthropic LLM services. String input. This value is encrypted when stored.- System Config path: Plugins > Agents > Add an AI Bot - config.json setting: N/A - Environment variable: N/A

조직 ID#

Ensures that requests are billed and processed under the correct organization, where applicable. Supported for OpenAI, OpenAI Compatible, and Azure LLM services. String input.- System Config path: Plugins > Agents > Add an AI Bot - config.json setting: N/A - Environment variable: N/A
  • true: Includes unique user identifiers in API requests to the LLM.
  • false: (Default) Does not include user identifiers in API requests.

사용자 ID 전송#

- true: Includes unique user identifiers in API requests to the LLM for analytics, personalization, and auditing purposes. - false: (Default) Does not include user identifiers. Review LLM data privacy policies before enabling this setting.- System Config path: Plugins > Agents > Add an AI Bot - config.json setting: N/A - Environment variable: N/A
Note

We recommend reviewing LLM data privacy policies to confirm whether transmitting user information is acceptable and secure within your organization's regulatory framework. Do not enable when you need to conform to strict privacy regulations (e.g., GDPR) that limit sharing user-identifiable data with external services.

기본 모델#

The specific LLM that will be used to process queries if no other model is explicitly selected. Supported for all LLM services. String input (model name).- System Config path: Plugins > Agents > Add an AI Bot - config.json setting: N/A - Environment variable: N/A

입력 토큰 제한#

The maximum number of tokens (chunks of text, including words, punctuation, or special characters) that the selected LLM can process in a single prompt or request. Numerical value. Directly impacts the size of user queries that can be handled.- System Config path: Plugins > Agents > Add an AI Bot - config.json setting: N/A - Environment variable: N/A

출력 토큰 제한#

The maximum number of tokens (chunks of text, including words, punctuation, or special characters) that the LLM can generate in its response to a query. Numerical value. Must be greater than 0 for Anthropic LLM services.- System Config path: Plugins > Agents > Add an AI Bot - config.json setting: N/A - Environment variable: N/A

스트리밍 타임아웃#

Determines how long the system will wait for a response from the LLM when using streaming (real-time) output mode. Supported for OpenAI, OpenAI Compatible, and Azure LLM services. Numerical value (in seconds). If the LLM takes longer than the configured timeout, the connection is terminated.- System Config path: Plugins > Agents > Add an AI Bot - config.json setting: N/A - Environment variable: N/A
Note

스트리밍은 LLM이 응답을 생성하면서 점진적으로 표시할 수 있게 하여 사용자에게 더 부드럽고 상호작용적인 경험을 제공합니다.

커스텀 지침#

Preset specific contextual or behavioral guidance for the LLM. Helps tailor the model's responses to align with your organization's needs, tone, or expectations. Supported for all LLM services. Text input. Instructions that the model will implicitly follow for every interaction, providing consistency and adaptability.- System Config path: Plugins > Agents > Add an AI Bot - config.json setting: N/A - Environment variable: N/A
Note

커스텀 지침에는 행동 지침, 어조 기본 설정, 상황별 기능 및 조직 기본 설정이 포함될 수 있습니다. 이를 통해 응답이 조직의 언어 및 어조 가이드라인을 준수하고 모델의 동작을 특정 역할이나 목적에 맞게 조정할 수 있습니다.

    • true: Enables the LLM to process and generate responses that incorporate image-related input or output.
    • false: (Default) Disables vision capabilities.

비전 활성화#

- true: Enables the LLM to process and generate responses that incorporate image-related input or output. Supported for OpenAI, OpenAI Compatible, Azure, and Anthropic LLM services. - false: (Default) Disables vision capabilities.- System Config path: Plugins > Agents > Add an AI Bot - config.json setting: N/A - Environment variable: N/A
Note

이 기능은 베타 단계에 있습니다. 활성화하면 LLM은 이미지 분석, 시각적 관련 지원, 시각적 출력과 같은 이미지 관련 입력이 포함된 프롬프트와 상호작용할 수 있습니다(지원되는 경우).

    • true: Enables the LLM to leverage additional tools or plugins to enhance its capabilities.
    • false: (Default) Disables tool capabilities.

도구 활성화#

- true: Enables the LLM to leverage additional tools or plugins to enhance its capabilities. Supported for OpenAI, OpenAI Compatible, Azure, and Anthropic LLM services. - false: (Default) Disables tool capabilities.- System Config path: Plugins > Agents > Add an AI Bot - config.json setting: N/A - Environment variable: N/A
Note

활성화하면 기본 쿼리 처리를 넘어서는 고급 기능을 통해 LLM이 데이터 검색, 외부 API와의 통합, 계산 수행 등의 특화된 작업을 수행할 수 있습니다(지원되는 경우).

채널 접근#

Determines whether the bot can consume the contents of a given channel and provide answers only from content available in the channel. Supported for all LLM services. Available options: Allow for all channels, Allow for selected channels, Block selected channels, and Block all channels.- System Config path: Plugins > Agents > Add an AI Bot - config.json setting: N/A - Environment variable: N/A

사용자 접근#

Determines whether users who chat with this bot can get private assistance about content across all channels the user has access to. Supported for all LLM services. Available options: Allow for all users, Allow for selected users, and Block selected users.- System Config path: Plugins > Agents > Add an AI Bot - config.json setting: N/A - Environment variable: N/A

기본 에이전트#

Select the default bot to use for AI functions when multiple agents are configured. Based on defined agents.- System Config path: Plugins > Agents > AI Functions - config.json setting: N/A - Environment variable: N/A

허용된 업스트림 호스트명#

Comma-separated list of hostnames that LLMs are allowed to contact when using tools. Supports wildcards like *.mydomain.com. Example: mattermost.atlassian.net to allow JIRA tool use.- System Config path: Plugins > Agents > AI Functions - config.json setting: N/A - Environment variable: N/A
  • true: Enables tracing of LLM requests and outputs full conversation data to the logs.
  • false: (Default) Disables LLM request tracing.

LLM 추적 활성화#

- true: Enables tracing of LLM requests and outputs full conversation data to the logs. Supported for all LLM services. - false: (Default) Disables LLM request tracing.- System Config path: Plugins > Agents > Debug - config.json setting: N/A - Environment variable: N/A
Note

이 설정은 디버깅 목적으로만 사용하세요. 활성화하면 민감한 대화 데이터가 로깅될 수 있습니다.

    • Composite: Enables experimental embedding search capabilities for semantic search across Mattermost content.
    • Disabled: (Default) Disables embedding search capabilities.

임베딩 검색 활성화#

- Composite: Enables experimental embedding search capabilities for semantic search across Mattermost content using pgvector and OpenAI-compatible endpoints. - Disabled: (Default) Disables embedding search capabilities.- System Config path: Plugins > Agents > Embedding Search - config.json setting: N/A - Environment variable: N/A
Note

임베딩 검색은 Enterprise 라이선스가 필요하며 실험적 기능으로 사용 가능합니다. PostgreSQL 데이터베이스에서 pgvector 확장을 활성화해야 합니다. 대규모 데이터셋에서는 성능이 다를 수 있습니다.

임베딩 공급자 유형#

Select the provider for generating embeddings for semantic search. Available options: OpenAI and OpenAI Compatible.- System Config path: Plugins > Agents > Embedding Search - config.json setting: N/A - Environment variable: N/A

API Key#

The API key used to authenticate requests to the embedding provider's API. Required for OpenAI Compatible embedding providers. String input. This value is encrypted when stored.- System Config path: Plugins > Agents > Embedding Search - config.json setting: N/A - Environment variable: N/A

모델#

The specific embedding model to use for generating vector representations of content. Must be compatible with the selected embedding provider. String input (model name).- System Config path: Plugins > Agents > Embedding Search - config.json setting: N/A - Environment variable: N/A

API URL#

The endpoint URL for the OpenAI-compatible embedding API. Required string input (URL format).- System Config path: Plugins > Agents > Embedding Search - config.json setting: N/A - Environment variable: N/A

차원#

The dimensionality of the embedding vectors, which must match the chosen embedding model. Common values include 1536 for OpenAI text-embedding-ada-002 and 3072 for text-embedding-3-large. Numerical input. Common values are 768, 1024, or 1536, depending on the model.- System Config path: Plugins > Agents > Embedding Search - config.json setting: N/A - Environment variable: N/A

청킹 전략#

The method used to split content into smaller chunks for embedding generation. Available options: Sentences, Paragraphs, Fixed Size. Choose based on your content type and search requirements.- System Config path: Plugins > Agents > Embedding Search - config.json setting: N/A - Environment variable: N/A

청크 크기#

The maximum size of each content chunk in characters. Recommended range is 512-1024 characters. The optimal value varies by chunking strategy. Numerical input.- System Config path: Plugins > Agents > Embedding Search - config.json setting: N/A - Environment variable: N/A

청크 중복#

The number of tokens that consecutive chunks share for better context continuity. Recommended range is 20-50 characters for Fixed Size chunking. Numerical input.- System Config path: Plugins > Agents > Embedding Search - config.json setting: N/A - Environment variable: N/A

최소 청크 크기 비율#

The minimum ratio for chunk size validation to ensure sentence and paragraph chunks meet size requirements. Used to filter out chunks that are too small releative to the configured chunk size. Numerical input (decimal ratio).- System Config path: Plugins > Agents > Embedding Search - config.json setting: N/A - Environment variable: N/A

모든 게시물 재인덱싱#

Select Reindex Posts to trigger a complete reindexing of all posts for embedding search. Use this control to rebuild the search index when changing embeddingproviders, models, or chunking configurations. Monitor indexing progress during the reindexing process.- System Config path: Plugins > Agents > Embedding Search - config.json setting: N/A - Environment variable: N/A

GitLab#

자세한 내용은 GitLab을 Mattermost에 연결 제품 문서를 참조하세요.

GitHub#

자세한 내용은 GitHub을 Mattermost에 연결 제품 문서를 참조하세요.

Jira#

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

법적 보존#

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

Microsoft 캘린더 통합#

사용 가능한 Mattermost 구성 옵션에 대해서는 Microsoft 캘린더 통합을 Mattermost에 연결 제품 문서를 참조하세요.

Microsoft Teams 회의#

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

MS Teams#

Microsoft Teams용 Mattermost는 Teams에서 Mattermost로 실시간 채팅 알림을 전달하여 Mattermost와 Teams가 혼합된 환경에서 사일로를 극복할 수 있게 합니다.

Tip

Microsoft Teams용 Mattermost 데이터시트를 다운로드하여 Mattermost가 조직에서 Microsoft 도구를 더 잘 활용하는 방법을 알아보세요.

Plugins > MS Teams로 이동하여 System Console에서 다음 구성 설정에 접근합니다.

  • true: Enables the MS Teams plugin on your Mattermost workspace.
  • false: Disables the MS Teams plugin on your Mattermost workspace.

플러그인 활성화#

Enable the Mattermost for Microsoft Teams plugin for all Mattermost teams. - true: Enables MS Teams plugin on your Mattermost workspace. - false: (Default) Disables the MS Teams plugin.- System Config path: Plugins > MS Teams - config.json setting: N/A - Environment variable: N/A
Note

Use the Enabled Teams configuration option to specify which Mattermost teams synchronize

direct and group messages with Microsoft Teams chats.

테넌트 ID#

Specify the Microsoft Teams Tenant ID from the Azure portal.- System Config path: Plugins > MS Teams - config.json setting: N/A - Environment variable: N/A

클라이언트 ID#

Specify the Microsoft Teams Client ID of your registered OAuth app in the Azure portal.- System Config path: Plugins > MS Teams - config.json setting: N/A - Environment variable: N/A

클라이언트 시크릿#

Specify the client secret of your registered OAuth app in Azure portal. Alpha-numeric value.- System Config path: Plugins > MS Teams - config.json setting: N/A - Environment variable: N/A

정지 암호화 키#

Regenerate a new encryption secret. This encryption secret will be used to encrypt and decrypt the OAuth token. Alpha-numeric value.- System Config path: Plugins > MS Teams - config.json setting: N/A - Environment variable: N/A
Note

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

웹훅 시크릿#

Generate the webhook secret that Microsoft Teams will use to send messages to Mattermost.- System Config path: Plugins > MS Teams - config.json setting: N/A - Environment variable: N/A
Note

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

    • true: Enables the evaluation API pay model. Enable this only for testing purposes. You need the pay model to be able to support enough message notifications to work in a real world scenario.
    • false: Disables the evaluation API pay model.

평가용 API 유료 모델 사용#

Enable this only for testing purposes. You need the pay model to be able to support enough message notifications to work in a real world scenario. - true: Enables the evaluation API pay model. - false: (Default) Disables the evaluation API pay model.- System Config path: Plugins > MS Teams - config.json setting: N/A - Environment variable: N/A
  • true: Users are required to connect their Mattermost and Microsoft Teams accounts.
  • false: Users aren't required to connect their Mattermost and Microsoft Teams accounts.

동기화 알림#

Notify connected users in Mattermost on receipt of a chat or group chat from Microsoft Teams. - true: (Default) Sync notifications of chat messages for any connected user that enables the feature. - false: Do not sync notifications.- System Config path: Plugins > MS Teams - config.json setting: N/A - Environment variable: N/A

첨부 파일 일회성 전체 다운로드를 위한 최대 크기#

Specify the maximum file size, in mebibytes (MiB), of attachments that can be loaded into memory. Attachment files larger than this value will be streamed from Microsoft Teams to Mattermost. Numerical value. Default is 20 MiB.- System Config path: Plugins > MS Teams - config.json setting: N/A - Environment variable: N/A

스트리밍 파일 버퍼 크기#

Specify the buffer size, in mebibytes (MiB), for streaming attachment files from Microsoft Teams to Mattermost. Numerical value. Default is 20 MiB.- System Config path: Plugins > MS Teams - config.json setting: N/A - Environment variable: N/A

성능 메트릭#

사용 가능한 Mattermost 구성 옵션은 성능 메트릭 모니터링 제품 문서를 참조하세요.

협업 플레이북#

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

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

  • true: (Default) Enables collaborative playbooks on your Mattermost workspace.
  • false: Disables collaborative playbooks on your Mattermost workspace.

플러그인 활성화#

- true: (Default) Enables collaborative Playbooks on your Mattermost workspace. - false: Disables collaborative Playbooks on your Mattermost workspace.- System Config path: Plugins > Collaborative playbooks - config.json setting: - Environment variable:

활성화된 팀#

Enable collaborative playbooks for all Mattermost teams, or for only selected teams.- System Config path: Plugins > Collaborative playbooks - config.json setting: - Environment variable:
  • true: Enables experimental playbooks features on your Mattermost workspace.
  • false: Disables experimental playbooks features on your Mattermost workspace.

실험적 기능 활성화#

- true: Enables experimental playbooks features on your Mattermost workspace. - false: Disables experimental playbooks features on your Mattermost workspace.- System Config path: Plugins > Collaborative playbooks - config.json setting: - Environment variable:

ServiceNow#

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

Zoom#

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

config.json 전용 설정#

다음 자체 호스팅 배포 설정은 config.json 파일에서만 구성할 수 있으며 시스템 콘솔에서는 사용할 수 없습니다.

서명 공개 키 파일#

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

서버에 내장된 Mattermost 플러그인 서명 키 외에도 여기에 지정된 각 공개 키는 플러그인 서명의 유효성을 검사하기 위해 신뢰됩니다.

Important

Mattermost v10.11부터 사전 패키지된 플러그인은 시작 시 서명 유효성 검사가 필요합니다. 사용자 지정 사전 패키지된 플러그인을 번들로 묶는 배포판은 서명된 플러그인의 올바른 유효성 검사를 보장하기 위해 사용자 지정 공개 키로 이 설정을 구성해야 합니다. 사용자 지정 플러그인 서명 키를 정의하려면 PluginSettings.SignaturePublicKeyFiles를 사용하세요.

사용자 지정 플러그인을 번들로 묶는 경우:

    • 플러그인 파일과 해당 .sig 서명 파일을 모두 prepackaged_plugins 디렉터리에 넣습니다.
    • 서명의 유효성을 검사하기 위해 이 구성 설정을 사용하여 사용자 지정 공개 키를 추가합니다.
This feature's config.json setting is "SignaturePublicKeyFiles": {} with string array input consisting of contents that are relative or absolute paths to signature files.

Chimera OAuth 프록시 URL#

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

Mattermost 플러그인이 미리 생성된 OAuth 애플리케이션에 연결하는 데 사용하는 Chimera URL을 지정합니다.

This feature's config.json setting is "ChimeraOAuthProxyUrl": {} with string input.