dmno-dev/varlock

해결하는 문제

Varlock은 AI 에이전트에게 안전한 방식으로 환경 변수와 비밀 정보를 관리하는 문제를 해결합니다. 기존의 .env 파일은 종종 비밀 정보 유출을 초래하거나 예제 파일과 실제 값 간의 동기화가 부족한 문제를 겪습니다. Varlock은 스키마 기반 접근 방식을 도입하여 AI 에이전트가 실제 민감한 값을 보지 않고도 구성 요구 사항(유형, 유효성 검사, 설명)을 이해할 수 있도록 합니다.

작동 방식

@env-spec이라는 새로운 DSL을 사용하여 JSDoc 스타일의 주석을 통해 .env 파일에 스키마와 기능을 추가합니다. 이를 통해 개발자는 .env.schema 파일에서 단일 진실 공급원(Single Source of Truth)을 정의할 수 있습니다. 이 도구는 변수를 로드, 검증하고 해결된 변수로 프로세스를 실행하기 위한 CLI를 제공합니다. 또한 1Password, AWS, Azure, GCP와 같은 외부 백엔드에서 비밀 정보를 가져오는 플러그인 시스템을 갖추고 있으며, AI가 생성한 코드에서 유출된 비밀 정보를 감지하는 varlock scan 명령도 포함되어 있습니다.

대상 사용자

AI 통합 애플리케이션을 구축하는 개발자 및 팀으로, 비밀 정보를 보호하면서 AI 에이전트에게 필요한 컨텍스트를 제공하고 여러 환경에서 유형 안전성을 유지해야 하는 경우에 적합합니다.

주요 특징

• AI 안전 구성: 비밀 정보를 노출하지 않고 에이전트에게 변수 이름과 유형을 제공합니다.
• 비밀 정보 유출 방지: varlock scan을 통한 사전 예방적 스캔 및 로그 마스킹을 포함한 런타임 보호.
• 유형 안전성: VSCode 확장을 통해 유효성 검사, 강제 변환 및 IntelliSense 지원을 제공합니다.
• 확장 가능한 백엔드 지원: 주요 비밀 관리자(예: HashiCorp Vault, Infisical, 1Password)를 위한 다양한 플러그인 지원.
• 다중 환경 관리: .env.* 파일의 자동 로드 및 명시적 가져오기.