Files
beh-rde-brief/proxy
JUSN ec6ec22421 Web-Demo: 2 Gratis-Analysen direkt auf der Webseite
Worker (/demo auf behoerdenklar-proxy):
- Turnstile-Verifikation serverseitig (Bot-Mauer)
- Analyse 1 anonym (1x pro IP/30 Tage), Analyse 2 nur mit E-Mail
  (SHA-256-Hash mit Pepper, dauerhaft — nie Klartext gespeichert)
- IP-Gesamtlimit 3/30 Tage, globales Tagesbudget 100 (~2,50 EUR Deckel)
- Wegwerf-Mail-Blockliste, 5-MB-Limit, CORS nur eigene Domain
- Prompt/Schema identisch zur App (ohne Antwort-Generator)

Webseite:
- demo.html im Papier-Design: Einwilligung, Upload mit Client-Downscaling
  (2000px/JPEG wie App), Ampel-Logik, Ergebnis-Karten, Warteliste-CTA
  mit vorbelegter E-Mail, gestaffelter Ablauf 1. anonym / 2. mit E-Mail
- Startseite verlinkt Demo im Hero
- Datenschutz: neuer Abschnitt 8 Gratis-Demo (Einwilligung, Turnstile,
  E-Mail-Hash), Folgeabschnitte neu nummeriert; Sitemap + /demo

Ende-zu-Ende getestet: echte Analyse (Jobcenter-Testbrief korrekt erklärt,
Ampel erkennt fruehere Absagefrist), Schummler-Szenarien (Browser-Loeschen,
doppelte E-Mail) serverseitig abgefangen. Dabei entdeckt: Anthropic-Key
war ungueltig -> erneuert (App-Analyse funktionierte wieder).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-24 13:06:03 +02:00
..

BehördenKlar Backend-Proxy

Cloudflare Worker, der den Anthropic-API-Key serverseitig hält. Die App schickt ihre Claude-Anfragen an diesen Worker statt direkt an Anthropic — kein API-Key in der App, Missbrauchsschutz inklusive.

Was der Worker macht

  1. Prüft die anonyme Geräte-ID (x-geraete-id-Header) und setzt ein Tageslimit pro Gerät durch (Standard: 20 Anfragen, siehe wrangler.toml)
  2. Erlaubt nur die Modelle, die die App nutzt, und deckelt max_tokens
  3. Leitet den Request-Body unverändert an api.anthropic.com/v1/messages weiter und setzt dabei serverseitig x-api-key + anthropic-version
  4. Gibt die Anthropic-Antwort unverändert zurück

Deployment (einmalig)

cd proxy
npm install

# Bei Cloudflare anmelden (kostenloser Account reicht für den Start)
npx wrangler login

# KV-Namespace für das Rate-Limit anlegen …
npx wrangler kv namespace create RATE_LIMIT
# … und die ausgegebene ID in wrangler.toml bei [[kv_namespaces]] eintragen

# Anthropic-API-Key als Secret hinterlegen (von console.anthropic.com)
npx wrangler secret put ANTHROPIC_API_KEY

# Deployen
npm run deploy

Der Deploy gibt eine URL aus, z. B. https://behoerdenklar-proxy.<account>.workers.dev.

App umstellen

In src/services/claudeClient.ts die URL eintragen:

const PROXY_URL: string | null = 'https://behoerdenklar-proxy.<account>.workers.dev';

Fertig — die App braucht dann keinen API-Key mehr in den Einstellungen.

Lokal testen

npm run dev   # startet den Worker auf http://localhost:8787

Dann in claudeClient.ts vorübergehend PROXY_URL = 'http://localhost:8787' setzen (im Simulator; auf echtem Gerät die LAN-IP des Rechners verwenden).

Später ergänzen (wenn Abo/IAP kommt)

  • Abo-Prüfung: RevenueCat-Webhook oder Receipt-Validierung vor dem Weiterleiten
  • Tageslimit je nach Abo-Stufe (Free: 3, Abo: 20+)
  • Die Geräte-ID durch eine echte Nutzer-ID ersetzen