Cloudwiki/기능/ACL

정보:
문서와 카테고리 단위로 **편집 권한**과 **열람 공개 범위**를 제어하는 ACL(접근 제어) 기능을 설명합니다. 모든 설정은 **관리자 전용** 이며, 문서 보기 화면의 **권한 관리** 모달에서 이루어집니다.


# 개요

ACL(Access Control List)은 "누가 이 문서를 **편집**하거나 **열람**할 수 있는가"를 문서 또는 카테고리 단위로 제한하는 기능입니다.

과거에는 문서 편집기 상단에 비공개·관리자 잠금 체크박스가 있었지만, 현재는 모두 제거되고 문서 보기 화면의 **권한 관리** 모달로 통합되었습니다. 이 모달은 관리자에게만 표시됩니다.

| 제어 항목 | 의미 |
| --- | --- |
| 비공개 | 관리자만 문서를 **열람**할 수 있음 |
| 편집 ACL | 지정한 조건을 모두 만족하는 사용자만 **편집**할 수 있음 |

# 권한 관리 모달 열기

문서 보기 화면에서 문서 도구 드롭다운을 열고  **권한 관리** 를 선택합니다. 이 항목과 모달은 관리자에게만 노출됩니다.

모달은 세 부분으로 구성됩니다.

1. **현재 문서** — 이 문서 하나의 비공개·편집 ACL 설정
2. **하위 문서 일괄 적용** — `현재문서/...` 아래 하위 문서들에 설정을 일괄 적용하고, 자동 규칙으로 저장
3. **자동 규칙 목록** — 등록된 prefix 자동 규칙 확인 및 삭제

# 비공개 (열람 제한)

**비공개 (관리자만 열람)** 를 켜면 일반 사용자는 해당 문서를 볼 수 없고, 관리자만 열람할 수 있습니다.

# 편집 ACL (편집 제한)

편집 ACL은 다음 네 가지 조건(플래그)으로 구성됩니다. 여러 조건을 켜면 **모두 만족(AND)** 해야 편집할 수 있습니다.

| 플래그 | UI 라벨 | 통과 조건 |
| --- | --- | --- |
| `aged` | 가입 N일 이상 | 계정 생성 후 N일이 지난 사용자 |
| `page_editor` | 본 문서 편집 이력 | 이 문서를 한 번이라도 편집한 적이 있는 사용자 |
| `any_editor` | 임의 문서 편집 이력 | 위키 내 아무 문서나 편집한 적이 있는 사용자 |
| `admin_only` | 관리자 전용 | 관리자만 |

- **가입 N일 이상** 의 기준 일수(N)는 관리자 설정의 전역 값(`edit_acl_min_age_days`, 기본 15일)을 따릅니다.
- **관리자 전용(`admin_only`)** 플래그가 없으면 관리자는 ACL을 무시하고 항상 편집할 수 있습니다. 이 플래그가 켜져 있으면 관리자도 다른 플래그와 동일하게 평가됩니다.
- 신규 문서를 만들 때는 **본 문서 편집 이력** 을 만족할 수 없으므로, 이 플래그는 기존 문서에만 의미가 있습니다.

>  편집이 차단된 문서에서 일반 사용자가 편집을 시도하면, 차단 사유(관리자 전용 / 조건 미충족 등)가 안내됩니다.

# 하위 문서 일괄 적용과 자동 규칙

권한 관리 모달의 **하위 문서 일괄 적용** 영역에서는 `현재문서/...` 아래의 하위 문서 목록을 보고, 선택한 문서들에 다음을 일괄 적용할 수 있습니다.

- 비공개: 그대로 / 비공개 / 공개
- 편집 ACL: 그대로 / 비활성화 / 지정한 ACL 적용
- 카테고리: 그대로 / 추가 / 교체 / 비움

**자동 규칙으로 저장** 을 켜면 이 설정이 해당 prefix의 **자동 규칙**으로 등록되어, 이후 그 prefix 아래로 새로 만들어지는 문서에 자동으로 적용됩니다. 여러 규칙이 겹치면 **가장 긴 prefix** 가 우선합니다.

# 카테고리 단위 ACL

카테고리 문서의 문서 도구 > **권한 관리** 에서는 카테고리 단위의 편집 ACL **템플릿**을 지정하고, 그 카테고리에 속한 문서들에 일괄 적용할 수 있습니다. 적용 방식(병합 모드)은 세 가지입니다.

| 모드 | 동작 |
| --- | --- |
| 합치기 | 문서 ACL과 카테고리 템플릿의 조건을 **합칩니다**. AND 평가이므로 결과적으로 더 엄격해집니다. |
| 덮어쓰기 | 문서 ACL을 카테고리 템플릿으로 **교체**합니다. |
| 무시 | 문서 ACL은 그대로 두고 템플릿만 저장합니다. |

>  카테고리 입력 방법 자체는 [[Cloudwiki/기능/카테고리]] 를 참고하세요.

# 권한과 주의사항

- 비공개·편집 ACL·카테고리 ACL·자동 규칙은 **모두 관리자만** 설정할 수 있습니다. 일반 사용자에게는 권한 관리 모달이 노출되지 않습니다.
- 이 설정들은 본문과 별개로 즉시 적용되며, 편집 이력(리비전)에는 본문 변경으로 기록되지 않습니다.