Atlassian Confluence

개요

대상 사용자: Atlassian Confluence Cloud를 사용하는 조직의 보안·감사 담당자와 문서 관리자

Atlassian Confluence 앱으로 다음 업무를 수행할 수 있습니다.

• 권한, 사용자·그룹, 스페이스, 공개 링크 등 사이트 설정 변경 이력 점검
• 페이지·블로그·댓글·첨부 파일의 작성·수정 이력 추적
• 휴지통으로 이동한 페이지·블로그 확인

기본 개념·용어

주요 화면·메뉴 경로

작업 시나리오

시나리오 1: 특정 문서의 작성·수정 이력 조회

목적: 중요한 문서가 언제, 누구에 의해, 어떤 순서로 바뀌었는지 확인합니다. 본문 수정뿐 아니라 그 문서에 달린 댓글과 첨부 파일 이력도 함께 봅니다.

사전 조건:

• 설치 매뉴얼의 콘텐츠 활동 로그 수집 설정이 완료되어 있어야 합니다.
• 토큰을 발급한 계정이 해당 스페이스와 페이지를 볼 수 있어야 합니다.

수행 절차:

1. 확인할 문서의 제목 일부를 정합니다. 예: 운영 가이드
2. 아래 쿼리를 분석 > 쿼리에서 실행합니다.

table duration=7d CONFLUENCE_CONTENT_ACTIVITY
| search doc_title == "*운영 가이드*"
| sort _time
| fields _time, action, doc_title, ver, user_name, comment_id, file_name

3. 특정 버전의 내용을 보려면 fields에 content를 추가합니다. content는 그 버전의 본문을 평문으로 바꾼 값입니다.

결과 확인:

• 페이지는 page_created·page_updated, 블로그는 blogpost_created·blogpost_updated, 댓글은 comment_created·comment_updated, 첨부 파일은 attachment_created·attachment_updated로 구분됩니다. 1번 버전이 생성(created), 그 뒤 버전이 수정(updated)입니다.
• 댓글과 첨부 파일의 ver는 문서가 아니라 그 댓글·파일의 버전입니다.

실패 대응:

시나리오 2: 삭제된 페이지와 마지막 작업자 확인

목적: 휴지통으로 이동한 페이지·블로그를 확인하고, 삭제 직전에 그 문서를 마지막으로 작성하거나 수정한 사용자를 함께 확인합니다. Confluence는 삭제한 사용자를 API로 제공하지 않으므로, 콘텐츠 활동 로그의 마지막 작업자를 단서로 활용합니다.

사전 조건:

• 설치 매뉴얼의 콘텐츠 활동 로그 수집 설정과 콘텐츠 삭제 로그 수집 설정이 모두 완료되어 있어야 합니다.
• 콘텐츠 삭제 수집기가 등록된 이후에 휴지통으로 이동한 문서만 조회됩니다.

수행 절차:

1. 아래 쿼리를 분석 > 쿼리에서 실행합니다. 삭제 로그에 콘텐츠 활동 로그의 문서별 마지막 작업자와 시각을 붙입니다.

table duration=1d CONFLUENCE_CONTENT_TRASH
| fields _time, action, doc_id, doc_title
| join type=left doc_id [
    table duration=30d CONFLUENCE_CONTENT_ACTIVITY
    | search isnotnull(user_name)
    | sort limit=1 -_time by doc_id
    | eval last_user = user_name, last_time = _time
    | fields doc_id, last_user, last_time ]

2. 문서 주소가 필요하면 둘째 줄의 fields에 url을 추가합니다.

결과 확인:

• _time은 실제 삭제 시각이 아니라 수집기가 휴지통에서 처음 발견한 시각입니다(최대 수집 주기 1회만큼 늦음).
• last_user는 삭제한 사용자가 아니라 마지막으로 작성·수정한 사용자입니다. 댓글·첨부 작업도 그 문서의 활동에 포함됩니다.

실패 대응:

시나리오 3: 권한·공개 링크 설정 변경 정기 점검

목적: 전역 권한 추가, 페이지 제한 추가, 공개 링크 설정 변경처럼 보안에 영향을 주는 사이트 설정 변경을 매일 확인합니다.

사전 조건:

• 설치 매뉴얼의 감사 로그 수집 설정이 완료되어 있어야 합니다.
• 토큰을 발급한 계정에 Confluence 관리자 전역 권한이 있어야 합니다.

수행 절차:

1. 아래 쿼리를 분석 > 쿼리에서 실행해 최근 1일간의 권한·공개 링크 관련 변경을 확인합니다.

table duration=1d CONFLUENCE_AUDIT
| search category == "Permissions" or category == "Product permissions" or category == "Public Link"
| sort -_time
| fields _time, user_name, category, event_name

2. 변경 전·후 값을 보려면 fields에 changes를 추가합니다.
3. 변경 종류별 건수만 보려면 아래 쿼리를 실행합니다.

table duration=1d CONFLUENCE_AUDIT
| search category == "Permissions" or category == "Product permissions" or category == "Public Link"
| stats count by category, event_name
| sort -count

4. 매일 반복해서 확인하려면 1번 쿼리를 분석 > 예약된 쿼리에 등록합니다.

결과 확인:

• changes에는 변경된 항목마다 항목명(field_name), 변경 전 값(changed_from), 변경 후 값(changed_to)이 들어 있습니다. 예를 들어 위 첫 행의 changes에는 제한 종류(Type)가 View로, 대상 사용자(User)가 홍길동으로 추가된 내용이 기록됩니다.
• 시스템이 수행한 작업은 user_name이 System입니다.
• category와 event_name은 영문으로 기록되므로 조건에도 영문 값을 사용합니다.

실패 대응:

주의사항

• 삭제 이벤트의 시각과 작업자: 콘텐츠 삭제 로그의 시각은 실제 삭제 시각이 아닌 감지 시각이고, 삭제한 사용자는 기록되지 않습니다. 댓글·첨부 파일 삭제는 감지 대상이 아닙니다.
• 콘텐츠 삭제 수집기 최초 실행: 처음 실행할 때 이미 휴지통에 있던 항목은 기준 목록으로만 저장하고 이벤트로 남기지 않습니다.
• 생성 직후 삭제된 콘텐츠: 생성 후 콘텐츠 활동 수집기의 다음 주기 전에 삭제되면 생성 이벤트 없이 삭제 이벤트만 남습니다.
• 조회 가능 범위: 콘텐츠 활동은 토큰 발급 계정이 볼 수 있는 스페이스와 페이지만 수집됩니다. 페이지 제한으로 볼 수 없는 페이지는 수집되지 않습니다.
• 수집하지 않는 활동: 페이지 열람 기록은 수집하지 않습니다. 페이지 제한(권한) 변경은 콘텐츠 활동이 아닌 감사 로그에 Content restriction added 등으로 기록됩니다.
• 감사 로그 보존 기간: Confluence 감사 로그는 기본 1년간 보관되며 사이트 관리자가 1~12개월 사이로 바꿀 수 있습니다. 보존 기간보다 오래된 기록은 수집되지 않고, 초기 수집 일수는 수집기가 처음 실행될 때만 적용됩니다.

관련 문서

• 설치 매뉴얼 — API 토큰 발급, 접속 프로파일, 수집기 설정
• confluence-audit — 감사 로그 스키마
• confluence-content-activity — 콘텐츠 활동 로그 스키마
• confluence-content-trash — 콘텐츠 삭제 로그 스키마