76 lines
3.5 KiB
Markdown
76 lines
3.5 KiB
Markdown
# 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. |
|