Sicherheitsänderung zum 1. Dezember 2026: TLS 1.2 wird Mindeststandard für 365 business Print Agent. Details und Systemanforderungen
365 business development
Support

Proxy-Einstellungen konfigurieren

Die Proxy-Einstellungen des 365 business Proxy Application Clients werden in der Datei config.json hinterlegt.

Hinweis

Die Datei config.json ist eine JSON-Konfigurationsdatei. Änderungen müssen daher in einer gültigen JSON-Struktur vorgenommen werden.


Konfigurationsdatei öffnen

Öffnen Sie die Datei config.json im folgenden Verzeichnis mit einem Texteditor, z. B. Notepad:

Code
%ProgramData%\365 business development GmbH\365 business Proxy Application\Client

Starten Sie den Texteditor im Administratormodus, da die Datei andernfalls möglicherweise nicht gespeichert werden kann.

Gut zu wissen

Unter Windows können Sie z. B. nach „Notepad“ suchen, per Rechtsklick Als Administrator ausführen wählen und die Datei anschließend über Datei > Öffnen auswählen.


Aufbau der Konfigurationsdatei

Die Datei enthält bereits bestehende Einstellungen des Clients, z. B. die WebSocket-Adresse, Tenant-ID, Client-ID und den Client-Namen.

Eine vereinfachte config.json kann beispielsweise so aussehen:

JSONCode
{ "WebSocketURL": "https://proxyapplication.365businessapi.com/Jobs", "TenantId": "00000000-0000-0000-0000-000000000000", "ClientId": "00000000-0000-0000-0000-000000000000", "ClientName": "Proxy Client Name", "IsEnabled": true, "Proxy": { "Enabled": false, "Url": null, "BypassProxyOnLocal": false, "UserCredentials": null } }

Wichtig

Ersetzen Sie nicht den gesamten Inhalt der Datei. Passen Sie nur den Abschnitt Proxy an oder ergänzen Sie diesen, falls er noch nicht vorhanden ist.


Proxy-Konfiguration ergänzen oder anpassen

Suchen Sie in der Datei nach dem Abschnitt Proxy.

Falls der Abschnitt bereits vorhanden ist, passen Sie die Werte innerhalb von Proxy an.

Falls der Abschnitt noch nicht vorhanden ist, fügen Sie ihn innerhalb des äußeren JSON-Objekts ein.

Wichtig

Wenn Sie den Proxy-Abschnitt am Ende der bestehenden JSON-Datei ergänzen, muss hinter dem vorherigen Eintrag ein Komma gesetzt werden.

Beispiel:

JSONCode
{ "WebSocketURL": "https://proxyapplication.365businessapi.com/Jobs", "TenantId": "00000000-0000-0000-0000-000000000000", "ClientId": "00000000-0000-0000-0000-000000000000", "ClientName": "Proxy Client Name", "IsEnabled": true, "Proxy": { "Enabled": true, "Url": "http://hostname:port", "BypassProxyOnLocal": false, "UserCredentials": null } }

Proxy ohne Benutzeranmeldung

Verwenden Sie diese Variante, wenn Ihr Proxyserver keine Benutzeranmeldung benötigt.

JSONCode
{ "WebSocketURL": "https://proxyapplication.365businessapi.com/Jobs", "TenantId": "00000000-0000-0000-0000-000000000000", "ClientId": "00000000-0000-0000-0000-000000000000", "ClientName": "Proxy Client Name", "IsEnabled": true, "Proxy": { "Enabled": true, "Url": "http://hostname:port", "BypassProxyOnLocal": false, "UserCredentials": null } }

Proxy mit Benutzeranmeldung

Verwenden Sie diese Variante, wenn Ihr Proxyserver eine Benutzeranmeldung benötigt.

JSONCode
{ "WebSocketURL": "https://proxyapplication.365businessapi.com/Jobs", "TenantId": "00000000-0000-0000-0000-000000000000", "ClientId": "00000000-0000-0000-0000-000000000000", "ClientName": "Proxy Client Name", "IsEnabled": true, "Proxy": { "Enabled": true, "Url": "http://hostname:port", "BypassProxyOnLocal": false, "UserCredentials": { "Username": "user.name", "Password": "p@ssword" } } }

Wichtig

Achten Sie darauf, dass der Abschnitt Proxy nur einmal in der Datei vorhanden ist. Wenn bereits ein Proxy-Abschnitt existiert, ändern Sie diesen bestehenden Abschnitt, anstatt einen zweiten einzufügen.


Werte anpassen

Passen Sie die folgenden Werte an Ihre Umgebung an:

EinstellungBeschreibung
EnabledAktiviert oder deaktiviert die Proxy-Verwendung. Verwenden Sie true, um den Proxy zu aktivieren.
UrlAdresse des Proxyservers, z. B. http://proxy.example.com:8080.
BypassProxyOnLocalGibt an, ob lokale Adressen am Proxy vorbeigeleitet werden sollen.
UserCredentialsZugangsdaten für den Proxyserver. Verwenden Sie null, wenn keine Anmeldung erforderlich ist.
UsernameBenutzername für die Proxy-Anmeldung.
PasswordPasswort für die Proxy-Anmeldung.

Hinweis

Die Proxy-URL muss inklusive Protokoll und Port angegeben werden, z. B. http://proxy.example.com:8080.


Beispiel: Proxy deaktivieren

Um die Proxy-Verwendung zu deaktivieren, setzen Sie Enabled auf false.

JSONCode
{ "WebSocketURL": "https://proxyapplication.365businessapi.com/Jobs", "TenantId": "00000000-0000-0000-0000-000000000000", "ClientId": "00000000-0000-0000-0000-000000000000", "ClientName": "Proxy Client Name", "IsEnabled": true, "Proxy": { "Enabled": false, "Url": null, "BypassProxyOnLocal": false, "UserCredentials": null } }

Datei speichern und Dienst neu starten

Speichern Sie die Datei config.json.

Starten Sie anschließend den Windows-Dienst neu:

Code
365 business Proxy Application Client

Die geänderten Proxy-Einstellungen werden erst nach dem Neustart des Dienstes übernommen.

Gut zu wissen

Sie können den Dienst über die Windows-Diensteverwaltung neu starten. Öffnen Sie dazu services.msc, suchen Sie den Dienst 365 business Proxy Application Client und wählen Sie Neu starten.

Last modified on