본문으로 건너뛰기

사용자/권한 관리 시나리오

KIWI에서 사용자 초대, 역할 관리, 권한 설정을 하는 방법을 안내합니다.

권한 체계​

권한 코드접근 가능 페이지설명
device[장비 관리]서버/장비 관리
infra[인프라 관리], [런타임 환경]K8s/Docker 환경 관리
service[서비스 관리]서비스 빌드/배포
backup[백업 관리]백업/복구
database[데이터베이스 관리]DB 관리
audit[감사 로그]로그 조회
vpn[VPN 관리]VPN 설정
user[사용자 관리], [권한 관리]사용자/권한 관리

시나리오 1: 새 사용자 초대하기​

Q. 팀원을 KIWI에 초대하고 싶습니다​

필요 권한: user 권한 또는 Manager 이상 역할

단계별 안내:

Step 1: 사용자 관리 페이지 이동​

  • 이동 경로: [사용자 관리]
  • UI 요소: 좌측 메뉴에서 "사용자 관리" 클릭

Step 2: 사용자 초대 시작​

  • UI 요소: 사용자초대버튼 - 우측 상단 "사용자 초대" 버튼 클릭
  • 동작: 초대 모달이 열립니다

Step 3: 초대 정보 입력​

  • 입력 항목:
    항목설명필수
    이메일초대할 사용자 이메일O
    이름사용자 표시 이름O
    역할기본 역할 선택O
    기관소속 기관 (해당 시)-

Step 4: 역할 선택​

  • 역할 옵션:
    역할설명기본 권한
    Viewer조회만 가능읽기 전용
    Developer개발 업무 수행service, device
    Operator운영 업무 수행infra, backup, database
    Manager관리 업무 수행전체 권한
    Admin시스템 관리자최고 관리자

Step 5: 초대 발송​

  • UI 요소: "초대 발송" 버튼 클릭
  • 결과: 초대 이메일이 발송됩니다

Step 6: 초대 상태 확인​

  • UI 요소: 초대목록테이블 - 초대 상태 확인
  • 상태:
    상태의미
    대기 중초대 수락 대기
    수락됨초대 완료
    만료됨초대 기간 경과

시나리오 2: 사용자 권한 변경하기​

Q. 특정 사용자의 권한을 변경하고 싶습니다​

필요 권한: user 권한 또는 Manager 이상 역할

단계별 안내:

Step 1: 권한 관리 페이지 이동​

  • 이동 경로: [권한 관리]
  • UI 요소: 좌측 메뉴에서 "권한 관리" 클릭

Step 2: 사용자 선택​

  • UI 요소: 사용자목록테이블 - 권한을 변경할 사용자 클릭

Step 3: 권한 설정 모달 열기​

  • UI 요소: 권한설정버튼 - "권한 설정" 버튼 클릭

Step 4: 권한 체크박스 설정​

  • UI 요소: 권한체크박스 - 필요한 권한 선택/해제
  • 권한 목록:
    권한설명
    device장비 관리 접근
    infra인프라 관리 접근
    service서비스 관리 접근
    backup백업 관리 접근
    database데이터베이스 관리 접근
    audit감사 로그 접근
    vpnVPN 관리 접근
    user사용자/권한 관리 접근

Step 5: 저장​

  • UI 요소: "저장" 버튼 클릭
  • 확인: 권한 변경 완료 메시지

시나리오 3: 역할 관리하기​

Q. 새로운 역할을 생성하거나 기존 역할을 수정하고 싶습니다​

필요 권한: Admin 역할

단계별 안내:

Step 1: 권한 관리 페이지 이동​

  • 이동 경로: [권한 관리]

Step 2: 역할 관리 탭 선택​

  • UI 요소: 역할관리탭 - "역할 관리" 탭 클릭

Step 3: 새 역할 생성 (또는 기존 역할 편집)​

  • UI 요소: 역할추가버튼 - "역할 추가" 버튼 클릭
  • 또는: 기존 역할 클릭하여 편집

Step 4: 역할 정보 입력​

  • 입력 항목:
    항목설명
    역할 이름역할 식별 이름
    설명역할 설명
    기본 권한역할에 포함될 기본 권한

Step 5: 기본 권한 설정​

  • 동작: 이 역할에 기본으로 포함될 권한 선택
  • 참고: 사용자별로 추가 권한 부여 가능

Step 6: 저장​

  • UI 요소: "저장" 버튼 클릭

시나리오 4: 기관별 사용자 관리​

Q. 여러 기관의 사용자를 분리하여 관리하고 싶습니다​

단계별 안내:

Step 1: 기관 관리 페이지 이동​

  • 이동 경로: [기관 관리]
  • UI 요소: 좌측 메뉴에서 "기관 관리" 클릭

Step 2: 기관 등록​

  • UI 요소: 기관등록버튼 - "기관 등록" 버튼 클릭
  • 입력 항목:
    항목설명
    기관명기관 이름
    기관 코드고유 식별 코드
    설명기관 설명

Step 3: 기관에 사용자 할당​

  • 이동 경로: [사용자 관리]
  • 동작: 사용자 편집에서 소속 기관 선택

Step 4: 기관별 리소스 접근 제한 (선택사항)​

  • 설정: 기관별로 접근 가능한 클러스터/서비스 제한

시나리오 5: 사용자 비활성화/삭제​

Q. 퇴사자 계정을 비활성화하고 싶습니다​

필요 권한: user 권한 또는 Manager 이상 역할

단계별 안내:

Step 1: 사용자 관리 페이지 이동​

  • 이동 경로: [사용자 관리]

Step 2: 사용자 선택​

  • UI 요소: 사용자목록테이블 - 비활성화할 사용자 선택

Step 3: 비활성화 또는 삭제 선택​

  • 옵션:
    동작설명복구 가능
    비활성화로그인 차단, 데이터 유지O
    삭제계정 완전 삭제X

Step 4: 비활성화 실행​

  • UI 요소: 비활성화버튼 - "비활성화" 버튼 클릭
  • 확인: 확인 대화상자에서 "확인" 클릭

Step 5: 상태 확인​

  • 확인: 사용자 상태가 "비활성"으로 변경됨

시나리오 6: 내 프로필 및 비밀번호 변경​

Q. 내 계정 정보를 수정하고 싶습니다​

단계별 안내:

Step 1: 프로필 페이지 이동​

  • 이동 경로: 우측 상단 프로필 아이콘 → "내 정보"

Step 2: 프로필 정보 수정​

  • 수정 가능 항목:
    항목설명
    이름표시 이름
    연락처전화번호
    프로필 이미지프로필 사진

Step 3: 비밀번호 변경​

  • UI 요소: 비밀번호변경버튼 - "비밀번호 변경" 버튼 클릭
  • 입력 항목:
    항목설명
    현재 비밀번호기존 비밀번호
    새 비밀번호변경할 비밀번호
    비밀번호 확인새 비밀번호 재입력

Step 4: 저장​

  • UI 요소: "저장" 버튼 클릭
  • 확인: 변경 완료 메시지

관련 질문​

자주 묻는 질문​

질문답변관련 페이지
초대 이메일이 오지 않습니다스팸 폴더 확인 또는 관리자에게 재발송 요청[사용자 관리]
권한이 부족합니다 메시지가 나옵니다관리자에게 필요한 권한 요청[권한 관리]
비밀번호를 잊어버렸습니다로그인 페이지에서 "비밀번호 찾기" 사용로그인 페이지
계정이 잠겼습니다관리자에게 계정 잠금 해제 요청[사용자 관리]

다음 단계​

사용자/권한 설정이 완료되면 다음 작업을 진행하세요:

  • 팀원에게 KIWI 사용법 안내
  • 각 팀원의 역할에 맞는 권한 검토
  • 정기적인 권한 감사 실시