🔑 Roles

Open WebUI는 다음의 세 가지 주요 사용자 역할을 포함하는 구조화된 역할 기반 접근 제어 시스템을 구현합니다:

역할	설명	기본 생성
관리자	전체 통제 권한을 가진 시스템 관리자	첫 번째 사용자 계정
일반 사용자	제한된 권한을 가진 표준 사용자	이후 승인된 사용자들
대기중	관리자의 승인 대기 중인 미승인 사용자	신규 등록 (구성 가능)

역할 부여

• 첫 번째 사용자: 새 Open WebUI 인스턴스에서 생성된 첫 번째 계정은 자동으로 관리자 권한을 받습니다. 특권을 받습니다.
• 후속 사용자들: 신규 사용자 등록 시 DEFAULT_USER_ROLE 구성에 따라 기본 역할이 할당됩니다.

신규 등록의 기본 역할은 DEFAULT_USER_ROLE 환경 변수를 사용하여 구성할 수 있습니다:

DEFAULT_USER_ROLE=pending  # 선택지: pending, user, admin

"pending"으로 설정하면 신규 사용자는 시스템에 접근하기 전에 관리자의 승인이 필요합니다.

사용자 그룹

관리자는 그룹을 통해:

• 복수의 사용자에게 한꺼번에 권한을 부여하여 접근 관리를 단순화
• 특정 자원(모델, 도구 등)의 접근을 "비공개"로 설정한 뒤 특정 그룹에게 접근 권한 부여
• 자원에 대한 그룹 접근은 "읽기" 또는 "쓰기"로 설정 가능

그룹 구조

Open WebUI의 각 그룹은 다음을 포함합니다:

• 고유 식별자
• 이름 및 설명
• 소유자/생성자 참조
• 멤버 사용자 ID 목록
• 권한 구성
• 추가 메타데이터

그룹 관리

그룹은 다음과 같은 방법으로 관리될 수 있습니다:

• 관리자가 직접 생성 (사용자 인터페이스를 통해)
• OAuth 제공자로부터 자동 동기화 (ENABLE_OAUTH_GROUP_MANAGEMENT 활성화 시)
• OAuth 클레임으로부터 자동 생성 (ENABLE_OAUTH_GROUP_MANAGEMENT 및 ENABLE_OAUTH_GROUP_CREATION 모두 활성화 시)

OAuth 그룹 통합

OAuth 그룹 관리를 활성화하면 사용자 그룹 멤버십이 OAuth 클레임에서 받은 그룹과 동기화됩니다:

• OAuth 클레임과 일치하는 Open WebUI 그룹에 사용자가 추가됩니다
• OAuth 클레임에 포함되지 않은 그룹에서 사용자가 제거됩니다
• ENABLE_OAUTH_GROUP_CREATION이 활성화된 경우 Open WebUI에 존재하지 않는 OAuth 클레임의 그룹이 자동으로 생성됩니다