Openclaw용 CredAgent 자격 증명 보호

CredAgent는 저장 시 암호화된 스토리지, FUSE 격리, SHA256 측정 프로그램 액세스를 통해 파일 기반 자격 증명을 보호합니다.

benson666
v0.2.0
Oct 13, 2026
0
138
0

설치 및 다운로드

1. ClawHub CLI

레지스트리에서 스킬을 바로 설치하는 가장 빠른 방법입니다.

npx clawhub@latest install credagent

2. 수동 설치

스킬 폴더를 다음 위치 중 하나로 복사하세요

글로벌
~/.openclaw/skills/
워크스페이스
<project>/skills/

우선순위: 워크스페이스 > 로컬 > 번들

3. 프롬프트 설치

이 프롬프트를 OpenClaw에 복사하면 자동으로 설치됩니다.

Clawhub를 사용해서 credagent 설치를 도와줘. Clawhub가 설치되어 있지 않다면 먼저 설치해 줘 (npm i -g clawhub).

다운로드를 원하시나요?

ZIP 아카이브 형태의 원본 스킬 파일을 받으세요.

CredAgent 자격 증명 보호란 무엇인가요?

CredAgent는 Openclaw 스킬을 위한 제로 트러스트 자격 증명 보호 스킬로, SSH 키, 클라우드 CLI 자격 증명, API 토큰, OAuth 쿠키 및 .env 파일과 같은 파일 기반 보안 파일들을 보호합니다. 원래 자격 증명 경로를 보호된 참조로 교체하는 동시에 복호화된 콘텐츠는 명시적으로 승인된 프로그램에만 제공합니다.

이 워크플로는 credctl 명령줄 인터페이스를 사용하여 특정 바이너리나 스크립트를 허용하고, 선택적으로 SHA256 측정을 검증하며, 열기 빈도를 제한하고, 쓰기 액세스를 제어합니다. 또한 필수적인 보안 경계를 강조합니다. 즉, 자격 증명 파일을 보호한다고 해서 쓰기 가능한 승인된 프로그램이나 그 종속성 트리가 안전해지는 것은 아닙니다.

CredAgent 자격 증명 보호 활용 사례

  • ~/.ssh/id_rsa와 같은 SSH 키를 승인되지 않은 도구 및 프로세스로부터 보호합니다.
  • AWS, Aliyun, Docker, Claude CLI 및기타 클라우드 또는 개발자 설정 파일을 차단합니다.
  • API 토큰, OAuth 쿠키, .env 보안 파일 및 기타 파일 기반 자격 증명을 승인된 프로그램으로 제한합니다.
  • /usr/bin/ssh와 같은 안정적인 시스템 바이너리에 대해 SHA256 무결성 검증을 필수로 지정합니다.
  • 변경 가능한 스크립트 및 종속성의 위험을 명시적으로 평가하면서 스크립트가 보안 파일에 액세스하도록 허용합니다.
  • Git 푸시 등의 작업 중에 프로세스가 보호된 자격 증명을 여는 빈도를 제한합니다.
  • 쓰기 가능한 OAuth 설정 또는 토큰 파일에 대한 제어된 업데이트를 허용합니다.
  • 기존 CredAgent 보호를 감사, 업데이트, 연결, 분리, 해제 또는 제거합니다.

CredAgent 자격 증명 보호 작동 원리

  1. credctl이 설치되어 있는지, CredAgent 디먼이 응답하는지, FUSE 차단 마운트가 사용 가능한지 확인합니다. 사전 조건이 실패하면 중지하고 CredAgent를 먼저 설치하십시오.
  2. ~/.ssh/, ~/.aws/, ~/.docker/, ~/.config/와 같은 일반적인 위치를 사용하여 보호할 자격 증명 파일을 식별합니다.
  3. 정확한 승인된 실행 파일을 식별합니다. 스크립트의 경우 인터프리터 대신 스크립트 경로를 사용하고, Git SSH 작업의 경우 git 대신 /usr/bin/ssh를 승인합니다.
  4. BASIC 전략, 승인된 프로그램 경로, 명시적 측정 설정 및 자격 증명 경로와 함께 credctl protect를 실행합니다.
  5. 프로세스별 액세스 제한을 위한 --open-frequency 및 업데이트해야 하는 자격 증명을 위한 --writable true와 같은 선택적 제어 항목을 설정합니다.
  6. 원본 경로가 보호된 객체를 가리키는지 확인한 다음, credctl list --json 및 credctl inspect를 사용하여 보호된 파일 인벤토리 및 정책 세부 정보를 검사합니다.
  7. 승인된 프로그램을 실행하고 CredAgent 로그를 검토하여 허용된 액세스를 확인합니다.
  8. 승인된 프로그램과 전체 디렉토리 트리에 대해 모든 사용자가 쓸 수 있는 파일, 쓸 수 있는 종속성, 안전하지 않은 설정, 심볼릭 링크 위험 또는 임포트 섀도잉 공격을 감사합니다.
  9. 합법적인 바이너리 업데이트 후 SHA256 측정을 새로 고치거나, 액세스 규칙을 변경하거나, 필요할 때 보호를 해제하여 시간에 따라 정책을 유지 관리합니다.

CredAgent 자격 증명 보호 설정 가이드

CredAgent는 별도의 필수 구성 요소이며 이 Openclaw 스킬과 번들로 제공되지 않습니다. root 권한과 FUSE가 필요하므로 사용자가 설치 명령을 검토하고 승인해야 합니다.

  1. 설치, 디먼 및 마운트를 확인합니다.
command -v credctl && credctl version
credctl list --json >/dev/null 2>&1 && echo OK
ls -d /mnt/credagent/shielded 2>/dev/null || ls -d /usr/local/var/credagent/shielded 2>/dev/null
  1. 확인에 실패하면 프로젝트 설치 문서를 사용하여 CredAgent를 설치하십시오. 지원되는 경로는 미리 빌드된 릴리스 tarball을 다운로드하고 sudo ./INSTALL을 실행하거나 Go를 사용하여 소스에서 빌드하는 것입니다. Linux 빌드는 CGO_ENABLED=0을 사용하고, macOS 빌드는 CGO_ENABLED=1을 사용하며 네이티브로 컴파일해야 합니다.

  2. 필요한 마운트, 소켓, 암호화된 기준선 및 설정 경로로 서비스를 한 번 부트스트랩합니다.

sudo credagent run --mount /mnt/credagent/shielded/ --socket-dir /run/credagent --baseline-file /var/lib/credagent/baseline.enc --config /usr/local/etc/credagent/engine/config.json --auto-init

준비되었다고 보고한 후 임시 포그라운드 프로세스를 중지하고, 시스템 서비스를 시작하고, sudo credagent init --config ...로 무작위로 생성된 관리자 비밀번호를 재설정합니다.

  1. credctl version이 성공하고 디먼이 응답한 후 자격 증명을 보호합니다. 측정 플래그는 v0.2.0에서 필수이며 true 또는 false여야 합니다.
credctl protect --strategy BASIC --program-permit /usr/bin/ssh --measure true --open-frequency 2 ~/.ssh/id_rsa
credctl protect --strategy BASIC --program-permit /path/to/script.py --measure false --open-frequency 1 /path/to/api-key.txt
credctl protect --strategy BASIC --program-permit /usr/bin/aliyun --measure true --writable true ~/.aliyun/config.json
  1. 결과를 확인하고 액세스 로그를 검사합니다.
ls -la <credential-file>
credctl list --json
credctl inspect <id>
sudo journalctl -u credagent --since "2 minutes ago" | grep permitted

플랫폼별 서비스 설정 및 권한 오류에 대해서는 설치, 명령 참조 및 문제 해결 문서를 사용하십시오.

CredAgent 자격 증명 보호 데이터 스키마 및 분류 체계

CredAgent는 원본 경로, 보호된 FUSE 객체 및 액세스 정책을 중심으로 보호된 자격 증명을 구성합니다.

데이터 요소 설명
원본 경로 ~/.ssh/id_rsa 또는 ~/.aws/credentials와 같은 사용자 대면 자격 증명 위치.
보호된 대상 내부 ID로 자주 참조되는 CredAgent 보호 마운트를 통해 노출된 보호된 객체.
경로 매핑 원본 경로가 보호된 객체에 대한 링크 또는 보호된 참조가 됩니다.
정책 전략 credctl이 사용하는 보호 전략으로, 일반적으로 BASIC.
프로그램 허가 자격 증명을 열도록 승인된 정확한 바이너리 또는 스크립트 경로.
SHA256 측정 허용된 프로그램에 대한 선택적 무결성 강제 적용; true는 측정된 바이너리를 검증하고 false는 검증을 건너뜁니다.
열기 빈도 반복되는 자격 증명 액세스를 제어하는 데 유용한 프로세스별 선택적 열기 제한.
쓰기 가능 상태 승인된 프로그램이 보호된 자격 증명을 업데이트할 수 있는지 여부; 읽기 전용이 기본값입니다.
인벤토리 메타데이터 credctl list --json은 기계 읽기 가능한 보호된 파일 기록을 제공합니다.
상세 메타데이터 credctl inspect <id>는 특정 보호된 파일에 대한 정책 및 객체 세부 정보를 노출합니다.

작업 파일 및 인프라에는 /var/lib/credagent/baseline.enc의 암호화된 기준선, /run/credagent의 디먼 소켓 디렉토리, /usr/local/etc/credagent/engine/config.json의 서비스 설정, 그리고 /mnt/credagent/shielded/ 또는 플랫폼별 동등한 위치의 FUSE 마운트가 포함됩니다. 이 스킬은 별도의 애플리케이션 데이터베이스를 생성하지 않으며, CredAgent가 보호된 객체와 정책 메타데이터를 유지 관리합니다.

CredAgent 자격 증명 보호 고급 기능

  • SHA256으로 측정한 실행 정책은 안정적인 승인된 바이너리의 변경 사항을 감지하는 데 도움이 됩니다.
  • PID별 --open-frequency 제한은 반복되거나예상치 못한 보안 파일 읽기를 줄여줍니다.
  • --writable true는 OAuth 토큰, 쿠키 및 순환 설정 파일에 대한 제어된 업데이트를 지원합니다.
  • JSON 인벤토리 출력을 통해 스크립팅, 감사 및 Openclaw 스킬 워크플로와의 통합이 가능합니다.
  • 정책 수명 주기 명령은 list, inspect, update, attach, detach, refresh, release 및 remove 작업을 지원합니다.
  • 보호된 자격 증명에 프로그램 경로를 연결하거나 분리하여 여러 승인된 프로그램을 관리할 수 있습니다.
  • 측정 새로 고침 워크플로는 보호된 객체를 버리지 않고 합법적인 바이너리 업그레이드를 수용합니다.
  • 보안 검토에는 전체 디렉토리 트리, 종속성 폴더, 설정 파일, 심볼릭 링크, Python 임포트 섀도잉 및 불변 파일 제어가 포함됩니다.
  • 이 워크플로는 자격 증명 보호와 프로그램 무결성을 명시적으로 분리하여 root 소유권, 모든 사용자가 쓸 수 있는 권한 제거, 버전 제어 확인 및 정기적인 감사를 권장합니다.
  • FUSE 기반 제공은 CredAgent 정책 시행을 통해 액세스를 제한하면서 보호된 보안 파일을 사용 가능한 경로에 유지합니다.

SKILL.md


로드 중

관련 Openclaw 스킬

METADATA

Github Stars: 0
forks: 0

추천*