Skill: andyxinweiminicloud/agent-card-signing-auditor (version 1.0.0)

--- name: agent-card-signing-auditor description: > Helps audit Agent Card signing practices in A2A protocol implementations. Identifies missing signatures, weak signing schemes, and revocation gaps that allow impersonation in agent-to-agent trust handshakes. version: 1.0.0 metadata: openclaw: requires: bins: [curl, python3] env: [] emoji: "🪪" --- # A2A Says Signing Is Optional. That's the Problem. > Helps identify gaps in Agent Card signing that allow impersonation, identity spoofing, and unverifiable capability claims in agent-to-agent trust handshakes. ## Problem The A2A Protocol specifies Agent Cards as the primary mechanism for agent identity and capability advertisement. An Agent Card tells other agents: who you are, what you can do, and what trust level you claim. But the A2A spec makes signing optional — "recommended but not required." In an ecosystem where 15-18% of published skills are already confirmed malicious, optional signing means any agent can present any identity and any capability claim with zero verifiable proof. The trust handshake that underpins all A2A interactions is built on a foundation that most implementations don't verify. ## What This Checks This auditor examines Agent Card signing practices across five dimensions: 1. **Signature presence** — Does the Agent Card include a signature field? Many implementations omit it entirely, relying on the marketplace's account verification as a trust proxy. That's a single point of failure — marketplace accounts can be compromised or impersonated 2. **Signing scheme strength** — If a signature is present, which algorithm was used? RSA-1024 and ECDSA with weak curves are no longer adequate for high-stakes agent interactions. Checks against current recommendations (Ed25519, RSA-2048+ with PSS padding) 3. **Key transparency** — Is the signing key published in a verifiable key transparency log or JWKS endpoint? A signature is only as trustworthy as the process by which you obtained the public key to verify it 4. **Revocation mechanism** — Does the signing infrastructure include a revocation path? Signing keys get compromised. An Agent Card signed with a compromised key looks identical to a legitimately-signed one without revocation checking 5. **Rotation audit trail** — Has the signing key changed? When? With what announcement? Key rotation events that coincide with capability changes or that happen without public announcement are higher-risk than routine scheduled rotations ## How to Use **Input**: Provide one of: - An Agent Card JSON object to audit directly - An agent endpoint URL to fetch and audit the Agent Card - A set of Agent Card snapshots to compare for rotation events **Output**: A signing audit report containing: - Signature presence and scheme assessment - Key transparency verification result - Revocation mechanism check - Rotation history (if available) - Risk rating: STRONG / ADEQUATE / WEAK / UNSIGNED - Specific recommendations for remediation ## Example **Input**: Audit Agent Card for `data-processing-agent.example` ``` 🪪 AGENT CARD SIGNING AUDIT Agent: data-processing-agent.example Card version: 2.1.0 Audit timestamp: 2025-03-15T10:30:00Z Signature presence: ⚠️ ABSENT Agent Card contains no signature field Identity claim is unverifiable — relies entirely on marketplace account trust Risk: any agent can claim this identity or capabilities without detection Signing scheme: N/A (unsigned) Key transparency: ✗ NOT CONFIGURED No JWKS endpoint referenced in Agent Card No key transparency log entry found Revocation mechanism: ✗ NONE No revocation endpoint specified No CRL or OCSP equivalent configured Rotation history: N/A Risk rating: UNSIGNED This Agent Card makes identity and capability claims that cannot be cryptographically verified. In a trust-sensitive interaction, treat all capability claims as unverified assertions. Recommended actions: 1. Implement Ed25519 signing for Agent Card with JWKS endpoint 2. Register signing key in a public key transparency log 3. Add revocation endpoint to Agent Card metadata 4. Establish rotation policy with public announcement process ``` ## Related Tools - **publisher-identity-verifier** — Audits publisher identity at the marketplace level; signing auditor checks the A2A protocol layer - **trust-decay-monitor** — Tracks trust freshness over time; signing provides the baseline trust claim that decays - **protocol-doc-auditor** — Checks documentation trust signals; Agent Card signing is the machine-readable equivalent - **attestation-chain-auditor** — Validates the full trust chain from signing key to capability claim ## Limitations This auditor evaluates signing practices based on publicly observable Agent Card metadata. It cannot assess the security of key storage practices on the agent's host system, verify that the private key holder is actually the claimed agent, or detect signing key compromise that has not yet been publicly disclosed. A well-formed signed Agent Card with strong cryptography can still represent a compromised or malicious agent — signing establishes identity, not trustworthiness. Use in combination with behavioral analysis tools for comprehensive trust assessment.


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: clean (LOW)