# Flowg8 · Authentifizierung

Nutze auf deinem Server einen eingeschränkten Integrationsschlüssel. Jeder Workspace-Aufruf benötigt zusätzlich X-Organization-Id.

Sende Authorization: Bearer $FLOWG8_API_KEY. Administratoren erstellen befristete Schlüssel unter API-Keys. Secrets werden einmal angezeigt, nur als SHA-256-Hash gespeichert und sind nicht wiederherstellbar. Bewahre sie auf deinem Server auf.

Nutze POST /v1/auth/token zur Anmeldung ohne Browser oder die normale Flowg8-Webanmeldung. Beide liefern FLOWG8_ACCESS_TOKEN. Flowg8 verwaltet die Authentifizierung; du brauchst keinen eigenen Identitätsanbieter. Interaktive Aktionen verwenden diesen Access-Token, keinen ID-Token. Schlüsselverwaltung, Gruppenverknüpfung, KI, Billing, Inbox und Entscheidungen erfordern einen angemeldeten Flowg8-Nutzer. Integrationsschlüssel können keine Anträge genehmigen.

Schlüssel gelten für einen Workspace, laufen nach 1–365 Tagen ab und sind für nachfolgende Aufrufe widerrufbar. Schlüssel mit serviceAccountId gehören der Organisation und bleiben beim Ausscheiden des Erstellers gültig; das Deaktivieren des Servicekontos sperrt alle seine Schlüssel. Bestehende Schlüssel ohne serviceAccountId werden bei deaktivierter Erstellermitgliedschaft ungültig. Widerrufe Schlüssel ausdrücklich beim Offboarding.

Workspace-Zugriff erfordert einen eingerichteten Authenticator. Richte ihn zuerst im Browser unter /security ein. Jeder API-Aufruf prüft den Token online und aktualisiert Gruppenrechte. Abmelden widerruft alle laufenden Cognito-Sitzungen. Die API-Anmeldung kann eine MFA-Challenge liefern.

## GET /v1/access

Authentication: restricted integration key (scope: any) or Flowg8 sign-in access token
Required tenant header: X-Organization-Id.
Required user permissions: Aktive Workspace-Mitgliedschaft erforderlich. The API checks current membership, roles, key scopes and resource permissions on every request. Documentation visibility grants no access.

## Request example (replace example IDs)

```sh
curl "https://api.flowg8.io/v1/access" \
  -H "authorization: Bearer $FLOWG8_API_KEY" \
  -H "x-organization-id: 10000000-0000-4000-8000-000000000001"
```

Source: /docs/authentication
Full schemas: /docs/openapi.json