# 어떤 클라이언트가 모델에 접근할 수 있는지 결정하세요

> 요청 헤더 액세스 규칙으로 어떤 클라이언트가 AI 게이트웨이를 호출할 수 있는지 제한합니다: User-Agent 또는 모든 헤더로 허용/거부, 전역 / 그룹 / 키 범위, 허용 목록 모드, ReDoS 안전 정규식.

표준 링크: https://www.gatellm.io/ko/use-cases/client-admission-control/

User-Agent, 오리진 또는 모든 헤더로 허용/거부하는 요청 헤더 액세스 규칙 — 전역, 키 그룹 단위, 또는 단일 키 단위로 범위를 정합니다.

## 커뮤니티가 실제로 불평하는 것
"키가 유출되면 가진 사람 누구나 우리 할당량을 태울 수 있다", "회사 전체의 코딩 에이전트는 허용하되 순수 curl과 스크래퍼는 막고 싶다", "벤더 콘솔에는 IP 허용 목록이 있지만 우리 트래픽은 동적이고 프록시 뒤에 있어 맞지 않는다".
강제는 요청이 도착하는 곳 — 게이트웨이 — 에서 일어나야 하며, 개발자가 그냥 꺼 버릴 수 있는 클라이언트 측 설정이어서는 안 됩니다.

## GateLLM은 이렇게 합니다
GateLLM은 모든 요청에서 HTTP 헤더를 기준으로 승인 규칙을 평가합니다: 여섯 가지 일치 유형(정확 / 접두사 / 정규식 / 존재 / 부재 / 임의)과 세 가지 범위(전역 / 키 그룹 / 키)를 가지며, sort_order 순으로 첫 일치 우선입니다.
"승인된 클라이언트만"을 원하면 허용 목록 모드를 사용합니다: 그룹의 기본 동작을 거부로 두고 클라이언트 서명과 일치하는 허용 규칙 하나를 추가하세요 — 나머지는 모델에 도달하기 전에 거부됩니다.

## 실제로 효과가 있는 5가지 레버
- 6가지 일치 유형: 정확 / 접두사 / 정규식 / 존재 / 부재 / 임의 — 규칙 하나로 정규식 대안을 통해 "A 또는 B 또는 C"를 표현
- 3가지 범위: 전역, 키 그룹별, 키별 — 첫 일치 우선과 동일 순서의 전역 우선순위
- 허용 목록 모드: 기본 거부 + 명시적 허용 하나 — 새로운 미지 클라이언트는 기본적으로 거부
- 규칙이 모델 목록 경로(/v1/models)도 커버해 거부된 클라이언트는 종단 간 차단
- ReDoS 안전 선형 시간 정규식 엔진 — 병리적 패턴은 요청 시점이 아니라 로드 시점에 거부

## FAQ
### 클라이언트가 X-Forwarded-For를 위조해 규칙을 우회할 수 있나요?
예 — X-Forwarded-For는 클라이언트가 위조할 수 있습니다. 신뢰할 수 있는 리버스 프록시가 덮어쓸 때만 신뢰할 수 있고, 그렇지 않으면 악의적 클라이언트가 임의로 채웁니다. 실제 IP 승인에는 게이트웨이가 직접 보는 소스 IP를 TRUSTED_PROXIES와 함께 구성해 사용하세요.

### 키는 맞는데 클라이언트가 403을 받는 이유는 무엇인가요?
액세스 규칙은 모델 목록 경로에도 적용됩니다. 거부된 클라이언트는 첫 /v1/models 호출에서부터 차단될 수 있습니다. Header ACL 규칙이 일치하는지 확인하고, 기본 거부에서는 허용 규칙에 일치하지 않는 클라이언트가 거부된다는 점을 기억하세요.

### "헤더에 X가 없을 때만 허용"을 쓸 수 있나요?
단일 정규식으로는 표현할 수 없습니다 — 엔진에는 lookahead가 없습니다. 반대로 구성하세요: 기본 동작을 거부로 두고 "X가 있으면 허용" 규칙 하나를 추가하면, 일치하지 않는 요청은 기본 거부로 폴백됩니다.

- [전체 방법: Header ACL 구성(문서)](https://docs.gatellm.io/en/howto/configure-header-acl)

## 관련 페이지
- [홈](https://www.gatellm.io/ko/index.md)
- [요금](https://www.gatellm.io/ko/pricing.md)
- [비용 계산기](https://www.gatellm.io/ko/calculator.md)
- [소개](https://www.gatellm.io/ko/about.md)
- [데모 예약](https://www.gatellm.io/ko/demo.md)
- [FAQ](https://www.gatellm.io/ko/faq.md)
- [AI 게이트웨이 비교](https://www.gatellm.io/ko/compare.md)
- [LiteLLM 비교](https://www.gatellm.io/ko/compare/litellm.md)
- [OpenRouter 비교](https://www.gatellm.io/ko/compare/openrouter.md)
- [Alibaba Cloud AI Gateway 비교](https://www.gatellm.io/ko/compare/alibaba-cloud.md)
- [Azure API Management 비교](https://www.gatellm.io/ko/compare/azure-apim.md)
- [Apigee 비교](https://www.gatellm.io/ko/compare/apigee.md)
- [Cloudflare AI Gateway 비교](https://www.gatellm.io/ko/compare/cloudflare.md)
- [Kong AI Gateway 비교](https://www.gatellm.io/ko/compare/kong.md)
- [Portkey 비교](https://www.gatellm.io/ko/compare/portkey.md)
- [LiteLLM vs Kong AI Gateway](https://www.gatellm.io/ko/compare/litellm-vs-kong.md)
- [LiteLLM vs OpenRouter](https://www.gatellm.io/ko/compare/litellm-vs-openrouter.md)
- [LiteLLM vs Portkey](https://www.gatellm.io/ko/compare/litellm-vs-portkey.md)
- [사용 사례](https://www.gatellm.io/ko/use-cases.md)
- [LLM 비용 절감](https://www.gatellm.io/ko/use-cases/reduce-cost.md)
- [고가용성](https://www.gatellm.io/ko/use-cases/high-availability.md)
- [멀티테넌트 격리](https://www.gatellm.io/ko/use-cases/multi-tenant.md)
- [컴플라이언스 및 감사](https://www.gatellm.io/ko/use-cases/compliance-audit.md)
- [증상별 트러블슈팅](https://www.gatellm.io/ko/use-cases/troubleshooting.md)
- [다중 벤더 혼합 모델 스택](https://www.gatellm.io/ko/use-cases/mixed-model-stack.md)
- [Office 내 AI 셀프 호스팅](https://www.gatellm.io/ko/use-cases/self-hosted-office-ai.md)
- [Token 사용량 가시성 및 귀속](https://www.gatellm.io/ko/use-cases/token-ops.md)
- [Token FinOps: AI 비용 배분 및 통제](https://www.gatellm.io/ko/use-cases/token-finops.md)
- [MCP 도구 거버넌스](https://www.gatellm.io/ko/use-cases/mcp-tool-governance.md)
- [모든 모델에 웹 검색 추가](https://www.gatellm.io/ko/use-cases/web-search-grounding.md)
- [다중 키 로테이션 및 대기](https://www.gatellm.io/ko/use-cases/multi-key-pooling.md)
- [모델 사용 정책 강제](https://www.gatellm.io/ko/use-cases/enforce-model-policy.md)
- [클라이언트에 모델 선택 비노출](https://www.gatellm.io/ko/use-cases/automatic-model-tiering.md)
- [하나의 프로토콜, 어떤 모델이든](https://www.gatellm.io/ko/use-cases/one-protocol-any-model.md)
- [Office / Microsoft 365 추가 기능](https://www.gatellm.io/ko/office-addin.md)
- [용어집](https://www.gatellm.io/ko/glossary.md)
- [모델 카탈로그](https://www.gatellm.io/ko/models.md)
- [SDK 및 프레임워크 통합](https://www.gatellm.io/ko/integrations.md)
- [AI 코딩 에이전트 및 하네스](https://www.gatellm.io/ko/coding-agents.md)
- [보안 및 컴플라이언스](https://www.gatellm.io/ko/security.md)