返回资讯中心
外部精选
软件工程
#开发者实时流

AgentShield 发布零依赖密钥脱敏与 Shell 防火墙,拦截 Claude 等编码代理泄露密钥

来源标题:Show HN: AgentShield Zero-dep secret redactor and shell firewall for Claude

AgentShield 是一款面向 Claude Code、Cursor、Windsurf 等自主编码代理的零依赖安全工具,可在命令执行和输出阶段拦截 .env 文件读取、环境变量导出等密钥泄露行为,并过滤 stdout/stderr 中的敏感信息。官方称其脱敏延迟低于 20 微秒(P99),10,000 次调用基准下每秒可处理 149k+ 次操作,且默认完全本地运行、无需联网。

Hacker News 最新RitualDev2026/11/18 · 今天30 分钟阅读

以下正文同步自 Hacker News 最新,版权归原站所有,已转换为易读排版。

Stop Claude Code, Cursor, Windsurf, and autonomous coding agents from leaking .env secrets, SSH keys, or running destructive shell commands.

Zero runtime dependencies. 100% local & air-gapped by default. <20 µs P99 redaction across 10,000-call benchmarks (149k+ ops/sec).

npx @ritualdev-lab/agentshield demo

$ npx @ritualdev-lab/agentshield exec "cat .env && printenv" [AgentShield] BLOCKED: Direct credential file read & environment dump (.env / printenv)

$ node print-config.js | npx @ritualdev-lab/agentshield stream {"db":"[AGENT_SHIELD:DATABASE_URL:9f3a12]","token":"[AGENT_SHIELD:GITHUB_TOKEN:4c8e19]"}

Want to record a fresh 15-second terminal GIF? Run vhs assets/demo.tape with Charm VHS.

Autonomous coding agents have direct access to your shell, filesystem, and git repo. Even well-behaved agents routinely run cat .env, printenv, node -e 'console.log(process.env)', or commit live test keys into PRs—leaking raw credentials into third-party model APIs and git history.

AgentShield intercepts commands and stdout/stderr before credentials leave your machine:

Think you can bypass our .env / /proc/self/environ blocker or split a secret across stream chunks without triggering redaction?

npx @ritualdev-lab/agentshield bounty-verify "your-payload-here"

If you find a bypass, open an issue with your repro—every confirmed bypass gets a regression test and credit in the repo. Check THREAT_MODEL.md for exact scope and honest OS isolation limits.

Quick Start · Full Guide · Threat Model · Examples (Claude Code, LangGraph, E2B/Daytona) · GitHub Action

1. Diagnose your OS sandbox (Seatbelt / bwrap / Landlock / AppContainer)

npx @ritualdev-lab/agentshield doctor

2. Install a git pre-commit secret leak gate

npx @ritualdev-lab/agentshield hook install

3. Generate Claude Code PreToolUse or Cursor hooks

npx @ritualdev-lab/agentshield init-claude npx @ritualdev-lab/agentshield init-cursor

4. Wrap any agent shell command safely

npx @ritualdev-lab/agentshield exec "cat .env"

🚀 Key Defense Layers

🛡️ 1. Autonomous Agent Shell Sandbox & OS Isolation Boundary

Intercept and sandbox agent terminal execution. If an agent tries to read .env, dump shell variables (printenv), or send keys to outbound endpoints, AgentShield blocks it on the fly:

npx @ritualdev-lab/agentshield exec "cat .env"

🚨 [AgentShield Sandbox Block] Blocked attempt to read raw .env or private credential file.

Protected credentials from entering agent LLM context window!

OS Isolation Guarantees & Defense-in-Depth Boundary

Important

Defense-in-Depth vs OS Security Boundary: Userland command inspection (AST parsing and regex heuristics) is defense-in-depth designed to prevent accidental exfiltration and common script bypasses. It is not an OS kernel security boundary. Arbitrary compiled binaries or direct kernel syscalls require true OS-level containerization.

By default, requesting kernel sandboxing on non-macOS hosts logs an isolation warning and runs under the defense-in-depth AST firewall. To fail-closed and refuse execution whenever OS-level kernel isolation cannot be guaranteed:

Refuse execution if the host cannot enforce true OS kernel isolation

npx @ritualdev-lab/agentshield exec "npm test" --require-isolation

🛑 [AgentShield Isolation Refusal] Execution refused: requireIsolation is enabled, but OS-level kernel isolation is unavailable on host (win32). Refusing to silently downgrade to process-level firewall.

In the TypeScript SDK:

const result = await interceptor.execute(command, { enableKernelSandbox: true, requireIsolation: true, // Fails closed instead of silently downgrading });

🚦 2. Git Pre-Commit Leak Shield

Catch leaked credentials before they enter git history. Audits staged diffs automatically:

Install once in your repo (native git hook)

npx @ritualdev-lab/agentshield hook git-install

Or manually audit staged files

npx @ritualdev-lab/agentshield hook check

Or using the standard pre-commit framework (.pre-commit-config.yaml):

repos:

🐙 3. CI/CD Security Gate & GitHub Action

Block pull requests that introduce exposed credentials into your codebase:

name: AgentShield Security Gate on: [pull_request, push]

jobs: secret-audit: runs-on: ubuntu-latest steps:

  • uses: actions/checkout@v4 with: fetch-depth: 0
  • uses: RitualDev-Lab/AgentShield@v1 with: fail_on_leak: "true"

Or run via CLI in any CI container:

npx @ritualdev-lab/agentshield ci --base origin/main --report security-report.md

📋 4. Scope-Honest Secret-Control Assessment

Assess files and workspace streams against technical secret-handling controls in standard frameworks (SOC 2, PCI-DSS, HIPAA, ISO 27001):

npx @ritualdev-lab/agentshield compliance .env

📋 [SECRET-CONTROL ASSESSMENT] Status: NO_FINDINGS_IN_ASSESSED_CONTROLS (Assessed Controls Score: 100%) ℹ️ Scope: Technical secret detection, real-time streaming token redaction, and CLI command firewall. ⚠️ Disclaimer: Notice: This report reflects only the results of automated secret detection across assessed technical controls ('NO_FINDINGS_IN_ASSESSED_CONTROLS'). It does NOT establish overall organizational SOC 2, HIPAA, PCI-DSS, or ISO 27001 compliance. Overall compliance requires an accredited third-party audit firm, administrative governance, physical safeguards, and operational policies.

Assessed Controls: ✅ [SOC2] CC6.1: Logical Access Controls & Credential Integrity ✅ [SOC2] CC6.6: Boundary Protection & Unauthorized Egress Controls ✅ [PCI_DSS] Req-3.4: Protection of Authentication & Payment Gateway Secrets ✅ [PCI_DSS] Req-8.3: Strong Authentication Credential Management ✅ [HIPAA] §164.312(a)(1): Technical Safeguards - Access Control & Authentication ✅ [ISO27001] A.8.28: Secure Coding & Secret Management ✅ [ISO27001] A.8.24: Use of Cryptography & Key Protection

Broader Controls (Not Assessed by Secret Scanning): ⏸️ [SOC2] CC1.1: Integrity & Ethical Values (Governance) (NOT ASSESSED) ⏸️ [SOC2] CC5.2: Risk Assessment & Vendor Management (NOT ASSESSED) ⏸️ [PCI_DSS] Req-9.1: Physical Access Restrictions (NOT ASSESSED) ⏸️ [HIPAA] §164.308(a)(1): Administrative Safeguards (NOT ASSESSED) ⏸️ [ISO27001] A.5.1: Policies for Information Security (NOT ASSESSED)

🔐 5. Zero-Trust In-Memory Surrogate Injection

Instead of cleartext .env keys, AgentShield provides deterministic, collision-resistant surrogate tokens ([AGENT_SHIELD:ID:hexHash]). Agents can safely manipulate configurations and inspect outputs without ever seeing the plaintext secret in prompt history, rehydrating values locally when required.

AgentShield provides 1-command generators for leading AI coding agent environments:

Automatically intercept agent terminal executions before commands touch your environment:

npx @ritualdev-lab/agentshield init-claude

Generates .claude/settings.json configured with:

{ "hooks": { "PreToolUse": [ { "matcher": "Bash|Terminal", "command": "npx @ritualdev-lab/agentshield exec --claude-hook" } ] } }

Note: Claude Code delivers tool call payloads via stdin JSON. AgentShield inspects the payload in real-time and cleanly returns exit code 2 to halt unauthorized commands before execution.

npx @ritualdev-lab/agentshield init-cursor

Generates .cursor/rules.json with sensitive path boundaries (.env*, .pem, id_rsa) and pre-execution command sandboxing.

Plug SKILL.md into workspace agent instructions to enforce zero-leak guarantees natively.

Traditional scanners (gitleaks, trufflehog) were designed for post-facto static git repository scanning (scanning files and commit histories at rest).

AgentShield is designed specifically for Autonomous Agent Runtime Protection — intercepting shell commands, scrubbing streaming stdio chunk-by-chunk in sub-milliseconds, and sanitizing LLM prompt inputs before transmission.

AgentShield combines high-performance regular expressions with Shannon Entropy to catch both structured keys and arbitrary high-entropy passwords:

AgentShield provides first-class, idiomatic SDKs across multiple languages:

Works in pure-Python without requiring Node.js, with built-in LangChain/LangGraph callbacks:

from agentshield import AgentShieldEngine, AgentShieldCallbackHandler from langchain_openai import ChatOpenAI

shield = AgentShieldEngine() redacted = shield.scan_and_redact("Query database with sk-proj-placeholder-token") print(redacted["sanitizedText"])

"Query database with [AGENT_SHIELD:AI:7b3a4f1c]"

Attach to LangChain to protect prompt inputs automatically:

llm = ChatOpenAI(callbacks=[AgentShieldCallbackHandler()])

🦫 Go SDK (sdks/go)

import "github.com/RitualDev-Lab/agentshield/sdks/go"

client, _ := agentshield.NewClient(ctx) defer client.Close()

res, _ := client.ScanAndRedact(ctx, "Stripe secret sk_live_placeholder_token") fmt.Println(res.SanitizedText)

🦀 Rust SDK (sdks/rust)

use agentshield::AgentShieldClient;

let client = AgentShieldClient::new()?; let res = client.scan_and_redact("My token is ghp_placeholder_token")?; println!("Sanitized: {}", res.sanitized_text);

⚡ Language-Agnostic Stdio Sidecar Daemon

Any language can interact with AgentShield via line-delimited JSON-RPC 2.0:

npx @ritualdev-lab/agentshield sidecar

{"jsonrpc": "2.0", "id": 1, "method": "shield.scanAndRedact", "params": {"text": "My API key is sk-proj-placeholder"}}

Response:

{"jsonrpc":"2.0","id":1,"result":{"hasSecrets":true,"sanitizedText":"My API key is [AGENT_SHIELD:AI:...]","findings":[...]}}

🧩 Programmatic TypeScript SDK

Integrate AgentShield directly into your AI workflows, proxy servers, or custom agent frameworks:

import { AgentShieldEngine, AgentCommandSandbox, AgentStdioInterceptor } from "@ritualdev-lab/agentshield";

const shield = new AgentShieldEngine();

// Scan and redact unmasked credentials from LLM prompt inputs const rawPrompt = Run tests with OPENAI_API_KEY=${mySecretToken}; const result = shield.scanAndRedact(rawPrompt);

console.log(result.hasSecrets); // true console.log(result.sanitizedText); // "Run tests with OPENAI_API_KEY=[AGENT_SHIELD:OPENAI_API_KEY:c2stcH]"

// Deterministically rehydrate when receiving LLM response back locally const original = shield.rehydrate(result.sanitizedText);

Live Documentation: https://agentshield.ritualdev.in/

Bug Bounty Program: Read our SECURITY.md for rewards ($50 – $500).

Open Governance Charter: Read our GOVERNANCE.md for project stewardship.

Grant Applications: Review our GRANTS.md dossier for NLnet, OpenSSF & Mozilla.

Contributing: Check out CONTRIBUTING.md to add new secret patterns.

👥 Team & Contributors

AgentShield is initiated and maintained by the team at RitualDev Lab and protected by the global AI security research community.

Divyanshu Jethi

🚀 Founder & Lead

🔑 Direct Access Admin

Sakshi Sharma

🎨 Core Maintainer & Product

🔑 Direct Access Admin

RitualDev

⚙️ Core Maintainer & Infra

🔑 Direct Access Admin

Divyanshu-hub-dotcom

🛠️ Core Member

Ayush

🛡️ Core Maintainer & Triage

💖 Sponsor & Support via Dodo Payments

AgentShield is 100% open-source and Apache-2.0 licensed. Your sponsorship directly funds multi-platform OS sandbox testing rigs (Linux Landlock, macOS Seatbelt, Windows AppContainer), automated security regression suites, and cloud runner hours.

⚡ 1-Click Dodo Payments Checkout  •  🎁 Interactive Donation Form (USD & INR UPI)  •  ❤️ GitHub Sponsors

🔒 Zero physical shipping required. Powered by Dodo Payments (Merchant of Record) with instant tax invoice and global payment methods (Cards, UPI, Apple Pay).

ciperx

📜 OWASP ATLAS & AEO (PR #8)

Voyagerroc-Lab

🔒 Security & Rules Contributor

Huge thanks to all our open-source Contributors!

正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。

打开原文
去社区讨论 →