게이팅 그룹 컬렉션

이 기능은 Team & Enterprise 플랜의 일부입니다.

Gating Group Collections는 조직이 저장소별로 접근 권한을 부여(또는 거부)하는 대신, 컬렉션 내의 모든 모델과 데이터셋에 대해 한 번에 접근 권한을 부여(또는 거부)할 수 있도록 합니다. 사용자는 단 하나의 접근 요청만 거치면 됩니다.

컬렉션에서 Gating Group을 활성화하려면:

• 컬렉션 소유자는 조직이어야 합니다
• 조직은 Team 또는 Enterprise 플랜에 구독되어 있어야 합니다
• 컬렉션의 모든 모델과 데이터셋은 컬렉션과 동일한 조직에 의해 소유되어야 합니다
• 컬렉션의 각 모델 또는 데이터셋은 하나의 Gating Group Collection에만 속할 수 있습니다(비게이팅, 즉 일반 컬렉션에는 포함될 수 있습니다).

Gating은 모델과 데이터셋에만 적용되며, 컬렉션의 다른 리소스(예: Space 또는 Paper)에는 영향을 미치지 않습니다.

조직 관리자로 게이팅 그룹 관리

액세스 요청을 활성화하려면 컬렉션 페이지로 이동한 후 오른쪽 하단의 Gating group을 클릭하세요.

기본적으로 게이팅 그룹은 비활성화되어 있습니다: 액세스 요청 구성을 클릭하여 설정을 엽니다

기본적으로 컬렉션의 저장소 접근 권한은 사용자가 요청할 때 자동으로 부여됩니다. 이를 자동 승인이라고 합니다. 이 모드에서는 사용자가 연락처 정보를 공유하는 데 동의하면 모든 사용자가 저장소에 접근할 수 있습니다.

컬렉션 내 저장소에 액세스할 수 있는 사용자를 수동으로 승인하려면 Manual Review로 설정해야 합니다. 이 경우 새로운 옵션이 표시됩니다:

새로운 사용자 액세스 요청에 대한 알림을 받을 시점을 설정할 수 있는 Notifications frequency입니다. 하루 한 번 또는 실시간으로 설정할 수 있습니다. 기본적으로 조직의 첫 5명의 관리자 이메일로 메일이 전송됩니다. Notifications email 필드에서 다른 이메일 주소를 설정할 수도 있습니다.

액세스 요청 검토

액세스 요청이 활성화되면, 승인 모드가 수동인지 자동인지에 관계없이 게이팅 그룹 컬렉션 내 리포지토리에 대한 액세스 권한을 완전히 제어할 수 있습니다. UI 또는 API를 통해 요청을 검토하고 관리할 수 있습니다.

게이팅 그룹 컬렉션에 속한 저장소에 대한 요청을 승인하면 해당 컬렉션의 모든 저장소(모델 및 데이터셋)에 대한 액세스가 자동으로 승인됩니다.

UI에서

컬렉션 내 모든 저장소에 대한 액세스 권한을 가진 사용자는 컬렉션의 저장소 중 하나에서 설정 페이지로 이동하여 Review access requests 버튼을 클릭하면 확인할 수 있습니다:

이렇게 하면 3개의 사용자 목록이 포함된 모달이 열립니다:

• pending: 저장소 접근을 승인 대기 중인 사용자 목록입니다. Manual Review를 선택하지 않은 경우 이 목록은 비어 있습니다. 각 요청에 대해 Accept 또는 Reject를 선택할 수 있습니다. 요청이 거부되면 해당 사용자는 저장소에 접근할 수 없으며, 다시 접근을 요청할 수도 없습니다.
• accepted: 저장소에 액세스 권한이 있는 사용자의 전체 목록입니다. 승인 모드가 수동 또는 자동인 경우를 불문하고, 언제든지 특정 사용자의 액세스를 거부할 수 있습니다. 또한 승인을 취소하여 해당 사용자를 pending 목록으로 이동시킬 수도 있습니다.
• rejected: 수동으로 거부한 사용자 목록입니다. 해당 사용자는 저장소에 접근할 수 없습니다. 저장소에 접근하면 이 저장소 접근 요청이 저장소 작성자에 의해 거부되었습니다라는 메시지가 표시됩니다.

API를 통해

Gated Group Collection의 모델 또는 데이터셋 중 하나를 통해 API로 액세스 요청을 프로그래매틱하게 관리할 수 있습니다.

자세한 내용은 gated models 또는 gated datasets 문서를 참조하세요.

다운로드 액세스 보고서

Gated Group Collection의 모델 또는 데이터셋 설정 페이지에서 액세스 보고서를 다운로드할 수 있습니다.

자세한 내용은 gated models 또는 gated datasets 문서를 참조하세요.

수집할 프로필 데이터를 선택

기본적으로 Hugging Face는 요청자의 사용자 이름과 기본 이메일 주소를 조직과 공유합니다. 게이팅 그룹 설정에서 이를 제어하고 Hugging Face가 귀하와 공유하는 정보를 변경할 수 있습니다. 이러한 설정은 컬렉션의 모든 저장소에 적용되며 새로운 요청에만 영향을 미칩니다.

자세한 내용은 gated models 또는 gated datasets 문서를 참조하세요.

요청한 정보 사용자 지정

조직은 게이팅 파라미터와 게이티드 리포당 수집되는 사용자 정보를 사용자 정의할 수 있습니다. 자세한 내용은 게이티드 모델 또는 게이티드 데이터셋 문서를 참조하세요.

위 프로필 데이터 설정을 제외하고, 현재 게이트 매개변수와 요청 정보를 중앙 집중식으로 사용자 정의할 방법은 없습니다. 사용자가 어떤 컬렉션의 저장소에 접근을 요청하든 동일한 데이터를 수집하려면, 해당 컬렉션의 모든 모델과 데이터셋의 메타데이터에 동일한 게이트 매개변수를 추가하고 이를 동기화 상태로 유지해야 합니다.

고급 설정

Enterprise Plus 조직은 모든 모델 및 데이터셋에서 특정 위치의 방문자를 자동으로 거부하거나 차단할 수 있습니다. 이러한 설정은 Publisher Analytics 설정의 Advanced Gating 탭에 있습니다.

적용

Enforcement 설정은 차단된 방문자에게 어떤 항목이 거부되는지를 제어합니다:

• 게이트된 저장소: 조직의 게이트된 저장소에 대한 액세스 요청은 자동으로 거부됩니다.
• 모든 저장소: 액세스 요청을 자동 거부하는 것 외에도, 공개 저장소를 포함하여 해당 조직의 모든 저장소에서 다운로드가 차단됩니다. 차단된 방문자는 저장소 페이지에서 “해당 지역에서 사용할 수 없음” 안내를 보며, 데이터셋 뷰어는 비활성화됩니다.

Enforcement는 차단된 국가 및 지역의 방문자에게 적용되며, 로그인 여부와 관계없이 적용됩니다. 조직의 멤버도 예외가 아닙니다.

차단된 위치

두 개의 목록이 차단된 위치를 정의합니다:

• 차단 국가: ISO 3166-1 alpha-2 코드로 식별된 국가.
• 차단 지역: 위의 국가 목록에 별도로 선택할 수 없는, 독립된 국가가 아닌 영토에 대해, 위의 국가 외에 추가로 차단할 특정 지역.

Gating Group Collection에서 사용자로서 게이트된 리포지토리에 액세스

Gated Group Collection은 이름 옆에 특정 아이콘을 표시합니다:

Gated Group Collection의 모델과 데이터셋에 액세스하려면 해당 컬렉션의 저장소 중 하나에서 액세스 요청을 한 번만 하면 됩니다. 요청이 승인되면 컬렉션 내의 다른 모든 저장소, 향후 추가될 저장소를 포함하여 모두 액세스할 수 있습니다.

리포지토리에 대한 액세스 요청에 대해 자세히 알아보려면 gated models 또는 gated datasets 문서를 방문하세요.

Update on GitHub