C
CIFP

Quick Start

Get your first proxy running in under 5 minutes.

This guide takes you from zero to a working CIFP proxy in under 5 minutes. You'll create a proxy, store your first secret, generate a credential, and make your first proxied request.

1

Create a proxy

Log in to the CIFP dashboard and click New Proxy. Give it a name, choose a region, and pick a mode:

  • Auto-auth — clients send Authorization: Bearer {$VAR} placeholders; CIFP fills in real values
  • Firewall — full TLS interception with per-request CEL rule evaluation

Or via API:

bash
curl -X POST https://cifp.vril.dev/api/proxies \
  -H "Authorization: Bearer cifp_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"name":"my-first-proxy","mode":"auto-auth","region":"sjc"}'
2

Store a secret

Copy your proxy ID from the dashboard (e.g. proxy-abc123def456), then store a secret. The value is encrypted and only accessible inside the proxy.

bash
curl -X POST https://cifp.vril.dev/api/proxies/proxy-abc123def456/secrets \
  -H "Authorization: Bearer cifp_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "OPENAI_API_KEY",
    "value": "sk-proj-your-real-openai-key",
    "description": "OpenAI production key"
  }'
3

Generate a proxy credential

Proxy credentials (username + password) are what your clients use to authenticate with the proxy itself. The plaintext password is only returned once on creation.

bash
curl -X POST https://cifp.vril.dev/api/proxies/proxy-abc123def456/credentials \
  -H "Authorization: Bearer cifp_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"description":"my-agent"}'

# Response:
# {
#   "username": "proxy-abc123def456-u1a2b3",
#   "password": "CIFPrand0mGeneratedPassword",
#   "id": "..."
# }

Save the password — it won't be shown again.

4

Make your first proxied request

Use the proxy URL and the credential you just generated. Send Authorization: Bearer {$OPENAI_API_KEY} — CIFP will replace it with the real key before forwarding.

bash
curl -x https://proxy-abc123def456.proxy.cifp.vril.dev:3128 \
  -U "proxy-abc123def456-u1a2b3:CIFPrand0mGeneratedPassword" \
  -H "Authorization: Bearer {\$OPENAI_API_KEY}" \
  -H "Content-Type: application/json" \
  https://api.openai.com/v1/models

CIFP resolves $OPENAI_API_KEY from its encrypted store and forwards the real key to OpenAI. Your agent never sees the real key.

That's it!

Your proxy is running and intercepting requests. Check the Access Logs tab in the dashboard to see the request flow.

Next Steps