규정 준수 내보내기#

plans-img Enterprise 플랜 에서 이용 가능

deployment-img Cloud 및 self-hosted 배포

Mattermost Enterprise 고객은 규정 준수 내보내기를 통해 감사 및 규정 준수 목적으로 기록을 보관하거나 메시지 데이터를 타사 시스템으로 전송할 수 있습니다. 지원되는 통합에는 Actiance Vantage, Global Relay, Proofpoint 가 포함됩니다.

Mattermost v10.5부터 규정 준수 내보내기는 출력 형식, 시스템 성능 및 로직에 영향을 미치는 변경 사항과 함께 대규모 일일 데이터 세트에 대한 성능 개선을 포함합니다. 규정 준수 내보내기는 규정 준수 팀에 채널 상태를 재구성하고, 초기 메시지에 대한 가시성이 있는 사용자 또는 메시지가 편집되거나 삭제된 시점을 파악하는 데 필요한 완전한 정보를 제공합니다. 규정 준수 팀은 메시지가 편집되거나 삭제될 때와 배치 및 내보내기 기간 동안 MessageId로 메시지를 추적할 수 있습니다.

개요#

규정 준수 내보내기는 시스템 콘솔에서 생성되며 다음과 같은 모든 메시지를 포함합니다:

  • 다이렉트 메시지 채널에서 전송된 메시지

  • 파일 업로드

  • 플러그인에서의 게시물

  • 봇/웹훅에서의 게시물

내보내기에는 메시지가 게시된 시점의 채널 구성원 기록에 대한 정보가 포함됩니다.

설정 가이드#

CSV, Actiance XML, Global Relay EML, 또는 Proofpoint 에 대한 내보내기를 구성하려면 다음 가이드를 사용하세요.

참고

  • 자체 호스팅 배포의 경우, 규정 준수 내보내기는 선택한 형식으로 구성된 파일 저장소의 exports 하위 디렉토리에 기록됩니다. 이는 로컬 스토리지 디렉토리 또는 S3 스토리지가 구성된 경우 Mattermost S3 버킷에 저장됩니다.

  • 또는 대체 파일 저장소 대상을 지정하고 규정 준수 내보내기를 위한 S3 사전 서명된 URL을 생성할 수 있습니다. 자세한 내용은 전용 내보내기 파일 저장소 대상 구성 설정 문서를 참조하세요.

  • 규정 준수 내보내기에는 기능이 활성화되기 전에 전송된 게시물이 포함되지 않습니다. 자체 호스팅 배포의 경우 export 명령줄 도구 를 통해 과거 기록을 내보낼 수 있습니다.

CSV#

  1. 시스템 콘솔 > 규정 준수 > 규정 준수 내보내기 로 이동하세요.

  2. 규정 준수 내보내기 활성화 를 true 로 설정하세요.

  3. 규정 준수 내보내기 시간 을 설정하세요. 이는 일일 예약된 규정 준수 내보내기 작업의 시작 시간이며 HH:MM 형식의 24시간 타임스탬프여야 합니다. 시스템 사용자가 적은 시간을 선택하세요.

  4. 내보내기 파일 형식을 CSV 로 설정하세요.

  5. 저장 을 선택하세요.

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

일일 규정 준수 내보내기 작업이 완료되면 내보내기가 시작된 시간과 내보내기의 startTimestamp 및 endTimestamp 를 기반으로 이름이 지정된 상위 디렉토리가 생성됩니다(예: compliance-export-2024-08-13-05h08m-1723105062492-1723109100075). 해당 상위 디렉토리에는 배치 번호와 해당 배치의 메시지 시작 및 종료 타임스탬프를 기반으로 이름이 지정된 각 배치당 1개의 zip 파일이 포함됩니다(예: batch001-1723105062492-1723106622163.zip). 각 zip 파일에는 이전 Mattermost 서버 릴리스에서 사용 가능한 것과 동일한 정보가 포함됩니다.

위의 동일한 예시를 사용하면 디렉토리는 다음과 같이 표시됩니다:

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 내보내기 필드

게시물 생성 시간 은 메시지와 첨부 파일의 경우 항상 CreateAt 이며, 참가자 참여 및 퇴장 이벤트의 경우 각각 JoinTime 과 LeaveTime 입니다.

  • 업데이트 시간 은 메시지가 업데이트되었음을 나타내며, 이는 updateAt 시간입니다.

  • 업데이트 유형 은 다음과 같은 업데이트 유형을 구분하는 데 도움이 됩니다:

    • EditedNewMsg 는 메시지가 편집되었음을 나타내며, 이는 새로운 메시지(편집 후) 내용입니다.

    • EditedOriginalMsg 는 메시지가 편집되었음을 나타내며, 이는 원본 메시지(편집 전) 내용입니다. 이 메시지에는 편집된 메시지 내용을 포함하는 메시지의 ID인 EditedNewMsgId 필드가 있습니다.

    • UpdatedNoMsgChange 는 메시지 내용이 변경되지 않았지만, 반응, 답장, 답장 편집 또는 답장 삭제와 같은 이유로 게시물이 업데이트되었음을 나타냅니다.

    • Deleted 는 이 메시지가 삭제되었음을 나타냅니다.

    • FileDeleted 는 이 메시지가 파일이 삭제되었음을 기록하고 있음을 나타냅니다.

일일 규정 준수 내보내기 작업은 지난 24시간 동안 게시된 모든 메시지의 고유 작업 식별자가 포함된 .zip 파일을 생성합니다. 파일을 압축 해제하여 기본 .csv 형식을 타사 보관 시스템에 필요한 형식으로 쉽게 변환할 수 있습니다.

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

Actiance XML#

  1. 시스템 콘솔 > 규정 준수 > 규정 준수 내보내기 로 이동하세요.

  2. 규정 준수 내보내기 활성화 를 true 로 설정하세요.

  3. 규정 준수 내보내기 시간 을 설정하세요. 이는 일일 예약된 규정 준수 내보내기 작업의 시작 시간이며 HH:MM 형식의 24시간 타임스탬프여야 합니다. 시스템을 사용하는 사람이 적은 시간을 선택하세요.

  4. 내보내기 파일 형식을 Actiance XML 로 설정하세요.

  5. 저장 을 선택하세요.

참고

Actiance XML 내보내기에서는 채널 이름 앞에 채널 유형이 추가됩니다.

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

일일 규정 준수 내보내기 작업이 완료되면 내보내기가 시작된 시간과 내보내기의 startTimestamp 및 endTimestamp 를 기반으로 이름이 지정된 상위 디렉토리가 생성됩니다(예: compliance-export-2024-08-13-05h08m-1723105062492-1723109100075). 해당 상위 디렉토리에는 배치 번호와 해당 배치의 메시지 시작 및 종료 타임스탬프를 기반으로 이름이 지정된 각 배치당 1개의 zip 파일이 포함됩니다(예: batch001-1723105062492-1723106622163.zip). 각 zip 파일에는 이전 Mattermost 서버 릴리스에서 사용 가능한 것과 동일한 정보가 포함됩니다.

위의 동일한 예시를 사용하면 디렉토리는 다음과 같이 표시됩니다:

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 필드가 비어 있으면 내보내지 않습니다. 이는 이전 Mattermost 릴리스에서 빈 XML 노드가 내보내졌던 것과 다른 변경 사항입니다.

  • MessageId 는 고유한 messageId 입니다.

  • DateTimeUTC 는 항상 게시물의 CreateAt 시간입니다.

  • UpdatedDateTimeUTC 는 메시지가 업데이트되었음을 나타내며, 이는 updateAt 시간입니다.

  • UpdatedType 은 다음과 같은 업데이트 유형을 구분하는 데 도움이 됩니다:

    • EditedNewMsg 는 이 메시지가 편집되었음을 나타내며, 이는 새로운 메시지(편집 후) 내용입니다.

    • EditedOriginalMsg 는 이 메시지가 편집되었음을 나타내며, 이는 원본 메시지(편집 전) 내용입니다. 이 메시지는 편집된 메시지 내용을 포함하는 메시지의 ID인 EditedNewMsgId 필드를 가집니다.

    • UpdatedNoMsgChange 는 메시지 내용이 변경되지 않았지만, 반응, 답장, 답장 편집 또는 답장 삭제와 같은 이유로 게시물이 업데이트되었음을 나타냅니다.

    • Deleted 는 메시지가 삭제되었음을 나타냅니다.

    • FileDeleted 는 파일이 삭제되었음을 기록하는 메시지를 나타냅니다.

일일 규정 준수 내보내기 작업은 지난 24시간 동안 게시된 모든 메시지의 고유 작업 식별자가 포함된 .zip 파일을 생성합니다. Actiance XML을 파일 형식으로 선택하면 Actiance Vantage 아카이브 시스템과의 통합을 설정할 수 있습니다. Actiance 출력 샘플은 여기서 Actiance XML 내보내기 파일을 다운로드 하세요.

Global Relay EML#

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

  1. 시스템 콘솔 > 규정 준수 > 규정 준수 내보내기 로 이동하세요.

  2. Enable Compliance Export 를 true 로 설정하세요.

  3. 규정 준수 내보내기 시간 을 설정하세요. 이는 일일 예약된 규정 준수 내보내기 작업의 시작 시간이며 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. 저장 을 선택하세요.

참고

250MB보다 큰 메시지는 Global Relay로 전송하기에 너무 크기 때문에 첨부 파일이 제거됩니다. 서버 로그에 ID global_relay_attachments_removed 가 포함된 오류가 추가됩니다. 여기에는 첨부 파일이 제거된 게시물 ID와 첨부 파일 ID가 포함됩니다. 큰 메시지를 더 잘 처리하기 위한 티켓이 대기 중입니다.

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

Proofpoint#

  1. 시스템 콘솔 > 규정 준수 > 규정 준수 내보내기 로 이동하세요.

  2. Enable Compliance Export 를 true 로 설정하세요.

  3. 규정 준수 내보내기 시간 을 설정하세요. 이는 일일 예약된 규정 준수 내보내기 작업의 시작 시간이며 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. 저장 을 선택하세요.

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

자주 묻는 질문(FAQ)#

과거 내역을 어떻게 내보내나요?#

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

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

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

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

시스템 콘솔을 통해 수동으로 실행할 때, .csv 및 Actiance XML 파일은 구성된 로컬 스토리지 디렉토리 의 exports 하위 디렉토리에 기록됩니다. 파일은 에포크 시간 범위를 기반으로 한 이름의 폴더에 기록됩니다. Global Relay EML 내보내기 형식 파일은 수동으로 실행할 때 구성된 이메일 주소로 메일이 발송됩니다.

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

아니요. 규정 준수 모니터링 CSV 파일 내의 행 수에는 제한이 없습니다.

규정 준수 내보내기 작업이 실패했는지 어떻게 알 수 있나요?#

Mattermost는 시스템 콘솔 > 규정 준수 > 규정 준수 내보내기 에서 각 규정 준수 내보내기 작업의 상태를 제공합니다. 여기에서 내보낸 메시지 및 파일 수를 포함하여 작업이 성공했는지 실패했는지 확인할 수 있습니다.

또한 자체 호스팅 배포의 서버 로그에 모든 실패가 반환됩니다. 오류 로그는 Failed job 문자열로 시작하며 job_id key/value 쌍을 포함합니다. 규정 준수 내보내기 작업 실패는 작업자 이름 MessageExportWorker 로 식별됩니다. 선택적으로 이러한 실패를 프로그래밍 방식으로 쿼리하고 적절한 시스템에 알리는 스크립트를 만들 수 있습니다.

참고

이 규정 준수 내보내기 기능은 기존 규정 준수 보고 감독 기능을 대체합니다. Enterprise 고객은 새 시스템으로 마이그레이션하는 것을 권장합니다. 새 규정 준수 내보내기 시스템의 CSV 출력 샘플은 여기에서 CSV 내보내기 파일을 다운로드 하세요.