> ## Documentation Index
> Fetch the complete documentation index at: https://exosphere-auto-translate-docs-20260623-1106.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Anmelden

> Bei FailproofAI über die CLI anmelden, um Erinnerungen und personalisierte Funktionen zu aktivieren

```bash theme={null}
failproofai auth login    # E-Mail + Einmalcode
failproofai auth logout   # diese Sitzung widerrufen
failproofai auth whoami   # angemeldete Identität ausgeben
```

Die veraltete Flag-Schreibweise `--login` / `--logout` / `--whoami` wird zur Rückwärtskompatibilität weiterhin als Alias akzeptiert.

Die Authentifizierung ist optional. Richtlinien, das Dashboard, die `/audit`-Seite und alle anderen lokalen Funktionen verhalten sich identisch, egal ob Sie angemeldet sind oder nicht. Die Anmeldefunktion existiert, damit Features, die eine **stabile Identität benötigen** (heute: Wiederholen von Audit-Erinnerungen, in Zukunft mehr), einen Ankerpunkt haben.

## Anmeldeablauf

```bash theme={null}
failproofai auth login
```

Fordert Ihre E-Mail-Adresse an, sendet einen 6-stelligen Einmalcode an diese Adresse, fragt den Code ab und schreibt bei Erfolg `~/.failproofai/auth.json` (Modus `0600`). Die gleiche Sitzung ist dann im In-App-Dashboard sichtbar — ein Klick auf `[ set a reminder ]` unter `/audit` erkennt Sie als angemeldet.

Das Dashboard stellt den gleichen Ablauf als modalen Dialog auf `/audit` für Nutzer bereit, die die CLI nie verwenden.

## Abmelden

```bash theme={null}
failproofai auth logout
```

Widerruft die aktuelle Sitzung auf dem Server und löscht `~/.failproofai/auth.json`. Ist der API-Server nicht erreichbar, wird die lokale Datei trotzdem entfernt — der lokale Abmeldewunsch hat immer Vorrang.

## Identitätsprüfung

```bash theme={null}
failproofai auth whoami
```

Gibt `<E-Mail> (<Benutzer-UUID>)` aus und beendet sich mit Exitcode 0, wenn eine gültige Sitzung besteht, oder gibt `not signed in` aus und beendet sich mit Exitcode 1 andernfalls. Erneuert das Zugriffstoken im Hintergrund automatisch, wenn es innerhalb einer Minute abläuft.

## Wiederkehrende Audit-Erinnerung

Wenn Sie auf der `/audit`-Seite auf **`[ set a reminder ]`** klicken (oder sich über den Modal anmelden, den die Schaltfläche voraussetzt), schreibt das Dashboard eine kleine Begleitdatei unter `~/.failproofai/next-audit.json`:

```json theme={null}
{
  "next_audit_at": 1780765200,
  "user_email": "you@example.com",
  "set_at": 1780160574
}
```

Diese Datei ist an die E-Mail-Adresse gebunden, für die sie erstellt wurde — wird die CLI-Sitzung auf ein anderes Konto umgestellt, werden Erinnerungen des vorherigen Nutzers ausgeblendet. Der Standardabstand beträgt **7 Tage** und ist später konfigurierbar, sobald der Scheduler verfügbar ist. Wird wie `auth.json` mit `0600`-Berechtigungen erstellt.

Der `/api/auth/reminder`-Endpunkt des Dashboards bietet `GET` (lesen), `POST` (setzen / neu planen) und `DELETE` (löschen) und erfordert eine aktive Sitzung.

## Inhalt von `~/.failproofai/auth.json`

```json theme={null}
{
  "access_token": "eyJhbGc…",
  "refresh_token": "9ede3e…",
  "access_expires_at": 1780160574,
  "refresh_expires_at": 1782748974,
  "user": { "id": "<uuid>", "email": "you@example.com" }
}
```

Wird mit `0600`-Berechtigungen erstellt (nur Eigentümer kann lesen/schreiben). Das Zugriffstoken ist ein 1-stündiges HS256-JWT; das Refresh-Token ist eine undurchsichtige 256-Bit-Zufallszeichenfolge, die der Server als `SHA-256(token)` speichert. Mehrfache Verwendung eines Refresh-Tokens wird serverseitig erkannt und widerruft alle Sitzungen des Nutzers.

## Umgebungsvariablen

| Variable               | Standard                     | Zweck                                                                                                                     |
| ---------------------- | ---------------------------- | ------------------------------------------------------------------------------------------------------------------------- |
| `FAILPROOF_API_URL`    | `https://api.befailproof.ai` | Überschreibt die Basis-URL des API-Servers. Nützlich für die lokale Entwicklung gegen einen selbst gehosteten API-Server. |
| `FAILPROOFAI_AUTH_DIR` | `~/.failproofai`             | Überschreibt den Speicherort von `auth.json`. Hauptsächlich für Tests.                                                    |

Unter [Umgebungsvariablen](/de/cli/environment-variables) finden Sie die vollständige Liste.

## Fehlerbehebung

**„Could not reach the api-server"** — die CLI kann keine TCP-Verbindung zu `FAILPROOF_API_URL` herstellen. Überprüfen Sie Ihre Netzwerkverbindung oder setzen Sie `FAILPROOF_API_URL`, wenn Sie einen selbst gehosteten API-Server betreiben.

**„Rate limited"** — zu viele Anmeldeversuche in einem 15-Minuten-Fenster für diese E-Mail-Adresse (5/E-Mail) oder IP-Adresse (20/IP), oder eine 30-sekündige Wiederholungssperre nach der letzten Anfrage für dieselbe E-Mail. Die Fehlermeldung enthält das Wiederholen-nach-Intervall in Sekunden.

**Code abgelehnt** — der OTP war falsch, abgelaufen oder der Eintrag hat die Sperrgrenze von 5 Fehlversuchen erreicht. Führen Sie `failproofai auth login` erneut aus, um einen neuen Code anzufordern.