Erste Schritte

Noirdoc in unter 5 Minuten einrichten. Einfach API-Key und Base-URL tauschen.

Was ist Noirdoc?

Noirdoc ist ein datenschutzkonformer Reverse Proxy, der zwischen Ihrer Anwendung und LLM-Anbietern wie OpenAI oder Anthropic sitzt. Er erkennt und pseudonymisiert personenbezogene Daten automatisch — Namen, E-Mail-Adressen, Telefonnummern und mehr — bevor Ihre Anfragen das Sprachmodell erreichen, und stellt die Originalwerte in der Antwort wieder her.

Voraussetzungen

Bevor Sie beginnen, stellen Sie sicher, dass Sie Folgendes haben:

  • Einen API-Key eines unterstützten LLM-Anbieters (OpenAI, Anthropic, Azure OpenAI oder OpenRouter)
  • Einen Noirdoc-Proxy-API-Key (beginnt mit px-), den Sie über das Noirdoc-Portal oder Ihren Administrator erhalten

Schnellstart

Die Einrichtung von Noirdoc erfordert drei Schritte. Kein SDK zu installieren, kein Code umzuschreiben.

1. Noirdoc-API-Key besorgen

Melden Sie sich im Noirdoc-Portal an oder bitten Sie den Administrator Ihrer Organisation um einen Proxy-API-Key. Jeder Noirdoc-Key beginnt mit dem Praefix px-, sodass er leicht von Ihren Provider-Keys zu unterscheiden ist.

2. Base-URL und API-Key ersetzen

Tauschen Sie in Ihrem bestehenden Code zwei Werte aus:

  • Base-URL — verwenden Sie https://api.noirdoc.de/v1 anstelle des Endpunkts Ihres Providers
  • API-Key — verwenden Sie Ihren px--Noirdoc-Key anstelle des Provider-Keys

Ihr Provider-Key wird sicher im Noirdoc-Portal gespeichert und ist für Ihren Anwendungscode nicht sichtbar.

3. Fertig — Ihre Daten sind jetzt geschützt

Jede Anfrage, die Sie senden, wird automatisch auf personenbezogene Daten geprueft. Erkannte Entitäten werden durch Pseudonyme ersetzt, bevor die Anfrage das LLM erreicht, und die Originalwerte werden in der Antwort wiederhergestellt. Keine weitere Konfiguration noetig.

Python-Beispiel mit OpenAI

Wenn Sie bereits das OpenAI Python SDK verwenden, ist die Aenderung minimal:

from openai import OpenAI

# Vorher — direkt zu OpenAI
# client = OpenAI(api_key="sk-...")

# Nachher — über Noirdoc geroutet
client = OpenAI(
    base_url="https://api.noirdoc.de/v1",
    api_key="px-your-noirdoc-key",
)

response = client.chat.completions.create(
    model="gpt-5.4-mini",
    messages=[
        {
            "role": "user",
            "content": "Fasse den Vertrag für Max Mustermann, geboren am 15.03.1985, IBAN DE89370400440532013000 zusammen."
        }
    ],
)

print(response.choices[0].message.content)

Das Modell erhaelt einen Prompt, in dem Max Mustermann durch <<PERSON_1>>, das Datum durch <<DATE_1>> und die IBAN durch <<IBAN_1>> ersetzt wurde. Die Antwort kommt mit den Originalwerten nahtlos wiederhergestellt zurueck.

Funktioniert mit jeder OpenAI-kompatiblen Bibliothek

Noirdoc ist nicht auf Python oder das offizielle OpenAI SDK beschraenkt. Jede Bibliothek oder jedes Tool, das eine benutzerdefinierte Base-URL unterstützt, funktioniert — LangChain, LlamaIndex, curl, Node.js-Clients und mehr.

curl https://api.noirdoc.de/v1/chat/completions \
  -H "Authorization: Bearer px-your-noirdoc-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4-mini",
    "messages": [
      {"role": "user", "content": "Erstelle eine E-Mail an anna.schmidt@example.com bezueglich der Rechnung."}
    ]
  }'

Managed vs Self-Hosted

  • Managed Service — Melden Sie sich bei portal.noirdoc.de an, konfigurieren Sie Ihre Provider und erstellen Sie Proxy-API-Keys. Keine eigene Infrastruktur noetig.
  • Self-Hosted — Betreiben Sie Noirdoc auf Ihrer eigenen Infrastruktur. Siehe Self-Hosting für die Einrichtung.

Nächste Schritte