---
title: "사용자 조회 및 편집"
description: "워크스페이스 사용자 목록에서 검색과 필터로 수정할 대상을 찾습니다. 사용자 상세 화면에서 프로필과 역할을 변경하고 비밀번호를 재설정하세요. 수정한 계정 정보가 화면에 어떻게 표시되는지, 역할 변경 후 실제 서버 접근 범위에 어떤 영향이 있는지도 함께 확인할 수 있습니다."
---

> Full documentation index: https://docs.alpacax.com/llms.ko.txt

# 사용자 조회 및 편집

워크스페이스의 모든 사용자를 조회하고 정보를 편집합니다.

## 사용자 목록 조회

### 접근 방법

1. 좌측 사이드바에서 **IAM** > **Users** 클릭
2. 등록된 모든 사용자가 표시됩니다.

### 표시 정보

각 사용자에 대해 다음 정보가 표시됩니다.

- 이름
- 이메일 주소
- 역할 (User/Staff/Superuser)
- 계정 상태 (Active/Inactive)

## 사용자 검색

상단 검색창으로 사용자를 빠르게 찾습니다.

**검색 가능 항목:**

- 이름
- 이메일 주소
- 유저명

## 사용자 필터링

**필터** 버튼을 눌러 조건별로 필터링합니다.

- **역할**: User, Staff, Superuser
- **상태**: Active, Inactive

## 사용자 상세 정보

### 상세 페이지 열기

1. 사용자 목록에서 사용자 이름 클릭
2. 사용자 상세 페이지로 이동

### 개요 탭

**기본 정보:**

- 유저명 (변경 불가)
- 이메일
- 전화번호
- 설명
- UID (시스템 할당)
- 쉘 (기본값)
- 홈 디렉터리
- 역할

**활동 개요:**

- 가입일
- 마지막 활동
- Websh 세션 사용량
- WebFTP 파일 전송량

**그룹 멤버십:**

- 소속 그룹 목록

### 활동 탭

이 탭은 사용자 본인과 Staff/Superuser만 볼 수 있습니다.

사용자의 활동 기록을 시간순으로 확인합니다.

- 시간
- IP 주소
- 작업 (로그인, 서버 접근, 설정 변경 등)
- 결과 (HTTP 상태 코드)
- 세부 정보

### 역할 탭

이 사용자에게 할당된 역할이 표시됩니다. 각 항목에는 역할 이름, 범위 정보(범위가 제한된 경우 리소스 유형과 오브젝트 ID), 특정 리소스로 제한되었는지 여부가 나타납니다.

**역할 할당:**

1. **역할 할당** 클릭
2. 드롭다운에서 **역할** 선택
3. 필요하면 범위를 설정해 역할을 특정 리소스로 제한
4. 저장

**역할 할당 제거:**

할당 항목을 선택하고 **할당 제거**를 클릭합니다.

Superuser의 `admin` 역할은 따로 제거할 수 없습니다. `superuser` 역할을 먼저 제거하세요.

기본 제공 역할은 자동으로 할당되며 이 탭에서는 제거할 수 없습니다.

## 사용자 정보 편집

**필수 권한:** Staff 또는 Superuser

### 정보 수정

1. 사용자 상세 페이지에서 **업데이트** 버튼 클릭
2. Quick View 패널에서 수정:

   - 이름, 성
   - 전화번호
   - 권한(역할)

3. **저장** 클릭

### 역할 변경

역할을 변경할 때 유의할 점입니다.

**User → Staff/Superuser:**

- 관리 권한이 부여됩니다.
- 신중하게 결정하세요.

**Staff/Superuser → User:**

- 관리 권한이 제거됩니다.
- 접근할 수 있는 서버가 줄어듭니다.
- 역할 탭에서 바꿀 때는 `superuser` 역할을 먼저 제거하세요. Superuser의 `admin` 역할은 따로 제거할 수 없습니다.

**⚠️ Superuser 역할:**

- 워크스페이스를 삭제할 수 있습니다.
- 모든 설정을 변경할 수 있습니다.
- 매우 신중하게 부여하세요.

사용자를 Staff로 설정하면 RBAC `admin` 역할이, Superuser로 설정하면 `superuser` 역할이 자동으로 할당됩니다.

## 비밀번호 재설정

### Alpacon Cloud

비밀번호는 사용자 본인만 변경할 수 있습니다.

1. 왼쪽 사이드바 맨 아래의 계정 카드 클릭
2. **설정** → **보안 설정** 선택 후 **비밀번호**로 이동

### Self-hosted

관리자가 사용자 비밀번호를 재설정할 수 있습니다.

1. 사용자 상세 페이지에서 **비밀번호 초기화** 클릭
2. 현재 비밀번호 입력 (필요한 경우)
3. 새 비밀번호 설정

## 사용자 역할별 권한

| 역할      | 권한                                 |
| --------- | ------------------------------------ |
| User      | 할당된 서버 접근, 자신의 프로필 수정 |
| Staff     | 사용자·그룹 관리, 일부 설정 접근     |
| Superuser | 모든 권한, 워크스페이스 전체 제어    |

## 관련 문서

- [사용자 추가하기](/use/iam/users/add/)
- [사용자 제거하기](/use/iam/users/remove/)
- [그룹에 사용자 할당](/use/iam/groups/assign-users/)
- [권한 설정](/use/workspace/settings/roles/)
- [역할 관리](/use/workspace/settings/roles/)

Source: https://docs.alpacax.com/ko/use/iam/users/manage/