사용자 목록(userlist) 가이드
프로젝트(CSN)에 소속된 사용자를 조회하고, 새 사용자를 초대하며, 멤버의 권한을 변경하거나 프로젝트에서 제거하는 방법을 안내합니다.
📋 개요
사용자 목록은 현재 선택된 프로젝트(CSN)에 속한 멤버를 관리하는 화면입니다. 프로젝트 상단의 프로젝트 선택기에서 CSN을 고른 뒤 이 페이지에 접속하면, 해당 프로젝트의 멤버 목록과 각자의 권한(Member/Owner)을 확인할 수 있습니다.
🔍 주요 기능
1. 프로젝트 멤버 목록 조회
- 상단에서 선택한 프로젝트(CSN)에 속한 모든 사용자를 표로 보여줍니다.
- 표에는 로그인ID, 이름, 이메일, 가입일, 결제 여부, 권한(
uPerCorp: 1=Member, 49=Owner) 등이 표시됩니다. - 프로젝트가 선택되지 않았거나 해당 프로젝트의 멤버가 아니면 목록이 비어 있습니다.
2. 사용자 초대
- [초대] 버튼을 눌러 이메일 주소를 입력하면, 해당 사용자를 프로젝트 멤버로 추가하는 요청과 함께 초대 메일이 발송됩니다.
- 새로 초대된 멤버의 권한은 항상 Member(1)로 시작합니다. Owner 권한이 필요하면 초대 후 별도로 [권한 편집]으로 변경해야 합니다.
- ⚠️ 초대 대상이 아직 GIIP 계정이 없는 경우: 초대 메일은 발송되지만 실제 프로젝트 멤버 매핑은 되지 않습니다. 대상자가 GIIP에 가입한 뒤, 다시 [초대] 버튼으로 같은 이메일을 초대해야 목록에 나타납니다.
3. 권한 편집 (Owner 전용)
- 목록의 각 사용자 권한 옆 [권한 편집] 버튼으로 Member(1) ↔ Owner(49)를 전환할 수 있습니다.
- 이 기능은 프로젝트 Owner만 사용할 수 있으며, 자기 자신의 권한은 변경할 수 없습니다(실수로 자신의 권한을 낮추는 사고 방지).
- Owner가 아닌 계정으로 시도하면 요청이 거부됩니다.
4. 멤버 제거
- 각 행의 [권한 삭제] 버튼으로 해당 사용자를 프로젝트에서 제외할 수 있으며, 확인 창이 표시됩니다.
- 제거된 사용자는 즉시 해당 프로젝트의 모든 인프라 자산 접근 권한을 잃습니다. 이 작업은 되돌릴 수 없으므로 신중히 진행하세요.
🛠️ 사용 방법
- 상단 프로젝트 선택기에서 관리할 프로젝트(CSN)를 선택합니다.
사용자 목록메뉴로 이동하면 목록이 자동으로 조회됩니다.- 신규 멤버 추가는 [초대] 버튼 → 이메일 입력 → [전송].
- 권한 변경은 대상 행의 [권한 편집] → Member/Owner 선택 → [저장].
- 멤버 제거는 대상 행의 [권한 삭제] → 확인.
💡 활용 팁
- 여러 명을 한 번에 Owner로 승격하지 말고, 실제로 프로젝트 설정·삭제 권한이 필요한 인원에게만 부여하세요.
- 초대 후 목록에 사용자가 보이지 않으면 먼저 상대방의 GIIP 계정 존재 여부를 확인하세요(가입 전이면 매핑되지 않습니다).
API 참조
이 기능의 API 상세 사양은 별도 가이드를 참조하세요.
🔧 문제 해결
| 증상 | 원인 | 해결 |
|---|---|---|
| 사용자 목록이 비어 있음 | 프로젝트(CSN)가 선택되지 않았거나, 현재 계정이 해당 프로젝트 멤버가 아님 | 상단에서 올바른 프로젝트를 선택했는지 확인합니다 |
| 초대 메일은 왔는데 목록에 안 보임 | 초대 대상이 아직 GIIP 계정을 만들지 않아 멤버 매핑이 실패함 | 대상자가 가입을 완료한 뒤 동일 이메일로 다시 초대합니다 |
| [권한 편집]으로 저장했는데 실패 메시지가 뜸 | 현재 로그인 계정이 해당 프로젝트의 Owner(49)가 아니거나, 자기 자신의 권한을 바꾸려 함 | Owner 계정으로 로그인해서 다른 멤버를 대상으로 변경합니다 |
| [권한 삭제] 후에도 목록에서 사라지지 않음 | 네트워크 지연 등으로 새로고침이 늦게 반영됨 | [새로고침] 버튼을 눌러 최신 목록을 다시 조회합니다 |
버전: 1.0
최종 업데이트: 2026-07-26
소스 파일: giipv3/public/help/userlist.ko.md
관련 문서: