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

# Workplace association

De module **Workplace association** declareert de instantie van Systancia Workplace waarmee Bastion zich verbindt: de reverse proxy die de Workplace-desktops via Bastion levert, de HTML5 Edge Gateways die worden gebruikt om de Workplace-applicaties te starten, en de optionele samenvoeging van de Workplace- consolemodules in die van Bastion.

Het scherm wordt bestuurd door één enkel selectievakje, **Enable Workplace association**: zolang dat niet is aangevinkt, zijn de vier onderstaande secties **uitgeschakeld**.

> **De samenvoeging van de consoles is wat de Workplace-modules zichtbaar maakt**
>
> De schermen van het Workplace-bereik — toegangscontracten, VDI-desktops, virtualisatie- hosts, virtuele machines, firewall — verschijnen alleen in de console wanneer de koppeling actief is **en** de sectie **Console merging** ook actief is.

## Communicatie met Workplace

| Veld | Beschrijving |
|---|---|
| **Internal URL** | Samengestelde regel: een vervolgkeuzelijst voor het protocol (**http** of **https**), dan `://`, dan het interne adres van de Workplace-server. Verplicht. De keuze **http** schakelt de certificaatoptie van de sectie [Console merging](#console-merging) uit en vinkt die af. |
| **Virtualhost IP (external IP)** | Extern adres waaronder Bastion Workplace beschikbaar stelt. Het prefix `https://` wordt vast vóór het invoerveld weergegeven. Verplicht. |

## Reverse Proxy

| Veld | Beschrijving |
|---|---|
| **Site** | Site via welke Bastion Workplace bereikt om instellingen vanuit de console te lezen en te schrijven. Verplicht. De sites via welke de **gebruikers** de Workplace-desktops bereiken, worden daarentegen in de toegangscontracten gedefinieerd. |
| **Login attribute** | Naam van het veld van het SSO-formulier dat de gebruikersnaam bevat. Verplicht. |
| **Password attribute** | Naam van het veld van het SSO-formulier dat het wachtwoord bevat. Verplicht. |
| **Open the Workplace Console at the opening of Bastion** | Indien aangevinkt, wordt de Workplace-console geopend bij elke verbinding met de Bastion-console. |

### HTML5 Gateways

Een uitklapbare subsectie die de HTML5 Gateways opsomt die de Workplace-applicaties starten. De tabel heeft twee kolommen, **Full address** en **Redirection**; zolang er geen Edge Gateway is gedeclareerd, geeft ze **No available gateways** weer. Daarboven staan drie knoppen: **Add**, **Properties** (enkelvoudige selectie) en **Delete**.

Het venster voor toevoegen bevat slechts twee labels, waarvan het eerste drie invoervelden dekt:

| Veld | Beschrijving |
|---|---|
| **Full address** | Een vast `https://`, dan de HTML5-server, dan `:` en de poort (standaard `18443`), dan `/` en het HTML5-pad (standaard `systanciaHTML5-6.0`). Alle drie de invoervelden zijn verplicht. |
| **Redirection** | Omleidingspad, voorgevuld met `/systanciaHTML5-6.0/`. Verplicht. |

> **Certificaat van de HTML5-server**
>
> Bij elke toevoeging herinnert de console eraan: **Warning: the HTML5 server certificate must be on the client used**. Zonder dat certificaat mislukt het starten van de applicaties op het werkstation van de gebruiker.

## Console merging

Een sectie die **standaard is ingeklapt**, met een selectievakje in de titel. Uitklappen schakelt de inhoud in; inklappen schakelt de inhoud uit en sluit die uit van het opslaan. Zodra de samenvoeging is ingericht, worden de Workplace-modules bereikbaar in de Bastion-console en de applicaties van beide producten worden door hetzelfde gebruikersportaal geleverd.

| Veld | Beschrijving |
|---|---|
| **Authentication Domain** | Authenticatiedomein van Workplace. Verplicht. |
| **Administrator account** | Beheerdersaccount van dat domein. Verplicht. |
| **Password** | Wachtwoord van dat account, gemaskeerd. Kan bij het wijzigen leeg blijven: de opgeslagen waarde wordt dan behouden. |
| **Use specific certificate authorities to validate the server certificate** | **Uitgeschakeld** zolang het protocol dat is gekozen in de sectie [Communicatie met Workplace](#communication-with-workplace) `http` is. Zodra dit is aangevinkt, wordt het volgende veld verplicht. Het vinkt zichzelf aan wanneer er al een certificaat is opgeslagen. |
| **Certificate authorities to validate the server certificate (base64 encoding)** | Bestandskiezer. Het bestand moet **minder dan 20 KB** wegen en de inhoud ervan moet beginnen met `-----BEGIN CERTIFICATE---`; anders antwoordt de console **This file is not a valid base64-encoded certificate** en wordt de selectie geannuleerd. |

### Connectiviteitstest

Een uitklapbare subsectie, standaard ingeklapt. De knop **Configuration test** ondervraagt Workplace met de op dat moment ingevoerde waarden — het is dus niet nodig op te slaan voordat u test.

| Resultaat | Weergave |
|---|---|
| Gelukt | **Connectivity test succeeded.** gevolgd door **Workplace version: [version]**, in vet |
| Onvoldoende parameters | **Incomplete configuration**, in rood |
| Verbindingsfout | **Connectivity test failed.**, in rood |

## Options

| Veld | Beschrijving |
|---|---|
| **Enable Bastion theme** | Past het Bastion-thema toe op de Workplace-desktops die via de reverse proxy worden geleverd. |

## Opslaan

Met de knop **Validate** worden alle actieve secties opgeslagen.

> **Opnieuw laden van de console**
>
> Als de staat van de **samenvoeging van de consoles** is gewijzigd, vraagt de console **Do you want to refresh the page so that the option changes can take effect?** onder de titel **Confirmation**. Als u ja antwoordt, wordt de pagina opnieuw geladen, waardoor de Workplace-modules in het menu verschijnen of daaruit verdwijnen.
