What is AgentSecrets?
The Zero-Knowledge Difference
How AgentSecrets Works
Installation
Quick Start
Migrating from .env Files
Migrating from Vault / AWS
Migrating from dotenv-vault
Production Checklist
Credential Exposure
What Zero-Knowledge Means
The Proxy Model
The Three-Layer Model
Environments
Agent Identity
Storage Modes
The No get() Principle
Secret-Level Policies
Cloud Overview & Architecture
The Dual-Engine Model
Cloud Resolver Data Plane
Workload & Agent Tokens
Egress Allowlists & Audit Streams
Cloud REST API Reference
Account (init / login)
Server & Self-Hosting (server)
Docs
Shell Autocompletion
Keychain Auth
Secrets
Environments
Credential Proxy
env Injection
Workspaces & Teams
Projects
Agent Identity
Audit & Governance
Integrations Overview
Claude Desktop
Cursor
OpenClaw
HTTP Proxy (Any)
LangChain (Soon)
CrewAI (Soon)
CI/CD Pipeline
SDK Overview
Python SDK
Python API Reference
Python SDK Manual Testing
JavaScript SDK (Soon)
Ecosystem Overview
Zero-Knowledge MCP Server
Server Overview
5-Layer Architecture
Self-Hosting Guide
Authentication & Keys
Workspaces & Teams
Projects & Scope
Environments
Secrets & Sync Protocol
Agent Identity Resolution
Telemetry & Metrics Engine
Audit Log Sync
API Endpoint Reference
Security Overview
Anti-Impersonation & Process Verification
Encryption Model
Zero-Knowledge Sync
Proxy Security Layers
Threat Model
OWASP Top 10 Mitigation
Security FAQ
Third-Party Audit
Reporting Vulnerabilities
Guides Overview
Building on the SDK
Stripe Integration
OpenAI Integration
Multi-Agent Setup
Onboarding Team
CI/CD Pipeline
Publishing ZK MCP
Rotating Credentials
Auditing Team Activity
Dev to Production
Kubernetes Deployment
Monorepo Setup
Production Proxy Hardening
vs .env Files
vs HashiCorp Vault
vs AWS Secrets Manager
vs dotenv-vault
vs Infisical
When Not to Use
Proxy Not Starting
Proxy Not Resolving
Domain Blocked
Sync Conflicts
MCP Not Connecting
Session Token Errors
Proxy Session Authorization
Keychain Storage & Backends
SSRF & Destination Rules
Installation Issues
Error Codes Reference
Frequently Asked Questions
v3.1.x
v3.0.0
v2.1.0
v2.0.0
v1.4.0
v1.3.x
v1.2.0
v1.1.x
v1.0.x
TroubleshootingProxy Not Resolving

Proxy Not Resolving Secrets

If your AI agent's outbound requests are failing due to missing or invalid authentication, it means the AgentSecrets proxy is successfully receiving the request but failing to resolve and inject the secret.


1Missing or Incorrect Injection Headers

The HTTP Proxy relies on X-AS-Inject-* headers to know which secret to resolve from the keychain and where to inject it in the destination request.

If you pass the wrong secret name, the proxy will not resolve it. Ensure your request includes the correct header formatting:

# Example: Injecting the secret named "STRIPE_KEY" as a Bearer token curl -s http://localhost:8765/proxy \ -H "X-AS-Inject-Bearer: STRIPE_KEY" \ -H "X-Target-Url: https://api.stripe.com/v1/charges"

The secret name must exactly match the name in your active environment. Runagentsecrets secrets list to verify the exact key names available in your local keychain.


2Secret Not Present in Active Environment

AgentSecrets partitions secrets by environment (development, staging, production). If your proxy is running in the development environment, but the secret was only added to production, the proxy will not find it.

Check your current environment and available keys:

agentsecrets project info agentsecrets secrets list

3Cryptographic Revocation

If a key was recently revoked by a team member, the proxy's 10-second background sync cycle will pull down the revocation. The proxy will then intentionally blackhole any request attempting to use that key.

To verify if a key was revoked:

agentsecrets proxy logs --secret STRIPE_KEY

Look for action: revoked_key_blocked in the logs.


4MCP Tool Configuration

If you are using the Model Context Protocol (MCP) server instead of the raw HTTP proxy, ensure the AI agent is calling the api_call tool with the correct payload structure. The injections map must reference valid local keys:

{ "url": "https://api.github.com/user", "method": "GET", "injections": { "bearer": "GITHUB_PAT" } }

5Domain Allowlist Interference

If the target domain is not allowlisted, the proxy halts execution before attempting to resolve the secret. This will result in a 403 Forbidden rather than a missing injection. See Fixing Domain Blocked Errors for more details.

Was this helpful?
Thanks for your feedback!
Your feedback helps us improve the platform.