문서 별 권한 설정
문서에 접근할 수 있는 담당자 및 고객(SDK/API 사용자)을 설정하는 방법을 알아보겠습니다.
담당자 권한 설정
각 문서 별로 “액세스 목록”에서 조회/편집이 가능한 담당자를 관리할 수 있습니다. 단, 프로젝트의 관리자는 모든 문서를 편집할 수 있습니다.
- 조회: 문서 내용 및 메타데이터 읽기, 검색
- 편집: 조회 및 수정, 삭제

액세스 목록은 기본적으로 화이트리스트 방식을 따릅니다. 즉, 목록에 등록되지 않은 담당자는 문서를 편집, 조회할 수 없음은 물론, 검색을 통해 문서 내용을 확인할 수도 없습니다. 따라서, 아래와 같이 문서 검색을 활용하고 계신 경우는 화이트리스트 방식의 액세스 목록을 운영하는 방식이 적합하지 않습니다.
- 편집 권한을 가진 담당자만 제한하되, 조회(검색)은 모든 담당자에게 허가하고자하는 경우
이를 방지하기 위해, 액세스 목록 아래에 위치하는 “목록에 없는 담당자도 조회 허용” 옵션을 켜시면 모든 담당자가 조회 권한을 가지게 되므로, 권한 제약 없이 검색을 이용하실 수 있습니다.
고객(SDK/API 사용자) 권한 설정
담당자 관리와 마찬가지로, 각 문서 별로 “액세스 목록”에서 조회가 가능한 고객을 관리할 수 있습니다. 여기서 고객이란 SDK 혹은 API를 통해 문서를 검색하는 사용자를 말합니다. 고객은 대시보드에 접근이 불가능하므로, 편집 권한을 가질 수 없으며, 조회 권한만 가질 수 있습니다.

고객 액세스 목록 또한 화이트리스트 방식을 따릅니다. 따라서 목록에 등록되지 않은 고객에게는 문서 검색시, 해당 문서가 제안되지 않습니다. 단, 액세스 목록 아래에 위치하는 “목록에 없는 고객(SDK/API 사용자)도 조회 허용” 옵션을 켜시면 모든 고객이 조회 권한을 가지게 되므로, 권한 제약 없이 검색을 이용하실 수 있습니다.
담당자를 한 명씩 추가해야하는 담당자 액세스 목록과 달리, 고객 액세스 목록 관리는 고객 개별 추가 외 고객 그룹 추가도 지원합니다. 개별 관리는 좌측의 옵션에서 customer id(user id)를 선택 후 추가, 그룹 관리는 customer group을 선택 후 추가하시면 됩니다.

customer id, customer group 이 두 변수는 모두 고객 별 변수로, 고객 목록에서 입력하실 수 있습니다. 특히, customer group은 입력 뿐 아니라 기존의 그룹에서 추가하실 수도 있습니다.
폴더를 활용한 권한 설정
문서 별로 권한을 설정하지 않더라도, 폴더를 사용해 여러 문서들의 권한을 한 번에 설정할 수 있습니다.
문서 탭 내에서 “새 폴더 추가”, 혹은 “모든 폴더 보기” 클릭을 통해 폴더 페이지로 진입 후, “새 폴더 추가” 버튼을 클릭해 폴더를 추가할 수 있습니다. 폴더명 및 액세스 목록을 입력해 폴더를 추가해주세요. 폴더의 조회/편집 권한도 문서와 유사하게 정의됩니다.
- 조회: 폴더 정보 읽기(폴더 내 문서 조회 권한은 최종적으로 각 문서에 설정된 권한을 따르며, 폴더 권한과 문서 권한을 동일시 시킬 수 있는 옵션이 존재함. 후술 예정)
- 편집: 폴더 수정, 삭제

추가(생성)된 폴더는 문서 업로드 시 선택할 수 있으며, 문서 선택 후, “기타” 메뉴 내 “문서 이동하기”를 클릭하여 기존의 문서들 또한 폴더 내로 이동시킬 수 있습니다.

이 때, “선택한 폴더의 액세스 목록을 문서의 액세스 목록에 덮어쓰기” 옵션을 체크할 경우, 폴더의 액세스 목록을 문서의 액세스 목록에 덮어쓰게 됩니다.

기타 유용한 정보
- 폴더 수정/삭제 권한은 각 폴더 내에서 설정된 “편집 가능” 담당자 목록에 의해 결정됩니다. 폴더를 추가할 수 있는 권한은 프로젝트 설정 > 담당자 > 그룹 > 권한 조정에서 실행하실 수 있습니다.

- “모든 폴더” 페이지에서 편집 권한이 있는 폴더를 편집하거나 삭제할 수 있습니다. 폴더 삭제 시, 폴더 내 문서의 삭제 여부는 선택 가능합니다. 모두 삭제 혹은 폴더 밖으로 이동 두 가지 옵션을 제공합니다.
- 폴더 내에 위치한 문서들은 폴더 내로 진입 후, 해당 폴더의 문서 목록에서 확인할 수 있습니다. 폴더에 속해있지 않은 문서들만 메인 페이지에서 노출됩니다.
- 상단의 검색바를 활용할 때, 현재 위치한 경로 이하만 검색 범위에 포함됩니다.
- 메인 페이지에서 검색 시, 전체 문서 대상으로 검색 가능
- “모든 폴더” 페이지 진입 후 검색 시, 모든 폴더 내 문서들 검색 가능, 폴더에 들어있지 않은 문서들은 검색 범위에 포함되지 않음
- 폴더 A 진입 후 검색 시, 폴더 A 내 문서들만 검색 가능