> ## Documentation Index
> Fetch the complete documentation index at: https://wb-21fd5541-docs-1917.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> 가시성 범위와 프로젝트 수준 역할을 사용해 프로젝트 액세스를 관리합니다

# 프로젝트의 액세스 제어 관리

W\&B 프로젝트의 범위를 정의하여 누가 해당 프로젝트의 W\&B run을 보고, 편집하고, 제출할 수 있는지 제한합니다.

몇 가지 제어를 조합해 W\&B 팀 내 모든 프로젝트의 액세스 수준을 구성할 수 있습니다. **가시성 범위**는 더 상위 수준의 메커니즘입니다. 이를 사용해 어떤 사용자 그룹이 프로젝트에서 run을 보거나 제출할 수 있는지 제어합니다. 프로젝트의 가시성 범위가 *Team* 또는 \_Restricted\_인 경우, 이어서 **프로젝트 수준 역할**을 사용해 각 사용자가 프로젝트 내에서 갖는 액세스 수준을 제어할 수 있습니다.

<Note>
  프로젝트 소유자, 팀 관리자 또는 조직 관리자는 프로젝트의 가시성을 설정하거나 수정할 수 있습니다.
</Note>

<div id="visibility-scopes">
  ## 가시성 범위
</div>

선택할 수 있는 프로젝트 가시성 범위는 네 가지입니다. 가장 공개적인 범위부터 가장 비공개적인 범위 순으로 다음과 같습니다.

| 범위         | 설명                                                                              |
| ---------- | ------------------------------------------------------------------------------- |
| Open       | 프로젝트를 알고 있는 사람이라면 누구나 프로젝트를 볼 수 있고 run 또는 Reports를 제출할 수 있습니다.                  |
| Public     | 프로젝트를 알고 있는 사람이라면 누구나 프로젝트를 볼 수 있습니다. run 또는 Reports는 소속 팀만 제출할 수 있습니다.         |
| Team       | 상위 팀의 멤버만 프로젝트를 볼 수 있고 run 또는 Reports를 제출할 수 있습니다. 팀 외부 사용자는 프로젝트에 액세스할 수 없습니다. |
| Restricted | 상위 팀에서 초대된 멤버만 프로젝트를 볼 수 있고 run 또는 Reports를 제출할 수 있습니다.                         |

<Note>
  민감한 데이터나 기밀 데이터와 관련된 워크플로에서 협업하려면 프로젝트 범위를 **Restricted**로 설정하세요. 팀 내에서 Restricted 프로젝트를 만들면 관련 실험, artifact, Reports 등에 대해 협업할 수 있도록 해당 팀의 특정 멤버를 초대하거나 추가할 수 있습니다.

  다른 프로젝트 범위와 달리 Restricted 프로젝트에서는 팀의 모든 멤버에게 암묵적으로 액세스 권한이 부여되지 않습니다. 다만 필요한 경우 팀 관리자도 Restricted 프로젝트에 참여할 수 있습니다.
</Note>

<div id="set-visibility-scope-on-a-new-or-existing-project">
  ### 새 프로젝트 또는 기존 프로젝트의 가시성 범위 설정
</div>

프로젝트를 만들 때 또는 나중에 편집할 때 프로젝트의 가시성 범위를 설정할 수 있습니다.

<Note>
  * 프로젝트 소유자 또는 팀 관리자만 가시성 범위를 설정하거나 편집할 수 있습니다.
  * 팀 관리자가 팀의 개인정보 보호 설정에서 **Make all future team projects private (public sharing not allowed)** 를 활성화하면 해당 팀에서 **Open** 및 **Public** 프로젝트 가시성 범위를 사용할 수 없게 됩니다. 이 경우 팀은 **Team** 및 **Restricted** 범위만 사용할 수 있습니다.
</Note>

<div id="set-visibility-scope-when-you-create-a-new-project">
  #### 새 프로젝트를 만들 때 가시성 범위 설정
</div>

1. W\&B Multi-tenant Cloud, Dedicated Cloud 또는 Self-Managed 인스턴스의 W\&B 조직으로 이동합니다.

2. 왼쪽 사이드바의 **My projects** 섹션에서 **Create a new project** 버튼을 클릭합니다. 또는 팀의 **Projects** 탭으로 이동한 다음 오른쪽 상단의 **Create new project** 버튼을 클릭합니다.

3. 상위 팀을 선택하고 프로젝트 이름을 입력한 후 **Project Visibility** 드롭다운에서 원하는 범위를 선택합니다.

   <Frame>
     <img src="https://mintcdn.com/wb-21fd5541-docs-1917/pKzhFl-6PjFOaAdA/images/hosting/restricted_project_add_new.gif?s=fe10988f8f7e35461be69b2d2326048b" alt="제한된 프로젝트 생성" width="2116" height="1438" data-path="images/hosting/restricted_project_add_new.gif" />
   </Frame>

   **Restricted** 가시성을 선택한 경우에만 다음 step을 완료합니다.

4. **Invite team members** 필드에 W\&B 팀 구성원 한 명 이상의 이름을 입력합니다. 프로젝트 협업에 꼭 필요한 구성원만 추가합니다.

   <Frame>
     <img src="https://mintcdn.com/wb-21fd5541-docs-1917/pKzhFl-6PjFOaAdA/images/hosting/restricted_project_2.png?fit=max&auto=format&n=pKzhFl-6PjFOaAdA&q=85&s=b67b1ebbdf8b13372b4998ff7e32bb5b" alt="제한된 프로젝트 설정" width="2401" height="968" data-path="images/hosting/restricted_project_2.png" />
   </Frame>

   <Note>
     나중에 제한된 프로젝트의 **Users** 탭에서 구성원을 추가하거나 제거할 수 있습니다.
   </Note>

<div id="edit-visibility-scope-of-an-existing-project">
  #### 기존 프로젝트의 가시성 범위 편집
</div>

1. W\&B 프로젝트로 이동합니다.

2. 왼쪽 열의 **Overview** 탭을 선택합니다.

3. 오른쪽 상단의 **Edit Project Details** 버튼을 클릭합니다.

4. **Project Visibility** 드롭다운에서 원하는 범위를 선택합니다.

   <Frame>
     <img src="https://mintcdn.com/wb-21fd5541-docs-1917/pKzhFl-6PjFOaAdA/images/hosting/restricted_project_edit.gif?s=fff3815316a1026d7f671a8c9954ef22" alt="제한된 프로젝트 설정 편집" width="2130" height="1438" data-path="images/hosting/restricted_project_edit.gif" />
   </Frame>

   **Restricted** 가시성을 선택한 경우 다음 step을 완료합니다.

5. 프로젝트의 **Users** 탭으로 이동한 다음, **Add user** 버튼을 클릭해 특정 사용자를 제한된 프로젝트에 초대합니다.

<Warning>
  * 가시성 범위를 **Team**에서 **Restricted**로 변경하면, 프로젝트에 필요한 팀 구성원을 초대하지 않는 한 팀의 모든 구성원이 해당 프로젝트에 대한 액세스 권한을 잃습니다.
  * 가시성 범위를 **Restricted**에서 **Team**으로 변경하면 팀의 모든 구성원이 해당 프로젝트에 대한 액세스 권한을 얻게 됩니다.
  * 제한된 프로젝트의 사용자 목록에서 팀 구성원을 제거하면 해당 구성원은 그 프로젝트에 대한 액세스 권한을 잃습니다.
</Warning>

<div id="other-key-things-to-note-for-restricted-scope">
  ### 제한된 범위에서 추가로 알아둘 주요 사항
</div>

* 제한된 프로젝트에서 팀 수준 service account를 사용하려면 해당 service account를 해당 프로젝트에 명시적으로 초대하거나 추가해야 합니다. 그렇지 않으면 팀 수준 service account는 기본적으로 제한된 프로젝트에 접근할 수 없습니다.
* 제한된 프로젝트에서는 run을 이동할 수 없지만, 비제한 프로젝트의 run은 제한된 프로젝트로 이동할 수 있습니다.
* 팀 개인정보 보호 설정 **Make all future team projects private (public sharing not allowed)** 과 관계없이, 제한된 프로젝트의 가시성을 **Team** 범위로만 전환할 수 있습니다.
* 제한된 프로젝트의 소유자가 더 이상 상위 팀에 속해 있지 않다면, 프로젝트에서 원활한 운영이 이루어지도록 팀 관리자가 소유자를 변경해야 합니다.

<div id="project-level-roles">
  ## 프로젝트 수준 역할
</div>

팀의 *Team* 또는 *Restricted* 범위 프로젝트에서는 사용자에게 팀 수준 역할과는 다른 특정 역할을 할당할 수 있습니다. 예를 들어, 사용자가 팀 수준에서 *Member* 역할인 경우, 해당 팀의 *Team* 또는 *Restricted* 범위 프로젝트 내에서 그 사용자에게 *View-Only*, *Admin* 또는 사용 가능한 커스텀 역할을 할당할 수 있습니다.

<Note>
  프로젝트 수준 역할은 W\&B Multi-tenant Cloud, Dedicated Cloud 및 Self-Managed 인스턴스에서 미리보기 기능으로 제공됩니다.
</Note>

<div id="assign-project-level-role-to-a-user">
  ### 사용자에게 프로젝트 수준 역할 할당
</div>

1. W\&B 프로젝트로 이동합니다.
2. 왼쪽 열에서 **Overview** 탭을 선택합니다.
3. 프로젝트의 **Users** 탭으로 이동합니다.
4. **Project Role** 필드에서 해당 사용자의 현재 할당된 역할을 클릭합니다. 그러면 다른 사용 가능한 역할이 나열된 드롭다운이 열립니다.
5. 드롭다운에서 다른 역할을 선택합니다. 변경 사항은 즉시 저장됩니다.

<Note>
  사용자의 프로젝트 수준 역할을 팀 수준 역할과 다르게 변경하면, 그 차이를 나타내기 위해 프로젝트 수준 역할에 \*\*\*\*\* 표시가 붙습니다.
</Note>

<div id="other-key-things-to-note-for-project-level-roles">
  ### 프로젝트 수준 역할에 대해 추가로 알아둘 사항
</div>

* 기본적으로 *team* 또는 *restricted* 범위의 프로젝트에서는 모든 사용자의 프로젝트 수준 역할이 각자의 팀 수준 역할을 **상속**합니다.
* 팀 수준에서 *View-only* 역할을 가진 사용자의 프로젝트 수준 역할은 **변경할 수 없습니다**.
* 특정 프로젝트에서 사용자의 프로젝트 수준 역할이 팀 수준 역할과 **같은 경우**, 이후 팀 관리자가 팀 수준 역할을 변경하면 해당 프로젝트 역할도 팀 수준 역할을 따르도록 자동으로 변경됩니다.
* 특정 프로젝트에서 사용자의 프로젝트 수준 역할을 팀 수준 역할과 **다르게** 변경한 경우, 이후 팀 관리자가 팀 수준 역할을 변경하더라도 해당 프로젝트 수준 역할은 그대로 유지됩니다.
* 사용자의 프로젝트 수준 역할이 팀 수준 역할과 다른 상태에서 *restricted* 프로젝트에서 사용자를 제거한 뒤, 얼마 후 다시 해당 프로젝트에 추가하면 기본 동작에 따라 팀 수준 역할을 상속받습니다. 필요한 경우 프로젝트 수준 역할을 다시 변경해 팀 수준 역할과 다르게 설정해야 합니다.