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

# Workplace association

Moduł **Workplace association** deklaruje instancję Systancia Workplace, z którą Bastion się łączy: reverse proxy udostępniający pulpity Workplace przez Bastion, serwery HTML5 Edge Gateway używane do uruchamiania aplikacji Workplace oraz opcjonalne scalenie modułów konsoli Workplace z konsolą Bastion.

Ekranem steruje jedno pole wyboru, **Enable Workplace association**: dopóki nie jest zaznaczone, cztery poniższe sekcje są **wyłączone**.

> **To scalenie konsol odsłania moduły Workplace**
>
> Ekrany z zakresu Workplace — kontrakty dostępu, pulpity VDI, hosty wirtualizacji, maszyny wirtualne, zapora — pojawiają się w konsoli tylko wtedy, gdy powiązanie jest aktywne **i** sekcja **Console merging** jest również aktywna.

## Komunikacja z Workplace

| Pole | Opis |
|---|---|
| **Internal URL** | Wiersz złożony: lista rozwijana protokołu (**http** lub **https**), następnie `://`, a potem adres wewnętrzny serwera Workplace. Obowiązkowe. Wybór **http** wyłącza opcję certyfikatu w sekcji [Console merging](#console-merging) i odznacza ją. |
| **Virtualhost IP (external IP)** | Adres zewnętrzny, pod którym Bastion udostępnia Workplace. Przedrostek `https://` jest wyświetlany na stałe przed polem wprowadzania. Obowiązkowe. |

## Reverse Proxy

| Pole | Opis |
|---|---|
| **Site** | Site, przez który Bastion dociera do Workplace, aby odczytywać i zapisywać ustawienia z konsoli. Obowiązkowe. Site, przez które **użytkownicy** docierają do pulpitów Workplace, definiuje się natomiast w kontraktach dostępu. |
| **Login attribute** | Nazwa pola formularza SSO zawierającego nazwę użytkownika. Obowiązkowe. |
| **Password attribute** | Nazwa pola formularza SSO zawierającego hasło. Obowiązkowe. |
| **Open the Workplace Console at the opening of Bastion** | Gdy zaznaczone, konsola Workplace otwiera się przy każdym połączeniu z konsolą Bastion. |

### HTML5 Gateways

Rozwijalna podsekcja wypisująca serwery HTML5 Gateway, które uruchamiają aplikacje Workplace. Tabela ma dwie kolumny, **Full address** i **Redirection**; dopóki nie zadeklarowano żadnego Edge Gateway, pokazuje **No available gateways**. Powyżej znajdują się trzy przyciski: **Add**, **Properties** (wybór pojedynczy) i **Delete**.

Okno dodawania zawiera tylko dwie etykiety, z których pierwsza obejmuje trzy pola wprowadzania:

| Pole | Opis |
|---|---|
| **Full address** | Stałe `https://`, następnie serwer HTML5, potem `:` i port (domyślnie `18443`), a następnie `/` i ścieżka HTML5 (domyślnie `systanciaHTML5-6.0`). Wszystkie trzy pola są obowiązkowe. |
| **Redirection** | Ścieżka przekierowania, wstępnie wypełniona wartością `/systanciaHTML5-6.0/`. Obowiązkowe. |

> **Certyfikat serwera HTML5**
>
> Przy każdym dodaniu konsola przypomina: **Warning: the HTML5 server certificate must be on the client used**. Bez niego uruchamianie aplikacji na stacji roboczej użytkownika się nie udaje.

## Console merging

Sekcja **domyślnie zwinięta**, z polem wyboru w tytule. Rozwinięcie jej włącza jej treść; zwinięcie wyłącza treść i wyłącza ją z zapisu. Gdy scalenie jest już gotowe, moduły Workplace stają się dostępne w konsoli Bastion, a aplikacje obu produktów są udostępniane przez ten sam portal użytkownika.

| Pole | Opis |
|---|---|
| **Authentication Domain** | Domena uwierzytelniania Workplace. Obowiązkowe. |
| **Administrator account** | Konto administratora tej domeny. Obowiązkowe. |
| **Password** | Hasło tego konta, zamaskowane. Przy edycji może pozostać puste: zachowywana jest wtedy wartość zapisana. |
| **Use specific certificate authorities to validate the server certificate** | **Wyłączone**, dopóki protokół wybrany w sekcji [Komunikacja z Workplace](#communication-with-workplace) to `http`. Po zaznaczeniu czyni następne pole obowiązkowym. Zaznacza się samo, gdy certyfikat jest już zapisany. |
| **Certificate authorities to validate the server certificate (base64 encoding)** | Selektor plików. Plik musi mieć **mniej niż 20 KB**, a jego treść zaczynać się od `-----BEGIN CERTIFICATE---`; w przeciwnym razie konsola odpowiada **This file is not a valid base64-encoded certificate** i wybór jest anulowany. |

### Test łączności

Rozwijalna podsekcja, domyślnie zwinięta. Przycisk **Configuration test** odpytuje Workplace z aktualnie wprowadzonymi wartościami — nie ma więc potrzeby zapisywania przed testem.

| Wynik | Wyświetlenie |
|---|---|
| Powodzenie | **Connectivity test succeeded.**, a po nim **Workplace version: [version]**, pogrubione |
| Niewystarczające parametry | **Incomplete configuration**, na czerwono |
| Niepowodzenie połączenia | **Connectivity test failed.**, na czerwono |

## Options

| Pole | Opis |
|---|---|
| **Enable Bastion theme** | Stosuje motyw Bastion do pulpitów Workplace udostępnianych przez reverse proxy. |

## Zapisywanie

Przycisk **Validate** zapisuje wszystkie aktywne sekcje.

> **Przeładowanie konsoli**
>
> Jeśli stan **scalenia konsol** się zmienił, konsola pyta **Do you want to refresh the page so that the option changes can take effect?** pod tytułem **Confirmation**. Odpowiedź twierdząca przeładowuje stronę, co sprawia, że moduły Workplace pojawiają się lub znikają z menu.
