RAGO-X 사용자와 접근 권한 관리: 초대부터 부서 이동·퇴사까지

신입 직원에게 업무 문서를 열어주고, 부서가 바뀐 직원의 접근 범위를 조정하고, 퇴사자의 이용을 정리하는 일은 지식 관리의 일부입니다. 문서를 잘 정리해 두었더라도 누가 어떤 문서에 접근할 수 있는지 불분명하면 운영하기 어렵습니다.

RAGO-X에서는 조직의 사용자 역할과 문서함 접근을 위한 사용자 그룹을 구분해 관리합니다. 사용자를 초대하는 것, 관리자로 지정하는 것, 특정 문서함을 열어주는 것은 각각 다른 설정입니다.

이 글은 RAGO-X의 사용자 관리·권한관리 화면과 접근 제어 동작을 바탕으로 작성했습니다. 아래 부서명과 인물은 설정 방법을 설명하기 위한 가상의 예시입니다.

역할과 접근 그룹은 무엇이 다른가요?

먼저 두 가지 질문을 나눠 봅니다.

• 이 사용자가 조직을 운영하거나 설정을 변경해야 하나요?
• 이 사용자가 업무에 필요한 어떤 문서함을 이용해야 하나요?

첫 번째는 역할, 두 번째는 문서함 접근 그룹에 관한 질문입니다.

그룹 이름을 관리자로 만들었다고 해서 그 그룹의 사용자가 조직 관리자 역할을 얻는 것은 아닙니다. 반대로, 특정 문서함을 보여주기 위해 사용자의 역할을 관리자로 올릴 필요도 없습니다.

소유자·관리자·일반 사용자

RAGO-X의 조직 역할은 OWNER, ADMIN, MEMBER로 구분됩니다.

그룹 접근 설정이 소유자·관리자의 열람 범위를 일반 사용자와 똑같이 제한한다고 생각하면 안 됩니다. 소유자·관리자는 일반 사용자용 문서함 접근 그룹 검사에서 예외가 적용되는 조회 경로가 있습니다. 그룹으로 문서를 구분하려면, 문서 이용만 필요한 구성원에게는 일반 사용자 역할을 부여하는 것이 출발점입니다.

관리자에게 보이는 문서함이라도 모든 설정을 수정할 수 있다는 뜻은 아닙니다. 조회 권한과 문서함을 관리하는 권한은 구분되며, 관리자는 관리 가능한 공간 범위 안에서 설정합니다.

사례 1. 신입 직원에게 필요한 문서만 열어주기

고객지원팀에 새 직원이 입사했다고 가정하겠습니다. 이 직원은 전사 공통 안내와 고객지원 매뉴얼이 필요하지만, 인사 운영 자료까지 볼 필요는 없습니다.

1. 일반 사용자로 초대합니다

사용자 관리 화면에서 초대할 이메일과 역할을 확인한 뒤 초대를 보냅니다. 이 사례에서는 MEMBER를 선택합니다. 초대받은 사람이 초대 절차를 완료했는지, 사용자 목록에 정상적으로 등록되었는지 확인합니다.

초대를 보냈다는 사실과 실제 사용자가 등록되었다는 사실은 구분합니다. 초대가 완료되지 않은 상태라면 먼저 초대 상태와 이메일을 확인하고, 사용자 수 한도에 걸린 경우에는 조직의 이용 현황을 확인합니다.

2. 업무 기준으로 사용자 그룹을 만듭니다

권한관리 → 사용자 그룹 → 새 그룹에서 다음과 같이 그룹을 구성합니다.

그룹명과 설명을 작성하고 활성 상태를 확인합니다. 그룹을 선택한 뒤 그룹 멤버에서 등록된 사용자를 추가합니다. 신입 직원은 전사 구성원과 고객지원에 추가하고, 인사 운영에는 추가하지 않습니다.

전사 구성원은 이 글에서 만드는 예시 그룹입니다. 모든 사용자가 자동으로 포함되는 특별한 시스템 그룹이라는 뜻은 아닙니다. 신규 사용자를 초대할 때 필요한 그룹에도 추가해야 합니다.

3. 문서함에 접근 그룹을 지정합니다

권한관리 → 문서함 접근으로 이동해 공간과 문서함을 선택합니다. 해당 문서함을 이용할 그룹을 체크하고 접근 그룹 저장을 누릅니다.

신입 직원 — 일반 사용자
    ├─ 전사 구성원 그룹 → 공통 안내 문서함
    └─ 고객지원 그룹   → 고객지원 매뉴얼 문서함

인사 운영 그룹         → 인사 운영 문서함

문서함을 만들었다고 일반 사용자에게 자동으로 열리는 것은 아닙니다. 일반 사용자는 자신이 속한 활성 그룹과 문서함의 접근 그룹이 연결되어 있어야 합니다. 연결이 없는 문서함은 일반 사용자에게 공개된 문서함으로 취급하지 않습니다.

4. 일반 사용자 계정으로 결과를 확인합니다

설정을 마친 뒤에는 관리자 화면만 보고 완료로 판단하지 않습니다. 일반 사용자 계정에서 다음을 확인합니다.

• 공통 안내와 고객지원 매뉴얼 문서함을 선택할 수 있는가?
• 허용된 문서함에서 질문을 시작할 수 있는가?
• 인사 운영 문서함은 이용할 수 없도록 구분되어 있는가?

관리자는 일반 사용자보다 넓은 조회 권한을 가질 수 있으므로, 관리자 계정에서 문서함이 보인다는 결과만으로 일반 사용자의 설정을 검증할 수 없습니다.

문서함은 접근 대상이 같은 문서끼리 나눕니다

RAGO-X의 권한관리 화면에서는 문서함별 접근 그룹을 지정합니다. 이 화면에서 문서마다 서로 다른 사용자를 지정하거나 읽기·편집 권한을 세분화하는 것으로 이해하면 안 됩니다.

예를 들어 전 직원용 복리후생 안내와 인사 담당자용 운영 자료는 접근 대상이 다릅니다. 이런 자료를 하나의 문서함에 섞고 파일명으로만 구분하기보다, 접근 대상에 맞춰 문서함을 나누는 편이 설정을 이해하기 쉽습니다.

자료를 넣기 전에 “이 문서함 안의 문서들은 같은 사람들에게 제공해도 되는가?”를 확인하면 이후 권한 설정도 단순해집니다. 문서의 주제뿐 아니라 열람 대상도 분류 기준이 됩니다.

사례 2. 부서 이동 시 권한을 함께 정리하기

고객지원 담당자가 인사 운영 업무로 이동했다고 가정하겠습니다. 새로운 그룹에 추가하는 것만으로는 기존 고객지원 접근 권한이 사라지지 않습니다.

일반 사용자가 여러 활성 그룹에 속해 있다면, 그중 하나라도 문서함의 허용 그룹과 연결되면 접근 경로가 남습니다. 한 그룹에서 제거했더라도 다른 그룹을 통해 같은 문서함을 이용할 수 있습니다.

이동 후 필요한 권한을 먼저 정합니다

1. 변경된 업무에서 필요한 문서함을 정합니다.
2. 권한관리에서 새 업무 그룹에 사용자를 추가합니다.
3. 더 이상 필요하지 않은 이전 그룹에서는 사용자를 제거합니다.
4. 공통 안내처럼 계속 필요한 그룹은 유지합니다.
5. 다른 그룹을 통해 이전 문서함에 접근하는 경로가 남아 있는지도 확인합니다.

이 사례에서는 전사 구성원은 유지하고, 고객지원에서 제거한 뒤 인사 운영에 추가합니다. 접근 공백을 피할지, 권한이 겹치는 시간을 없앨지는 조직의 업무 전환 일정에 맞춰 순서를 정합니다.

기존 문서함의 접근 그룹을 통째로 해제하는 방법과 특정 사용자를 그룹에서 제거하는 방법도 구분해야 합니다. 한 사람의 부서 이동 때문에 문서함의 그룹 연결을 지우면 같은 그룹의 다른 구성원에게도 영향을 줄 수 있습니다.

사례 3. 협업이 끝났을 때 접근 권한 회수하기

여러 부서가 함께 쓰는 임시 협업 문서함이라면 신제품 협업 같은 그룹을 만들고 필요한 사람들만 추가할 수 있습니다. 협업이 종료되면 무엇을 중단하려는지에 따라 조치를 고릅니다.

그룹을 비활성화해도 같은 사용자가 다른 활성 그룹을 통해 접근할 수 있는 문서함은 별도로 남을 수 있습니다. 사용자 비활성화, 그룹 소속 변경, 문서함 연결 변경은 서로 대체되는 설정이 아닙니다.

또한 접근 설정을 바꾸는 것은 앞으로의 서비스 이용 범위를 조정하는 일입니다. 이미 다운로드한 문서나 외부 시스템에 복사한 답변을 원격으로 회수하는 기능은 아닙니다.

사례 4. 퇴사자와 API 연동을 함께 점검하기

퇴사자 처리에서는 사용자 상태만 보는 것으로 끝내지 않는 편이 좋습니다. 그 사람이 운영하던 외부 연동이 있는지도 함께 확인합니다.

사용자 계정 정리

사용자 관리에서 대상 사용자를 선택하고 수정 → 상태 → 비활성으로 변경해 저장합니다. 이후 필요한 그룹 소속도 정리하고, 업무를 이어받을 담당자의 권한을 확인합니다.

관리자 역할의 사용자가 다른 관리자나 소유자의 상태를 바꾸려 하면 제한될 수 있습니다. 역할 변경이나 관리자 계정 정리는 조직 소유자에게 요청합니다. 본인의 역할이나 활성 상태를 변경하는 작업에도 보호 제한이 있으므로, 운영 담당자를 확보한 상태에서 진행합니다.

비활성화 후에는 해당 계정의 로그인과 보호된 기능 이용을 확인합니다. 이미 열린 세션이나 진행 중인 작업의 처리까지 확인하지 않은 상태에서 “모든 연결이 즉시 종료됐다”고 판단하지 않습니다.

API Key는 별도로 확인

RAGO-X의 외부 연동은 조직 범위의 API Key와 그 키에 허용된 문서함을 사용합니다. 일반 사용자 그룹 설정과 API Key의 허용 문서함 설정은 별개입니다.

따라서 퇴사자가 관리하던 연동이 있다면 다음도 확인합니다.

• 해당 키를 사용하는 서버와 업무가 무엇인가?
• 새 담당자가 연동을 유지해야 하는가?
• 키에 허용된 문서함과 출발지 IP 범위가 여전히 적절한가?
• 키를 교체한다면 연동 서버에 새 키를 적용한 뒤 이전 키를 폐기할 수 있는가?

사용자 비활성화가 API Key 폐기까지 대신한다고 가정하지 않습니다. 키를 폐기하면 해당 키를 사용하는 연동이 중단되므로, 계속 운영할 시스템은 인수인계와 키 교체 순서를 함께 정합니다.

외부 시스템에 사용자별 문서 접근 제어를 적용하는 방법은 RAGO-X API 활용 가이드에서 이어서 볼 수 있습니다.

문서함이 보이지 않을 때 확인하는 순서

정상적으로 초대를 마쳤는데도 문서함을 찾을 수 없다면, 설정을 넓히기 전에 연결 관계부터 확인합니다.

1. 사용자 등록과 상태: 초대가 완료되었고 사용자가 활성 상태인가?
2. 조직 역할: 일반 사용자 기준으로 확인하고 있는가?
3. 그룹 소속: 해당 사용자가 필요한 그룹에 실제로 추가되어 있는가?
4. 그룹 활성 상태: 그룹이 비활성화되어 있지 않은가?
5. 문서함 연결: 올바른 공간·문서함을 선택해 그 그룹을 지정했는가?
6. 저장과 재확인: 접근 그룹 저장을 완료하고 사용자 화면을 다시 확인했는가?

반대로 예상보다 많은 문서함이 보이면 소유자·관리자 역할 여부와 다른 활성 그룹 소속을 먼저 확인합니다. 문제를 해결하려고 곧바로 관리자 역할을 부여하면 원래 의도보다 넓은 권한을 줄 수 있습니다.

문서함 접근 설정이 맞더라도 질문 처리에는 문서 준비 상태나 크레딧 등 다른 조건이 관련될 수 있습니다. 문서함이 보이는 문제와 답변 생성 실패를 구분해서 확인하세요.

운영 기준을 한 장으로 남겨두세요

처음에는 아래와 같은 간단한 표만 있어도 담당자가 바뀔 때 설정을 이해하는 데 도움이 됩니다.

사용자 관리와 접근 제어의 목표는 필요한 사람이 필요한 지식을 이용하게 하는 것입니다. 일반 사용자를 초대하고, 업무에 맞는 그룹에 추가하고, 문서함과 연결한 뒤 실제 사용자 관점에서 확인하는 흐름을 기본으로 삼으면 운영 기준을 유지하기 쉬워집니다.

RAGO-X 제품 개요와 보안 안내에서 기능 범위를 확인할 수 있습니다. 문서함과 답변 생성 흐름은 RAGO-X 아키텍처, 이용 환경별 설정 문의는 고객지원을 참고하세요.