shim: 개인정보 마스킹과 API 관리를 위한 AI 게이트웨이

쉽게 설명하면 shim은 어떤 사이트인가요?

shim은 애플리케이션과 AI 모델 제공업체 사이에 두는 AI 게이트웨이입니다. 요청이 모델로 바로 나가는 대신 이 계층을 먼저 거칩니다. 활성화한 개인정보 정책이 이메일이나 비밀 키를 감지하면 전송 전에 자리표시자로 바꾸고, 앱에 전달하는 응답에서 원래 값을 복원할 수 있습니다.

AI API를 제품에 연결하면서 외부로 나가는 데이터와 비용을 관리하려는 개발팀에 적합합니다. 개발자 컴퓨터에서 사용하는 shim-cli도 제공하지만, 애플리케이션 게이트웨이와 검사 대상 및 보호 범위가 다릅니다.

개인정보 마스킹은 어떻게 작동하나요?

문서에 나온 항목은 이메일, 전화번호, 카드, IBAN, 튀르키예 TCKN, 미국 SSN, API 키, 개인 키, 데이터베이스 연결 문자열, 네트워크 주소 등입니다. 한 요청 안에서 같은 값은 같은 무작위 자리표시자를 사용하므로 모델이 원본 식별값 없이 관계를 이해하도록 돕습니다.

되돌릴 수 있는 치환이므로 완전한 익명화와 같지 않습니다. 공식 문서는 영어 사람 이름을 아직 감지하지 못한다고 설명합니다. 한국 식별번호나 모든 언어의 이름을 지원한다고 추정하지 말고, 가상 업무 데이터로 감지와 복원을 시험해야 합니다.

백엔드에서 한 번의 요청을 연결하는 방법

1. shim 키를 만들고 모델 제공업체 자격 증명을 별도로 설정합니다.
2. 공식 API 연동 문서를 따릅니다. OpenAI 예시는 https://api.getshim.tech/v1을 쓰며, Anthropic과 Gemini는 문서화된 원래 경로와 형식을 유지합니다.
3. 승인된 모델과 테넌트 정책을 선택하고 적절한 출력 토큰 제한을 설정합니다. 키는 서버에 보관합니다.
4. 가짜 식별값이 담긴 텍스트로 요청해 응답, 복원 결과, 사용량 기록을 확인합니다.
5. 거부되면 모델 목록과 한도를 확인합니다. 설정한 속도나 할당량을 넘으면 HTTP 429가 반환될 수 있습니다.

OpenAI Responses와 Chat, Anthropic Messages, Gemini generateContent 및 해당 스트리밍 형식 등이 문서화되어 있습니다. 모든 SDK 리소스의 호환성을 뜻하지 않습니다. 문서는 제공업체 간 변환·라우팅·자동 장애 전환과 OpenAI Responses 백그라운드 실행을 제외합니다.

로컬 shim-cli의 클라이언트별 차이

무료 Apache-2.0 CLI는 shim 계정 없이 macOS와 Linux에서 작동하고 Python 3.10 이상이 필요합니다. Claude Code의 공식 흐름은 설치, shim demo claude, shim install claude --dry-run으로 변경 확인, 훅 설치, 새 세션에서 shim doctor claude 확인입니다.

Claude Code는 대상 파일과 도구 내용 일부를 마스킹할 수 있습니다. Claude Code와 Codex에 직접 입력한 프롬프트는 기본적으로 보고하며 enforce 모드에서는 차단하지만 재작성하지 않습니다. Copilot CLI는 프롬프트를 바꿀 수 있으나 그 도구 트래픽과 Codex 도구 트래픽은 검사하지 않습니다. VS Code는 마스킹하지 않습니다. Windows는 미지원이고 WSL은 검증되지 않았습니다.

shim audit은 Claude Code 로컬 기록의 노출을 집계하면서 민감한 값을 출력하지 않습니다. shim watch -- claude는 세션 트래픽, 토큰, 비용을 관찰합니다. 감지가 일부 값을 놓칠 가능성은 남습니다.

무료 한도와 데이터 보관을 함께 확인하세요

2026년 10월 20일 확인 기준 Developer는 $0이며 월 100만 토큰과 1,000건 요청이라는 두 한도가 함께 적용됩니다. Enterprise는 배포, 사용량, 지원에 따라 견적을 받습니다. 모델 추론 요금 포함 여부는 확인되지 않았으므로 공식 최신 요금과 제공업체 청구를 확인해야 합니다.

개인정보 처리방침은 원시 프롬프트와 응답 본문을 일시 처리하고 영구 요청 기록에 저장하지 않는다고 설명합니다. 다만 OpenAI Responses 연속 요청의 암호화된 테넌트별 복원 매핑은 Redis에 최대 30일 남을 수 있습니다. Enterprise 자체 배포는 게이트웨이 데이터를 shim 인프라 밖에 두지만 선택한 모델에는 요청이 전송됩니다.

스크러빙을 활성화하면 안전하게 검사할 수 없는 불투명 파일, 이미지, 오디오 입력은 거부됩니다. 홈페이지의 문서 변환 설명을 모든 API의 첨부 지원으로 해석하면 안 됩니다.

팀 예산과 감사 기록으로 사용량 관리

조직, 팀, 요청 태그에 USD 또는 토큰 예산을 적용할 수 있습니다. 호출 전 예상 사용량을 예약하고 완료 후 실제 사용량을 정산합니다. RPM/TPM, 일별·월별 할당량, 동일 요청 반복 방지는 서로 다른 소비 패턴을 제어합니다.

감사 기록에는 요청 상태, 모델, 사용량, 비용, 개인정보 처리 사실이 포함됩니다. 감사 체인 검증과 증거 보고서, 선택적인 사람 검토는 내부 통제를 지원합니다. 이런 기록이 법적 인증이나 자동 규정 준수를 의미하지는 않습니다.

자주 묻는 질문

어떤 정보를 마스킹하나요?

연락처, 금융 식별값, 일부 국가 식별번호와 비밀 정보가 문서화되어 있습니다. 입력, 정책, 클라이언트에 따라 범위가 달라 완전 감지는 보장되지 않습니다.

무료이며 오픈소스인가요?

CLI는 Apache-2.0으로 무료입니다. 호스팅 게이트웨이는 월 한도가 있고 Enterprise는 견적형입니다. CLI 라이선스가 서비스 전체에 적용되지는 않습니다.

모든 모델 API와 파일을 사용할 수 있나요?

문서화된 엔드포인트와 승인 모델을 사용해야 합니다. 스크러빙은 불투명 입력을 거부하며 제공업체 간 자동 전환을 약속하지 않습니다.

공식 자료

• 보안 아키텍처: 자격 증명과 배포 조건을 확인합니다.
• shim-cli 소스와 이슈: 라이선스 및 클라이언트별 지원 범위를 확인합니다.