게이팅 그룹 컬렉션
게이팅 그룹 컬렉션 (Gating Group Collections)
Gating Group Collections는 조직이 컬렉션 안의 모든 모델·데이터셋에 대한 접근을 저장소별이 아니라 한 번에 부여(또는 거부)할 수 있게 해주는 Team & Enterprise 기능이에요. 사용자는 단 한 번의 접근 요청만 거치면 된답니다. 컬렉션이 게이팅되면 기본적으로 자동 승인 모드로 동작하고, 수동 검토 모드로 바꿀 수도 있어요.
출처: 문서
본문
[!WARNING] 이 기능은 Team & Enterprise 요금제의 일부예요.
Gating Group Collections를 사용하면 조직이 컬렉션의 모든 모델·데이터셋에 대한 접근을 저장소별이 아니라 한 번에 부여(또는 거부)할 수 있어요. 사용자는 단 한 번의 접근 요청만 거치면 돼요.
컬렉션에서 Gating Group을 활성화하려면:
- 컬렉션 소유자가 조직이어야 해요
- 조직이 Team 또는 Enterprise 요금제를 구독해야 해요
- 컬렉션의 모든 모델·데이터셋이 컬렉션과 같은 조직 소유여야 해요
- 컬렉션의 각 모델·데이터셋은 하나의 Gating Group Collection에만 속할 수 있어요 (하지만 게이팅 없는 즉 일반 컬렉션에는 여전히 포함될 수 있어요).
[!TIP] 게이팅은 모델과 데이터셋에만 적용돼요; 컬렉션의 다른 리소스(예: Space나 Paper)는 영향을 받지 않아요.
조직 관리자로서 게이팅 그룹 관리하기
접근 요청을 활성화하려면 컬렉션 페이지로 가서 오른쪽 아래의 Gating group을 클릭해요.
기본적으로 게이팅 그룹은 비활성화돼 있어요: Configure Access Requests를 클릭해 설정을 열어요.
기본적으로 컬렉션의 저장소 접근은 사용자가 요청하면 자동으로 부여돼요. 이를 자동 승인(automatic approval) 이라고 불러요. 이 모드에서는 사용자가 접촉 정보를 공유하는 데 동의하기만 하면 누구나 저장소에 접근할 수 있어요.
컬렉션의 저장소에 접근할 수 있는 사용자를 수동으로 승인하고 싶다면 Manual Review로 설정해야 해요. 이 경우 새 옵션이 하나 보이게 돼요:
Notifications frequency는 새 사용자가 접근을 요청할 때 언제 알림을 받을지 구성하게 해줘요. 하루 한 번 또는 실시간으로 설정할 수 있어요. 기본적으로 이메일은 조직의 처음 5명의 관리자에게 보내져요. Notifications email 필드에서 다른 이메일 주소를 설정할 수도 있어요.
접근 요청 검토
접근 요청이 활성화되면, 승인 모드가 수동이든 자동이든 게이팅 그룹 컬렉션의 저장소에 접근할 수 있는 사람을 완전히 제어할 수 있어요. UI 또는 API에서 요청을 검토·관리할 수 있어요.
게이팅 그룹 컬렉션의 저장소에 대한 요청을 승인하면, 그 컬렉션의 모든 저장소(모델·데이터셋)에 대한 접근이 자동으로 승인돼요.
UI에서
Gating Group Collection의 어느 저장소의 설정 페이지에서 Review access requests 버튼을 클릭하면 컬렉션의 모든 저장소에 접근할 수 있는 사람을 검토할 수 있어요:
그러면 3개의 사용자 목록이 있는 모달이 열려요:
- pending: 저장소에 대한 승인을 기다리는 사용자 목록. Manual Review를 선택하지 않으면 비어 있어요. 각 요청을 Accept하거나 Reject할 수 있어요. 요청이 거부되면 사용자는 저장소에 접근할 수 없고 다시 요청할 수도 없어요.
- accepted: 저장소에 접근 권한이 있는 완전한 사용자 목록. 승인 모드가 수동이든 자동이든 언제든 어떤 사용자에 대해 Reject를 선택할 수 있어요. Cancel로 승인을 취소하면 사용자가 pending 목록으로 이동해요.
- rejected: 수동으로 거부한 사용자 목록. 이 사용자들은 저장소에 접근할 수 없어요. 저장소로 가면 _Your request to access this repo has been rejected by the repo's authors_라는 메시지를 보게 돼요.
API를 통해
Gated Group Collection의 접근 요청을 그 모델·데이터셋 중 하나의 API를 통해 프로그래밍 방식으로 관리할 수 있어요.
자세한 내용은 gated models 또는 gated datasets 문서를 방문해 주세요.
접근 보고서 다운로드
Gated Group Collection의 접근 보고서는 그 모델·데이터셋 중 하나의 설정 페이지에서 다운로드할 수 있어요.
자세한 내용은 gated models 또는 gated datasets 문서를 방문해 주세요.
요청 정보 커스터마이즈
조직은 게이팅 파라미터와 gated repo별 수집되는 사용자 정보를 커스터마이즈할 수 있어요. 자세한 내용은 gated models 또는 gated datasets 문서를 방문해 주세요.
[!WARNING] 현재 게이트 파라미터와 요청 정보를 중앙 집중식으로 커스터마이즈하는 방법은 없어요. 사용자가 어느 컬렉션의 저장소에 접근하든 같은 데이터를 수집하려면, 컬렉션의 모든 모델·데이터셋 메타데이터에 같은 게이트 파라미터를 추가하고 동기화를 유지해야 해요.
고급 설정
Enterprise Plus 조직은 모든 모델·데이터셋에서 특정 위치의 방문자를 자동으로 거부하거나 차단할 수 있어요. 이 설정은 Publisher Analytics 설정의 Advanced Gating 탭에 있어요.
실행 (Enforcement)
Enforcement 설정은 차단된 방문자가 무엇을 거부당하는지 제어해요:
- Gated repositories: 조직의 gated 저장소에 대한 접근 요청이 자동 거부돼요.
- All repositories: 접근 요청 자동 거부에 더해, 공개된 것을 포함해 조직의 모든 저장소에서 다운로드가 거부돼요. 차단된 방문자는 저장소 페이지에서 "not available in your region" 공지를 보고, dataset viewer는 비활성화돼요.
Enforcement는 로그인 여부와 관계없이 차단된 국가·지역의 방문자에게 적용돼요. 조직 멤버도 예외가 아니에요.
차단된 위치
두 목록이 차단된 위치를 정의해요:
- Blocked countries: ISO 3166-1 alpha-2 코드로 식별되는 국가.
- Blocked regions: 위 국가들 외에 차단할 특정 영토 — 별개의 국가가 아니라 위 목록에서 선택할 수 없는 영토용.
사용자로서 Gating Group Collection의 gated 저장소 접근하기
Gated Group Collection은 이름 옆에 특정 아이콘을 표시해요:
Gated Group Collection의 모델·데이터셋에 접근하려면 그 저장소 중 하나의 페이지에서 단 한 번의 접근 요청이 필요해요. 요청이 승인되면 컬렉션의 다른 모든 저장소(향후 포함)에 접근할 수 있게 돼요.
저장소 접근 요청에 대해 더 알아보려면 gated models 또는 gated datasets 문서를 방문해 주세요.
더 알아보기 (Learn more)
- 게이팅 그룹 컬렉션에선 한 번의 접근 요청으로 컬렉션의 모든 저장소에 접근할 수 있어요.
- 승인 모드는 자동 자동 승인 또는 수동 검토 중 선택할 수 있어요.