← 返回 Skills 市场
daririnch

DCL Secret Leak Detector

作者 Dari Rinch · GitHub ↗ · v1.0.1 · MIT-0
cross-platform ✓ 安全检测通过
98
总下载
0
收藏
0
当前安装
2
版本数
在 OpenClaw 中安装
/install dcl-secret-leak-detector
功能描述
Instruction-only runtime secret and credential leak detector for AI agents and LLM pipelines. Catches API keys, tokens, private keys, database URLs, and .env...
使用说明 (SKILL.md)

DCL Secret Leak Detector — Leibniz Layer™

Publisher: @daririnch · Fronesis Labs
Version: 1.0.0
Part of: Leibniz Layer™ Security Suite


What this skill does

DCL Secret Leak Detector scans AI agent outputs, tool results, and pipeline data for exposed secrets and credentials — before they reach users, logs, or downstream systems.

This skill is 100% instruction-only. No text is sent to any external server. No webhook is called. The entire analysis runs inside the agent's context window using the detection checklist below. The scanned text never leaves the agent.

Every detection produces a deterministic dcl_fingerprint — a self-contained audit proof compatible with the Leibniz Layer™ chain.

What gets detected

Category Pattern class
api_key Provider-prefixed keys: OpenAI, Anthropic, Stripe, GitHub, Slack patterns
cloud_credential AWS access key IDs, GCP service account fragments, Azure client secrets
token Bearer tokens, JWT strings, OAuth access tokens, high-entropy credential-context strings
private_key_pem PEM header/footer blocks for any private key type
database_url Connection strings with embedded credentials: proto://user:pass@host
connection_string ADO.NET, ODBC, SQLAlchemy strings containing password fields
env_assignment .env-style lines where variable name matches known secret patterns
webhook_secret Signed secrets for Stripe, GitHub, Twilio webhook endpoints
internal_endpoint URLs containing API keys or tokens as query parameters

How to run a scan

The user provides text to scan directly in the conversation — model output, tool result, generated code, retrieved document chunk, or any pipeline data. This skill makes no network requests and does not transmit content anywhere.

Step 1 — Confirm content is in context

Verify the text to scan is present in the conversation. If not provided, ask the user to paste it.

Step 2 — Compute content fingerprint

content_hash = SHA-256(raw text submitted for scanning)

Record this as the immutable identifier for this scan event.

Step 3 — Run the detection checklist

Work through every category in the Detection Checklist below. For each match found, record:

  • type — which category triggered
  • provider — which service the credential belongs to (if identifiable)
  • position — approximate character offset in the text
  • redacted_sample — masked version showing only first 2 and last 4 chars
  • severitycritical, major, or minor

If no patterns match a category, mark it CLEAR.

Step 4 — Apply verdict logic

Condition Verdict
Any finding at any severity NO_COMMIT
No findings COMMIT

Any detected secret, regardless of severity, results in NO_COMMIT. Secrets have no safe threshold.

Step 5 — Compute DCL proof

analysis_content  = verdict + all findings serialized + timestamp
analysis_hash     = SHA-256(analysis_content)
dcl_fingerprint   = "DCL-SLD-" + date + "-" + content_hash[:8] + "-" + analysis_hash[:8]

Detection Checklist

Work through each item. Mark CLEAR or record finding with redacted evidence.

S1 — API Keys (Critical)

  • Short prefix followed by 20+ alphanumeric chars matching known provider key formats
  • Live payment key prefixes (distinct from test/publishable key prefixes)
  • Version control platform personal access token prefixes
  • Messaging platform bot/user token prefixes
  • Email delivery platform key prefixes
  • Communications platform account SID patterns

S2 — Cloud Credentials (Critical)

  • Cloud provider access key ID patterns (uppercase alpha + numeric, fixed length)
  • Cloud provider secret key context: high-entropy base64 string near credential field names
  • Service account JSON fragments: private key fields, client email fields
  • Client secret values in tenant/application ID combinations

S3 — Tokens & JWTs (Critical)

  • JWT pattern: three base64url segments separated by dots, first segment decodes to JSON header
  • Bearer token context: authorization header values or token field assignments with high-entropy values
  • High-entropy strings (40+ chars) appearing in credential assignment context

S4 — Private Keys (Critical)

  • PEM block opening markers: -----BEGIN + key type descriptor + -----
  • PEM block closing markers: -----END + key type descriptor + -----
  • Base64-encoded content between PEM markers

S5 — Database & Connection Strings (Critical)

  • URI with embedded credentials: protocol + :// + username + : + password + @ + host
  • Database protocols: postgres, mysql, mongodb, redis, amqp, and their variants
  • ORM/driver connection strings containing password parameter fields
  • Connection strings with User ID= and Password= or Pwd= fields

S6 — Environment Variable Assignments (Major)

  • Variable assignments where name contains: KEY, SECRET, TOKEN, PASS, PWD, CREDENTIAL, AUTH
  • Assignment format: VARNAME=value where value is non-trivial (not placeholder, not empty)
  • Shell export statements with credential variable names

S7 — Webhook & Signed URL Secrets (Major)

  • Webhook secret prefixes for known payment and developer platforms
  • Signed URL patterns where the signature or secret appears as a query parameter

S8 — Internal Endpoints with Auth (Minor → Major)

  • Internal hostnames (.internal, .local, .corp, .intra) with auth query parameters
  • Any URL where api_key=, apikey=, token=, secret=, or access_token= appears with a non-trivial value (Major)

Output schema

{
  "verdict": "COMMIT | NO_COMMIT",
  "risk_score": 0.0,
  "content_hash": "sha256:\x3C64-char hex>",
  "analysis_hash": "sha256:\x3C64-char hex>",
  "dcl_fingerprint": "DCL-SLD-2026-04-14-\x3Ccontent_hash[:8]>-\x3Canalysis_hash[:8]>",
  "detections": [
    {
      "type": "api_key",
      "provider": "identified provider name",
      "redacted_sample": "[PREFIX]-****...****[SUFFIX]",
      "position": 87,
      "severity": "critical"
    }
  ],
  "detection_count": 0,
  "categories_checked": ["S1","S2","S3","S4","S5","S6","S7","S8"],
  "categories_clear": ["S1","S2","S3","S4","S5","S6","S7","S8"],
  "timestamp": "2026-04-14T09:00:00Z",
  "powered_by": "DCL Secret Leak Detector · Leibniz Layer™ · Fronesis Labs"
}

detections is an empty array [] when verdict is COMMIT.


Secret Leak Detector vs DCL Sentinel Trace

These two skills are complementary, not competing. Run both.

DCL Sentinel Trace DCL Secret Leak Detector
Focus Personal identity data Technical credentials
Catches Emails, phones, SSNs, IBANs, card PANs API keys, tokens, private keys, DB URLs
Regulation GDPR, HIPAA SOC 2, ISO 27001, internal SecOps
Primary risk Privacy breach Security breach / credential compromise
External calls Via webhook None — instruction-only

A response can be PII-clean and still contain a live credential. Both checks are necessary for complete output coverage.


Where Secret Leak Detector fits in the DCL pipeline

Untrusted input
        │
        ▼
DCL Prompt Firewall          ← blocks malicious input
        │ COMMIT
        ▼
      LLM call
        │
        ▼
DCL Policy Enforcer          ← compliance & jailbreak check
        │ COMMIT
        ▼
DCL Sentinel Trace           ← PII redaction
        │ COMMIT
        ▼
DCL Secret Leak Detector     ← credential & secret scan (instruction-only)
        │ COMMIT
        ▼
DCL Output Sanitizer         ← final sweep: toxic, unsafe commands
        │ COMMIT
        ▼
DCL Semantic Drift Guard     ← hallucination & grounding check
        │ IN_COMMIT
        ▼
Safe to deliver

High-risk agent patterns

Coding agents — generate shell scripts, Dockerfiles, CI configs, Terraform. Common vector for hardcoded credentials appearing in generated output.

DevOps / infrastructure agents — read deployment configs, env files, Kubernetes secrets. May quote them verbatim in responses.

RAG pipelines over internal docs — internal wikis and runbooks routinely contain credentials left by engineers. Retrieved chunks can carry them into LLM context and outputs.

Tool-calling agents — an agent that calls an API internally may reproduce the key in its reasoning trace or final response.


Privacy & Data Policy

This skill is operated by Fronesis Labs and is 100% instruction-only.

No data leaves the agent. The text submitted for scanning is analyzed entirely within the agent's context window. No content is transmitted to any server — including Fronesis Labs infrastructure.

No retention. Nothing is stored, logged, or transmitted. The only artifact produced is the structured JSON output and dcl_fingerprint, which remain within the agent's session unless the caller saves them.

Detected secrets: Only redacted samples are included in output. Raw credential values are never reproduced in the result.

Full policy: https://fronesislabs.com/#privacy · Browse the full DCL Security Suite: hub.fronesislabs.com · Questions: [email protected]


Related skills

  • dcl-sentinel-trace — PII redaction and identity exposure detection
  • dcl-prompt-firewall — Input-layer injection and jailbreak detection
  • dcl-output-sanitizer — Final output sweep: toxic content, unsafe commands
  • dcl-secret-leak-detector-crypto — Specialist version for wallet keys, seed phrases, exchange credentials

Leibniz Layer™ · Fronesis Labs · fronesislabs.com

安全使用建议
This skill appears internally consistent and limited in scope, but review runtime and deployment controls before trusting it with sensitive production data: (1) The SKILL.md promises no network transmission, but your agent runtime or other enabled tools could still exfiltrate text — ensure the agent's connectors, tool permissions, and network egress are restricted as needed. (2) Test the detector on non-sensitive dummy secrets to validate false-positive/negative behavior and the redaction rules. (3) Confirm how and where agent logs are stored (the skill computes hashes and fingerprints that could be logged). (4) Because the skill is instruction-only and from an unknown source, prefer running it in an environment with minimal privileges and auditing enabled. If you need stronger guarantees, consider a vetted local implementation or review the detection logic integrated into your execution environment.
能力标签
cryptorequires-walletcan-make-purchasesrequires-oauth-token
能力评估
Purpose & Capability
The skill is an instruction-only secret/credential detector. It declares no installs, binaries, env vars, or credentials and its detection checklist and output (hashes, redacted samples, verdicts) align with that purpose.
Instruction Scope
SKILL.md gives a clear, bounded checklist: scan provided conversation text, compute SHA-256 hashes, classify matches, redact samples, and emit a deterministic fingerprint. It does not instruct reading unrelated files, other config paths, or sending data to external endpoints. (Caveat: the skill asserts 'no text leaves the agent'—that is an operational guarantee the runtime must enforce, not something the instruction file can technically enforce.)
Install Mechanism
No install spec or code files are present. Being instruction-only means nothing will be written to disk or downloaded by the skill itself.
Credentials
The skill requests no environment variables, credentials, or config paths. That is appropriate for an in-context scanner that operates on user-supplied text.
Persistence & Privilege
always is false and model invocation is default-enabled. The skill does not request permanent agent presence nor does it instruct modifying other skills or system-wide settings.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install dcl-secret-leak-detector
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /dcl-secret-leak-detector 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.1
**Summary:** 1.0.1 introduces an instruction-only mode — all secret detection runs entirely within the agent, with no external calls. - Now fully instruction-only: text never leaves the agent; no webhook or external server is used. - Detection produces a deterministic DCL audit proof (`dcl_fingerprint`) for every scan. - Updated detection checklist and output schema for in-agent operation and transparent results. - Audit logic and verdict system are now fully self-contained. - Improved agent safety and compliance for AI pipelines that require strict data residency.
v1.0.0
Initial release of DCL Secret Leak Detector — a runtime credential leak scanner and audit layer for AI agents and LLM pipelines. - Scans agent outputs, tool results, and pipelines for credentials like API keys, tokens, private keys, database URLs, .env values, and internal secrets. - Produces a tamper-evident audit proof for every detection, powered by Leibniz Layer™. - Returns detailed reports on detected secrets, including type, provider, redacted sample, severity, and risk score. - Offers endpoints for policy listing, audit chain verification, and health checks. - Designed as a specialist companion to DCL Sentinel Trace, focusing on technical secrets rather than PII. - Fits into LLM pipelines after PII checks and before content sanitization.
元数据
Slug dcl-secret-leak-detector
版本 1.0.1
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 2
常见问题

DCL Secret Leak Detector 是什么?

Instruction-only runtime secret and credential leak detector for AI agents and LLM pipelines. Catches API keys, tokens, private keys, database URLs, and .env... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 98 次。

如何安装 DCL Secret Leak Detector?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install dcl-secret-leak-detector」即可一键安装,无需额外配置。

DCL Secret Leak Detector 是免费的吗?

是的,DCL Secret Leak Detector 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

DCL Secret Leak Detector 支持哪些平台?

DCL Secret Leak Detector 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 DCL Secret Leak Detector?

由 Dari Rinch(@daririnch)开发并维护,当前版本 v1.0.1。

💬 留言讨论