🔐 그룹

그룹은 관리자에게 다음을 가능하게 합니다

• 여러 사용자에게 동시에 권한을 할당하여 액세스 관리를 단순화
• 특정 리소스(모델, 도구 등)에 대한 액세스를 "비공개"로 설정한 후 특정 그룹에 액세스를 허용하여 액세스 제한
• 그룹에 대해 리소스에 대한 액세스를 "읽기" 또는 "쓰기"로 지정(쓰기 권한은 읽기 권한을 포함함)

정보

권한 모델이 허용적임을 참고하세요. 사용자가 다른 권한을 정의하는 두 그룹의 구성원인 경우, 가장 허용적인 권한이 적용됩니다.

그룹 구조

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

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

그룹 관리

그룹은 다음과 같이 관리될 수 있습니다:

• 관리자가 사용자 인터페이스를 통해 수동으로 생성
• ENABLE_OAUTH_GROUP_MANAGEMENT가 활성화되었을 때 OAuth 공급자로부터 자동으로 동기화
• ENABLE_OAUTH_GROUP_MANAGEMENT 및 ENABLE_OAUTH_GROUP_CREATION이 모두 활성화되었을 때 OAuth 클레임에서 자동으로 생성

OAuth 그룹 통합

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

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

그룹 권한

그룹을 사용하여 사용자에게 권한의 세트를 제공할 수 있습니다. 예를 들어, "데이터 과학자" 그룹은 모든 모델, 지식 베이스 및 도구에 대한 읽기 및 쓰기 권한을 가질 수 있습니다.

그룹의 리소스 액세스 제어

Open WebUI는 모델, 지식 베이스, 프롬프트 및 도구와 같은 리소스에 대해 세밀한 액세스 제어를 구현합니다. 액세스는 사용자 및 그룹 수준에서 제어될 수 있습니다.

리소스의 액세스 제어를 활성화하려면 해당 액세스를 "비공개"로 설정한 후 특정 그룹에 액세스를 허용하세요.

액세스 제어 구조

지식 베이스와 같은 리소스는 사용자 및 그룹에 대한 읽기 및 쓰기 권한을 지정하는 액세스 제어 구조를 사용합니다:

{
  "read": {
    "group_ids": ["group_id1", "group_id2"],
    "user_ids": ["user_id1", "user_id2"]
  },
  "write": {
    "group_ids": ["group_id1", "group_id2"],
    "user_ids": ["user_id1", "user_id2"]
  }
}

이 구조는 특정 리소스를 누구나 볼 수 있고 수정할 수 있는지에 대해 정확한 제어를 가능하게 합니다.