커넥티드 워크스페이스

보안이 확보된 커넥티드 Mattermost 워크스페이스를 통해 메시지, 이모지 반응, 파일 공유를 실시간으로 동기화하여 조직 간은 물론 외부 파트너·협력사와도 Mattermost로 소통할 수 있습니다.

Mattermost의 커넥티드 워크스페이스는 일반적인 공개 채널·비공개 채널과 동일하게 동작하며 같은 사용자 경험과 기능을 제공합니다. 로컬 멤버와 원격 멤버를 포함해 보안 연결을 사용하는 모든 멤버가 채널 메시지를 주고받고, 이모지로 메시지에 반응하고, 파일을 공유하고, 메시지 기록을 검색할 수 있습니다. 콘텐츠는 참여 중인 모든 Mattermost 인스턴스에 동기화됩니다.

채널의 권한과 접근 제어는 계속해서 각 서버가 개별적으로 관리합니다. 공유 채널에 고급 접근 제어 권한을 적용할 수 있으며, 이는 로컬 Mattermost 서버에서는 적용되지만 원격 Mattermost 서버에서는 적용되지 않을 수 있습니다.

커넥티드 워크스페이스 설정

Mattermost 워크스페이스를 연결하는 과정은 다음 5단계로 이루어집니다.

1. 모든 Mattermost Enterprise 서버가 v10.2 이상에서 실행 중인지 확인합니다.

2. 연결하려는 각 Mattermost Enterprise 인스턴스에서 커넥티드 워크스페이스 기능을 활성화합니다.

3. 시스템 관리자가 시스템 콘솔이나 슬래시 명령을 사용해 다른 Mattermost Enterprise 인스턴스와 안전하고 신뢰할 수 있는 연결을 생성합니다. 이 과정에는 비밀번호로 보호된 암호화 초대장을 만들고, 강력한 복호화 비밀번호를 설정한 뒤, 초대장과 비밀번호를 원격 Mattermost 인스턴스의 관리자에게 전달하는 작업이 포함됩니다. Mattermost v11.0부터 원격 클러스터 초대장은 보안 강화를 위해 PBKDF2 키 파생을 사용합니다.

4. 원격 시스템 관리자가 초대장을 받으면 시스템 콘솔이나 슬래시 명령을 사용해 초대를 수락해야 합니다.

5. 두 Mattermost 서버 사이에 신뢰 관계가 수립되면, 시스템 관리자 또는 Shared Channel Manager 역할을 가진 사용자가 특정 공개 채널이나 비공개 채널을 보안 연결과 공유할 수 있습니다.

커넥티드 워크스페이스 활성화

시스템 관리자는 자신의 Mattermost 인스턴스에서 커넥티드 워크스페이스 기능을 활성화해야 합니다. config.json에서 다음 설정이 true로 지정되어 있는지 확인하세요.

• ConnectedWorkspacesSettings.EnableRemoteClusterService = true
• ConnectedWorkspacesSettings.EnableSharedChannels = true

자세한 내용은 사이트 구성 설정 문서를 참고하세요.

보안 연결 생성

System Console

시스템 콘솔을 사용해 워크스페이스 연결을 만들 수 있는 것은 시스템 관리자뿐입니다.

1. Site Configuration > Connected Workspaces로 이동합니다.
2. Connected Workspaces 아래에서 Add a connection을 선택한 뒤 Create a connection을 선택합니다.
3. 이 연결의 Organization Name을 지정합니다. 원격 시스템 관리자가 연결 초대를 수락할 때 이 이름을 입력해야 합니다.
4. 공유 채널이 추가될 기본 팀으로 Destination Team을 선택합니다. 이 팀이 해당 커넥티드 워크스페이스에서 온 공유 채널을 정리하는 기본 위치가 됩니다.
5. Save를 선택합니다.

비밀번호로 보호된 AES 256비트 암호화 코드 블롭으로 구성된 초대장이 생성됩니다. Mattermost v11.0부터 비밀번호 보호에는 보안 강화를 위해 PBKDF2 키 파생이 사용됩니다. 원격 시스템 관리자가 초대를 수락할 때까지 연결은 Connection Pending 상태로 표시됩니다.

Slash Commands

기본적으로 슬래시 명령으로 워크스페이스 연결을 만들 수 있는 것은 시스템 관리자뿐입니다. 내장된 Shared Channel Manager 위임형 관리 역할로 채널 공유 권한을 위임할 수 있습니다. 또는 시스템 스킴이나 팀 오버라이드 스킴의 권한을 수정해 Mattermost 사용자에게 Manage Shared Channels 권한을 부여할 수도 있습니다.

시스템 관리자는 다음 슬래시 명령을 실행해 보안 연결 초대장을 만들 수 있습니다.

/secure-connection create --name <--displayname> --password

예를 들면 다음과 같습니다.

/secure-connection create --name AcmeUS --displayname "AcmeUSA" --password examplepassword

이 슬래시 명령은 로컬에서 AcmeUS로 알려진 원격 Mattermost 엔터티에 대해, 비밀번호가 examplepassword인 비밀번호 보호 AES 256비트 암호화 코드 블롭으로 된 초대장을 만듭니다. Mattermost v11.0부터 비밀번호 보호에는 보안 강화를 위해 PBKDF2 키 파생이 사용됩니다. Mattermost 안에서 이 공유 연결은 입력한 name과 displayname을 기준으로 로컬 시스템 관리자에게 표시됩니다.

초대장 전달

초대 코드와 비밀번호를 공유하려면 Mattermost가 아닌 다른 시스템을 사용해야 합니다. 메시지가 유출되더라도 누구도 조치를 취하는 데 필요한 데이터를 전부 갖지 못하도록, 초대 코드와 비밀번호를 서로 다른 경로로 공유하는 것을 강력히 권장합니다. 원격 Mattermost 인스턴스가 여러분의 Mattermost 워크스페이스 URL에 접근할 수 있는지 확인하세요.

System Console

시스템 콘솔에서 연결을 만들고 나면 연결하려는 원격 Mattermost 서버의 시스템 관리자에게 초대 코드와 비밀번호를 공유하라는 안내가 표시됩니다. 초대 코드와 비밀번호를 모두 안전한 곳에 복사해 둔 뒤 Done을 선택하세요.

Slash Commands

시스템 메시지에 있는 초대 코드 블롭을 복사한 뒤, 안전하게 연결하려는 원격 Mattermost 시스템 관리자에게 코드 블롭과 복호화 비밀번호를 공유하세요.

연결 초대 수락

System Console

1. Site Configuration > Connected Workspaces로 이동합니다.
2. Connected Workspaces 아래에서 Add a connection을 선택한 뒤 Accept an invitation을 선택합니다.
3. 이 초대의 Organization Name을 지정합니다. 연결을 생성할 때 지정한 이름과 동일해야 합니다.
4. 공유 채널이 추가될 Destination Team을 선택합니다. 이 팀이 해당 커넥티드 워크스페이스에서 온 공유 채널을 정리하는 기본 위치가 됩니다.
5. 전달받은 암호화 초대 코드와 비밀번호를 붙여 넣어 원격 워크스페이스와 연결합니다.
6. Accept를 선택합니다.

연결 초대를 수락한 시스템 관리자는 모든 공유 채널에 자동으로 추가됩니다.

Slash Commands

원격 Mattermost 인스턴스의 보안 연결 초대를 수락하려면 다음 슬래시 명령을 실행합니다.

/secure-connection accept --name --displayname --password --invite [code blob]

예를 들면 다음과 같습니다.

/secure-connection accept --name AcmeUS --displayname "AcmeUSA" --password examplepassword --invite [code-blob]

이 슬래시 명령은 AcmeUS가 보낸 보안 연결 초대를 수락합니다.

보안 연결과 채널 공유

두 Mattermost 서버 사이에 연결이 수립되면, 시스템 관리자 또는 Shared Channel Manager 역할을 가진 사용자가 보안 워크스페이스 간에 채널을 공유할 수 있습니다.

System Console

1. Shared Channels 아래에서 Add channels를 선택합니다.
2. Mattermost 서버 간에 공유할 채널을 지정합니다.

공유 채널과 그 채널의 멤버에는 로컬 서버의 채널·채널 멤버와 구분되도록 공유 아이콘이 표시됩니다.

Slash Commands

공유할 공개 채널이나 비공개 채널을 지정하려면 다음 슬래시 명령을 실행합니다.

/share-channel invite --connectionID <--readonly>

원격 멤버가 자신의 채널·멤버 권한에 따라 채널에 참여할 수 있도록 초대장을 보낼 수 있습니다.

또는 이 명령에 선택 매개변수 --readonly를 붙여 보안 연결에 읽기 전용 초대장을 보낼 수도 있습니다. 읽기 전용으로 공유된 채널에서는 원격 멤버가 메시지를 게시하거나 답글을 달 수 없습니다.

다이렉트 메시지 전달

Mattermost v10.10부터 커넥티드 워크스페이스의 원격 사용자와 다이렉트 메시지나 그룹 메시지를 만드는 기능은 EnableSharedChannelsDMs 기능 플래그가 활성화된 경우에만 사용할 수 있습니다.

EnableSharedChannelsDMs가 비활성화되어 있으면 사용자 프로필의 다이렉트 메시지 옵션이 비활성화되어 사용할 수 없습니다. 상대 Mattermost 인스턴스에서 커넥티드 워크스페이스가 활성화되어 있지 않을 때 원격 사용자에게 다이렉트 메시지를 시도하지 못하도록 하기 위함입니다.

플러그인 컴포넌트 상호작용

Mattermost v10.10부터는 서로 다른 Mattermost 인스턴스 간 일관된 경험을 보장하기 위해, 슬래시 명령·인터랙티브 버튼·기타 플러그인 생성 컴포넌트 같은 플러그인 상호작용이 기본적으로 공유 채널에서 표시되거나 사용되지 않습니다.

시스템 관리자는 EnableSharedChannelsPlugins 기능 플래그를 활성화해 공유 채널에서 이러한 플러그인 상호작용을 사용할 수 있습니다. 공유 채널에서 플러그인 컴포넌트를 활성화하는 경우, 사용자 경험이 일관되지 않게 되는 것을 막기 위해 연결된 모든 Mattermost 인스턴스에 동일한 플러그인이 설치·구성되어 있는지 확인하는 것을 권장합니다. 플러그인 버전이나 구성이 다르면 인스턴스마다 플러그인 동작이 달라질 수 있습니다.

원격 사용자 검색

Mattermost v10.10부터 EnableSyncAllUsersForRemoteCluster 기능 플래그가 활성화되면 커넥티드 워크스페이스의 원격 사용자를 다이렉트 메시지나 그룹 메시지 대상으로 찾을 수 있습니다. 이 기능은 연결된 Mattermost 인스턴스 간의 전역 사용자 동기화를 구현하여, 원격 사용자가 먼저 공유 채널에 글을 남기지 않아도 검색되도록 합니다. 활성화하면 Mattermost는 커서 기반 동기화를 사용해 연결된 인스턴스 간 사용자 정보를 효율적으로 동기화합니다. 시스템의 동작은 다음과 같습니다.

• 타임아웃을 방지하고 메모리 사용량을 줄이기 위해 구성 가능한 배치 크기로 사용자를 동기화합니다.
• 타임스탬프로 동기화 진행 상황을 추적해 효율적으로 재개할 수 있게 합니다.
• 사용자를 원래 인스턴스로 되돌려 동기화하지 않도록 원 클러스터의 사용자를 걸러 냅니다.
• 마지막 동기화 이후 갱신된 사용자만 동기화합니다.

이 기능에는 연결이 수립될 때 사용자를 자동으로 동기화하는 옵션과, 최적의 성능을 위해 배치 처리 크기를 제어하는 옵션이 포함되어 있습니다.

EnableSyncAllUsersForRemoteCluster가 비활성화되어 있으면 원격 사용자는 공유 채널에 참여한 뒤에만 DM/GM 생성 모달에서 검색됩니다.

채널 멤버십 동기화

Mattermost v10.10부터 커넥티드 워크스페이스 간 채널 멤버십 동기화는 EnableSharedChannelsMemberSync 기능 플래그로 제어합니다. 이 기능 플래그를 활성화하면 채널 멤버십 변경이 같은 채널을 공유하는 모든 커넥티드 워크스페이스에 자동으로 동기화됩니다.

EnableSharedChannelsMemberSync를 활성화하면 다음과 같이 동작합니다.

• 한 워크스페이스에서 공유 채널에 추가된 사용자가 연결된 모든 워크스페이스의 해당 공유 채널에도 자동으로 추가됩니다.
• 한 워크스페이스에서 공유 채널에서 제거된 사용자가 연결된 모든 워크스페이스의 해당 공유 채널에서도 자동으로 제거됩니다.
• 멤버십 변경은 성능을 최적화하고 타임아웃을 방지하기 위해 구성 가능한 배치 크기로 처리됩니다.
• 시스템은 커서 기반 동기화를 사용해 멤버십 변경을 효율적으로 추적하고 동기화합니다.

이 기능에는 대규모 멤버십 변경 시 최적의 성능을 보장하도록 멤버 동기화의 배치 처리 크기를 제어하는 구성 옵션이 포함되어 있습니다.

EnableSharedChannelsMemberSync가 비활성화되어 있으면 채널 멤버십 변경이 커넥티드 워크스페이스 간에 동기화되지 않으며, 각 워크스페이스의 공유 채널에서 사용자를 수동으로 추가하거나 제거해야 합니다.

연결 및 초대 관리

시스템 관리자는 커넥티드 워크스페이스를 편집하거나 삭제할 수 있고, 연결 상태를 확인할 수 있으며, 대기 중인 연결의 초대 코드와 비밀번호를 재생성할 수 있습니다.

커넥티드 워크스페이스 편집

시스템 콘솔에서 시스템 관리자는 Organization Name, Destination Team(해당 커넥티드 워크스페이스에서 온 공유 채널을 정리하는 기본 위치), 원격 Mattermost 인스턴스와 공유한 채널, 로컬 Mattermost 인스턴스와 공유한 채널을 변경할 수 있습니다.

1. Connected Workspaces 아래에서 변경하려는 커넥티드 워크스페이스를 찾습니다.
2. 해당 커넥티드 워크스페이스 오른쪽의 More 아이콘을 선택한 뒤 Edit를 선택합니다.

현재 채널에서 모든 연결 제거

현재 채널에서 모든 보안 연결을 제거하려면 다음 슬래시 명령을 실행합니다.

/share-channel unshare

이 슬래시 명령은 현재 채널에서 모든 보안 연결을 제거합니다. 채널이 더 이상 공유되지 않는다는 시스템 메시지가 표시됩니다. 해당 보안 연결은 다른 공유 채널에는 계속 초대될 수 있습니다.

커넥티드 워크스페이스 삭제

연결된 서버를 삭제하면 로컬 Mattermost 서버와 원격 Mattermost 서버 간의 신뢰 관계가 끊어집니다.

Mattermost v10.10부터 커넥티드 워크스페이스에서 공유 채널을 제거하면 연결된 모든 워크스페이스에서 그 채널이 제거됩니다. 채널은 로컬과 원격 Mattermost 서버 양쪽에서 삭제됩니다. Mattermost v10.10 이전에는 커넥티드 워크스페이스에서 공유 채널을 제거하면 원격 Mattermost 서버와의 동기화만 중단되고, 채널 자체는 로컬 사용자에게 계속 동작했습니다.

System Console

1. Connected Workspaces 아래에서 제거하려는 커넥티드 워크스페이스를 찾습니다.
2. 해당 커넥티드 워크스페이스 오른쪽의 More 아이콘을 선택한 뒤 Delete를 선택합니다.

Slash Commands

슬래시 명령으로 Mattermost 인스턴스에서 보안 연결의 초대를 취소하거나 연결을 삭제할 수 있습니다.

보안 연결의 초대를 취소하려면 다음 슬래시 명령을 실행합니다.

/share-channel uninvite --connectionID

이 슬래시 명령은 connectionID를 기준으로 현재 채널에서 보안 연결을 제거합니다. 해당 보안 연결은 다른 공유 채널에는 계속 초대될 수 있습니다.

보안 연결을 삭제하려면 다음 슬래시 명령을 실행합니다.

/secure-connection remove --connectionID

예를 들면 다음과 같습니다.

/secure-connection remove --connectionID

이 슬래시 명령은 connectionID를 기준으로 로컬 Mattermost 서버와 원격 Mattermost 서버 간의 신뢰 관계를 끊고, 공유된 모든 Mattermost 채널에서 해당 보안 연결을 제거합니다.

연결 상태 확인

System Console

Connected Workspaces 아래에서 모든 커넥티드 워크스페이스와 그 현재 상태를 Connected, Offline, Connection Pending 중 하나로 확인할 수 있습니다.

Slash Commands

Mattermost 인스턴스에 수립된 모든 보안 연결의 현재 상태를 확인하려면 다음 슬래시 명령을 실행합니다.

/secure-connection status

상태 정보에는 다음이 포함됩니다.

• Connection ID
• Connection URL
• Description
• Invite accepted (Yes/No)
• Online (Yes/No)
• Last ping timestamp (UTC)
• Deleted

대기 중인 연결의 초대 코드 재생성

시스템 콘솔로 커넥티드 워크스페이스를 관리할 때, 시스템 관리자는 대기 중인 연결의 초대 코드와 비밀번호를 다시 생성할 수 있습니다.

1. Connected Workspaces 아래에서 초대장과 비밀번호를 재생성하려는 대기 중 연결을 찾습니다.
2. 해당 커넥티드 워크스페이스 오른쪽의 More 아이콘을 선택한 뒤 Regenerate invitation code를 선택합니다.

자주 묻는 질문

보안 연결 이름에 특수 문자를 사용할 수 있나요?

사용할 수 없습니다. 슬래시 명령을 사용할 때 --name에는 마침표, 하이픈, 밑줄을 포함할 수 있습니다. 값에 공백이 포함되는 경우 --name을 큰따옴표(")로 감싸야 합니다.

두 Mattermost 인스턴스의 이모지가 서로 다르면 어떻게 되나요?

한 Mattermost 인스턴스의 이모지가 다른 인스턴스와 다른 경우, 없는 이모지 이미지 대신 이모지 텍스트가 표시됩니다.

모든 보안 연결에 표시 이름이 필요한가요?

필요하지 않습니다. 슬래시 명령을 사용할 때 --displayname은 선택 사항입니다. 생략하면 대신 --name이 표시되고 사용됩니다.

커넥티드 워크스페이스 간에는 어떤 정보가 동기화되나요?

기본적으로 공유 채널의 모든 멤버에 대한 멤버 상태와 접속 가능 여부가 커넥티드 워크스페이스 간에 동기화됩니다.

사용자가 공유 채널에 추가되면 멤버 상태는 상태가 바뀐 뒤 몇 초 이내에 동기화됩니다. 상태 업데이트는 즉시 반영되지 않으며 반드시 실시간으로 표시되지도 않습니다.

웹 브라우저에서 Mattermost를 사용할 때 Mattermost는 1분마다 서버를 폴링합니다. 브라우저 페이지를 새로 고치면 즉시 동기화가 실행됩니다.

기본적으로 한 번에 최대 50개의 메시지가 동기화되며, 이 값은 구성할 수 있습니다.

채널 동기화와 멤버 상태·접속 가능 여부 동기화는 비활성화할 수 있습니다.

Mattermost v10.10부터 EnableSharedChannelsMemberSync 기능 플래그가 활성화되면 커넥티드 워크스페이스 간에 채널 멤버십을 동기화할 수 있습니다. 한 워크스페이스의 공유 채널에 사용자가 추가되거나 제거되면 그 멤버십 변경이 연결된 모든 워크스페이스의 해당 공유 채널에 자동으로 적용됩니다. 이를 통해 참여 중인 모든 Mattermost 인스턴스에서 채널 멤버십이 일관되게 유지됩니다. 또한 커넥티드 워크스페이스는 연결된 서버 간에 메시지 우선순위, 메시지 확인(acknowledgement), 지속 알림도 동기화합니다. 이를 통해 중요한 메시지 표시와 사용자 상호작용이 연결된 모든 워크스페이스 인스턴스에 일관되게 반영됩니다.

연결이 끊기면 메시지 동기화에 영향이 있나요?

영향이 있습니다. 메시지 동기화가 5분 넘게 중단되면 모든 채널 멤버가 볼 수 있는 시스템 메시지가 채널에 게시됩니다. 연결이 복구되면 다이렉트 메시지와 채널 링크를 포함해 누락된 모든 메시지에 대해 전체 동기화가 수행됩니다.

두 보안 연결에 동일한 사용자 이름이 있으면 어떻게 되나요?

Mattermost 보안 연결 간에 멤버들이 동일한 사용자 이름을 사용하는 경우, 로컬 서버 인스턴스의 사용자 이름 뒤에 원격 서버의 보안 연결 이름이 덧붙습니다.

예를 들어 두 Mattermost 인스턴스가 서로 보안 연결을 수립한 뒤 John Smith라는 이름의 멤버가 여러 명 존재한다면, 여러 Mattermost 인스턴스에 걸친 멤버를 구분할 수 있도록 원격의 John Smith 멤버 모두에게 사용자 이름 뒤에 Secure Connection ID가 붙습니다.