BookStack 외부 공개를 위한 권한 설정 및 페이지 액세스 제어 가이드
BookStack에서 특정 페이지만 비로그인 사용자에게 공개하기 위한 전역 설정 및 책(Book) 단위의 권한 상속 해제, 게스트 뷰어 권한 부여 절차 기술.
1. 개요
BookStack은 기본적으로 로그인한 사용자에게만 콘텐츠를 제공하도록 설계되어 있음. 그러나 문서화 도구 특성상 특정 매뉴얼이나 가이드를 외부(비로그인) 사용자에게 공개해야 할 경우가 발생함. 본 문서는 전체 사이트를 공개하지 않고, 특정 '책(Book)' 또는 포함된 '페이지' 내역만 선별적으로 공개하기 위한 권한 설정 프로세스를 정리함.
2. 전역 설정: 공개 액세스 허용
가장 먼저 시스템 레벨에서 외부 접근을 허용해야 함. 이 설정이 비활성화되어 있으면 개별 권한 설정이 적용되지 않음.
- 관리자 권한으로 로그인.
- 설정(Settings) > 기능 및 보안(Features & Security) 메뉴로 이동.
- 공개 액세스 허용(Allow Public Access) 옵션을 찾아 체크박스를 활성화함.
- 저장 버튼을 눌러 변경 사항을 반영.
이 설정이 완료되면 시스템에 Guest 역할(Role)이 활성화되며, 비로그인 사용자가 접근할 수 있는 통로가 열림.
3. 책(Book) 단위 권한 격리 및 부여
전역 설정 이후에는 모든 콘텐츠가 공개되는 것이 아니며, 기본 권한 정책을 따르게 됨. 특정 콘텐츠만 공개하기 위해 권한 상속을 끊고 별도 규칙을 적용해야 함.
3.1 권한 상속 해제
- 공개하고자 하는 대상이 포함된 **'책(Book)'**을 선택하여 이동.
- 상단 메뉴의 '권한(Permissions)' 탭을 클릭.
- 설정 항목 중 '기본값 상속(Inherit defaults)' 체크박스를 해제함.
참고: 기본값 상속을 해제하는 즉시 해당 책은 시스템의 기본 권한 규칙에서 분리되어 독자적인 권한 체계를 갖게 됨.
3.2 공개 권한(View) 부여
상속이 해제된 상태에서 외부 사용자(Guest)가 해당 책과 내부 페이지를 볼 수 있도록 명시적인 허용이 필요함.
- 동일한 권한 설정 페이지 하단의 역할(Role) 목록 확인.
- 'Public' (또는 Guest) 역할 행을 찾음.
- '보기(View)' 항목의 체크박스를 허용으로 설정.
- 설정을 저장함.
4. 적용 결과 및 작동 원리
위 설정을 적용하면 다음과 같은 논리로 작동함:
- 전역 설정: 시스템 문을 열어둠 (Guest 접근 가능).
- 상속 해제: 다른 비공개 콘텐츠와의 연결 고리를 끊음.
- 보기 허용: 해당 책(Book)과 그 하위에 속한 챕터/페이지에 대해 '읽기' 권한만 부여함.
결과적으로 URL을 통해 접근하는 일반 사용자(비로그인)는 해당 책에 포함된 페이지만 열람할 수 있으며, 그 외 권한이 부여되지 않은 다른 책이나 설정 메뉴에는 접근할 수 없음.
5. 결론
BookStack의 권한 제어는 전역 허용 -> 상속 차단 -> 개별 허용의 3단계 흐름을 따름. 이 방식을 통해 내부 문서는 철저히 보호하면서도, 필요한 기술 문서나 가이드라인만 선택적으로 외부에 서비스할 수 있음.
끝.
