# flow2act · Authentifizierung

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

Sende Authorization: Bearer $FLOW2ACT_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 flow2act-Webanmeldung. Beide liefern FLOW2ACT_ACCESS_TOKEN. flow2act 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 flow2act-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 flow2act 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.flow2act.com/v1/access" \
  -H "authorization: Bearer $FLOW2ACT_API_KEY" \
  -H "x-organization-id: 10000000-0000-4000-8000-000000000001"
```

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