코딩 에이전트(Coding agents)는 테스트를 실행하고, API를 호출하며, 인프라를 관리하고, 로컬 개발 도구와 함께 작업할 수 있습니다. 이러한 유용성은 결국 자격 증명(credentials) 문제와 충돌하게 됩니다.

일반적인 선택지들은 불편합니다. 프롬프트에 토큰을 붙여넣거나, 광범위한 환경 변수(environment variable)에 남겨두거나, 모든 하위 프로세스(subprocess)가 동일한 비밀 값(secret)을 상속받게 하는 방식입니다.

저는 에이전트와 자격 증명 사이에 로컬 승인 경계(approval boundary)를 설정하기 위해 s-gw를 구축했습니다.

에이전트에게 비밀 값이 아닌 핸들(handle)을 제공하세요

에이전트는 필요한 자격 증명을 식별하는 타입화된 핸들(typed handle)을 받습니다. 에이전트가 동작을 수행하려 할 때, s-gw는 로컬 검토를 위해 정확한 명령(command), 자격 증명, 환경 바인딩(environment binding), 작업 디렉토리(working directory), 정책(policy), 그리고 목적지를 보여줍니다.

에이전트는 원시 값(raw value)을 읽거나 보유하지 않고도 유용한 액세스 권한을 요청할 수 있습니다.

실행을 하나의 로컬 신뢰 루프(trust loop) 내에 유지하세요

승인 후, s-gw는 자격 증명을 로컬에서 해석(resolve)하여 하나의 제한된 자식 프로세스(child process)에 주입합니다. 명령은 승인된 범위(scope) 내에서 실행되며, 출력값은 에이전트에게 반환되기 전에 정화(sanitized)됩니다.

흐름은 다음과 같습니다:

1. 에이전트가 타입화된 핸들과 작업 요청을 보냅니다.
2. 정책 엔진(policy engine)이 요청을 검증합니다.
3. 사용자가 로컬에서 명령을 검토하고 승인합니다.
4. 자격 증명은 승인된 프로세스에만 들어갑니다.
5. 정화된 출력(Sanitized output)이 에이전트에게 반환됩니다.
6. 로컬 활동 로그(activity log)는 원시 비밀 값을 기록하지 않고 요청, 결정, 목적지를 기록합니다.

이것은 코딩 에이전트를 신뢰할 수 있게 만들기 위한 것이 아닙니다. 자격 증명 사용을 더 좁게 제한하고, 가시화하며, 취소 가능하게 만들기 위한 것입니다.

자격 증명이 어디에서 사용되고 있는지 확인하세요

로컬 사용 맵 (local usage map)은 에이전트를 인증 유형 (authentication types) 및 목적지와 연결합니다. 이는 다음과 같은 실질적인 질문에 답하는 데 도움을 줍니다: 어떤 에이전트가 AWS 키를 사용했는가? 어떤 대상이 가장 많은 자격 증명 기반 액션 (credentialed actions)을 받고 있는가? 오래된 핸들 (handle)이 여전히 활성화되어 있는가?

현재 상태 (Current status)

s-gw는 오픈 소스 프리뷰 (open source preview) 소프트웨어이며, 강화된 엔터프라이즈 비밀 관리 플랫폼 (hardened enterprise secrets platform)이 아닙니다. 현재 macOS가 주요 경로이며, Windows는 프리뷰 단계이고, Linux는 실험적 단계입니다.

npm에서 설치하세요:

npm install -g @s-gw/s-gw

저장소 (Repository): github.com/sgateway/s-gw

대화형 데모 (Interactive demo): s-gw.com

특히 API 토큰 (API tokens), SSH 키 (SSH keys), 클라우드 자격 증명 (cloud credentials), 로컬 MCP 도구 (local MCP tools) 또는 1Password를 사용하는 코딩 에이전트 사용자분들의 피드백을 소중히 받겠습니다. 에이전트에게 실제 자격 증명 사용을 허용하기 전에 어떤 기능들을 확인하고 싶으신가요?