컴플라이언스 내보내기

Mattermost Enterprise 고객은 컴플라이언스 내보내기를 사용해 감사와 컴플라이언스 목적으로 기록을 보관하거나 메시지 데이터를 서드파티 시스템으로 이전할 수 있습니다. 지원되는 연동 대상은 Smarsh (Actiance) Vantage, Global Relay, Proofpoint입니다.

Mattermost v10.5부터 컴플라이언스 내보내기에는 대용량 일일 데이터 세트를 위한 성능 개선이 포함되었으며, 이에 따라 출력 형식, 시스템 성능, 처리 로직이 변경되었습니다. 컴플라이언스 내보내기는 컴플라이언스 팀이 채널의 상태를 재구성하고, 최초 메시지를 누가 볼 수 있었는지 또는 메시지가 언제 편집되거나 삭제되었는지 판단할 수 있는 완전한 정보를 제공합니다. 컴플라이언스 팀은 메시지가 편집되거나 삭제되더라도, 그리고 배치와 내보내기 기간을 넘나들더라도 MessageId로 해당 메시지를 추적할 수 있습니다.

개요

컴플라이언스 내보내기는 시스템 콘솔에서 생성되며, 다음을 포함한 모든 메시지를 담습니다.

• 다이렉트 메시지 채널에서 전송된 메시지
• 파일 업로드
• 플러그인이 게시한 게시물
• 봇/웹훅이 게시한 게시물

내보내기에는 메시지가 게시된 시점의 채널 멤버 이력 정보도 포함됩니다.

설정 가이드

CSV, Smarsh / Actiance XML, Global Relay EML, Proofpoint 내보내기를 구성하려면 다음 가이드를 참고하세요.

CSV

1. System Console > Compliance > Compliance Export로 이동합니다.
2. Enable Compliance Exports를 true로 설정합니다.
3. Compliance Export time을 설정합니다. 이 값은 매일 예약된 컴플라이언스 내보내기 작업의 시작 시각이며, HH:MM 형식의 24시간 표기여야 합니다. 시스템 사용자가 적은 시간대를 선택하세요.
4. 내보내기 파일 형식을 CSV로 설정합니다.
5. Save를 선택합니다.

Mattermost v10.5 이상

시스템 콘솔에서 내보내기 작업 상태를 확인할 수 있습니다.

매일 실행되는 컴플라이언스 내보내기 작업이 완료되면, 내보내기가 시작된 시점과 내보내기의 startTimestamp·endTimestamp를 기준으로 이름이 지정된 상위 디렉터리가 생성됩니다. 예: administration-guide/comply/compliance-export-2024-08-13-05h08m-1723105062492-1723109100075. 이 상위 디렉터리에는 배치마다 zip 파일이 하나씩 들어 있으며, 파일 이름은 배치 번호와 해당 배치에 포함된 메시지의 시작·종료 타임스탬프를 기준으로 지정됩니다. 예: batch001-1723105062492-1723106622163.zip. 각 zip 파일에는 이전 Mattermost 서버 릴리스에서 제공되던 것과 동일한 정보가 들어 있습니다.

위 예시를 그대로 따르면 디렉터리는 다음과 같습니다.

administration-guide/comply/compliance-export-2024-08-13-05h08m-1723105062492-1723109100075
├── batch001-1723105062492-1723106622163.zip
├── batch002-1723106622163-1723108196005.zip
└── batch003-1723108196005-1723109100075.zip

그리고 각 배치는 다음과 같습니다.

batch001-1723105062492-1723106622163.zip
├── files
├── metadata.json
└── actiance_export.xml

업데이트된 CSV 내보내기 필드

Post Creation Time은 메시지와 첨부 파일의 경우 항상 CreateAt이며, 참가자 입장·퇴장 이벤트의 경우 각각 JoinTime과 LeaveTime입니다.

• Update Time은 메시지가 업데이트되었음을 나타내며, updateAt 시각입니다.
• Updated Type은 어떤 종류의 업데이트였는지 구분하며, 다음 중 하나입니다.
  • EditedNewMsg는 메시지가 편집되었으며 이 항목이 새 메시지(편집 후) 내용임을 나타냅니다.
  • EditedOriginalMsg는 메시지가 편집되었으며 이 항목이 원본 메시지(편집 전) 내용임을 나타냅니다. 이 메시지에는 편집 후 메시지 내용을 담고 있는 메시지의 Id인 EditedNewMsgId 필드가 추가로 포함됩니다.
  • UpdatedNoMsgChange는 메시지 내용은 변경되지 않았지만 반응, 답글, 답글 편집, 답글 삭제 등의 이유로 게시물이 업데이트되었음을 나타냅니다.
  • Deleted는 이 메시지가 삭제되었음을 나타냅니다.
  • FileDeleted는 이 메시지가 파일 삭제를 기록하고 있음을 나타냅니다.

Mattermost v10.5 이전

매일 실행되는 컴플라이언스 내보내기 작업은 최근 24시간 동안 게시된 모든 메시지를 담은 .zip 파일을 고유한 작업 식별자와 함께 생성합니다. 이 파일의 압축을 풀면 기본 .csv 형식을 서드파티 아카이브 시스템에 맞는 형식으로 손쉽게 변환할 수 있습니다.

CSV 출력 샘플은 여기에서 CSV 내보내기 파일을 다운로드해 확인하세요.

Actiance XML

Actiance XML은 Smarsh Vantage 제품에서 지원되는 형식입니다.

1. System Console > Compliance > Compliance Export로 이동합니다.
2. Enable Compliance Exports를 true로 설정합니다.
3. Compliance Export time을 설정합니다. 이 값은 매일 예약된 컴플라이언스 내보내기 작업의 시작 시각이며, HH:MM 형식의 24시간 표기여야 합니다. 시스템 사용자가 적은 시간대를 선택하세요.
4. 내보내기 파일 형식을 Actiance XML로 설정합니다.
5. Save를 선택합니다.

Mattermost v10.5 이상

시스템 콘솔에서 내보내기 작업 상태를 확인할 수 있습니다. 파일 형식으로 Actiance XML을 선택하면 Actiance Vantage 아카이브 시스템과의 연동을 설정할 수 있습니다.

매일 실행되는 컴플라이언스 내보내기 작업이 완료되면, 내보내기가 시작된 시점과 내보내기의 startTimestamp·endTimestamp를 기준으로 이름이 지정된 상위 디렉터리가 생성됩니다. 예: administration-guide/comply/compliance-export-2024-08-13-05h08m-1723105062492-1723109100075. 이 상위 디렉터리에는 배치마다 zip 파일이 하나씩 들어 있으며, 파일 이름은 배치 번호와 해당 배치에 포함된 메시지의 시작·종료 타임스탬프를 기준으로 지정됩니다. 예: batch001-1723105062492-1723106622163.zip. 각 zip 파일에는 이전 Mattermost 서버 릴리스에서 제공되던 것과 동일한 정보가 들어 있습니다.

위 예시를 그대로 따르면 디렉터리는 다음과 같습니다.

administration-guide/comply/compliance-export-2024-08-13-05h08m-1723105062492-1723109100075
├── batch001-1723105062492-1723106622163.zip
├── batch002-1723106622163-1723108196005.zip
└── batch003-1723108196005-1723109100075.zip

그리고 각 배치는 다음과 같습니다.

batch001-1723105062492-1723106622163.zip
├── 20240808
└── actiance_export.xml

업데이트된 Actiance XML 내보내기 필드

XML 필드가 비어 있으면 내보내지지 않습니다. 빈 XML 노드를 내보내던 이전 Mattermost 릴리스에서 달라진 점입니다.

• MessageId는 고유한 messageId입니다.
• DateTimeUTC는 항상 게시물의 CreateAt 시각입니다.
• UpdatedDateTimeUTC는 메시지가 업데이트되었음을 나타내며, updateAt 시각입니다.
• UpdatedType은 어떤 종류의 업데이트였는지 구분하며, 다음을 포함합니다.
  • EditedNewMsg는 이 메시지가 편집되었으며 이 항목이 새 메시지(편집 후) 내용임을 나타냅니다.
  • EditedOriginalMsg는 이 메시지가 편집되었으며 이 항목이 원본 메시지(편집 전) 내용임을 나타냅니다. 이 메시지에는 편집 후 메시지 내용을 담고 있는 메시지의 Id인 EditedNewMsgId 필드가 추가로 포함됩니다.
  • UpdatedNoMsgChange는 이 메시지의 내용은 변경되지 않았지만 반응, 답글, 답글 편집, 답글 삭제 등의 이유로 게시물이 업데이트되었음을 나타냅니다.
  • Deleted는 메시지가 삭제되었음을 나타냅니다.
  • FileDeleted는 메시지가 파일 삭제를 기록하고 있음을 나타냅니다.

Mattermost v10.5 이전

매일 실행되는 컴플라이언스 내보내기 작업은 최근 24시간 동안 게시된 모든 메시지를 담은 .zip 파일을 고유한 작업 식별자와 함께 생성합니다. 파일 형식으로 Actiance XML을 선택하면 Actiance Vantage 아카이브 시스템과의 연동을 설정할 수 있습니다. Actiance 출력 샘플은 여기에서 Actiance XML 내보내기 파일을 다운로드해 확인하세요.

Global Relay EML

Global Relay 아카이브 시스템에 대한 자세한 내용은 해당 웹사이트를 참고하세요.

1. System Console > Compliance > Compliance Export로 이동합니다.
2. Enable Compliance Export를 true로 설정합니다.
3. Compliance Export time을 설정합니다. 이 값은 매일 예약된 컴플라이언스 내보내기 작업의 시작 시각이며, HH:MM 형식의 24시간 표기여야 합니다. 시스템 사용자가 적은 시간대를 선택하세요.
4. Export Format을 GlobalRelay EML로 설정합니다.
5. Global Relay Customer Account에서 A9/Type 9, A10/Type 10, Custom 중 하나를 선택합니다. 이는 조직이 보유한 Global Relay 고객 계정 유형입니다.
   • A9/Type 9 및 A10/Type 10 유형의 경우, Global Relay에서 제공한 Global Relay SMTP username, Global Relay SMTP password, Global Relay SMTP email address를 설정합니다.
   • Custom 유형의 경우, Global Relay에서 제공한 Global Relay SMTP username, Global Relay SMTP password, Global Relay SMTP email address, SMTP Server Name, SMTP Server Port를 설정합니다. Custom 유형은 Proofpoint 연동에도 사용할 수 있습니다.
6. Save를 선택합니다.

파일 형식으로 Global Relay EML을 선택하면 Global Relay 아카이브 시스템과의 연동을 설정할 수 있습니다. 자세한 내용은 Global Relay Archive를 참고하세요.

Proofpoint

1. System Console > Compliance > Compliance Export로 이동합니다.
2. Enable Compliance Export를 true로 설정합니다.
3. Compliance Export time을 설정합니다. 이 값은 매일 예약된 컴플라이언스 내보내기 작업의 시작 시각이며, HH:MM 형식의 24시간 표기여야 합니다. 시스템 사용자가 적은 시간대를 선택하세요.
4. Export Format을 GlobalRelay EML로 설정합니다.
5. Proofpoint와 연동하려면 Global Relay Customer Account에서 Custom을 선택합니다.
6. Proofpoint에서 제공한 SMTP username, SMTP password, SMTP email address, SMTP Server Name, SMTP Server Port를 설정합니다.
7. Save를 선택합니다.

업데이트된 Global Relay 내보내기 필드에 대한 자세한 내용은 Global Relay 섹션을 참고하세요. 이제 Proofpoint 아카이브 시스템과의 연동을 설정할 수 있습니다. 자세한 내용은 Proofpoint Archive 웹사이트를 참고하세요.

자주 묻는 질문(FAQ)

플레이북과 보드 데이터도 컴플라이언스 내보내기에 포함되나요?

아닙니다. 컴플라이언스 내보내기에는 채널 메시지, 다이렉트 메시지, 파일 업로드, 플러그인/봇/웹훅이 게시한 게시물만 포함됩니다. Mattermost Playbooks의 데이터(실행 활동, 상태 업데이트, 회고 포함)와 Mattermost Boards의 데이터(카드, 댓글, 보드 활동 포함)는 컴플라이언스 내보내기 기능에 포함되지 않습니다. 플레이북과 보드 데이터의 컴플라이언스 보관이 필요한 조직은 이러한 기능에 대해 별도의 데이터 보존 전략을 고려해야 합니다.

과거 기록은 어떻게 내보내나요?

export 명령줄 도구를 실행하세요. exportFrom 옵션을 지정하면 특정 타임스탬프 이후의 데이터를 내보낼 수 있습니다. 해당 타임스탬프 이후에 작성된 모든 게시물이 내보내집니다.

mmctl로 컴플라이언스 내보내기 작업을 다운로드하려면 어떻게 하나요?

Mattermost Server v10.11부터 시스템 관리자는 mmctl compliance_export download 명령어로 컴플라이언스 내보내기 작업을 다운로드할 수 있습니다. 이를 통해 완료된 컴플라이언스 내보내기 작업을 작업 ID로 조회해 가져오는 명령줄 인터페이스를 사용할 수 있습니다.

데이터를 수동으로 내보내면 어떻게 되나요?

컴플라이언스 내보내기 작업이 자동으로 실행되든, 시스템 콘솔에서 수동으로 실행되든, CLI로 수동 실행되든(--exportFrom 옵션 없이) 이전 작업 실행에서 마지막으로 내보낸 게시물 이후에 작성된 모든 게시물을 내보냅니다. 작업이 처음 실행되는 경우에는 기능이 활성화된 이후에 작성된 모든 게시물이 내보내집니다.

CLI 명령어에 --exportFrom 옵션을 지정하면, 지정한 타임스탬프 이후에 작성된 모든 게시물이 내보내집니다.

시스템 콘솔에서 수동으로 실행하면 .csv 및 Actiance XML 파일이 구성된 로컬 저장소 디렉터리의 exports 하위 디렉터리에 기록됩니다. 파일은 에포크 시간 범위를 기준으로 이름이 지정된 폴더에 기록됩니다. Global Relay EML 내보내기 형식의 파일은 수동 실행 시 구성된 이메일 주소로 발송됩니다.

CSV 파일에 최대 행 수 제한이 있나요?

없습니다. 컴플라이언스 모니터링 CSV 파일의 행 수에는 제한이 없습니다.

컴플라이언스 내보내기 작업이 실패했는지 어떻게 알 수 있나요?

Mattermost는 System Console > Compliance > Compliance Export에서 각 컴플라이언스 내보내기 작업의 상태를 제공합니다. 여기에서 작업의 성공·실패 여부와 함께 내보낸 메시지 및 파일 수를 확인할 수 있습니다.

또한 자체 호스팅 배포에서는 모든 실패가 서버 로그에 기록됩니다. 오류 로그는 Failed job 문자열로 시작하며 job_id key/value 쌍을 포함합니다. 컴플라이언스 내보내기 작업 실패는 워커 이름 MessageExportWorker로 식별됩니다. 필요하다면 이러한 실패를 프로그래밍 방식으로 조회해 적절한 시스템에 알리는 스크립트를 작성할 수 있습니다.