Support: support@tinplate.dev · Zero-Retention Edge Security Support Trust Center DPA GitHub Issues
Security & Secrets Tier 2 All-Access

SSRF Protection & URL Validator API — Block Private IPs & Cloud Metadata

Validate URLs and redirect chains against SSRF, private IPs, and cloud metadata targets. Validate untrusted URLs before your AI agent or webhook fetcher requests them. Blocks RFC1918, loopback, IPv6 mapped, octal/decimal IPs, and cloud metadata.

Interactive Sandbox · No API Key Required 200 OK · Ready
POST /v1/ssrf-firewallinput
200 OK sample / live responsejson
{
  "ok": true,
  "data": {
    "allowed": false,
    "risk_level": "blocked",
    "advisory": true,
    "note": "Advisory pre-check and redirect inspector; DNS rebinding requires enforcing SSRF checks at your actual HTTP client / fetcher hop.",
    "static_check": {
      "allowed": false,
      "category": "link_local_metadata",
      "reason": "169.254.0.0/16 link-local / cloud metadata range is blocked",
      "normalized_url": null,
      "hostname": "169.254.169.254"
    },
    "dns_checked": false,
    "dns_ips": [
      "169.254.169.254"
    ],
    "blocked_dns_ips": [
      "169.254.169.254"
    ],
    "redirect_chain": []
  },
  "meta": {
    "request_id": "req_ssrf_01",
    "ms": 1
  }
}
OpenAPI 3.0.3 Get All-Access Key ($29/mo) No signup. No payload storage.
Quickstart Code Examples
curl -X POST "https://api.tinplate.dev/v1/ssrf-firewall" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TINPLATE_KEY" \
  -d '{"url":"http://169.254.169.254/latest/meta-data/iam/security-credentials/"}'
import { TinplateClient } from "@tinplate/sdk";

const tinplate = new TinplateClient({
  apiKey: process.env.TINPLATE_API_KEY!,
});

const { data, meta } = await tinplate.call("/v1/ssrf-firewall", {
  "url": "http://169.254.169.254/latest/meta-data/iam/security-credentials/"
});
console.log(`[${meta.ms} ms]`, data);
import requests

response = requests.post(
    "https://api.tinplate.dev/v1/ssrf-firewall",
    headers={
        "Content-Type": "application/json",
        "Authorization": "Bearer YOUR_TINPLATE_KEY",
    },
    json={
  "url": "http://169.254.169.254/latest/meta-data/iam/security-credentials/"
}
)
print(response.json())
const response = await fetch("https://api.tinplate.dev/v1/ssrf-firewall", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_TINPLATE_KEY",
  },
  body: JSON.stringify({
  "url": "http://169.254.169.254/latest/meta-data/iam/security-credentials/"
}),
});
const result = await response.json();
console.log(result);
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "tinplate_ssrf_firewall",
    "arguments": {
      "url": "http://169.254.169.254/latest/meta-data/iam/security-credentials/"
    }
  }
}
OpenAPI 3.0.3 Schema Contract

Request Parameters & Response Schema Reference

Request Body Parameters (POST /v1/ssrf-firewall)

ParameterType & ConstraintsDescription
url required string
minLen: 1, maxLen: 2048
Target URL to evaluate for SSRF risk.
check_dns optional boolean Resolve A/AAAA records via DoH and check resolved IPs (default true).
inspect_redirects optional boolean Follow redirects via private fetcher to inspect redirect chain (default false).

Response data Object Fields (200 OK)

FieldTypeDescription
allowed boolean Field 'allowed'
risk_level "safe" | "blocked" | "high_risk" Field 'risk_level'
advisory true Field 'advisory'
note string Field 'note'
static_check object Field 'static_check'
dns_checked boolean Field 'dns_checked'
dns_ips string[] Field 'dns_ips'
blocked_dns_ips string[] Field 'blocked_dns_ips'
redirect_chain object[] Field 'redirect_chain'

What Agent URL & SSRF Firewall API Detects & Validates

  • Blocks AWS/GCP/Azure/Alibaba cloud metadata endpoints (169.254.169.254, fd00:ec2::254, metadata.google.internal)
  • Catches RFC1918 private networks, loopback (127.0.0.0/8, ::1), CGNAT (100.64.0.0/10), and link-local ranges
  • Defeats parser bypasses: decimal/octal/hex IP encodings (0x7f000001, 2130706433), IPv4-mapped IPv6 (::ffff:127.0.0.1), nip.io/sslip.io wildcard DNS
  • Optional DNS resolution and redirect-chain inspection via isolated Fetcher Worker
Honest Engineering Boundaries

Known Limitations & Test Verification

Release: v1.0.39 · Verified: 16 November 2026 · Portfolio Median: 0.318 ms in-Worker V8 compute (add 15–65 ms HTTPS RTT) · See Full Portfolio Benchmarks →

  • Pre-flight URL and DNS validation mitigates SSRF risk, but Time-of-Check to Time-of-Use (TOCTOU) DNS rebinding requires pinning the resolved IP in your own HTTP client or using Tinplate's isolated fetcher.
  • Tested v1.0.4 (14 November 2026).

Direct All-Access & Marketplace Plans

Direct Polar All-Access Keys unlock all 42 APIs (49 endpoints), /v1/pipeline, and /mcp on api.tinplate.dev: Pro ($29/mo · 120 req/min · 100k/mo · 128 KB) or Team ($79/mo · 300 req/min · 500k/mo · 256 KB).

PlanMonthly PriceIncluded RequestsRate LimitMax PayloadBest For
BASIC$0.00 / mo500 / month10 req / min64 KBEvaluation & CI smoke tests
PRO$9.99 / mo15,000 / month60 req / min128 KBSolo devs & production apps
ULTRA$29.99 / mo100,000 / month300 req / min256 KBGrowing SaaS & multi-agent pipelines
MEGA$79.99 / mo500,000 / month1,000 req / min256 KBHigh-volume enterprise workloads

Frequently Asked Questions

Does it catch decimal, octal, and IPv6-mapped localhost bypasses?

Yes. It normalizes integer, octal, hex, shorthand IPv4, and IPv4-mapped IPv6 addresses before checking CIDR blocklists.

What about wildcard DNS services like nip.io or sslip.io?

Wildcard DNS rebinding domains (nip.io, sslip.io, xip.io, localtest.me) and embedded private IPs in hostnames are detected and blocked.

Why do AI agents need an SSRF firewall?

Any agent with a 'browse_url' or 'fetch_webhook' tool can be tricked via indirect prompt injection into querying internal Kubernetes or cloud metadata endpoints.

Zero Payload Logging

Data Handling, Privacy & Proxy Disclosure

Stateless URL analysis; zero payload logging.

Worker Zero-Logging Guarantee: Cloudflare Workers Observability and invocation logging are disabled (observability.enabled = false, head_sampling_rate = 0, invocation_logs = false). Requests via RapidAPI or Zyla traverse marketplace proxies; use a Direct Bearer Key for zero-intermediary routing.

Related Tinplate APIs

POST /v1/mcp-manifest-linter Tier 1

MCP Server Manifest & Tool Security Linter API

Audit MCP server manifests for hidden tool poisoning, shell risks, and excessive permissions.

POST /v1/url-normalizer Developer Utilities

URL Normalizer & Tracking Parameter Stripper API

Canonicalize URLs and strip 120+ ad-tracking and click-ID parameters for clean deduplication.

POST /v1/security-headers Security & Secrets

HTTP Security Header Scanner API

Audit CSP, HSTS, and browser security headers with an A+ to F grade and fix snippets.