> Source: https://docs.cyberelements.io/bastion/4.6/de/Usage/AdminConsoleReference/WorkplaceAssociation/

# Workplace association

Das Modul **Workplace association** deklariert die Instanz von Systancia Workplace, mit der sich Bastion verbindet: den Reverse Proxy, der die Workplace-Desktops über Bastion bereitstellt, die HTML5 Edge Gateways, die zum Start der Workplace-Anwendungen dienen, und die optionale Zusammenführung der Workplace- Konsolenmodule in die von Bastion.

Der Bildschirm wird von einem einzigen Kontrollkästchen gesteuert, **Enable Workplace association**: Solange es nicht markiert ist, sind die vier folgenden Abschnitte **deaktiviert**.

> **Die Zusammenführung der Konsolen ist es, die die Workplace-Module sichtbar macht**
>
> Die Bildschirme des Workplace-Bereichs — Zugriffsverträge, VDI-Desktops, Virtualisierungs- hosts, virtuelle Maschinen, Firewall — erscheinen in der Konsole nur, wenn die Zuordnung aktiv ist **und** der Abschnitt **Console merging** ebenfalls aktiv ist.

## Kommunikation mit Workplace

| Feld | Beschreibung |
|---|---|
| **Internal URL** | Zusammengesetzte Zeile: eine Dropdown-Liste für das Protokoll (**http** oder **https**), dann `://`, dann die interne Adresse des Workplace-Servers. Obligatorisch. Die Wahl von **http** deaktiviert die Zertifikatsoption von Abschnitt [Console merging](#console-merging) und hebt ihre Markierung auf. |
| **Virtualhost IP (external IP)** | Externe Adresse, unter der Bastion Workplace bereitstellt. Das Präfix `https://` wird fest vor dem Eingabefeld angezeigt. Obligatorisch. |

## Reverse Proxy

| Feld | Beschreibung |
|---|---|
| **Site** | Standort, über den Bastion Workplace erreicht, um Parameter aus der Konsole zu lesen und zu schreiben. Obligatorisch. Die Standorte, über die die **Benutzer** die Workplace-Desktops erreichen, werden hingegen in den Zugriffsverträgen definiert. |
| **Login attribute** | Name des Feldes des SSO-Formulars, das den Benutzernamen trägt. Obligatorisch. |
| **Password attribute** | Name des Feldes des SSO-Formulars, das das Kennwort trägt. Obligatorisch. |
| **Open the Workplace Console at the opening of Bastion** | Wenn markiert, öffnet sich die Workplace-Konsole bei jeder Verbindung mit der Bastion-Konsole. |

### HTML5 Gateways

Ein aufklappbarer Unterabschnitt, der die HTML5 Gateways auflistet, die die Workplace-Anwendungen starten. Die Tabelle hat zwei Spalten, **Full address** und **Redirection**; solange kein Edge Gateway deklariert ist, zeigt sie **No available gateways** an. Darüber befinden sich drei Schaltflächen: **Add**, **Properties** (Einzelauswahl) und **Delete**.

Das Fenster zum Hinzufügen enthält nur zwei Bezeichnungen, von denen die erste drei Eingabefelder abdeckt:

| Feld | Beschreibung |
|---|---|
| **Full address** | Ein festes `https://`, dann der HTML5-Server, dann `:` und der Port (Standard `18443`), dann `/` und der HTML5-Pfad (Standard `systanciaHTML5-6.0`). Alle drei Eingabefelder sind obligatorisch. |
| **Redirection** | Umleitungspfad, vorbelegt mit `/systanciaHTML5-6.0/`. Obligatorisch. |

> **Zertifikat des HTML5-Servers**
>
> Bei jedem Hinzufügen erinnert die Konsole daran: **Warning: the HTML5 server certificate must be on the client used**. Ohne es scheitert der Start der Anwendungen auf dem Arbeitsplatz des Benutzers.

## Console merging

Ein Abschnitt, der **standardmäßig eingeklappt** ist, mit einem Kontrollkästchen in seinem Titel. Das Aufklappen aktiviert seinen Inhalt; das Einklappen deaktiviert den Inhalt und nimmt ihn vom Speichern aus. Sobald die Zusammenführung eingerichtet ist, werden die Workplace-Module in der Bastion-Konsole erreichbar, und die Anwendungen beider Produkte werden von demselben Benutzerportal bereitgestellt.

| Feld | Beschreibung |
|---|---|
| **Authentication Domain** | Authentifizierungsdomäne von Workplace. Obligatorisch. |
| **Administrator account** | Administratorkonto dieser Domäne. Obligatorisch. |
| **Password** | Kennwort dieses Kontos, verdeckt. Kann beim Bearbeiten leer bleiben: Der gespeicherte Wert wird dann beibehalten. |
| **Use specific certificate authorities to validate the server certificate** | **Deaktiviert**, solange das in Abschnitt [Kommunikation mit Workplace](#communication-with-workplace) gewählte Protokoll `http` ist. Ist es markiert, wird das nächste Feld obligatorisch. Es markiert sich selbst, wenn bereits ein Zertifikat gespeichert ist. |
| **Certificate authorities to validate the server certificate (base64 encoding)** | Dateiauswahl. Die Datei muss **kleiner als 20 KB** sein und ihr Inhalt mit `-----BEGIN CERTIFICATE---` beginnen; andernfalls antwortet die Konsole **This file is not a valid base64-encoded certificate** und die Auswahl wird abgebrochen. |

### Konnektivitätstest

Ein aufklappbarer Unterabschnitt, standardmäßig eingeklappt. Die Schaltfläche **Configuration test** fragt Workplace mit den aktuell eingegebenen Werten ab — es ist daher nicht erforderlich, vor dem Test zu speichern.

| Ergebnis | Anzeige |
|---|---|
| Erfolg | **Connectivity test succeeded.** gefolgt von **Workplace version: [version]**, in Fettschrift |
| Unzureichende Parameter | **Incomplete configuration**, in Rot |
| Verbindungsfehler | **Connectivity test failed.**, in Rot |

## Options

| Feld | Beschreibung |
|---|---|
| **Enable Bastion theme** | Wendet das Bastion-Thema auf die über den Reverse Proxy bereitgestellten Workplace-Desktops an. |

## Speichern

Die Schaltfläche **Validate** speichert alle aktiven Abschnitte.

> **Neuladen der Konsole**
>
> Wenn sich der Zustand der **Zusammenführung der Konsolen** geändert hat, fragt die Konsole **Do you want to refresh the page so that the option changes can take effect?** unter dem Titel **Confirmation**. Eine bejahende Antwort lädt die Seite neu, wodurch die Workplace-Module im Menü erscheinen oder daraus verschwinden.
