본문으로 건너뛰기
이 페이지는 기계 번역이며 충분한 검토를 거치지 않았습니다. 영어 원문이 기준입니다. 보안, 개인정보 보호, 데이터 처리, 규정 준수 및 라이선스에 관한 설명은 기술 검토가 끝날 때까지 영어로 유지됩니다. 영어 원문 보기

코드 변경 없이 기존 AI 앱 통제하기

사용하는 적용 지점: 게이트웨이 프록시 지원 모드: Hosted Hybrid (셀프 호스팅 게이트웨이) 플랜: Free Solo Teams

수행할 내용​

환경 변수 하나를 변경합니다. 이제 앱이 보내는 모든 LLM 요청이 Control Zero 게이트웨이를 거치며, 게이트웨이는 처리 중인 프롬프트와 도구 호출에 정책을 적용하고 감사 추적을 기록합니다 -- 애플리케이션 코드는 한 줄도 건드리지 않습니다.

이 방법이 적합한 경우​

  • 프로덕션에 기존 AI 앱(어떤 언어, 어떤 프레임워크든)이 있고 수정할 수 없거나 수정하고 싶지 않다면 이것이 가장 빠른 방법입니다.
  • 에이전트가 OpenAI, Anthropic, Google, Cohere, Mistral, DeepSeek 또는 OpenAI 호환 엔드포인트(Ollama, TGI, vLLM)를 호출한다면 게이트웨이가 처리합니다.
  • 새 앱을 만들면서 더 세밀한 제어가 필요하다면 Python SDK 또는 Node SDK를 권장합니다.

이 방법을 사용하지 말아야 할 경우​

주의

게이트웨이는 LLM 경계에서 정책을 적용합니다. 앱이 (LLM 왕복 밖에서) 직접 수행하는 도구 호출은 볼 수 없습니다. 그런 경우에는 SDK를 사용하세요. 또한 브라우저 기반 사용(claude.ai, ChatGPT)도 다루지 않으므로 브라우저 확장 프로그램을 사용하세요.

5분 설정​

대시보드 -> Settings -> Gateway에서 게이트웨이 URL과 API 키를 가져옵니다.

Anthropic (Claude)​

# Before:
export ANTHROPIC_API_KEY=sk-ant-...

# After:
export ANTHROPIC_BASE_URL=https://gateway.controlzero.ai/anthropic
export ANTHROPIC_API_KEY=sk-ant-...            # your real key
export CONTROLZERO_API_KEY=cz_live_...         # sent as X-ControlZero-API-Key

OpenAI​

export OPENAI_BASE_URL=https://gateway.controlzero.ai/openai/v1
export OPENAI_API_KEY=sk-...
export CONTROLZERO_API_KEY=cz_live_...

SDK가 CONTROLZERO_API_KEY를 자동으로 인식하지 못하면 헤더를 추가하세요:

X-ControlZero-API-Key: cz_live_...

앱을 다시 시작하면 끝입니다.

테스트​

curl https://gateway.controlzero.ai/anthropic/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "X-ControlZero-API-Key: $CONTROLZERO_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 64,
    "messages": [{"role": "user", "content": "hello"}]
  }'

예상 결과: 정상적인 Anthropic 응답. 정책이 무언가를 거부하면 [Control Zero]와 사유가 포함된 오류 본문이 표시됩니다.

작동 확인​

  1. 대시보드 -> Audit을 엽니다. 공급자, 모델, 토큰 수, 결정이 포함된 모든 요청이 표시되어야 합니다.
  2. DLP 규칙을 추가합니다(예: SSN 거부). 테스트용 SSN이 포함된 프롬프트를 보냅니다. 요청이 거부되고 감사 행에 일치한 규칙이 표시되는지 확인합니다.
  3. 게이트웨이 URL을 잠시 제거하고 같은 요청을 보내 직접 전달되고 Audit에 아무것도 기록되지 않는지 확인합니다. 그런 다음 게이트웨이 URL을 다시 설정합니다.

자주 이어지는 질문​

참고 자료​