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

# Workplace association

Il-modulu **Workplace association** jiddikjara l-istanza ta’ Systancia Workplace li magħha Bastion jorbot ruħu: ir-reverse proxy li jservi d-desktops ta’ Workplace permezz ta’ Bastion, il-komponenti HTML5 Edge Gateway użati biex jitnedew l-applikazzjonijiet ta’ Workplace, u l-għaqda fakultattiva tal-moduli tal-konsol ta’ Workplace f’dak ta’ Bastion.

L-iskrin huwa rregolat minn kaxxa ta’ selezzjoni waħda, **Enable Workplace association**: sakemm ma tkunx immarkata, l-erba’ taqsimiet ta’ hawn taħt huma **diżattivati**.

> **L-għaqda tal-konsols hija dik li turi l-moduli ta’ Workplace**
>
> L-iskrins tal-kamp ta’ Workplace — kuntratti ta’ aċċess, desktops VDI, ospitanti tal-virtwalizzazzjoni, magni virtwali, firewall — jidhru fil-konsol biss meta l-assoċjazzjoni tkun attiva **u** t-taqsima **Console merging** tkun attiva wkoll.

## Komunikazzjoni ma’ Workplace

| Qasam | Deskrizzjoni |
|---|---|
| **Internal URL** | Linja komposta: lista drop-down tal-protokoll (**http** jew **https**), imbagħad `://`, imbagħad l-indirizz intern tas-server Workplace. Obbligatorju. L-għażla ta’ **http** tiddiżattiva u tneħħi l-marka mill-għażla taċ-ċertifikat tat-taqsima [Console merging](#console-merging). |
| **Virtualhost IP (external IP)** | Indirizz estern li taħtu Bastion jesponi lil Workplace. Il-prefiss `https://` jintwera, fiss, qabel il-qasam tal-input. Obbligatorju. |

## Reverse Proxy

| Qasam | Deskrizzjoni |
|---|---|
| **Site** | Is-sit li permezz tiegħu Bastion jasal għal Workplace biex jaqra u jikteb is-settings mill-konsol. Obbligatorju. Is-siti li permezz tagħhom l-**utenti** jaslu għad-desktops ta’ Workplace huma minflok definiti fil-kuntratti ta’ aċċess. |
| **Login attribute** | Isem il-qasam tal-formola SSO li fih l-isem tal-utent. Obbligatorju. |
| **Password attribute** | Isem il-qasam tal-formola SSO li fih il-password. Obbligatorju. |
| **Open the Workplace Console at the opening of Bastion** | Meta jkun immarkat, il-konsol ta’ Workplace jinfetaħ f’kull konnessjoni mal-konsol Bastion. |

### HTML5 Gateways

Sottotaqsima li tingħalaq u tinfetaħ, li telenka l-komponenti HTML5 Gateway li jniedu l-applikazzjonijiet ta’ Workplace. Il-grilja għandha żewġ kolonni, **Full address** u **Redirection**; sakemm ma jkun iddikjarat l-ebda komponent Edge Gateway, turi **No available gateways**. Fuqha hemm tliet buttuni: **Add**, **Properties** (selezzjoni waħda) u **Delete**.

It-tieqa taż-żieda fiha żewġ tikketti biss, li l-ewwel waħda minnhom tkopri tliet oqsma tal-input:

| Qasam | Deskrizzjoni |
|---|---|
| **Full address** | `https://` fiss, imbagħad is-server HTML5, imbagħad `:` u l-port (default `18443`), imbagħad `/` u l-mogħdija HTML5 (default `systanciaHTML5-6.0`). It-tliet oqsma kollha huma obbligatorji. |
| **Redirection** | Mogħdija tar-ridirezzjoni, diġà mimlija b’`/systanciaHTML5-6.0/`. Obbligatorja. |

> **Ċertifikat tas-server HTML5**
>
> F’kull żieda, il-konsol ifakkar: **Warning: the HTML5 server certificate must be on the client used**. Mingħajru, it-tnedija tal-applikazzjonijiet tfalli fuq l-istazzjon tax-xogħol tal-utent.

## Console merging

Taqsima **magħluqa b’mod default**, b’kaxxa ta’ selezzjoni fit-titlu tagħha. Meta tiftaħha, jiġi attivat il-kontenut tagħha; meta tagħlaqha, il-kontenut jiġi diżattivat u eskluż mis-salvataġġ. Ladarba l-għaqda tkun stabbilita, il-moduli ta’ Workplace isiru aċċessibbli fil-konsol Bastion u l-applikazzjonijiet taż-żewġ prodotti jiġu servuti mill-istess portal tal-utent.

| Qasam | Deskrizzjoni |
|---|---|
| **Authentication Domain** | Dominju tal-awtentikazzjoni ta’ Workplace. Obbligatorju. |
| **Administrator account** | Kont tal-amministratur ta’ dak id-dominju. Obbligatorju. |
| **Password** | Il-password ta’ dak il-kont, mgħottija. Tista’ tibqa’ vojta waqt l-editjar: f’dak il-każ jinżamm il-valur maħżun. |
| **Use specific certificate authorities to validate the server certificate** | **Diżattivat** sakemm il-protokoll magħżul fit-taqsima [Komunikazzjoni ma’ Workplace](#communication-with-workplace) ikun `http`. Ladarba jiġi mmarkat, jagħmel il-qasam li jmiss obbligatorju. Jimmarka ruħu awtomatikament meta ċertifikat ikun diġà maħżun. |
| **Certificate authorities to validate the server certificate (base64 encoding)** | Selettur tal-fajls. Il-fajl irid ikun **inqas minn 20 KB** u l-kontenut tiegħu jrid jibda b’`-----BEGIN CERTIFICATE---`; inkella l-konsol iwieġeb **This file is not a valid base64-encoded certificate** u s-selezzjoni tiġi kkanċellata. |

### Test tal-konnettività

Sottotaqsima li tingħalaq u tinfetaħ, magħluqa b’mod default. Il-buttuna **Configuration test** tistaqsi lil Workplace bil-valuri attwalment imdaħħla — għalhekk m’hemmx bżonn li tissejvja qabel it-test.

| Riżultat | Wiri |
|---|---|
| Suċċess | **Connectivity test succeeded.** segwit minn **Workplace version: [version]**, b’tipa grassa |
| Parametri insuffiċjenti | **Incomplete configuration**, bl-aħmar |
| Falliment tal-konnessjoni | **Connectivity test failed.**, bl-aħmar |

## Options

| Qasam | Deskrizzjoni |
|---|---|
| **Enable Bastion theme** | Japplika t-tema Bastion għad-desktops ta’ Workplace servuti permezz tar-reverse proxy. |

## Issalva

Il-buttuna **Validate** tissejvja kull taqsima attiva.

> **Tagħbija mill-ġdid tal-konsol**
>
> Jekk l-istat tal-**għaqda tal-konsols** inbidel, il-konsol jistaqsi **Do you want to refresh the page so that the option changes can take effect?** taħt it-titlu **Confirmation**. Jekk twieġeb iva, il-paġna terġa’ titgħabba, u dan iġiegħel il-moduli ta’ Workplace jidhru jew jgħibu mill-menu.
