API 키 마스킹 도구
로그, .env, 설정 파일의 API 키·토큰·JWT·개인 키·비밀번호를 [OPENAI_KEY_1] 같은 플레이스홀더로 바꿔 AI에 붙여넣고, 받은 답변은 원래 값으로 복원합니다. 브라우저에서만 처리하며 업로드하지 않습니다.
- 브라우저에서 처리
- 도구 입력을 ZeroTool 서버에 업로드하지 않습니다
- 무료 · 회원가입 불필요
WeChat으로 스캔하여 공유
예시·자세한 설명·자주 묻는 질문 실제 출력이 있는 예시, 다른 도구와의 차이, 자주 묻는 질문.
예시 1: 네이버 검색 API 호출
네이버 검색 API는 두 개의 헤더로 인증합니다(네이버 개발자 센터). 값은 모두 예시입니다.
$ curl "https://openapi.naver.com/v1/search/blog.json?query=%EB%A7%88%EC%8A%A4%ED%82%B9" \
-H "X-Naver-Client-Id: DemoClientId0000" \
-H "X-Naver-Client-Secret: DemoSecr3t"
② 칸 결과:
$ curl "https://openapi.naver.com/v1/search/blog.json?query=%EB%A7%88%EC%8A%A4%ED%82%B9" \
-H "X-Naver-Client-Id: DemoClientId0000" \
-H "X-Naver-Client-Secret: [SECRET_1]"
헤더 이름이 Secret으로 끝나는 Client Secret만 바뀌고, Client Id는 이름이 Id로 끝나서 그대로 남습니다. Client Id도 숨기고 싶다면 복사한 뒤 직접 지우세요.
예시 2: Spring 설정 파일과 답변 복원
spring.datasource.url=jdbc:postgresql://localhost:5432/shop
spring.datasource.password=shop-local-pw!
kakao.rest-api-key=0a1b2c3d4e5f60718293a4b5c6d7e8f9
jwt.secret=local-dev-jwt-signing-secret-please-change
비밀번호, 카카오 키, JWT 서명 키가 차례로 [SECRET_1], [SECRET_2], [SECRET_3]가 됩니다. 이 예시의 카카오 키는 16진수라 고엔트로피 검사에는 걸리지 않지만, 이름이 api-key로 끝나서 가려집니다. 답변이 이렇게 왔다고 해 봅시다.
로컬 설정은 환경 변수로 빼 두세요.
export KAKAO_REST_API_KEY=[ SECRET_2 ]
export JWT_SECRET='[secret_3]'
운영 키는 [API_KEY_1]처럼 따로 관리하세요.
③ 칸에서는 공백이 들어간 [ SECRET_2 ]와 소문자 [secret_3]가 원래 값으로 돌아오고, 상태 표시는 "2곳 복원 완료 (매핑 3개 중 2개 사용)"입니다. 매핑에 없는 [API_KEY_1]은 그대로 두고 "알 수 없는 플레이스홀더"로 따로 알려 줍니다. 설정 파일에 어떤 변수가 있는지 먼저 훑어보려면 .env 파일 파서를 쓰면 됩니다.
국내 서비스 키는 어떻게 처리되나
| 대상 | 결과 | 근거 |
|---|---|---|
네이버 X-Naver-Client-Secret | 가림 | 헤더 이름 |
카카오 REST API 키, 토스페이먼츠 시크릿 키를 담은 변수(…_API_KEY, …_SECRET_KEY) | 가림 | 변수 이름 |
토스페이먼츠 API의 Authorization: Basic …(토스페이먼츠 문서) | 가림 | Basic 헤더 규칙 |
카카오 Authorization: KakaoAK …(카카오 문서) | 키를 [KAKAO_API_KEY_n]으로 가림 | 인증 방식 이름 KakaoAK 뒤의 영숫자 16자 이상 |
네이버 X-Naver-Client-Id | 가려지지 않음 | 이름이 Id로 끝남 |
해외 서비스는 형식으로 찾습니다. GitHub의 ghp_ 등 접두사는 GitHub 공식 블로그, AWS의 AKIA·ASIA는 IAM 문서, Anthropic의 sk-ant-는 Anthropic 문서를 따릅니다. JWT는 RFC 7519, Bearer 헤더는 RFC 6750, Basic 헤더는 RFC 7617, PEM 개인 키는 RFC 7468 형식입니다. 로그에 찍힌 JWT가 만료됐는지는 JWT 디코더로 로컬에서 확인할 수 있습니다.
이름 없는 긴 문자열은 base64 문자가 32자 이상 이어지고, 대문자·소문자·숫자를 모두 포함하며, 섀넌 엔트로피가 문자당 4.2비트 이상일 때만 바꿉니다. 같은 길이의 무작위 base64는 평균 약 4.56비트입니다. 커밋 SHA, SHA-256, UUID는 16진수이거나 대소문자 한 가지만 쓰므로 해당하지 않습니다.
gitleaks·로그 마스킹과의 차이
gitleaks와 TruffleHog는 저장소와 git 기록에 이미 들어간 시크릿을 찾습니다. gitleaks 기본 설정은 2026년 9월 기준 222개 규칙입니다(이 도구는 30개 규칙과 엔트로피 검사). 결과를 보고서로 알려 줄 뿐 붙여넣을 텍스트는 만들지 않으며, pre-commit이나 CI에 두는 도구입니다. GitHub Actions의 ::add-mask::는 값을 *로 바꿉니다(GitHub 문서). 모든 값이 똑같이 보이고 되돌릴 수 없어서, AI는 두 키가 같은 값인지도 알 수 없습니다.
이 도구가 맡는 것은 붙여넣기 직전 단계입니다. 값마다 다른 번호를 붙이고, 같은 값에는 같은 번호를 쓰며, 답변은 되돌릴 수 있습니다. 예제 불러오기를 누르면 [OPENAI_KEY_1]이 .env와 재시도 로그 줄 양쪽에 나타납니다. AI는 이것으로 재시도가 설정된 키를 썼다는 것을 알 수 있습니다.
한계
- 입력 한도는 1,000,000자입니다. 넘으면 상태 표시에 "입력이 N자입니다. 한도는 1,000,000자입니다. 나눠서 붙여넣으세요."가 나옵니다.
- 개인 키 규칙을 뺀 모든 규칙은 줄 끝에서 멈추므로, 터미널에서 줄바꿈된 값은 감지하지 못합니다. 원본 파일에서 복사하세요.
- 카테고리를 켜고 끄면 다시 감지하면서 번호가 바뀔 수 있습니다. 복원은 마스킹할 때와 같은 설정으로 하세요.
- 이메일, 이름, 전화번호, 주민등록번호, IP 주소 같은 개인 정보는 다루지 않습니다. 호스트명은 일부러 남깁니다.
- 키가 아직 유효한지는 확인하지 않습니다. 확인하려면 키를 제공자에게 보내야 하기 때문입니다.
FAQ
AI에게 키는 무시하라고 하면 되지 않나요?
요청을 보내는 순간 키는 이미 내 컴퓨터를 떠났습니다. 텍스트는 먼저 제공자의 서버에 도착해 그 보관 정책에 따라 저장되고, 모델은 그다음에야 지시를 읽습니다. 이 도구의 감지는 고정된 정규식과 엔트로피 검사로만 이루어지며, 모두 브라우저 안에서 실행되고 요청을 보내지 않습니다. AI가 받는 것은 마스킹 후 직접 복사해 붙여 넣은 텍스트뿐입니다.
입력한 내용이 업로드되거나 저장되나요?
아니요. 페이지는 입력 텍스트를 담은 요청을 보내지 않고 localStorage, sessionStorage, 쿠키, URL에도 기록하지 않습니다. 이 페이지는 분석 스크립트나 광고 스크립트도 불러오지 않습니다. 플레이스홀더 매핑은 메모리에만 있으며 지우기, Ctrl/Cmd+L, 새로고침, 탭 닫기로 사라집니다.
어떤 키와 토큰을 감지하나요?
Anthropic, OpenAI 등 sk-로 시작하는 AI 서비스 키와 Hugging Face, AWS, Google, GitHub, GitLab, Slack, Stripe, SendGrid, npm, PyPI, Telegram 키를 형식으로 감지합니다. 그 밖에 JWT, Bearer·Basic 인증 헤더, PEM 개인 키 블록, postgres://user:pass@host처럼 URL에 든 비밀번호, password·secret·token·api_key 등으로 끝나는 이름에 할당된 값, 무작위로 보이는 긴 문자열도 가립니다. 대상은 자격 증명뿐이며 이메일, 호스트 이름, IP 주소는 그대로 둡니다.
네이버·카카오·토스페이먼츠 키도 가려지나요?
네이버의 X-Naver-Client-Secret, 이름이 api_key나 secret으로 끝나는 카카오·토스페이먼츠 키, 토스페이먼츠가 쓰는 Authorization: Basic 헤더는 가려집니다. 카카오 REST API의 Authorization: KakaoAK 헤더도 인증 방식 이름 KakaoAK로 감지합니다.
AI가 플레이스홀더를 바꾸면 복원이 안 되나요?
대소문자 변경, 대괄호 안 공백, Markdown으로 이스케이프된 대괄호는 복원합니다. 대괄호가 빠진 SECRET_1은 환경 변수 이름과 구별할 수 없어 그대로 둡니다. 매핑에 없는 플레이스홀더, 즉 AI가 지어낸 것은 복원 칸 아래에 따로 표시합니다.
왜 제 시크릿이 감지되지 않았나요?
줄바꿈으로 나뉜 값, 변수명 없는 16진수 전용 토큰, 알려진 접두사도 변수명도 없는 32자 미만의 키는 감지하지 않습니다. 16진수를 제외한 이유는 CI 로그의 커밋 SHA와 체크섬이 실제 결과를 묻어 버리지 않게 하기 위해서입니다. MY_SERVICE_TOKEN=처럼 이름을 붙이면 감지됩니다.