네트워크 보안

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

조직 IP 범위를 정의합니다

조직의 아웃바운드 트래픽 IP 주소를 나열하여 기업 네트워크에서 Hugging Face에 대한 인증된 액세스를 강제할 수 있습니다. 아웃바운드 IP 주소 범위는 CIDR 형식으로 정의됩니다. 예를 들어, 52.219.168.0/24 또는 2600:1f69:7400::/40입니다.

공백 또는 줄바꿈으로 구분하여 여러 범위를 한 번에 입력할 수 있습니다. 각 범위는 개별적으로 목록에 표시되며, 목록에서 원하는 범위를 제거할 수 있습니다.

조직 관리자가 네트워크 보안 설정에서 “Organization IP Ranges”를 입력한 후, “Require login for users in your IP ranges” 설정이 사용 가능해지려면 Hugging Face Solution Engineers와 조직 관리자가 함께 수행하는 수동 검증이 필요합니다.

IP 범위 목록의 각 항목에는 상태 배지가 표시되어, 현재 적용 중이거나 검증 대기 상태인 범위를 확인할 수 있습니다.

After the “Organization IP Ranges” have been manually verified, and the organization admins have enabled both “Restrict organization access to your IP ranges only” and “Require login for users in your IP ranges”, the following flow applies:

• 사용자가 플랫폼에 접속하면 IP 주소가 확인됩니다.
• IP가 조직에서 정의한 범위 내에 있는 경우, 사용자는 인증을 수행해야 합니다(활성화된 경우 조직의 SSO를 통해).
• 인증이 완료되면, 콘텐츠 액세스 정책이 사용자가 액세스할 수 있는 리소스를 결정합니다.

더 높은 Hub 속도 제한

Hub의 대부분의 작업에는 제한이 있습니다. 예를 들어, 사용자는 하루에 생성할 수 있는 저장소 수에 제한이 있습니다. Enterprise Plus는 모든 작업에 대해 사용자에게 높은 속도 제한을 자동으로 제공합니다.

또한, “Higher Hub Rate Limits” 옵션을 활성화하면 Hub API에서 가장 높은 HTTP rate limit을 활용할 수 있어 대량의 모델 또는 데이터셋 다운로드가 가능합니다.

속도 제한에 대한 자세한 내용은 Hub Rate limits 문서를 참조하세요.

조직 액세스를 IP 범위에만 제한

이 옵션은 조직의 리소스에 대한 액세스를 정의한 IP 범위에서 오는 요청으로만 제한합니다. IP 범위 외부에서는 누구도 조직 리소스에 액세스할 수 없습니다. 이 규칙은 액세스 토큰에도 적용됩니다. 이 옵션을 활성화하면 아래에 추가적인 중첩 보안 설정이 활성화됩니다.

기업 네트워크 외부에서 실행되는 자동화 워크플로우의 경우, 개별 서비스 계정 토큰에 대해 이러한 제한 사항과 콘텐츠 액세스 정책을 예외로 처리할 수 있습니다.

IP 범위 내 사용자의 로그인을 요구

이 옵션이 활성화되면, 기업 네트워크에서 Hugging Face를 방문하는 모든 사용자는 로그인되어 있어야 하며 사용자의 조직에 속해야 합니다(IP 범위가 변경된 경우 수동 확인이 필요합니다). 활성화된 경우, 콘텐츠 액세스 정책을 선택적으로 정의할 수 있습니다.

인증되지 않은 상태로 액세스하면 모든 공개 페이지에 다음 메시지가 표시됩니다:

콘텐츠 접근 정책

Hugging Face Hub의 특정 콘텐츠를 차단하여 세밀한 콘텐츠 액세스 정책을 정의합니다.

예를 들어, 조직의 멤버가 Spaces에 액세스하는 것을 차단할 수 있습니다. 조직의 사용자가 차단된 콘텐츠로 이동하면 다음 페이지가 표시됩니다:

Blocked content를 정의하려면, 저장소 유형, 조직, 특정 저장소 또는 주어진 조직 내의 저장소 유형과 같은 조합(예: 특정 조직의 모든 Spaces)을 대상으로 하는 규칙을 추가합니다.

Always allowed 필드는 차단 규칙에 대한 예외를 정의할 수 있게 합니다. 차단 규칙이 적용되어야 하는 상황에서도 접근이 허용되어야 하는 콘텐츠를 지정할 수 있습니다.

리포지토리 메타데이터를 표시 상태로 유지

기본적으로 Content Access Policy에 의해 저장소가 차단되면 저장소 전체에 접근할 수 없게 됩니다. 저장소의 콘텐츠만 차단하고 메타데이터는 표시되도록 하려면 “Keep repository metadata visible” 옵션을 활성화하세요.

이 옵션이 활성화되면 차단된 저장소의 메타데이터(리포지토리 카드, 프로필 및 목록 페이지)는 여전히 표시되며, 파일 다운로드, 데이터셋 뷰어, Spaces 실행 및 모델 추론과 같은 콘텐츠만 차단됩니다.

API를 통한 네트워크 보안 관리

Hub API를 통해 조직의 네트워크 보안 설정을 프로그래밍 방식으로 읽고 업데이트할 수 있습니다.

OpenAPI 참조:

• GET /api/organizations//settings/network-security
• PATCH /api/organizations//settings/network-security

Update on GitHub