Wie richte ich einen Proxyserver im JURA KI Assistenten ein?

Question

Accepted Answer

Überblick
Der JURA KI Assistent benötigt für verschiedene Funktionen eine Verbindung zum Internet. Dazu gehören insbesondere Updates, Downloads, die Lizenzprüfung, die Anmeldung mit RA-MICRO Online, die Validierung von Fundstellen sowie Anfragen an externe KI-Sprachmodelle.
In Kanzlei- und Unternehmensumgebungen erfolgt der Internetzugriff häufig über einen Proxyserver. In diesem Fall müssen die Proxy-Einstellungen korrekt eingerichtet sein, damit der JURA KI Assistent die benötigten Verbindungen herstellen kann.
Die nachfolgenden Hinweise richten sich insbesondere an die Kunden-IT oder den zuständigen Systemadministrator.
 
Hintergrund
Ein Proxyserver vermittelt den Internetzugriff zwischen dem lokalen Gerät bzw. Terminalserver und externen Diensten. Je nach Sicherheitskonfiguration dürfen Programme nur dann auf externe Ressourcen zugreifen, wenn sie den vorgesehenen Proxyserver verwenden.
Ist der Proxyserver nicht oder nicht korrekt eingerichtet, kann es beispielsweise dazu kommen, dass Updates nicht geladen werden, Downloads abbrechen, die Anmeldung nicht zuverlässig funktioniert, die Lizenzprüfung fehlschlägt, Fundstellen nicht validiert werden können oder Anfragen an externe KI-Sprachmodelle fehlschlagen.
Zusätzlich können Firewall, Webfilter, HTTPS-/SSL-Inspection oder Endpoint-Security-Lösungen Einfluss auf die Verbindung nehmen.
 
Wann ist ein Proxyserver relevant?
Ein Proxyserver ist insbesondere dann relevant, wenn der Internetzugriff in der Kanzlei oder im Unternehmen zentral gesteuert wird.
Typische Hinweise auf eine Proxyumgebung sind:
• Webseiten können nur über bestimmte Netzwerkeinstellungen geöffnet werden.
• Programme benötigen eigene Proxy-Einstellungen, um auf das Internet zuzugreifen.
• Der Internetzugriff funktioniert im Browser, aber nicht in einzelnen Anwendungen.
• Auf einem Terminalserver gelten andere Netzwerkeinstellungen als auf lokalen Arbeitsplätzen.
• Firewall- oder Webfilter-Protokolle zeigen blockierte Verbindungen.
• Anfragen an externe KI-Sprachmodelle schlagen fehl, obwohl API-Key und Modell korrekt eingerichtet sind.
• Updates, Lizenzprüfung oder Fundstellenvalidierung funktionieren nicht zuverlässig.
 
Proxyserver im JURA KI Assistenten eintragen
Der Proxyserver kann im JURA KI Assistenten im Bereich Einstellungen > Allgemein hinterlegt werden. Gehen Sie dazu wie folgt vor:
Öffnen Sie den JURA KI Assistenten.
Öffnen Sie die Einstellungen.
Wechseln Sie zu Allgemein.
Aktivieren Sie die Proxy-Einstellungen.
Tragen Sie die von Ihrer IT bereitgestellte Proxy-IP oder den Proxy-Hostnamen ein.
Tragen Sie den Proxy-Port ein.
Falls der Proxy eine Anmeldung erfordert, tragen Sie Benutzername und Passwort ein.
Speichern Sie die Einstellungen.
Testen Sie anschließend die betroffene Funktion erneut, zum Beispiel Update, Anmeldung, Lizenzprüfung, Fundstellenvalidierung, Download oder Anfrage an ein externes KI-Sprachmodell.
 
Besonderheiten in Kanzlei- und Unternehmensumgebungen
In verwalteten IT-Umgebungen können Proxyserver unterschiedlich umgesetzt sein. Möglich sind zum Beispiel systemweite Proxy-Einstellungen, benutzerbezogene Proxy-Regeln, Proxy-Konfigurationen über Gruppenrichtlinien oder separate Einstellungen für Terminalserver.
Bitte beachten Sie insbesondere:
• Proxy-Einstellungen können je nach Benutzer unterschiedlich sein.
• Auf einem Terminalserver können andere Regeln gelten als auf einem lokalen Arbeitsplatz.
• Webfilter können bestimmte Anbieter-Domains blockieren.
• HTTPS-/SSL-Inspection kann verschlüsselte Verbindungen beeinflussen.
• Lokale Verbindungen zu localhost und 127.0.0.1 sollten nicht über den Proxyserver geleitet werden.
• Sicherheitssoftware kann Verbindungen trotz korrekt eingetragenem Proxyserver blockieren.
 
Typische Hinweise auf Proxyprobleme
Typische Hinweise auf Proxy- oder Netzwerkkonfigurationsprobleme sind:
• Updates werden nicht heruntergeladen oder brechen ab.
• Downloads starten nicht oder bleiben nach kurzer Zeit stehen.
• Die Anmeldung funktioniert nicht zuverlässig.
• Die Lizenzprüfung kann nicht durchgeführt werden.
• Fundstellen können nicht validiert werden.
• Anfragen an externe KI-Sprachmodelle schlagen fehl.
• API-Key und Modell sind korrekt eingerichtet, die Anfrage wird aber nicht verarbeitet.
• Der Fehler tritt nur im Kanzlei- oder Unternehmensnetzwerk auf.
• Der Fehler tritt auf dem Terminalserver auf, aber nicht an einem lokalen Arbeitsplatz.
• Der Browser kann Webseiten öffnen, der JURA KI Assistent erreicht externe Dienste aber nicht.
• Firewall-, Proxy- oder Webfilter-Protokolle zeigen blockierte Verbindungen.
Diese Hinweise müssen nicht ausschließlich durch den Proxyserver verursacht werden. Sie sind aber ein sinnvoller Ansatzpunkt für die technische Prüfung.
 
Zusammenfassung - Prüfung durch die Kunden-IT
Bitte lassen Sie durch Ihre IT oder den zuständigen Systemadministrator insbesondere prüfen:
• Ist ein Proxyserver für den Internetzugriff erforderlich?
• Welche Proxy-IP oder welcher Proxy-Hostname muss verwendet werden?
• Welcher Proxy-Port muss verwendet werden?
• Ist für den Proxyserver eine Authentifizierung erforderlich?
• Falls ja: Sind Benutzername und Passwort korrekt?
• Gelten die Proxy-Einstellungen für den jeweiligen Benutzer, Arbeitsplatz oder Terminalserver?
• Sind ausgehende HTTPS-Verbindungen über den Proxyserver erlaubt?
• Werden die benötigten JURA KI-Adressen durch Proxy, Firewall oder Webfilter zugelassen?
• Werden die Dienste für Updates, Downloads, Lizenzprüfung, RA-MICRO Online Anmeldung und Fundstellenvalidierung zugelassen?
• Werden die API-Dienste des verwendeten KI-Anbieters zugelassen?
• Ist HTTPS-/SSL-Inspection aktiv und beeinflusst diese Verbindungen?
• Werden lokale Verbindungen zu localhost und 127.0.0.1 vom Proxy ausgenommen?
• Gibt es blockierte Verbindungen in Proxy-, Firewall- oder Webfilter-Protokollen?
 
Weiterführende Beiträge und Anleitungen
Zusätzlich hilfreich sind folgende FAQ-Beiträge:
Welche Firewall- und Antivirus-Ausnahmen benötigt der JURA KI Assistent?
Warum kann der JURA KI Assistent keine Verbindung zum KI-Anbieter herstellen?
Warum wird mein API-Key als ungültig oder nicht nutzbar erkannt?
Was sind API-Fehler und was kann ich selbst tun?
Ausführliche Schritt-für-Schritt-Anleitungen finden Sie hier:
Konfiguration von Firewalls für den JURA KI Assistenten
https://ki-lab.dictanet.com/downloads/JURA_KI-Whitelist-Anleitung.pdf
Konfiguration von SOPHOS Firewalls für den JURA KI Assistenten
https://ki-lab.dictanet.com/downloads/JURA_KI-Whitelist-Anleitung_SOPHOS.pdf
Konfiguration von Antivirenprogrammen für den JURA KI Assistenten
https://ki-lab.dictanet.com/downloads/JURA_KI-Antivirenprogramm-Anleitung.pdf
Konfiguration von SOPHOS Antivirenprogrammen für den JURA KI Assistenten
https://ki-lab.dictanet.com/downloads/JURA_KI-Antivirenprogramm-Anleitung_SOPHOS.pdf
 
Falls das Problem weiterhin besteht
Besteht das Problem weiterhin, wenden Sie sich bitte an unseren Support unter: jura-ki@jurasoft.de
Teilen Sie uns möglichst die nachfolgenden Informationen mit und übersenden Sie die Log-Dateien des JURA KI Assistenten. Dadurch können wir den Fehler genauer eingrenzen und gezielte Lösungsansätze unterbreiten.
Bitte teilen Sie uns mit:
• Wird Windows, Windows Terminalserver oder macOS eingesetzt?
• Ist ein Proxyserver im Einsatz?
• Welche Proxy-IP oder welcher Proxy-Hostname wurde eingetragen?
• Welcher Proxy-Port wurde eingetragen?
• Ist eine Proxy-Authentifizierung erforderlich?
• Tritt das Problem bei allen Benutzern oder nur bei einzelnen Benutzern auf?
• Tritt das Problem bei Updates, Downloads, Anmeldung, Lizenzprüfung, Fundstellenvalidierung oder Anfragen an externe KI-Sprachmodelle auf?
• Welcher KI-Anbieter bzw. welches KI-Sprachmodell wurde ausgewählt?
• Wird eine Fehlermeldung angezeigt? Falls ja, senden Sie bitte einen Screenshot mit.
• Gibt es blockierte Verbindungen in Proxy-, Firewall- oder Webfilter-Protokollen?
Bitte fügen Sie Ihrer E-Mail außerdem die Log-Dateien bei.
 
Log-Dateien unter Windows
Unter Windows befinden sich die Log-Dateien im folgenden Verzeichnis:
C:\ProgramData\JuraSoft\Jura-KI\logs
Kopieren Sie den Pfad C:\ProgramData\JuraSoft\Jura-KI in die Adresszeile des Datei-Explorers und drücken Sie die Eingabetaste. Der Ordner „ProgramData“ ist standardmäßig ausgeblendet, über die Adresszeile gelangen Sie trotzdem dorthin.
Klicken Sie mit der rechten Maustaste auf den Ordner logs.
Wählen Sie (je nach Windows-Version) Senden an → ZIP-komprimierter Ordner oder Komprimieren in ZIP-Datei.
Fügen Sie die erstellte ZIP-Datei Ihrer E-Mail bei.
 
Log-Dateien unter macOS
Unter macOS befinden sich die Log-Dateien im Benutzerordner unter:
~/Library/Application Support/JuraSoft/Jura-KI/logs
Öffnen Sie den Finder und wählen Sie in der Menüleiste Gehe zu → Gehe zum Ordner … (Tastenkombination Umschalt + Befehl + G).
Geben Sie ~/Library/Application Support/JuraSoft/Jura-KI ein und drücken Sie die Eingabetaste. Das Zeichen ~ steht für Ihren Benutzerordner; der ausgeblendete Ordner „Library“ wird so direkt geöffnet.
Klicken Sie mit der rechten Maustaste (oder bei gedrückter Ctrl-Taste) auf den Ordner logs und wählen Sie „logs“ komprimieren.
Fügen Sie die erstellte ZIP-Datei Ihrer E-Mail bei.