사용자 목록(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. 멤버 제거

• 각 행의 [권한 삭제] 버튼으로 해당 사용자를 프로젝트에서 제외할 수 있으며, 확인 창이 표시됩니다.
• 제거된 사용자는 즉시 해당 프로젝트의 모든 인프라 자산 접근 권한을 잃습니다. 이 작업은 되돌릴 수 없으므로 신중히 진행하세요.

🛠️ 사용 방법

1. 상단 프로젝트 선택기에서 관리할 프로젝트(CSN)를 선택합니다.
2. 사용자 목록 메뉴로 이동하면 목록이 자동으로 조회됩니다.
3. 신규 멤버 추가는 [초대] 버튼 → 이메일 입력 → [전송].
4. 권한 변경은 대상 행의 [권한 편집] → Member/Owner 선택 → [저장].
5. 멤버 제거는 대상 행의 [권한 삭제] → 확인.

💡 활용 팁

• 여러 명을 한 번에 Owner로 승격하지 말고, 실제로 프로젝트 설정·삭제 권한이 필요한 인원에게만 부여하세요.
• 초대 후 목록에 사용자가 보이지 않으면 먼저 상대방의 GIIP 계정 존재 여부를 확인하세요(가입 전이면 매핑되지 않습니다).

API 참조

이 기능의 API 상세 사양은 별도 가이드를 참조하세요.

📘 프로젝트/사용자 관리 API 가이드

🔧 문제 해결

증상	원인	해결
사용자 목록이 비어 있음	프로젝트(CSN)가 선택되지 않았거나, 현재 계정이 해당 프로젝트 멤버가 아님	상단에서 올바른 프로젝트를 선택했는지 확인합니다
초대 메일은 왔는데 목록에 안 보임	초대 대상이 아직 GIIP 계정을 만들지 않아 멤버 매핑이 실패함	대상자가 가입을 완료한 뒤 동일 이메일로 다시 초대합니다
[권한 편집]으로 저장했는데 실패 메시지가 뜸	현재 로그인 계정이 해당 프로젝트의 Owner(49)가 아니거나, 자기 자신의 권한을 바꾸려 함	Owner 계정으로 로그인해서 다른 멤버를 대상으로 변경합니다
[권한 삭제] 후에도 목록에서 사라지지 않음	네트워크 지연 등으로 새로고침이 늦게 반영됨	[새로고침] 버튼을 눌러 최신 목록을 다시 조회합니다

---

버전: 1.0 최종 업데이트: 2026-07-26 소스 파일: giipv3/public/help/userlist.ko.md

---

관련 문서:

• 프로젝트/사용자 관리 API 가이드
• 프로젝트 목록 가이드