Öffentlicher Leitfaden

AI Gateway und KI-Verbindungen aktivieren

Nutzen Sie `/ai-gateway` als Setup-Zentrale: Verbinden Sie einen BYOK-Anbieterschlüssel, setzen Sie ihn in der Richtlinie auf die Zulassungsliste und erstellen Sie dann einen Client für Ihre IDE oder Automatisierung. Zielgruppe: Mandantenadministratoren, Sicherheitsleiter und Arbeitsbereichseigentümer. Typische Einrichtungszeit: 15-20 Minuten.

reference

Verwenden Sie dies, wenn

Nutzen Sie `/ai-gateway` als Setup-Zentrale: Verbinden Sie einen BYOK-Anbieterschlüssel, setzen Sie ihn in der Richtlinie auf die Zulassungsliste und erstellen Sie dann einen Client für Ihre IDE oder Automatisierung.

Zielgruppe: Mandantenadministratoren, Sicherheitsleiter und ArbeitsbereichseigentümerTypische Dauer: 15-20 Minuten

Bevor Sie beginnen

  • Wählen Sie den ersten Anbieter, die erste IDE oder den ersten Automatisierungsworkflow für das Pilotprojekt aus.
  • Bestätigen Sie, welche Anbieterschlüssel und MCP-Tools die Benutzer sehen dürfen.
  • Halten Sie die Callback-URL oder Client-Konfigurationsdetails bereit, bevor Sie den Zugriff erstellen.

Schritt-für-Schritt-Anleitung

1

Schritt 1

Zuerst einen Anbieter verbinden

Starten Sie in `/ai-gateway` und öffnen Sie die OpenAI-Anbieterverbindung, um den ersten mandanteneigenen Schlüssel hinzuzufügen, dem Ihr Team bereits vertraut.

  • Verwenden Sie `/integrations/ai_openai` für die ersten BYOK-Anmeldeinformationen, es sei denn, Ihr Pilotprojekt erfordert explizit Anthropic oder einen OpenAI-kompatiblen Endpunkt.
  • Verwenden Sie einen dedizierten Anbieterschlüssel für BlackShield statt eines persönlichen Schlüssels, der von mehreren Personen geteilt wird.
  • Führen Sie die Vorabprüfung des Anbieters durch, bevor Sie zum AI Gateway zurückkehren.

Erfolgreicher Abschluss

Führen Sie die Vorabprüfung des Anbieters durch, bevor Sie zum AI Gateway zurückkehren.

2

Schritt 2

Anbieter in der Richtlinie auf die Zulassungsliste setzen

Das AI Gateway schränkt Routing und Zugriff ein, bis die Richtlinie den verbundenen Anbieter explizit zulässt.

  • Öffnen Sie die Richtlinienregisterkarte in `/ai-gateway` und fügen Sie den verbundenen Anbieter zu `approved_providers` hinzu.
  • Halten Sie die erste Richtlinie einfach: Anbieter-Zulassungsliste, ausgeblendete Tools und ein klares Anfragelimit.
  • Bleiben Sie im Beratungsmodus (advisory), bis das Pilotteam die erwarteten Warnungen sieht, und wechseln Sie erst dann in den Erzwingungsmodus (enforce).

Erfolgreicher Abschluss

Bleiben Sie im Beratungsmodus (advisory), bis das Pilotteam die erwarteten Warnungen sieht, und wechseln Sie erst dann in den Erzwingungsmodus (enforce).

3

Schritt 3

Einen Client für das Tool Ihres Teams erstellen

Geben Sie jeder IDE, jedem MCP-Client oder Service-Principal einen eigenen AI Gateway-Client, damit der Zugriff einfach rotiert oder deaktiviert werden kann.

  • Erstellen Sie einen öffentlichen Client für Anmeldeabläufe oder einen vertraulichen Client für Headless-Automatisierung.
  • Fügen Sie die Callback-URL hinzu, die Ihre IDE oder Ihr Agent benötigt, bevor Sie den Client an Endbenutzer übergeben.
  • Beschränken Sie jeden Client auf die Anbieterverbindungen und MCP-Tools, die das Team tatsächlich benötigt.

Erfolgreicher Abschluss

Beschränken Sie jeden Client auf die Anbieterverbindungen und MCP-Tools, die das Team tatsächlich benötigt.

4

Schritt 4

Gateway vor dem breiten Rollout testen

Führen Sie zuerst einen Test mit geringem Risiko durch, um Authentifizierung, Richtlinienverhalten und Aktivitätsprotokollierung zu bestätigen.

  • Setzen Sie den MCP-Endpunkt auf `/api/v1/mcp` und den Inferenz-Endpunkt auf `/api/v1/ai-gateway/openai/v1/chat/completions`.
  • Melden Sie sich mit dem neuen Client an oder tauschen Sie Client-Anmeldeinformationen gegen ein kurzlebiges Token aus.
  • Führen Sie `tools/list` oder einen einfachen schreibgeschützten Prompt aus und überprüfen Sie, ob das Ereignis in der AI Gateway-Aktivität erscheint.
  • Überprüfen Sie Richtlinienwarnungen und Nutzungsprotokolle, bevor Sie weitere Benutzer einladen.

Erfolgreicher Abschluss

Überprüfen Sie Richtlinienwarnungen und Nutzungsprotokolle, bevor Sie weitere Benutzer einladen.

Demonstration only

This configuration is designed for ease of use. To deploy scanner clients at scale, please plan your deployment architecture accordingly or contact us for enterprise best practices.

Ausführen

Exchange client credentials for a short-lived token
curl -X POST https://api.blackshield.chaplau.com/api/v1/ai-gateway/oauth/token \
  -H "Content-Type: application/json" \
  -d '{
    "grant_type": "client_credentials",
    "client_id": "your-client-id",
    "client_secret": "your-client-secret"
  }'
Query OpenAI completions via the Gateway Proxy
curl -X POST https://api.blackshield.chaplau.com/api/v1/ai-gateway/openai/v1/chat/completions \
  -H "Authorization: Bearer <your_short_lived_token>" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "openai",
    "model": "gpt-4o-mini",
    "messages": [
      {
        "role": "user",
        "content": "List the security requirements for the tenant onboarding flow."
      }
    ]
  }'
Configure the Stdin/Stdout MCP Proxy in Cursor / VS Code / Claude Desktop
{
  "mcpServers": {
    "blackshield-gateway": {
      "command": "blackshield-mcp",
      "args": [
        "--client-id", "<your-client-id>",
        "--client-secret", "<your-client-secret>",
        "--url", "https://api.blackshield.chaplau.com/api/v1/mcp"
      ]
    }
  }
}

Erfolgreicher Abschluss

  • Der Pilot-Client authentifiziert sich erfolgreich und sieht nur die geplanten Anbieter und Tools.
  • Der Aktivitätsstream zeigt den Testaufruf sowie alle erwarteten Richtlinienwarnungen oder -blockierungen an.
AI Gateway und KI-Verbindungen aktivieren | BlackShield Docs