> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wandb.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# 레지스트리 액세스 구성
> 사용자와 팀을 관리하고, 역할을 할당하고, 역할 기반 권한을 설정하여 W&B 레지스트리 액세스를 구성합니다.
레지스트리 관리자는 레지스트리의 Settings를 구성하여 [레지스트리 역할 설정](/ko/models/registry/configure_registry/#configure-registry-roles), [사용자 추가](/ko/models/registry/configure_registry/#add-a-user-or-a-team-to-a-registry), 또는 [사용자 제거](/ko/models/registry/configure_registry/#remove-a-user-or-team-from-a-registry)를 수행할 수 있습니다.
## Users 관리
### 사용자 또는 팀 추가
레지스트리 관리자는 개별 사용자 또는 전체 팀을 레지스트리에 추가할 수 있습니다. 레지스트리에 사용자 또는 팀을 추가하려면 다음과 같이 하세요.
1. W\&B Registry로 이동합니다.
2. 사용자 또는 팀을 추가할 레지스트리를 선택합니다.
3. 오른쪽 상단의 톱니바퀴 아이콘을 클릭해 레지스트리 설정을 엽니다.
4. **레지스트리 액세스** 섹션에서 **Add access**를 클릭합니다.
5. **Include users and teams** 필드에 하나 이상의 사용자 이름, 이메일 또는 팀 이름을 입력합니다.
6. **Add access**를 클릭합니다.
[레지스트리에서 사용자 역할 구성](/ko/models/registry/configure_registry/#configure-registry-roles) 또는 [레지스트리 역할 권한](/ko/models/registry/configure_registry#role-permissions)에 대해 자세히 알아보세요.
### 사용자 또는 팀 제거
레지스트리 관리자는 레지스트리에서 개별 사용자 또는 전체 팀을 제거할 수 있습니다. 레지스트리에서 사용자 또는 팀을 제거하려면 다음 단계를 따르세요.
1. [https://wandb.ai/registry/](https://wandb.ai/registry/)의 W\&B Registry로 이동합니다.
2. 사용자를 제거할 레지스트리를 선택합니다.
3. 오른쪽 상단의 톱니바퀴 아이콘을 클릭해 레지스트리 설정에 들어갑니다.
4. **레지스트리 액세스** 섹션으로 이동한 다음, 제거할 사용자 이름, 이메일 또는 팀을 입력합니다.
5. **Delete** 버튼을 클릭합니다.
팀에서 사용자를 제거하면 해당 사용자의 레지스트리 접근 권한도 함께 제거됩니다.
### 레지스트리 소유자 변경
레지스트리 관리자는 **Restricted Viewer** 또는 **Viewer**를 포함해 모든 멤버를 레지스트리 소유자로 지정할 수 있습니다. 레지스트리 소유권은 주로 책임 소재를 명확히 하기 위한 것이며, 사용자에게 할당된 역할로 이미 부여된 권한 외에 추가 권한을 제공하지는 않습니다.
소유자를 변경하려면:
1. [https://wandb.ai/registry/](https://wandb.ai/registry/) 의 W\&B Registry로 이동합니다.
2. 설정할 레지스트리를 선택합니다.
3. 오른쪽 상단에 있는 톱니바퀴 아이콘을 클릭합니다.
4. **Registry members and roles** 섹션까지 스크롤합니다.
5. 멤버의 행 위에 마우스를 올립니다.
6. 행 끝에 있는 **액션 ()** 메뉴를 클릭한 다음 **Make owner**를 클릭합니다.
## 레지스트리 역할 설정
이 섹션에서는 레지스트리 멤버의 역할을 설정하는 방법을 설명합니다. 각 역할의 기능, 우선순위, 기본값 등을 포함한 레지스트리 역할에 대한 자세한 내용은 [레지스트리 역할 상세 정보](#details-about-registry-roles)을 참조하세요.
1. [https://wandb.ai/registry/](https://wandb.ai/registry/)의 W\&B Registry로 이동합니다.
2. 설정하려는 레지스트리를 선택합니다.
3. 오른쪽 상단에 있는 톱니바퀴 아이콘을 클릭합니다.
4. **Registry members and roles** 섹션으로 스크롤합니다.
5. **Member** 필드에서 권한을 수정하려는 사용자 또는 팀을 검색합니다.
6. **Registry role** 열에서 사용자의 역할을 클릭합니다.
7. 드롭다운에서 사용자에게 할당할 역할을 선택합니다.
## 레지스트리 역할 상세 정보
다음 섹션에서는 레지스트리 역할에 대해 더 자세히 설명합니다.
[팀에서의 역할](/ko/platform/app/settings-page/teams/#team-roles-and-permissions)은 어떤 레지스트리에서든 맡은 역할과는 무관하며, 아무런 영향도 주지 않습니다.
### 기본 역할
W\&B는 사용자 또는 팀이 레지스트리에 추가되면 기본 **레지스트리 역할**을 자동으로 할당합니다. 이 역할은 해당 레지스트리에서 수행할 수 있는 작업을 결정합니다.
| 대상 | 기본 레지스트리 역할
(Dedicated Cloud / Self-Managed) | 기본 레지스트리 역할
(Multi-tenant Cloud) |
| --------------------- | -------------------------------------------------------------------- | ---------------------------------------------------------- |
| 팀 | Restricted Viewer (Server v0.75.0+)
Viewer (Server v0.74.x 이하) | Restricted Viewer |
| 사용자 또는 서비스 계정(관리자 아님) | Restricted Viewer (Server v0.75.0+)
Viewer (Server v0.74.x 이하) | Restricted Viewer |
| 서비스 계정(관리자 아님) | Member1 | Member1 |
| 조직 관리자 | Admin | Admin |
: 서비스 계정에는 **Viewer** 또는 **Restricted Viewer** 역할을 부여할 수 없습니다. 서비스 계정의 액세스가 어떻게 결정되는지는 [Service account access](#service-account-access)를 참조하세요.
레지스트리 관리자는 레지스트리의 사용자와 팀에 대한 역할을 할당하거나 수정할 수 있습니다.
자세한 내용은 [레지스트리에서 사용자 역할 구성](/ko/models/registry/configure_registry/#configure-registry-roles)을 참조하세요.
### 역할 권한
다음 표에는 각 레지스트리 역할과 역할별로 제공되는 권한이 나와 있습니다:
| 권한 | 권한 그룹 | Restricted Viewer
(Multi-tenant Cloud, 초대 전용) | Viewer | Member | Admin |
| ------------------------------------------------------------------------------ | ------ | -------------------------------------------------- | :----: | :----: | :---: |
| collection 세부 정보 보기 | 조회 | ✓ | ✓ | ✓ | ✓ |
| 연결된 artifact 세부 정보 보기 | 조회 | ✓ | ✓ | ✓ | ✓ |
| 사용: `use_artifact`로 레지스트리에서 artifact 사용 | 조회 | | ✓ | ✓ | ✓ |
| 연결된 artifact 다운로드 | 조회 | | ✓ | ✓ | ✓ |
| artifact 파일 뷰어에서 파일 다운로드 | 조회 | | ✓ | ✓ | ✓ |
| 레지스트리 검색 | 조회 | ✓ | ✓ | ✓ | ✓ |
| 레지스트리 설정 및 사용자 목록 보기 | 조회 | ✓ | ✓ | ✓ | ✓ |
| collection에 대한 새 자동화 생성 | Create | | | ✓ | ✓ |
| 새 버전이 추가될 때 Slack 알림 켜기 | Create | | | ✓ | ✓ |
| 새 collection 생성 | Create | | | ✓ | ✓ |
| 새 레지스트리 생성 | Create | | | ✓ | ✓ |
| collection 카드 편집(설명) | Update | | | ✓ | ✓ |
| 연결된 artifact 설명 편집 | Update | | | ✓ | ✓ |
| collection 태그 추가 또는 삭제 | Update | | | ✓ | ✓ |
| 연결된 artifact의 별칭 추가 또는 삭제 | Update | | | ✓ | ✓ |
| 연결된 artifact에 [보호된 별칭](/ko/models/registry/aliases#protected-aliases) 추가 또는 삭제 | Update | | | | ✓ |
| [보호된 별칭](/ko/models/registry/aliases#protected-aliases) 생성 또는 삭제 | Update | | | | ✓ |
| 새 artifact 연결 | Update | | | ✓ | ✓ |
| 레지스트리의 허용된 유형 목록 편집 | Update | | | ✓ | ✓ |
| 레지스트리 이름 편집 | Update | | | ✓ | ✓ |
| collection 삭제 | Delete | | | ✓ | ✓ |
| 자동화 삭제 | Delete | | | ✓ | ✓ |
| 레지스트리에서 artifact 연결 해제 | Delete | | | ✓ | ✓ |
| 레지스트리의 허용되는 artifact 유형 편집 | Admin | | | | ✓ |
| 레지스트리 공개 범위 변경(Organization 또는 Restricted) | Admin | | | | ✓ |
| 레지스트리에 사용자 추가 | Admin | | | | ✓ |
| 레지스트리에서 사용자 역할 할당 또는 변경 | Admin | | | | ✓ |
### 상속된 레지스트리 역할
레지스트리의 멤버십 목록에는 각 사용자의 상속된(유효) 레지스트리 역할이 해당 행의 역할 드롭다운 옆에 연한 회색으로 표시됩니다.
특정 레지스트리에서 사용자의 유효 역할은 상속 여부나 명시적 할당 여부와 관계없이, 조직에서의 역할, 레지스트리에서의 역할, 그리고 해당 레지스트리를 소유한 팀에서의 역할 중 *가장 높은* 역할과 일치합니다. 예를 들어 다음과 같습니다.
* 팀 **Admin** 또는 조직 **Admin**이 팀가 소유한 특정 레지스트리에서 **Viewer** 역할을 가지고 있으면, 해당 사용자의 실제 레지스트리 역할은 **Admin**입니다.
* 레지스트리 **Viewer**가 팀에서 **Member** 역할을 가지고 있으면, 해당 사용자의 실제 레지스트리 역할은 **Member**입니다.
* 팀 **Viewer**가 특정 레지스트리에서 **Member** 역할을 가지고 있으면, 해당 사용자의 실제 레지스트리 역할은 **Member**입니다.
### Restricted Viewer 역할 세부 정보
**Restricted Viewer** 역할은 Generally Available(GA) 상태입니다. Dedicated Cloud 및 Self-Managed에서는 Server v0.75.0 이상이 필요합니다.
이 역할은 컬렉션, 자동화 또는 기타 레지스트리 리소스를 생성, 업데이트 또는 삭제할 수 없으며, 레지스트리 artifact에 대한 읽기 전용 액세스만 제공합니다.
**Viewer**와 달리 **Restricted Viewer**는 다음과 같습니다.
* artifact 파일을 다운로드하거나 파일 내용에 액세스할 수 없습니다.
* W\&B SDK에서 `wandb.Run.use_artifact()`로 artifact를 사용할 수 없습니다.
#### SDK 호환성
**SDK 버전 요구 사항**
**Restricted Viewer** 권한으로 W\&B SDK를 사용해 artifact에 액세스하려면 W\&B SDK 버전 0.19.9 이상을 사용해야 합니다. 그렇지 않으면 일부 SDK 명령어에서 권한 오류가 발생합니다.
**Restricted Viewer**가 SDK를 사용하면 일부 함수는 사용할 수 없거나 다르게 동작합니다.
다음 메서드는 사용할 수 없으며 권한 오류가 발생합니다:
* [`Run.use_artifact()`](/ko/models/ref/python/experiments/run/#method-runuse_artifact)
* [`Artifact.download()`](/ko/models/ref/python/experiments/artifact/#method-artifactdownload)
* [`Artifact.file()`](/ko/models/ref/python/experiments/artifact/#method-artifactfile)
* [`Artifact.files()`](/ko/models/ref/python/experiments/artifact/#method-artifactfiles)
다음 메서드는 artifact 메타데이터에만 사용할 수 있습니다:
* [`Artifact.get_entry()`](/ko/models/ref/python/experiments/artifact/#method-artifactget_entry)
* [`Artifact.get_path()`](/ko/models/ref/python/experiments/artifact/#method-artifactget_path)
* [`Artifact.get()`](/ko/models/ref/python/experiments/artifact/#method-artifactget)
* [`Artifact.verify()`](/ko/models/ref/python/experiments/artifact/#method-artifactverify)
### 레지스트리 간 권한
사용자는 레지스트리마다 서로 다른 역할을 가질 수 있습니다. 예를 들어, 레지스트리 A에서는 **Restricted Viewer**이고 레지스트리 B에서는 **Viewer**일 수 있습니다. 이 경우:
* 두 레지스트리에 모두 연결된 동일한 아티팩트는 서로 다른 액세스 수준을 가집니다
* 레지스트리 A에서 사용자는 **Restricted Viewer**이므로 파일을 다운로드하거나 아티팩트를 사용할 수 없습니다
* 레지스트리 B에서 사용자는 **Viewer**이므로 파일을 다운로드하고 아티팩트를 사용할 수 있습니다
* 즉, 액세스 권한은 아티팩트에 접근하는 레지스트리에 따라 달라집니다