API-Zugang erstellen

Für Integrationen nutzt EMPEDIAcloud OAuth 2.0 (Client Credentials): ein API-Zugang liefert kurzlebige Access-Tokens statt eines dauerhaften Schlüssels.

1
Zugang anlegen

Öffnen Sie API-Zugang in der Seitenleiste, klicken Sie auf „Neuen Zugang anlegen“, vergeben Sie einen Namen (z. B. „CI/CD Pipeline“) und wählen Sie die nötigen Scopes.

2
Zugangsdaten sichern

Client-ID und Client-Secret werden nur einmal angezeigt. Speichern Sie sie in einem Secret-Manager (GitHub Secrets, Vault, Passwort-Manager).

3
Token holen und nutzen

Per POST /oauth/token mit grant_type=client_credentials einen Access-Token holen und als Authorization: Bearer senden — Schritt für Schritt in Erste Schritte mit der API.

Zugang widerrufen oder Secret erneuern

Unter API-Zugang „Neues Secret“ (altes Secret sofort ungültig) oder „Löschen“ wählen.

Secrets nie in Code-Repositories committen. Nutzen Sie Umgebungsvariablen oder einen Secret-Manager.

Mit AI-Agenten nutzen (MCP)

Für Claude, ChatGPT & Co. empfehlen wir den gehosteten Connector — Anleitung unter MCP verbinden. Das lokale MCP-Paket (@urbanstudio/auditcollector-mcp) nutzt ebenfalls einen API-Zugang: Client-ID und Secret (Scopes scan:read, scan:write, report:read) als AUDITCOLLECTOR_CLIENT_ID und AUDITCOLLECTOR_CLIENT_SECRET eintragen.

Nächste Schritte