Passkeepr
Diese Seite beschreibt, wie Passkeepr technisch arbeitet, was Server und Browser dafür brauchen und wo die Grenzen liegen.
Was das Modul leistet, steht auf der Modulseite.
Stand: November 2026, COD 3.8.6
Inhalt der Dokumentation
- Übersicht
- Erste Schritte
- Voraussetzungen
- Namen und Adressen
- Netzgeräte
- Zeit und DNS
- Installation
- Aufbauformen
- Ersteinrichtung
- Updates
- Module
- Netzwerk und MikroTik
- Automatisierung
- NAC
- TACACS+
- Firewall
- Captive Portal
- Monitoring
- Backup
- Hypervisor
- OTP
- Passkeepr
- GRC
- Inventar und CMDB-Import
- Fehlerbilder
- Sicherheit
- Versionen
- Versionsverlauf
- Support
Dokumentation
- Übersicht
- Erste Schritte
- Voraussetzungen
- Namen und Adressen
- Netzgeräte
- Zeit und DNS
- Installation
- Aufbauformen
- Ersteinrichtung
- Updates
- Module
- Netzwerk und MikroTik
- Automatisierung
- NAC
- TACACS+
- Firewall
- Captive Portal
- Monitoring
- Backup
- Hypervisor
- OTP
- Passkeepr
- GRC
- Inventar und CMDB-Import
- Fehlerbilder
- Sicherheit
- Versionen
- Versionsverlauf
- Support
Überblick
| Merkmal | Wert |
|---|---|
| Zweck | Ende-zu-Ende-verschlüsselter Team-Tresor für Passwörter, Einmalcodes, Passkeys, Karten und Notizen |
| Prinzip | Zero-Knowledge. Browser oder Erweiterung ver- und entschlüsseln. Der Server speichert nur Chiffrat und versiegelte Schlüssel |
| Kryptografie | Argon2id (Schlüsselableitung), X25519 (Schlüssel), AES-GCM (Einträge) |
| Anmeldung | Über COD. COD stellt ein signiertes Token aus (JWT, ES384). Passkeepr prüft es über die Signierschlüssel von COD (JWKS) |
| Erreichbarkeit | Nur über COD. Browser und Erweiterung sprechen COD über HTTPS, COD leitet an Passkeepr weiter |
| Datenhaltung | Eigene PostgreSQL-Datenbank, PostgreSQL ab Version 18 |
| Dienst | Paket cod-passkeepr. Betrieb auf dem COD-Server empfohlen |
| Browser-Erweiterung | Chrome ab Version 137 als entpackte Erweiterung, Firefox ab Version 140 signiert. Ab COD 3.8.6 mindestens Fassung 3.3.6 |
| Verbindung nach außen | Optional die Leck-Prüfung aus dem Browser gegen den Dienst Pwned Passwords. Dabei gehen nur fünf Zeichen des Hashs hinaus |
| Seit | COD 3.8. Passkeepr (bis 3.7 Stronghold) startet in COD 3.8 mit leerer Datenbank |
Voraussetzungen
Server
| Voraussetzung | Warum |
|---|---|
| PostgreSQL ab Version 18 | Passkeepr hat eine eigene Datenbank. Das Einrichtungsskript legt sie an oder nutzt einen vorhandenen Server |
| Passkeepr auf dem COD-Server, empfohlen | Kurzer Weg, keine Verbindung über das Netz zwischen COD und Passkeepr |
| Auf eigenem Server: vertrauenswürdiges Netz | Die Verbindung zwischen COD und Modul-Servern gehört in ein vertrauenswürdiges Netz |
| HTTPS für COD | Pflicht für jeden Zugriff auf COD, auch für die Erweiterung |
| Reverse Proxy lässt Server-Sent Events durch | Passkeepr nutzt Server-Sent Events. Eine Beispielkonfiguration erhalten Sie im Projekt. |
| Zeitabgleich per NTP auf allen Hosts | Siehe Zeit und DNS |
Die Liste der Verbindungen und Freigaben erhalten Kunden und Partner im Projekt.
Browser
| Voraussetzung | Warum |
|---|---|
| Chrome ab Version 137 oder Firefox ab Version 140 | Mindestfassung der Erweiterung |
| Erweiterung ab Fassung 3.3.6 bei COD 3.8.6 | COD 3.8.6 weist ältere Fassungen ab |
| Zugang zum Dienst Pwned Passwords, optional | Die Leck-Prüfung fragt aus dem Browser an, nicht vom Server |
In COD
- Modul Passkeepr am Mandanten freigeschaltet und für den Standort ausgerollt.
- Rolle mit Recht auf das Modul Passkeepr.
- Für Enterprise-Tresore mindestens zwei Keepr admins. Ein Keepr admin ist ein COD-Administrator.
Einrichtung
- Das Manager-Konto schaltet das Modul frei: „Admin Area > Tenant > Modules“. Danach ab- und wieder anmelden.
- Rollen Sie das Modul aus: „Admin Area > Module Rollout“, Modul Passkeepr, Standort wählen, dann „Install“, „Connect“, „Configure“ und „Apply“. Details unter Module ausrollen.
- Vergeben Sie das Recht auf das Modul Passkeepr an die Rollen, die den Tresor nutzen.
- Legen Sie die Einstellungen von Passkeepr fest, etwa „Only enterprise vaults“, „Time to move personal vaults“, „Offline copy works for“ und „Auto-lock when idle“.
- Jede Person richtet Passkeepr beim ersten Öffnen ein: Master-Passwort festlegen, Emergency Kit sichern.
- Installieren Sie die Erweiterung aus Passkeepr. Öffnen Sie dort den Dialog der Erweiterung. In Firefox genügt ein Klick. In Chrome laden Sie die Erweiterung herunter und wählen „Load unpacked“.
- Legen Sie Tresore an. Für Enterprise-Tresore benennen Sie mindestens zwei Keepr admins.
- Lesen Sie vorhandene Bestände über den Import ein.
Hinweis: Bewahren Sie das Emergency Kit dort auf, wo niemand sonst es lesen kann. Nie in COD und nicht in einem Backup davon.
Technische Details
Was der Server kennt
| Kennt der Server | Kennt der Server nicht |
|---|---|
| Konten, Mitgliedschaften, Rollen | Tresornamen, Eintragstitel, Adressen, Kunden, Passwörter, Notizen, Schlagwörter |
Der Server hält Chiffrat und versiegelte Schlüssel, die er nicht öffnen kann. Ohne das Master-Passwort, das nur im Browser existiert, ist auch ein vollständiger Datenbankauszug wertlos. Eine gewollte Ausnahme sind Enterprise-Tresore. Auch das Organisationskonto kann sie öffnen. Dessen Entsperren und Änderungen werden protokolliert.
Anmeldung
- Die Person meldet sich an COD an.
- COD prüft das Recht auf das Modul Passkeepr und stellt ein signiertes Token aus.
- Passkeepr prüft das Token über die Signierschlüssel von COD.
- Der Browser entsperrt den Tresor mit dem Master-Passwort.
Es gibt kein zweites Benutzerverzeichnis. Lokale Gruppen kommen vom Standort. Sperren und Löschen eines Kontos in COD wirken auf die Rolle im Tresor. Ratenbegrenzung und Protokoll laufen im Dienst.
Tresorarten
| Art | Gehört | Hinweis |
|---|---|---|
| Persönlich | einer Person | Nur diese Person öffnet ihn |
| Geteilt | den Mitgliedern | Rechte „Can edit“ oder „Read-only“ |
| Enterprise | der Organisation | Bleibt, wenn Personen gehen. Zwei oder mehr Keepr admins führen ihn. Das Organisationskonto kann ihn öffnen |
Teilen und Entzug
- Sie teilen ganze Tresore oder einzelne Einträge, mit Personen oder mit lokalen Gruppen des Standorts.
- Einladungslinks gelten sieben Tage und lassen sich einmal einlösen.
- Alles ist mit öffentlichen Schlüsseln verschlüsselt.
- Entziehen Sie einem Mitglied den Zugriff, erneuert Passkeepr den Tresorschlüssel. Das Mitglied verliert den Zugriff auf alles, was danach gespeichert wird.
Emergency Kit
| Bestandteil | Wofür |
|---|---|
| Wiederherstellungsphrase, 24 Wörter | Setzt bei vergessenem Master-Passwort ein neues. Auf der Entsperrseite über „Forgot your master password?“ |
| Secret Key | Schaltet Passkeepr auf einem neuen Gerät frei |
Nach dem Zurücksetzen zeigt Passkeepr ein neues Emergency Kit. Das alte gilt dann nicht mehr. Gegen Datenverlust auf dem Server schützt das Kit nicht.
Browser-Erweiterung
| Funktion | Hinweis |
|---|---|
| Füllt Zugangsdaten | Nur auf der Seite des Eintrags. Ein Login kann mehrere Adressen tragen, „Match by“ legt fest, auf welchen Seiten er füllt |
| Zähler am Symbol | Zeigt, wie viele Einträge zur geöffneten Seite passen |
| Speichern nach der Anmeldung | Fragt, ob die Zugangsdaten gespeichert werden sollen |
| Einmalcodes und Passkeys | Gehören zum Eintrag. Passkeys fragt die Erweiterung in einem eigenen Fenster ab |
| Karten und starke Passwörter | Seit COD 3.8.6: Karten im Checkout, Vorschlag eines starken Passworts auf Registrier- und Änderungsseiten |
| Anmeldung an COD | Der Feldtyp „COD sign-in“ sagt der Erweiterung, welchen Anmeldereiter von COD sie füllt |
Die Erweiterung legt keine Tresore an, lädt niemanden ein, teilt nichts, importiert nichts und öffnet die Verwaltung nicht. Das geht im Passkeepr selbst. Der Passkeepr-Dienst liefert die passende Fassung der Erweiterung aus.
Sperre bei Inaktivität
Der Web-Tresor sperrt ab Werk nach einer Stunde ohne Aktivität. Jede Person wählt in ihren Einstellungen 15 oder 30 Minuten, 1 oder 2 Stunden oder eine eigene Zeit. Die Zeit des Administrators unter „Auto-lock when idle“ ist die Obergrenze.
Verlauf, Archiv und Duplikate
- Seit COD 3.8.6 zeigt „History“ die früheren Stände eines Eintrags, mit Gültigkeit, Autor und Unterschied. „Restore“ holt einen Stand als neue Version zurück.
- Archivierte Einträge und Tresore warten mit Begründung im Reiter „Archived“. Löschen ist erst 30 Tage nach dem Archivieren möglich und lässt sich nicht rückgängig machen.
- Seit COD 3.8.6 findet „Duplicates“ in der Admin-Ansicht doppelte Einträge eines Tresors und verschiebt die überzähligen in den Papierkorb („Trash“).
Import
| Quelle | Hinweis |
|---|---|
| Bitwarden | Passkeys kommen mit. Aus dem JSON-Export kommen Karten als Karten-Einträge |
| 1Password, KeePass | Dateiimport |
| sysPass | Seit COD 3.8.3 mit Gruppendatei aus der sysPass-Datenbank, je Gruppe ein Tresor. Private Konten landen in einem eigenen Tresor ihres Besitzers. Dafür braucht es die Gruppenabfrage aus dem Handbuch von COD 3.8.6 |
| CSV, JSON | Dateiimport |
- Auch passwortgeschützte Dateien lassen sich lesen.
- Auf Wunsch sortiert der Import die Einträge nach den Gruppen der Datei in mehrere Tresore.
- Seit COD 3.8.6 aktualisiert ein erneuter Import mit „Update existing entries“ die Einträge eines früheren Imports. Maßgeblich sind gleicher Titel und Benutzername im selben Tresor. Gelöscht wird nichts.
- Für sysPass zeigt „Check“ vorher, was sich ändern würde.
- Große Importe laufen seit COD 3.8.4 ohne Pause durch.
Eine Übernahme aus dem früheren Tresor gibt es nicht. Mit COD 3.8 startet jede Passkeepr-Datenbank leer.
Offline-Kopien
Ab Werk aus. Nur wenn ein Administrator es erlaubt, lassen sich ausgewählte Einträge als eine passwortgeschützte Datei speichern, die ohne Netz öffnet. Passkeepr vermerkt, wer eine Kopie erzeugt hat, nicht welche Einträge sie enthält.
Leck-Prüfung
Der Browser prüft Passwörter gegen den öffentlichen Dienst Pwned Passwords. Er sendet dabei nur fünf Zeichen des Hashs eines Passworts. Das Passwort selbst verlässt den Browser nicht. Die Anfrage geht vom Browser aus, nicht vom Server.
Audit
Jede Änderung steht mit ihrem Autor im Audit-Protokoll von Passkeepr. Das Audit erscheint in der Admin Area unter „Audit“. Eine Prüffunktion zeigt, ob Einträge fehlen oder verändert wurden.
Update bei getrenntem Host
Läuft Passkeepr auf einem eigenen Server, gilt für COD 3.8.6:
- Aktualisieren Sie COD und Passkeepr zusammen.
- Das Passkeepr-Modul kommt mit COD oder vor COD auf 3.8.6.
- Der Passkeepr-Host liefert danach die neue Erweiterung aus. Installieren Sie sie in den Browsern neu.
Die Reihenfolge stimmen Sie mit Ihrem Partner ab. Mehr unter Updates.
Datensicherung
Vor einer Datenbankänderung legt ein Update eine eigene Sicherung der Passkeepr-Datenbank an. Sie ersetzt Ihre reguläre Datensicherung nicht. Sichern Sie die Datenbank und die Konfiguration des Dienstes regelmäßig. Die vollständige Liste erhalten Sie im Projekt.
Bekannte Grenzen
| Grenze | Was Sie tun können |
|---|---|
| Keine Übernahme aus dem früheren Tresor | Tragen Sie Einträge neu ein oder nutzen Sie den Import |
| COD 3.8.6 weist Erweiterungen unter Fassung 3.3.6 ab | Installieren Sie die Erweiterung aus Passkeepr neu |
| Chrome-Erweiterung als entpackte Erweiterung | Installieren Sie nach jedem COD-Update, das eine neue Fassung verlangt, die Erweiterung aus Passkeepr neu |
| Die Erweiterung verwaltet keine Tresore, Freigaben oder Importe | Erledigen Sie das im Passkeepr selbst |
| Passkeepr hindert niemanden, zu kopieren, was er lesen darf. Gesehenes bleibt gesehen | Ändern Sie nach einem Weggang die Zugangsdaten an den Systemen selbst |
| Offline-Kopien und Exporte lassen sich nicht zurückholen | Erlauben Sie Offline-Kopien nur bewusst und mit kurzer Gültigkeit |
| Gegen jemanden, der die Datenbank beschreiben kann, schützt Passkeepr nur begrenzt | Halten Sie den Zugriff auf Datenbank und Host eng |
| Das Emergency Kit schützt nicht vor Datenverlust | Sichern Sie die Datenbank regelmäßig |
| Reverse Proxy ohne Server-Sent Events stört Passkeepr | Lassen Sie Server-Sent Events durch. |
| Eigener Host für Passkeepr | Betreiben Sie Passkeepr nach Möglichkeit auf dem COD-Server. Sonst vertrauenswürdiges Netz und gemeinsames Update |
| Leck-Prüfung braucht Zugang aus dem Browser | Erlauben Sie den Dienst Pwned Passwords im Proxy, wenn Sie die Prüfung nutzen wollen |
Weiterführend
- Modulseite Passkeepr
- OTP in der Doku
- Was Ihr Netz für Passkeepr braucht
- Updates
- Sicherheit
- Roadmap mit allen Neuerungen in COD 3.8
- Fehlerbilder
- Fragen zu den Modulen