# Proxy-Einstellungen konfigurieren

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

<Callout type="info" title="Hinweis">
Die Datei `config.json` ist eine JSON-Konfigurationsdatei. Änderungen müssen daher in einer gültigen JSON-Struktur vorgenommen werden.
</Callout>

---

## Konfigurationsdatei öffnen

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

```text
%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.

<Callout type="tip" title="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.
</Callout>

---

## 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:

```json
{
  "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
  }
}
```

<Callout type="danger" title="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.
</Callout>

---

## 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.

<Callout type="danger" title="Wichtig">
Wenn Sie den `Proxy`-Abschnitt am Ende der bestehenden JSON-Datei ergänzen, muss hinter dem vorherigen Eintrag ein Komma gesetzt werden.
</Callout>

Beispiel:

```json
{
  "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.

```json
{
  "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.

```json
{
  "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"
    }
  }
}
```

<Callout type="danger" title="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.
</Callout>

---

## Werte anpassen

Passen Sie die folgenden Werte an Ihre Umgebung an:

| Einstellung | Beschreibung |
|---|---|
| `Enabled` | Aktiviert oder deaktiviert die Proxy-Verwendung. Verwenden Sie `true`, um den Proxy zu aktivieren. |
| `Url` | Adresse des Proxyservers, z. B. <code className="url-nowrap">http://proxy.example.com:8080</code>. |
| `BypassProxyOnLocal` | Gibt an, ob lokale Adressen am Proxy vorbeigeleitet werden sollen. |
| `UserCredentials` | Zugangsdaten für den Proxyserver. Verwenden Sie `null`, wenn keine Anmeldung erforderlich ist. |
| `Username` | Benutzername für die Proxy-Anmeldung. |
| `Password` | Passwort für die Proxy-Anmeldung. |

<Callout type="info" title="Hinweis">
Die Proxy-URL muss inklusive Protokoll und Port angegeben werden, z. B. <code className="url-nowrap">http://proxy.example.com:8080</code>.
</Callout>

---

## Beispiel: Proxy deaktivieren

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

```json
{
  "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:

```text
365 business Proxy Application Client
```

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

<Callout type="tip" title="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**.
</Callout>