OpenNIT-Vault-Extension/docs/INSTALL.md

Installation & Einrichtung

Voraussetzungen

• Eine erreichbare OpenNIT-Instanz mit aktiviertem Modul Passwort-Tresor.
• Ein Chromium-basierter Browser (Chrome, Edge, Brave, Vivaldi …).

1. Erweiterung laden

A) Entpackt aus dem Quellcode (Entwicklung / self-hosted)

1. chrome://extensions öffnen.
2. Oben rechts Entwicklermodus einschalten.
3. „Entpackte Erweiterung laden" klicken und den Ordner extension/ auswählen.
4. Die Erweiterung erscheint in der Liste; per Puzzle-Symbol an die Toolbar anheften.

B) Aus dem Chrome Web Store

Sobald veröffentlicht: im Store nach „OpenNIT Vault" suchen und „Hinzufügen" klicken.

C) Fertiges ZIP aus dem OpenNIT-Backend

Im OpenNIT-Web-Tresor gibt es unter „Extension" einen ZIP-Download mit bereits vorausgefüllter Server-URL. Diesen entpacken und wie unter A) laden.

2. Anmelden

Empfohlen – SSO: In den Erweiterungs-Einstellungen die Server-URL eintragen und auf „Mit OpenNIT anmelden" klicken. Es öffnet sich die gewohnte OpenNIT-Anmeldung (lokal + 2FA / Microsoft 365 / Keycloak). Nach erfolgreicher Anmeldung und Zustimmung ist die Erweiterung verbunden – der Zugang wird automatisch erneuert. Über „Abmelden" wird die Sitzung serverseitig widerrufen.

Voraussetzung: Der Betreiber muss ggf. die Redirect-URI der Erweiterung hinterlegen (Backend → Administration → Vault-Erweiterung). *.chromiumapp.org ist standardmäßig erlaubt.

Alternative – manueller Token (Kiosk/Headless ohne interaktiven Login): siehe Abschnitt „Erweitert" in den Einstellungen und die folgenden Schritte.

2b. Manuellen Token erzeugen

1. In OpenNIT den Passwort-Tresor öffnen.
2. Auf „Extension" klicken und einen API-Token generieren.
3. Der Token wird nur einmal angezeigt – kopieren.

Der Token verschlüsselt serverseitig deinen Vault-Schlüssel. Behandle ihn wie ein Passwort.

3. Erweiterung konfigurieren

1. Auf das OpenNIT-Vault-Symbol klicken → Zahnrad Einstellungen (oder chrome://extensions → Details → Erweiterungsoptionen).
2. Server-URL eintragen (z. B. https://vault.firma.de, ohne / am Ende).
3. API-Token einfügen → Speichern.
4. Verbindung testen – es sollte „Verbunden als …" erscheinen.

4. Optional: PIN-Sperre

1. In OpenNIT unter Tresor-PIN einen PIN festlegen (falls noch nicht geschehen).
2. In den Erweiterungs-Einstellungen unter Sicherheit eine Sperrdauer wählen (5 Min / 15 Min / 1 Std / bis der Browser geschlossen wird).
3. Ab jetzt verlangt die Erweiterung nach Ablauf den Tresor-PIN, bevor Zugangsdaten sichtbar werden.

5. Nutzung

• Autofill: Login-Feld auf einer Website anklicken → Vorschläge erscheinen → Eintrag wählen.
• Popup: Symbol anklicken → suchen → Eintrag anklicken für Details (Anzeigen/Kopieren, 2FA, „Auf dieser Seite ausfüllen").
• Neu anlegen: im Popup auf + → Felder ausfüllen, Passwort per Generator erzeugen → Speichern.

Fehlerbehebung

Problem	Ursache / Lösung
„Nicht verbunden"	Server-URL/Token prüfen; endet die URL ohne /? Ist die Instanz erreichbar (HTTPS/Zertifikat)?
Keine Vorschläge auf einer Seite	Ist der Tresor per PIN gesperrt? Passt eine hinterlegte URL zur Domain? Seite neu laden.
„Seite nicht bereit" beim Ausfüllen	Seite einmal neu laden, damit das Content-Script aktiv ist.
Favicons fehlen	Werden serverseitig per Cron nachgeladen; erscheinen nach dem ersten Durchlauf.