32cc4de8be
Vorschlagsliste: Bisher galt jedes E-Mail-Feld als Anmeldefeld (isUsernameField gibt bei type=email bedingungslos true zurueck), und das Dropdown liegt mit maximalem z-index direkt unter dem Feld. Auf Seiten mit eigener Auswahlliste - etwa einem Benutzer-Picker - verdeckte es deren Treffer, die dadurch nicht mehr anklickbar waren. Zwei Regeln davor: Felder mit eigener Vorschlagsliste (ARIA-Combobox mit aria-autocomplete/aria-controls/aria-expanded oder <input list>) bekommen keine Vault-Vorschlaege mehr, sofern autocomplete sie nicht ausdruecklich als Anmeldefeld ausweist. Und sobald der Nutzer selbst tippt, blendet sich die Liste aus und bleibt es, bis das Feld wieder leer ist. 2FA-Code bereitlegen: Nach dem Ausfuellen eines Eintrags mit 2FA bleibt dieser fuenf Minuten vorgemerkt. Taucht danach ein 2FA-Feld auf oder wird es fokussiert - auch auf einer Folgeseite -, wird ein frischer Code geholt und in die Zwischenablage gelegt, statt wie bisher nur einmal zum Fuellzeitpunkt (wo er bis zum 2FA-Schritt laengst rotiert waere). Automatisch wird ausschliesslich kopiert; ins Feld geschrieben wird ein Code weiterhin nur bei ausdruecklicher Auswahl. Geschrieben wird zuerst ueber die Seite und, falls diese keinen Zugriff bekommt, ueber das Offscreen-Dokument des Hintergrunds. Abschaltbar in den Einstellungen. Beim Sperren des Tresors werden Vormerkung und ausstehender Fuellauftrag verworfen. Der Seiten-Scan des MutationObservers laeuft jetzt gedrosselt statt bei jeder einzelnen Mutation. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01G12DRMpe4UjYDwuRU1sjy1
111 lines
5.2 KiB
Markdown
111 lines
5.2 KiB
Markdown
<p align="center">
|
||
<img src="extension/icon128.png" width="88" alt="OpenNIT Vault">
|
||
</p>
|
||
|
||
<h1 align="center">OpenNIT Vault – Browser-Erweiterung</h1>
|
||
|
||
<p align="center">
|
||
Passwort-Manager-Erweiterung für <a href="https://github.com/friloo/OpenNIT">OpenNIT</a> –
|
||
Autofill für Benutzer-, Passwort- und 2FA-Felder direkt im Browser.
|
||
</p>
|
||
|
||
---
|
||
|
||
## Was ist das?
|
||
|
||
**OpenNIT Vault** ist die Browser-Erweiterung zum Passwort-Tresor von OpenNIT. Sie verbindet sich mit
|
||
deiner selbst gehosteten OpenNIT-Instanz und bietet:
|
||
|
||
- 🔎 **Sofortsuche** über alle persönlichen und Team-Tresore
|
||
- ⌨️ **Autofill** von Benutzername, Passwort und **2FA/TOTP-Codes** – auch auf mehrstufigen Login-Seiten
|
||
- 💡 **Vorschläge direkt im Eingabefeld** (passend zur aufgerufenen Website)
|
||
- 👁️ **Detailansicht** mit Anzeigen/Kopieren von Zugangsdaten und 2FA-Code mit Countdown
|
||
- ➕ **Neue Einträge anlegen** inkl. **Passwort-Generator**
|
||
- 🔒 **PIN-Sperre** mit demselben PIN wie der Web-Tresor (Dauer frei wählbar, bis „bis Browser schließt")
|
||
- 🧹 **Zwischenablage-Auto-Clear** nach dem Kopieren von Geheimnissen
|
||
- 📋 **2FA-Code bereitgelegt:** nach dem Ausfüllen landet beim nächsten 2FA-Feld – auch auf einer
|
||
Folgeseite – automatisch ein frischer Code in der Zwischenablage (Strg + V genügt)
|
||
- 🖼️ **Favicons** der hinterlegten Seiten (serverseitig gecacht – keine externen Aufrufe)
|
||
- 🌙 **Heller & dunkler Modus** (folgt dem System)
|
||
|
||
<p align="center">
|
||
<img src="store/screenshots/01-uebersicht.png" width="49%">
|
||
<img src="store/screenshots/02-detail.png" width="49%">
|
||
</p>
|
||
|
||
## Wie es funktioniert
|
||
|
||
Die Erweiterung ist ein reiner **Client** zu deiner OpenNIT-Instanz. Sie enthält **keinen** eigenen Server
|
||
und **keinen** Remote-Code – alle Skripte sind im Paket enthalten. Kommuniziert wird ausschließlich mit dem
|
||
von dir konfigurierten OpenNIT-Server über dessen REST-API (`/api/vault/extension/...`) per **Bearer-Token**.
|
||
|
||
- Die Anmeldung erfolgt ausschließlich per **SSO** („Mit OpenNIT anmelden"). Die Erweiterung erhält dabei
|
||
ein kurzlebiges, rotierendes Zugriffstoken – ein manuelles Erzeugen von Tokens entfällt.
|
||
- Passwörter werden **serverseitig** ver-/entschlüsselt; die Erweiterung fordert das Klartext-Passwort
|
||
eines Eintrags erst **im Moment des Ausfüllens/Kopierens** an – nicht beim Laden der Liste.
|
||
- Es findet **keine** Ende-zu-Ende-Entschlüsselung im Browser statt; die Erweiterung speichert keine
|
||
Passwörter dauerhaft (nur Server-URL, Sitzungstoken und Einstellungen in `chrome.storage`).
|
||
|
||
Details: [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md) · Berechtigungen: [`docs/PERMISSIONS.md`](docs/PERMISSIONS.md)
|
||
|
||
> **Anmeldung per SSO:** „Mit OpenNIT anmelden" (OAuth 2.0 + PKCE) – Anmeldung wie an OpenNIT
|
||
> (lokal + 2FA / M365 / Keycloak), automatische Token-Erneuerung mit Rotation. Einen manuell eingetragenen
|
||
> API-Token unterstützt die Erweiterung nicht mehr.
|
||
|
||
## Installation
|
||
|
||
### Aus dem Chrome Web Store
|
||
|
||
Am einfachsten für Endnutzer: den Store-Eintrag öffnen und **„Hinzufügen"** klicken. Anschließend die
|
||
Erweiterung anheften, Einstellungen öffnen, **Server-URL** eintragen und **„Mit OpenNIT anmelden"** (SSO).
|
||
|
||
> Store-Link folgt, sobald die Veröffentlichung abgeschlossen ist.
|
||
|
||
### Aus dem Quellcode (Entwickler / self-hosted)
|
||
|
||
1. `chrome://extensions` öffnen, **Entwicklermodus** aktivieren.
|
||
2. **„Entpackte Erweiterung laden"** → den Ordner [`extension/`](extension/) auswählen.
|
||
3. Erweiterung anheften, Einstellungen öffnen, **Server-URL** eintragen und **„Mit OpenNIT anmelden"** (SSO).
|
||
|
||
Ausführliche Anleitung: [`docs/INSTALL.md`](docs/INSTALL.md).
|
||
|
||
### Aus dem OpenNIT-Backend
|
||
|
||
Jede OpenNIT-Instanz bietet im Backend unter **Admin → Vault-Erweiterung** (`/admin/vault/extension`)
|
||
einen ZIP-Download der Erweiterung (mit vorausgefüllter Server-URL) samt Einrichtungsanleitung. Diese
|
||
generische Variante hier ist für die Veröffentlichung im Chrome Web Store bzw. als eigenständiges
|
||
Repository gedacht.
|
||
|
||
## Konfiguration
|
||
|
||
| Einstellung | Beschreibung |
|
||
|--------------------|--------------|
|
||
| **Server-URL** | Adresse deiner OpenNIT-Instanz, ohne abschließenden Slash (`https://…`). |
|
||
| **Anmeldung** | Ausschließlich per **SSO** („Mit OpenNIT anmelden"). |
|
||
| **PIN-Sperre** | Aus / 5 Min / 15 Min / 1 Std / bis der Browser geschlossen wird. Nutzt den **Tresor-PIN**. |
|
||
| **Zwischenablage** | Nach 30 s automatisch leeren (Standard: an). |
|
||
| **2FA bereitlegen** | Frischen 2FA-Code beim nächsten 2FA-Feld in die Zwischenablage legen (Standard: an). |
|
||
|
||
## Build / Paketierung
|
||
|
||
```bash
|
||
./build.sh # erzeugt dist/opennit-vault-<version>.zip aus extension/
|
||
```
|
||
|
||
## Sicherheit & Datenschutz
|
||
|
||
- Kein Remote-Code, keine Telemetrie, keine Drittanbieter-Server.
|
||
- Datenfluss ausschließlich Browser ⇄ deine OpenNIT-Instanz.
|
||
- Datenschutzerklärung: [`PRIVACY.md`](PRIVACY.md).
|
||
|
||
Sicherheitslücken bitte **nicht** über öffentliche Issues melden, sondern vertraulich an das OpenNIT-Team.
|
||
|
||
## Verhältnis zu OpenNIT
|
||
|
||
Diese Erweiterung ist Teil des OpenNIT-Projekts. Der Quellcode wird in OpenNIT serverseitig generiert
|
||
(`src/Controllers/VaultApiController.php`); dieses Repository ist die eigenständige, generische Fassung
|
||
für Distribution und Store.
|
||
|
||
## Lizenz
|
||
|
||
[GNU AGPL-3.0](LICENSE) – wie OpenNIT.
|