Konfiguration der Instanz
Eine Serverinstanz wird teilweise bei der Bereitstellung konfiguriert, über eine Konfigurationsdatei und Umgebungsvariablen. Das ergänzt die Oberfläche: Die meisten Einstellungen erfolgen in der Anwendung, und die Konfiguration dient der automatisierten Bereitstellung, den grundlegenden Parametern und dem Festschreiben bestimmter Entscheidungen.
Diese Seite beschreibt die Kategorien von Einstellungen und die Wiven-eigenen Variablen. Die vollständige Referenz der Variablen wird mit der Installation geliefert.
Pflichtgeheimnisse
Drei Geheimnisse müssen lang, zufällig und für Ihre Installation eigen sein: Sie signieren die Sitzungen und verschlüsseln die von der Anwendung gespeicherten Geheimnisse. Verwenden Sie nie Beispielwerte erneut.
- Eine Änderung des Sitzungsgeheimnisses meldet alle Benutzer ab.
- Eine Änderung der Signaturgeheimnisse macht bereits verschlüsselte Geheimnisse unlesbar: SSO-Konnektoren, E-Mail- und Kalender-Tokens, Zwei-Faktor-Authentifizierung.
Speicher
Ein einziges Verzeichnis enthält Datenbank, Dokumente, Indizes, Modelle, Audit-Protokoll und Sicherheitsrichtlinien. Das ist im Betrieb der wichtigste Parameter: Er muss auf ein persistentes Volume zeigen, das zusammen mit der Konfigurationsdatei gesichert wird. Ist der Speicher nicht persistent, geht beim Neustart alles verloren.
Netzwerk und Dienst
- Die Ports der Anwendung und des Dienstes zur Dokumentextraktion sind konfigurierbar.
- TLS kann direkt in der Anwendung aktiviert werden, mit Ihrem Zertifikat und Ihrem Schlüssel. Stellt ein Reverse Proxy TLS bereit, lassen Sie das anwendungsseitige TLS deaktiviert.
- Hinter einem Reverse Proxy teilen Sie dies der Anwendung mit: Andernfalls sehen die Durchsatzgrenzen die tatsächliche Adresse der Besucher nicht.
Authentifizierung
- Einzelnes Passwort im Einzelbenutzermodus. Im Mehrbenutzermodus werden die Konten in der Anwendung verwaltet, und dieses Passwort hat keine Wirkung mehr.
- Sitzungsdauer: standardmässig 30 Tage.
- Regeln für die Passwortkomplexität: Länge, Kleinbuchstaben, Grossbuchstaben, Ziffern, Sonderzeichen.
- Gastsitzungen: neue Sitzungen pro Stunde, standardmässig 5 pro Adresse und 100 für die Instanz.
| Variable | Rolle |
|---|---|
WIVEN_LICENSE |
Die Lizenz WivenLLM Business selbst, als Alternative zur über die Wiven-Konsole installierten Datei |
WIVEN_MFA_REQUIRED_ROLES |
Rollen, für die die Zwei-Faktor-Authentifizierung Pflicht ist. Der Bildschirm kann sie nicht mehr ändern |
KI-Anbieter
Jeder Anbieter wird nach einem gleichbleibenden Schema konfiguriert: ein API-Schlüssel oder eine Dienstadresse, eine Modellpräferenz und manchmal eine Kontextgrenze, wenn diese nicht automatisch ermittelt werden kann. Drei Wahlen bestimmen die aktive Auswahl: der Anbieter des Sprachmodells, die Embedding-Engine und die Vektordatenbank.
Die Konfiguration des Sprachmodells wird beim ersten Start einmal in die Datenbank übernommen: Danach ist der in der Anwendung gespeicherte Wert massgebend. Embedding-Engine und Vektordatenbank bleiben durch die Konfiguration festgelegt. Stellen Sie jeden Punkt nur an einem Ort ein.
Sicherheit und Souveränität
Sind sie gesetzt, schreiben die folgenden Variablen WIVEN_ die Einstellung fest: Der entsprechende Bildschirm der Wiven-Konsole kann sie nicht mehr ändern.
| Variable | Rolle |
|---|---|
WIVEN_EGRESS_MODE |
Souveräner Modus: off, monitor (Standard, protokolliert ohne zu blockieren) oder strict |
WIVEN_PII_SHIELD |
PII-Schutz: off (Standard), external oder always |
WIVEN_GROUNDING |
Nicht belegte Aussagen: off (Standard), note oder verify |
WIVEN_MODEL_APPROVAL |
enforce verlangt freigegebene Modelle. Standardmässig deaktiviert |
AUDIT_RETENTION_MONTHS |
Aufzubewahrende Monate des Audit-Protokolls. Unbegrenzt, wenn nicht gesetzt |
AUDIT_SYSLOG_URL |
Weiterleitung des Audit-Protokolls an ein SIEM, über UDP oder TCP |
Betriebsoptionen
Weitere Installationseinstellungen erlauben unter anderem:
- die zentrale Einsicht in den Gesprächsverlauf und dessen Export zu entfernen;
- das Löschen von Arbeitsbereichen über die Oberfläche und über die API zu verbieten;
- die interaktive API-Dokumentation auszublenden;
- für jedes Web-Widget eine Liste erlaubter Domains zu verlangen;
- den Import von Seiten und das Weblesen der Agenten an interne Adressen zu erlauben oder nicht und dieses Lesen auf eine Liste von Hosts zu beschränken;
- die maximale Anzahl Tool-Aufrufe pro Agentenantwort (standardmässig 10) und die vorab bestätigten Fähigkeiten festzulegen, nie jedoch Senden, Beantworten oder Löschen von Nachrichten;
- die geplanten Aufgaben einzustellen: gleichzeitige Ausführungen (standardmässig 1) und maximale Dauer (standardmässig 5 Minuten);
- die Sprachen der Texterkennung zu wählen (standardmässig Englisch);
- die Frist für die erneute Synchronisation überwachter Dokumente festzulegen (standardmässig 7 Tage);
- die anonyme Telemetrie zu aktivieren, die standardmässig deaktiviert ist.
Lassen Sie die Telemetrie bei einer Installation mit Souveränitätsanforderung deaktiviert und dokumentieren Sie dies.
Bewährte Vorgehensweisen
Behandeln Sie die Konfigurationsdatei wie ein Geheimnis. Sie enthält alle Ihre Schlüssel. Beschränken Sie die Zugriffsrechte, versionieren Sie sie nicht, sichern Sie sie separat und verschlüsselt.
Erzeugen Sie echte Geheimnisse. Eine lange, von einem Generator erzeugte Zufallszeichenfolge für jeden der drei Pflichtwerte.
Prüfen Sie die Persistenz des Speichers vor der Inbetriebnahme: Starten Sie die Instanz neu und bestätigen Sie, dass Einstellungen und Dokumente noch vorhanden sind.
Dokumentieren Sie Ihre Entscheidungen. Welcher Anbieter, welche Embedding-Engine, welche Datenbank: Diese Informationen brauchen Sie für Ihr Bearbeitungsverzeichnis und für jeden späteren Eingriff.

Français