# Dein Alarmverlauf verdient mehr als ein Passwort.

> Schütze deinen Pocket Alert Account mit TOTP-Zwei-Faktor-Authentifizierung und einmalig nutzbaren Wiederherstellungscodes. Gilt im Web und auf dem Smartphone, während API-Schlüssel und Skripte weiter funktionieren.

<!-- source: https://pocketalert.app/de/features/two-factor-auth -->

Zuletzt aktualisiert: 2026-08-11

TOTP-Zwei-Faktor-Authentifizierung mit einmal verwendbaren Wiederherstellungscodes, erzwungen im Dashboard und in der App. Deine API-Schlüssel und Skripte laufen unverändert weiter.

Dokumentation: https://info.pocketalert.app/features/two-factor-auth.html

## In zwei Minuten eingerichtet

1. **Code scannen** — Öffne Konto → Sicherheit und scanne den QR-Code mit deiner Authenticator-App.
2. **Einmal bestätigen** — Gib einen sechsstelligen Code zur Bestätigung ein. 2FA wird erst nach einem korrekten Code aktiviert.
3. **Backups sichern** — Speichere die Wiederherstellungscodes an einem anderen Ort als dem Handy mit der Authenticator-App.

## Echte 2FA, ohne deine Skripte zu brechen

Dein Benachrichtigungsverlauf ist ein Protokoll dessen, was deine Systeme tun und wann sie ausfallen. Das ist mehr wert als ein einzelnes Passwort.

- **Funktioniert mit jeder Authenticator-App** — Standard-TOTP. Scanne den QR-Code mit deiner bereits verwendeten Authenticator-App und bestätige einen Code, um 2FA einzuschalten.
- **Gilt für Web und Mobile** — Wird nach der primären Anmeldung im Web-Dashboard und in der mobilen App erzwungen. Eine versteckte Hintertür gibt es also nicht.
- **Wiederherstellungscodes, die halten** — Einmal verwendbare Wiederherstellungscodes werden beim Setup ausgegeben und atomar verbraucht. Zwei parallele Anmeldungen können deshalb nicht denselben Code einlösen.
- **Automatisierung bleibt unberührt** — API-Schlüssel werden nie abgefragt. Deine Automatisierung läuft genau so weiter wie am Tag vor der Aktivierung von 2FA.
- **Sicher neu registrierbar** — Eine neue Registrierung wartet in einem ausstehenden Slot, bis du sie bestätigst. Ein unterbrochenes Setup kann dich so nicht aus deinem eigenen Konto aussperren.
- **Schutz vor Brute-Force-Angriffen** — Fünf falsche Codes sperren das Konto für fünfzehn Minuten. Außerdem bekommst du eine E-Mail, sobald 2FA ein- oder ausgeschaltet wird.

## Einschalten

    
Öffne Konto → Sicherheit und starte das Setup. Du bekommst einen QR-Code und ein Geheimnis, die du mit einer beliebigen TOTP-App scannen kannst. Danach bestätigst du einen sechsstelligen Code. Erst nach einem korrekten Code wird 2FA tatsächlich aktiviert, und erst dann werden deine Wiederherstellungscodes angezeigt. Speichere sie an einem Ort, der nicht das Handy mit der Authenticator-App ist.

    
## Was sich bei der Anmeldung ändert

    
Im Dashboard und in der App führt ein korrektes Passwort jetzt zu einer Code-Abfrage, statt dich direkt in dein Konto zu lassen. Intern liefert der Login-Endpunkt eine kurzlebige Challenge statt eines Tokens. Ein zweiter Aufruf tauscht diese Challenge zusammen mit deinem Code gegen die eigentliche Sitzung. Challenges laufen nach fünf Minuten ab.

    
Das Codefeld akzeptiert entweder einen sechsstelligen TOTP-Code oder einen deiner Wiederherstellungscodes. Wenn du dein Handy verlierst, ist das also ein Ärgernis und keine Aussperrung.

    
## Was sich nicht ändert

    
API-Schlüssel sind davon nicht betroffen. Sie authentifizieren sich über den `Token`-Header und werden nie abgefragt. Jedes Skript, jeder Cronjob und jede CI-Pipeline, die du hast, sendet deshalb weiterhin genau wie vorher Benachrichtigungen. Das spricht auch dafür, pro Dienst einen eigenen Schlüssel anzulegen: Wenn du einen widerrufst, bleiben die anderen unberührt.

## FAQ

### Welche Authenticator-Apps funktionieren?

Jede gängige TOTP-App: Google Authenticator, 1Password, Authy, Bitwarden und alles andere, was einen QR-Code scannen kann und sechsstellige Codes erzeugt.

### Bricht 2FA meine Skripte und API-Schlüssel?

Nein. 2FA gilt für interaktive Anmeldungen im Dashboard und in der mobilen App. API-Schlüssel authentifizieren sich über den Token-Header und werden nie abgefragt. Deine Cronjobs, CI-Pipelines und Monitoring-Hooks senden also weiter unverändert Benachrichtigungen.

### Was, wenn ich mein Handy verliere?

Verwende stattdessen einen deiner Wiederherstellungscodes anstelle des sechsstelligen Codes. Jeder funktioniert nur einmal. Du kannst jederzeit unter Konto → Sicherheit einen neuen Satz erzeugen. Die alten werden dann ungültig.

### Was passiert, wenn ich das Setup abbreche?

Das bereits bestehende 2FA bleibt unberührt. Das neue Geheimnis landet in einem ausstehenden Slot und ersetzt das aktive erst, wenn du einen Code bestätigst. Wenn du den Tab mitten im Setup schließt, bist du also nicht ausgesperrt.

### Wie verändert 2FA die API-Anmeldung?

Die Anmeldung liefert eine kurzlebige Challenge statt eines Tokens. Diese Challenge tauschst du zusammen mit einem Code gegen das eigentliche JWT ein. Challenges sind fünf Minuten gültig. Das Codefeld akzeptiert sowohl einen TOTP-Code als auch einen Wiederherstellungscode.

### Was verhindert, dass jemand meinen Code errät?

Fünf falsche Codes sperren das Konto für fünfzehn Minuten, weitere Versuche liefern 429. Außerdem bekommst du eine E-Mail, sobald 2FA aktiviert oder deaktiviert wird. Falls eine solche E-Mail kommt und du das nicht warst, ändere sofort dein Passwort.
