> 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/deployment/ko/self-hosted/inference-server/configuration/model-security.md).

# 모델 패키지 보안

서버 인증과 혼동하지 않도록 모델별 인증 및 로컬 또는 신뢰할 수 없는 모델 패키지 로딩을 구성합니다.

모델 로드와 서버 액세스는 별도의 제어 기능을 사용합니다. 클라이언트에 서버 액세스 권한을 부여해도 모든 모델 패키지가 안전하게 실행되는 것은 아닙니다.

확인 [보안 구성 마이그레이션](https://docs.roboflow.com/deployment/ko/self-hosted/inference-server/configuration/security-migration.md#release-status) 병합된 변경 사항과 대기 중인 변경 사항을 확인하세요.

## 서버 액세스 및 모델 권한 부여

`WORKSPACES_WHITELISTED_FOR_LOCAL_DEPLOYMENT` 는 통합 스트림 관리 경로를 포함해 서버를 호출할 수 있는 Workspace를 제어합니다. `MODELS_CACHE_AUTH_ENABLED=True` 는 서버가 온라인 상태일 때 호출자의 API 키로 요청한 Roboflow 모델에 액세스할 수 있는지 확인합니다. 모델 권한 부여는 [서버 인증](https://docs.roboflow.com/deployment/ko/self-hosted/inference-server/configuration/security.md#enforce-authentication).

## 을 대체하지 않습니다.

서버 Workflows에서 신뢰할 수 있는 로컬 패키지를 사용하려면 다음 설정을 활성화하고 패키지 디렉터리를 컨테이너에 마운트하세요.

```dotenv
USE_INFERENCE_MODELS=True
ALLOW_INFERENCE_MODELS_DIRECTLY_ACCESS_LOCAL_PACKAGES=True
MODELS_CACHE_AUTH_ENABLED=False
```

이렇게 하면 호출자가 Python 코드를 포함한 읽기 가능한 로컬 모델 패키지를 로드할 수 있습니다. 로컬 로드 경로 자체에는 API 키가 필요하지 않지만, 구성된 Workspace 인증은 요청에 계속 적용됩니다.

서버가 온라인 상태일 때 `MODELS_CACHE_AUTH_ENABLED=True` 와 `ALLOW_INFERENCE_MODELS_DIRECTLY_ACCESS_LOCAL_PACKAGES=True`가 모두 설정되어 있으면 시작이 거부됩니다. 모델별 권한 부여가 필요한 경우 로컬 로드를 비활성화하세요. 파일 시스템 경로를 호출자의 Roboflow 모델 액세스 권한과 대조해 확인할 수는 없습니다.

## 오프라인 권한 부여

다음이 설정된 경우 `OFFLINE_MODE=True`, 모델별 API 키 검사를 실행할 수 없습니다. 또한 `MODELS_CACHE_AUTH_ENABLED=True` 가 설정된 경우 시작하려면 명시적으로 `ALLOW_OFFLINE_MODEL_CACHE_AUTH_BYPASS=True` 를 선택해야 합니다. 이 우회 설정은 신뢰할 수 있는 단일 테넌트 배포에서만 사용하세요. 이 설정으로 오프라인 API 키 검사가 가능해지는 것은 아닙니다.

오프라인 모드에서는 API 연결이 필요한 Workspace 허용 목록 인증 및 Dedicated Deployment 인증도 거부됩니다. 배포 관련 내용은 [오프라인 모드](https://docs.roboflow.com/deployment/ko/self-hosted/enterprise/offline-mode.md) 를 참조하세요.

## 패키지 신뢰 기본값

의 보류 중인 런타임 강화 빌드에서는 [마이그레이션 가이드](https://docs.roboflow.com/deployment/ko/self-hosted/inference-server/configuration/security-migration.md#model-package-trust)에 설명된 대로 JetPack 5.1.1, 6.2.0 및 7.2.0 이미지에서 `ALLOW_INFERENCE_MODELS_UNTRUSTED_PACKAGES=False`로 설정합니다. 이는 코어 라이브러리의 기본값과 같습니다. 신뢰할 수 없는 것으로 분류된 패키지를 로드하려면 패키지와 소스를 검토한 후에만 명시적으로 `True` 로 설정하세요.

이 설정은 `ALLOW_INFERENCE_MODELS_DIRECTLY_ACCESS_LOCAL_PACKAGES`와 별개입니다. 신뢰할 수 없는 다운로드 패키지를 거부해도 로컬 패키지를 직접 로드하는 기능은 비활성화되지 않습니다. 어느 설정도 호출자 인증을 대체하지 않습니다.

## CLI 벤치마크

보류 중인 런타임 강화 빌드에서는 `inference benchmark inference-models-speed` 도 기본적으로 신뢰할 수 없는 패키지를 거부하도록 변경됩니다. 패키지를 의도적으로 신뢰하는 경우 `--allow-untrusted-packages` 를 사용하세요. 어댑터와 Python 벤치마크 헬퍼에도 동일하게 제한적인 기본값이 적용됩니다.

벤치마크 사용법은 다음을 참조하세요. [추론 벤치마크](https://docs.roboflow.com/reference/inference/inference-cli/benchmark).
