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

# Workplace association

Modulis **Workplace association** deklaruoja Systancia Workplace egzempliorių, prie kurio Bastion jungiasi: atvirkštinį tarpinį serverį, per Bastion teikiantį Workplace darbalaukius, HTML5 Edge Gateway, naudojamus Workplace taikomosioms programoms paleisti, ir pasirenkamą Workplace konsolės modulių sujungimą su Bastion konsole.

Ekraną valdo vienas žymės langelis **Enable Workplace association**: kol jis nepažymėtas, keturios toliau esančios sekcijos yra **išjungtos**.

> **Workplace modulius atskleidžia būtent konsolių sujungimas**
>
> Workplace srities ekranai – prieigos sutartys, VDI darbalaukiai, virtualizavimo pagrindiniai kompiuteriai, virtualiosios mašinos, ugniasienė – konsolėje rodomi tik tada, kai susiejimas aktyvus **ir** sekcija **Console merging** taip pat aktyvi.

## Ryšys su Workplace

| Laukas | Aprašas |
|---|---|
| **Internal URL** | Sudėtinė eilutė: protokolo išplečiamasis sąrašas (**http** arba **https**), tada `://`, tada Workplace serverio vidinis adresas. Privaloma. Pasirinkus **http**, sekcijos [Console merging](#console-merging) sertifikato parinktis išjungiama ir jos žymėjimas panaikinamas. |
| **Virtualhost IP (external IP)** | Išorinis adresas, kuriuo Bastion pateikia Workplace. Prieš įvesties lauką rodomas fiksuotas priešdėlis `https://`. Privaloma. |

## Reverse Proxy

| Laukas | Aprašas |
|---|---|
| **Site** | Site, per kurį Bastion pasiekia Workplace, kad iš konsolės skaitytų ir rašytų parametrus. Privaloma. Site, per kuriuos **vartotojai** pasiekia Workplace darbalaukius, apibrėžiami prieigos sutartyse. |
| **Login attribute** | SSO formos lauko, kuriame perduodamas vartotojo vardas, pavadinimas. Privaloma. |
| **Password attribute** | SSO formos lauko, kuriame perduodamas slaptažodis, pavadinimas. Privaloma. |
| **Open the Workplace Console at the opening of Bastion** | Pažymėjus, Workplace konsolė atidaroma kiekvieną kartą prisijungiant prie Bastion konsolės. |

### HTML5 Gateways

Sutraukiamas posekcis, kuriame išvardyti Workplace taikomąsias programas paleidžiantys HTML5 Gateway. Lentelėje yra du stulpeliai – **Full address** ir **Redirection**; kol nė vienas Edge Gateway nėra deklaruotas, joje rodoma **No available gateways**. Virš jos yra trys mygtukai: **Add**, **Properties** (vienas pasirinkimas) ir **Delete**.

Pridėjimo lange yra tik dvi etiketės, iš kurių pirmoji apima tris įvesties laukus:

| Laukas | Aprašas |
|---|---|
| **Full address** | Fiksuotas `https://`, tada HTML5 serveris, tada `:` ir prievadas (numatytasis `18443`), tada `/` ir HTML5 kelias (numatytasis `systanciaHTML5-6.0`). Visi trys įvesties laukai privalomi. |
| **Redirection** | Peradresavimo kelias, iš anksto užpildytas `/systanciaHTML5-6.0/`. Privaloma. |

> **HTML5 serverio sertifikatas**
>
> Kiekvieną kartą pridedant konsolė primena: **Warning: the HTML5 server certificate must be on the client used**. Be jo taikomųjų programų paleidimas vartotojo darbo stotyje nepavyksta.

## Console merging

Sekcija, **pagal numatytuosius nustatymus sutraukta**, su žymės langeliu antraštėje. Ją išskleidus, įjungiamas jos turinys; ją sutraukus, turinys išjungiamas ir neįtraukiamas į įrašymą. Kai sujungimas sukonfigūruotas, Workplace moduliai tampa pasiekiami Bastion konsolėje, o abiejų produktų taikomąsias programas teikia tas pats vartotojo portalas.

| Laukas | Aprašas |
|---|---|
| **Authentication Domain** | Workplace autentifikavimo domenas. Privaloma. |
| **Administrator account** | To domeno administratoriaus paskyra. Privaloma. |
| **Password** | Tos paskyros slaptažodis, užmaskuotas. Redaguojant galima palikti tuščią: tada išsaugoma įrašyta reikšmė. |
| **Use specific certificate authorities to validate the server certificate** | **Išjungta**, kol sekcijoje [Ryšys su Workplace](#communication-with-workplace) pasirinktas protokolas yra `http`. Pažymėjus, kitas laukas tampa privalomas. Pažymima automatiškai, kai sertifikatas jau įrašytas. |
| **Certificate authorities to validate the server certificate (base64 encoding)** | Failų parinkiklis. Failas turi būti **mažesnis nei 20 KB**, o jo turinys turi prasidėti `-----BEGIN CERTIFICATE---`; kitu atveju konsolė atsako **This file is not a valid base64-encoded certificate** ir pasirinkimas atšaukiamas. |

### Ryšio testas

Sutraukiamas posekcis, pagal numatytuosius nustatymus sutrauktas. Mygtukas **Configuration test** užklausia Workplace naudodamas šiuo metu įvestas reikšmes – todėl nebūtina įrašyti prieš testuojant.

| Rezultatas | Rodinys |
|---|---|
| Sėkmė | **Connectivity test succeeded.**, po kurio paryškintu šriftu rodoma **Workplace version: [version]** |
| Nepakanka parametrų | **Incomplete configuration**, raudonai |
| Ryšio klaida | **Connectivity test failed.**, raudonai |

## Options

| Laukas | Aprašas |
|---|---|
| **Enable Bastion theme** | Pritaiko Bastion temą Workplace darbalaukiams, teikiamiems per atvirkštinį tarpinį serverį. |

## Išsaugojimas

Mygtukas **Validate** įrašo visas aktyvias sekcijas.

> **Konsolės įkėlimas iš naujo**
>
> Jei pasikeitė **konsolių sujungimo** būsena, konsolė klausia **Do you want to refresh the page so that the option changes can take effect?** lange su antrašte **Confirmation**. Atsakius teigiamai, puslapis įkeliamas iš naujo, todėl Workplace moduliai meniu atsiranda arba iš jo išnyksta.
