> For the complete documentation index, see [llms.txt](https://docs.roboflow.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roboflow.com/get-started/ko/platform/enterprise-features/recommended-enterprise-access-setup.md).

# 권장 액세스 설정

사용자 지정 역할, 인증 그룹, 폴더 권한을 결합하여 역할은 사람이 할 수 있는 일을, 그룹은 위치를 나타내게 하세요.

이 페이지는 여러 사이트, 사업부 또는 팀이 있는 작업공간에 권장되는 접근 모델을 설명합니다. 이 모델은 별도로 문서화된 세 가지 기능을 결합합니다: [역할 기반 접근 제어](/get-started/ko/platform/enterprise-features/role-based-access-control.md), [프로젝트 폴더 권한](https://docs.roboflow.com/datasets/manage/project-folders/project-folder-permissions) 및 인증 그룹입니다. 스크린샷은 이 방식으로 설정된 예시 작업공간에서 가져왔습니다.

{% hint style="info" %}
사용자 정의 역할, 인증 그룹, 폴더 권한 및 SSO 그룹 매핑은 Enterprise 기능입니다. 다음으로 문의하세요. [Roboflow 영업팀](https://roboflow.com/sales) 또는 계정 담당자에게 활성화를 요청하세요.
{% endhint %}

## 역할은 무엇을, 그룹은 어디를 말한다

역할 이름에 위치를 넣으면(예: Engineer-PlantA, Engineer-PlantB) 역할 수가 늘어나고, 복제본은 시간이 지나면서 서로 달라집니다. 질문을 두 개로 나누세요.

* 역할은 사람이 무엇을 할 수 있는지 정의합니다: 주석 달기, 학습, 배포, API 키 관리, 폴더 관리. 역할은 전체 작업공간에 적용됩니다.
* 인증 그룹은 그 작업을 어디에서 할 수 있는지 정의합니다. 그룹은 폴더에 대해 읽기 전용 또는 읽기 및 쓰기 권한을 부여받습니다. 멤버십은 수동으로 설정하거나 SSO 그룹에서 매핑됩니다.

A 공장의 생산 엔지니어는 역할: Eng-Prod, 그룹: A 공장입니다. A 공장의 모델을 검토하는 B 공장 방문자는 자신의 역할을 유지하고, 그룹 권한 부여를 통해 A 공장 폴더에서 읽기 전용 권한을 얻습니다. 위치에 대한 역할은 생성되지 않습니다.

<figure><img src="https://83860450-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1YMZNIiZMBdlCHUDeZMP%2Fuploads%2Fgit-blob-2799beba3ed7cc9da2d8e9fd31258148c518aef5%2Faccess-setup-roles-tab.png?alt=media" alt="Roles tab listing Admin, Labeler, Reviewer, Eng-Dev, Eng-Prod, Read Only and Site Admin"><figcaption><p>기본 제공 역할과 읽기 전용, Eng-Dev, Eng-Prod, Site Admin이 포함된 "역할" 탭.</p></figcaption></figure>

## 권장 역할 계층

가장 낮은 권한에서 가장 높은 권한까지의 다섯 가지 역할입니다.

| 역할           | 일반적인 담당자        | 할 수 있는 일                                                                                                     |
| ------------ | --------------- | ------------------------------------------------------------------------------------------------------------ |
| 새 사용자(기본값)   | 모든 새 로그인        | 할당되기 전에는 아무것도 할 수 없습니다.                                                                                      |
| 읽기 전용        | 작업자, 감사자, 방문자   | 프로젝트, 모델, 비전 이벤트 및 장치 모니터링을 봅니다. 앱에서 추론을 실행합니다. 주석, 학습 또는 배포는 할 수 없습니다.                                      |
| Eng-Dev      | 개발 엔지니어         | 데이터셋 생성, 주석 달기, 업로드, 학습, 버전 생성, 작업 실행. 배포, 키 관리, 폴더 생성은 할 수 없습니다.                                            |
| Eng-Prod     | 생산 엔지니어         | Eng-Dev에 더해 배포, 모델 및 워크플로 관리, 장치 관리, 비전 이벤트 생성, 배치 작업 실행. 접근 가능한 폴더 내에서 전체 API 키 수명 주기(생성, 업데이트, 폐기)를 관리합니다. |
| Site Admin   | 사이트당 한두 명       | 작업공간 관리와 구성원 관리를 제외한 모든 것. 폴더 생성, 그룹에 폴더 접근 권한 부여, 키 관리, 통계 및 감사 로그 조회를 수행합니다.                               |
| Admin(기본 제공) | 중앙 IT, 프로그램 책임자 | 작업공간 전체 API 키, 결제, SSO 및 사용자 정의 역할을 포함한 전체 접근 권한.                                                            |

엔지니어는 폴더를 만들지 않습니다. 폴더 트리(예: 사업부 > 사이트 > 환경)는 거버넌스 구조이므로, 폴더 생성은 Site Admin과 Admin이 담당합니다. 작업공간 전체 API 키는 Admin만 볼 수 있습니다. Site Admin과 Eng-Prod는 폴더 키를 사용하며, 이렇게 하면 가장 민감한 자격 증명이 가장 적은 사람에게만 남습니다.

<figure><img src="https://83860450-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1YMZNIiZMBdlCHUDeZMP%2Fuploads%2Fgit-blob-24a5d4eba394c5c4d12c53d2002b128330233f53%2Faccess-setup-eng-prod-api-keys.png?alt=media" alt="Edit Role dialog for Eng-Prod showing the API keys permission group"><figcaption><p>Eng-Prod, "API 키" 그룹: 생성, 업데이트 및 폐기 가능, "API 키 사용 및 복사" 가능, "작업공간 API 키 보기" 비활성화.</p></figcaption></figure>

<figure><img src="https://83860450-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1YMZNIiZMBdlCHUDeZMP%2Fuploads%2Fgit-blob-383b61909b22e0fdef503eea9c301d980c230f00%2Faccess-setup-site-admin-workspace.png?alt=media" alt="Edit Role dialog for Site Admin showing the Workspace Management permission group"><figcaption><p>Site Admin, "Workspace Management" 그룹: "작업공간 설정 보기"와 "감사 로그 보기"만 가능.</p></figcaption></figure>

## 역할이 할 수 있는 것과 볼 수 있는 것

한 사람의 실제 접근 권한은 역할과 폴더 권한의 교집합입니다. 역할은 열을, 권한 부여는 행을 고정합니다.

| 그 사람의 그룹에 대한 폴더 권한 | 읽기 전용              | Eng-Dev               | Eng-Prod                                | Site Admin                        | Admin             |
| ------------------ | ------------------ | --------------------- | --------------------------------------- | --------------------------------- | ----------------- |
| 권한 없음              | 폴더 숨김              | 폴더 숨김                 | 폴더 숨김                                   | 폴더 숨김                             | 전체 액세스(모든 폴더 액세스) |
| 읽기 전용              | 프로젝트와 모델 보기, 추론 실행 | 읽기 전용과 동일             | 보기, 그리고 폴더의 API 키 관리(참고 참조)             | 보기, 그리고 폴더의 API 키 관리(참고 참조)       | 전체 액세스            |
| 읽기 및 쓰기            | 보기, 추론 실행          | 주석 달기, 업로드, 학습, 버전 생성 | Eng-Dev에 더해 배포, 워크플로, 장치, 비전 이벤트, API 키 | Eng-Prod에 더해 하위 폴더 생성 및 그룹과 폴더 공유 | 전체 액세스            |

핵심 작업은 폴더에 접근할 수 있는 한 그 폴더 어디서나 역할을 따릅니다. 방문자에게 읽기 전용 권한을 줄 때는 신중하게 하고, 한 곳에서 제거할 수 있도록 그룹을 통해 부여하세요.

각 사람은 그리드의 한 칸에 속합니다. 행은 역할이고, 열은 위치입니다.

| **역할**         | **A 공장 폴더** | **B 공장 폴더** | **모든 폴더** |
| -------------- | ----------- | ----------- | --------- |
| **읽기 전용**      | 현장 작업자      | 방문 감사인      |           |
| **Eng-Dev**    | 개발 엔지니어     |             |           |
| **Eng-Prod**   | 생산 엔지니어     | (읽기 전용 방문)  |           |
| **Site Admin** | A 공장 책임자    | B 공장 책임자    |           |
| **Admin**      |             |             | 중앙 IT     |

전근은 그 사람의 그룹을 바꿉니다. 승진은 그 사람의 역할을 바꿉니다.

## 설정 방법

### 역할 만들기

설정, "팀 구성원", "역할"로 이동한 다음 "새 역할"을 클릭합니다. 위의 계층을 사용해 각 역할을 만드세요. "권한 복제 대상"이 있는 가장 가까운 기본 제공 역할부터 시작해 조정합니다. 편집기의 권한 그룹(예: "작업공간 관리", "사용자 및 팀 관리", "API 키")은 표의 범주와 일치합니다. 편집기 자체는 [사용자 정의 역할 만들기](/get-started/ko/platform/enterprise-features/role-based-access-control.md#creating-a-custom-role) 를 참조하세요.

### 사이트별로 인증 그룹 하나 만들기

설정, "팀 구성원", "인증 그룹"으로 이동한 다음 "인증 그룹 만들기"를 클릭합니다. 그룹 이름은 직무가 아니라 위치(예: A 공장, B 공장)로 지정하세요. 사이트의 Dev 및 Prod 폴더에 서로 다른 사람들이 있다면 사이트와 환경별로 그룹을 하나씩 만드세요. 구성원을 직접 추가하거나 SSO 그룹 이름을 매핑하여 멤버십이 ID 제공자를 따르도록 합니다(참조 [SSO로 자동화하기](#automating-it-with-sso)).

<figure><img src="https://83860450-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1YMZNIiZMBdlCHUDeZMP%2Fuploads%2Fgit-blob-a948840be88b30f9fb266446f4ee8bc7ef3a1621%2Faccess-setup-auth-groups.png?alt=media" alt="Auth Groups tab with two groups and their members"><figcaption><p>두 개의 사이트 그룹과 수동으로 할당된 구성원이 있는 "인증 그룹" 탭.</p></figcaption></figure>

### 각 사이트 폴더를 해당 그룹과 공유하기

폴더 카드에서 메뉴를 열고 "권한 설정"을 선택합니다. 사이트의 그룹에는 읽기 및 쓰기 권한을, 방문 그룹에는 읽기 전용 권한을 부여하세요. 그룹이 역할을 대신하게 되면 개별 권한은 폐기합니다. 그러면 전근이나 퇴사도 그룹 하나만 수정하면 됩니다. 접근 수준은 [프로젝트 폴더 권한](https://docs.roboflow.com/datasets/manage/project-folders/project-folder-permissions) 를 참조하세요.

<figure><img src="https://83860450-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1YMZNIiZMBdlCHUDeZMP%2Fuploads%2Fgit-blob-e4bf8f0a374d3694bb076e31482700624df98924%2Faccess-setup-share-folder.png?alt=media" alt="Share Folder dialog with a group granted Read &#x26; Write"><figcaption><p>사이트 폴더의 "폴더 공유": 개별 권한 옆에 그룹에 부여된 읽기 및 쓰기 권한. 그룹이 목표 상태입니다.</p></figcaption></figure>

### 구성원에게 역할 할당

설정, "팀 구성원", "구성원"으로 이동하여 각 구성원의 역할을 설정합니다. 역할과 그룹은 독립적이므로 다른 사이트를 방문하기 위해 두 번째 역할이 필요하지 않습니다. 참조 [팀 구성원 역할 변경](/get-started/ko/platform/workspaces/team-members/change-a-team-member-role.md).

## 이 모델의 API 키

폴더 키는 사이트 작업을 담당합니다. 작업공간 전체 키는 Admin 전용입니다. 폴더 키는 해당 폴더에 접근할 수 있는 누구에게나 보입니다. Site Admin과 Eng-Prod는 폴더 카드 메뉴에서 키를 관리하며, 설정에 "API 키" 페이지가 없습니다.

폴더마다 여러 키를 만드세요: 생산 라인, 장치 군집 또는 통합마다 하나씩입니다. 각 키는 사용량 보고서에서 별도 항목이 되므로, 폴더 내에서 지출을 배분할 수 있습니다(참조 [결제 폴더](/get-started/ko/platform/billing-and-plans/billing-folders.md#folder-api-keys)), 또한 두 개의 활성 키로 교체 중 겹침을 허용할 수 있습니다.

각 키에는 생성 후 365일이 지난 시점의 교체 날짜가 표시되며, 그 시점을 넘으면 기한 초과 배지가 표시됩니다. 새 키를 생성하고, 사용자를 새 키로 옮긴 뒤, 이전 키를 폐기하여 교체하세요. "Roll"은 강제 전환이 가능할 때 제자리에서 교체합니다. 관리 API는 동일한 날짜를 `rotationDueAt`.

<figure><img src="https://83860450-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1YMZNIiZMBdlCHUDeZMP%2Fuploads%2Fgit-blob-05f30f98398bccc8f66b44a80f1dc483b8894e77%2Faccess-setup-folder-menu.png?alt=media" alt="Folder card menu with the API Keys entry"><figcaption><p>폴더 카드 메뉴: "API 키"는 "폴더 사용량" 및 "권한 설정" 옆에 있습니다.</p></figcaption></figure>

<figure><img src="https://83860450-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1YMZNIiZMBdlCHUDeZMP%2Fuploads%2Fgit-blob-ca19dda24a8a12a0ab4111d9a28cf55bbd9fcbd9%2Faccess-setup-folder-api-keys.png?alt=media" alt="API Keys dialog for one folder with three keys"><figcaption><p>하나의 폴더에 대한 "API 키": 사용 대상 이름으로 지은 키, 메타데이터의 소유자, 각 키의 교체 날짜, 그리고 "새 키 생성".</p></figcaption></figure>

<figure><img src="https://83860450-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1YMZNIiZMBdlCHUDeZMP%2Fuploads%2Fgit-blob-0a2f685ee5573972e6fe60cf6b01bff777e1190c%2Faccess-setup-rotation-badges.png?alt=media" alt="Key table with overdue and upcoming rotation badges"><figcaption><p>키 표의 교체 배지와, 목록을 좁히는 "교체 예정 키만 표시" 옵션.</p></figcaption></figure>

<figure><img src="https://83860450-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1YMZNIiZMBdlCHUDeZMP%2Fuploads%2Fgit-blob-1fc590337581497f9f2b501063453d25fc96e875%2Faccess-setup-eng-prod-settings.png?alt=media" alt="Settings sidebar as an Eng-Prod member with no API Keys entry"><figcaption><p>Eng-Prod 구성원으로서의 설정: "사용량", "팀 구성원" 및 "휴지통"만 표시됩니다. 키는 폴더에 있습니다.</p></figcaption></figure>

## SSO로 자동화하기

ID 제공자가 그룹 클레임을 보내면, 하나의 SSO 그룹을 각 역할에, 또 하나를 각 사이트 인증 그룹에 매핑하세요. 참조 [싱글 사인온](/get-started/ko/platform/enterprise-features/single-sign-on-sso.md#custom-role-mapping-via-sso-groups) 에서 ID 제공자 측을 확인하세요.

* 역할: 역할 편집기에서 "SSO 인증 그룹(자동 할당)"을 열고 ID 제공자 그룹 이름을 추가합니다. 해당 그룹을 가진 사용자는 다음 로그인이나 작업공간 로드 시 역할을 받습니다.
* 인증 그룹: 그룹에서 "편집"을 클릭하고 "SSO 그룹 매핑" 아래에 ID 제공자 그룹 이름을 추가합니다. 일치하는 구성원은 로그인 시 할당되며 구성원 목록에 SSO 배지가 표시됩니다.

신규 입사자는 IT가 적절한 그룹에 추가할 때까지 기본 역할에 머뭅니다. 역할과 폴더 접근 권한은 다음 로그인 시 나타납니다. 매핑은 한 번에 하나의 역할씩 활성화하세요. 아직 매핑되지 않은 항목은 수동 할당이 계속 작동합니다.

<figure><img src="https://83860450-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1YMZNIiZMBdlCHUDeZMP%2Fuploads%2Fgit-blob-35d15ebb844827381e12c1cae668469435666891%2Faccess-setup-role-sso.png?alt=media" alt="Edit Role dialog with the SSO Auth Groups field"><figcaption><p>"SSO 인증 그룹(자동 할당)" 필드가 있는 "역할 편집".</p></figcaption></figure>

<figure><img src="https://83860450-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1YMZNIiZMBdlCHUDeZMP%2Fuploads%2Fgit-blob-c400477b17ae13a4466a9330e221dc18b40927ed%2Faccess-setup-auth-group-sso.png?alt=media" alt="Edit Auth Group dialog with the SSO Group Mappings field"><figcaption><p>"SSO 그룹 매핑" 필드가 있는 "인증 그룹 편집".</p></figcaption></figure>