crypto-key-guard은(는) 무엇을 하나요?
텍스트에서 암호화폐 개인키와 시드 구문을 감지, 수정 및 차단합니다. 민감한 비밀 정보가 LLM, AI 에이전트, 로그 및 외부 서비스로 유출되는 것을 방지합니다.
개요
이 스킬은 AI 에이전트가 처리하는 텍스트 콘텐츠 내에서 암호화폐 개인키(Bitcoin, Ethereum, Solana 등)와 BIP39 시드 구문을 식별합니다. 감지된 비밀은 다음을 통해 보호됩니다:
- 수정(Redact): 개인키를
[REDACTED_KEY]또는[REDACTED_SEED]로 대체 - 차단(Block): 민감한 내용이 포함된 작업을 중단하고 경고 메시지 반환
- 로깅(Log): 보안 감사 로그에 경고 기록
지원 플랫폼
- Claude Code
- Cursor
- Codex
- 기타 AI 에이전트 프레임워크
작동 방식
- 텍스트 스캔: 사용자 프롬프트, 파일 내용, 코드 조각 등을 실시간으로 스캔
- 패턴 매칭: 알려진 개인키 형식(16진수, Base58, Base64 등)과 시드 구문 패턴을 정규 표현식으로 감지
- 엔트로피 검사: 난수 생성 키의 높은 엔트로피 값을 확인하여 위양성(false positive) 최소화
- 조치 실행: 설정에 따라 수정, 차단, 또는 경고 로그 기록
사용 예시
# AI 에이전트 컨텍스트 내에서 자동 실행
from crypto_key_guard import guard_text
user_input = "내 이더리움 개인키는 0xabc123... 입니다"
safe_input = guard_text(user_input)
# 출력: "내 이더리움 개인키는 [REDACTED_KEY] 입니다"
환경 변수
| 변수명 | 설명 | 기본값 |
|---|---|---|
CRYPTO_KEY_GUARD_ACTION | 감지 시 조치 (redact, block, log) | redact |
CRYPTO_KEY_GUARD_NETWORKS | 감지할 네트워크 목록 (쉼표로 구분) | all |
설정
{
"action": "block",
"networks": ["bitcoin", "ethereum", "solana"],
"entropy_threshold": 3.5
}
주의사항
이 스킬은 추가 보안 계층을 제공하지만, AI 에이전트 환경에서 개인키를 절대 공유하지 않는 것이 최선의 보안 방법입니다. 이 스킬은 인간의 판단을 대체할 수 없습니다.