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

# Workplace association

Il modulo **Workplace association** dichiara l'istanza di Systancia Workplace alla quale Bastion si collega: il reverse proxy che serve i desktop di Workplace attraverso Bastion, gli HTML5 Edge Gateway utilizzati per avviare le applicazioni di Workplace e la fusione opzionale dei moduli della console di Workplace in quella di Bastion.

La schermata è governata da un'unica casella di controllo, **Enable Workplace association**: finché non è selezionata, le quattro sezioni seguenti sono **disabilitate**.

> **È la fusione delle console a rivelare i moduli di Workplace**
>
> Le schermate dell'ambito Workplace — contratti di accesso, desktop VDI, host di virtualizzazione, macchine virtuali, firewall — compaiono nella console solo quando l'associazione è attiva **e** lo è anche la sezione **Console merging**.

## Comunicazione con Workplace

| Campo | Descrizione |
|---|---|
| **Internal URL** | Riga composita: un elenco a discesa di protocollo (**http** o **https**), poi `://`, poi l'indirizzo interno del server Workplace. Obbligatorio. Scegliere **http** disabilita e deseleziona l'opzione di certificato della sezione [Console merging](#console-merging). |
| **Virtualhost IP (external IP)** | Indirizzo esterno con il quale Bastion espone Workplace. Il prefisso `https://` è visualizzato, fisso, prima del campo di immissione. Obbligatorio. |

## Reverse Proxy

| Campo | Descrizione |
|---|---|
| **Site** | Sito attraverso il quale Bastion raggiunge Workplace per leggere e scrivere impostazioni dalla console. Obbligatorio. I siti attraverso i quali gli **utenti** raggiungono i desktop di Workplace sono invece definiti nei contratti di accesso. |
| **Login attribute** | Nome del campo della maschera SSO che porta il nome utente. Obbligatorio. |
| **Password attribute** | Nome del campo della maschera SSO che porta la password. Obbligatorio. |
| **Open the Workplace Console at the opening of Bastion** | Quando è selezionato, la console di Workplace si apre a ogni connessione alla console Bastion. |

### HTML5 Gateways

Una sottosezione richiudibile che elenca gli HTML5 Gateway che avviano le applicazioni di Workplace. La griglia ha due colonne, **Full address** e **Redirection**; finché non viene dichiarato alcun Edge Gateway, indica **No available gateways**. Sopra di essa si trovano tre pulsanti: **Add**, **Properties** (selezione singola) e **Delete**.

La finestra di aggiunta contiene solo due etichette, la prima delle quali copre tre campi di immissione:

| Campo | Descrizione |
|---|---|
| **Full address** | Un `https://` fisso, poi il server HTML5, poi `:` e la porta (predefinita `18443`), poi `/` e il percorso HTML5 (predefinito `systanciaHTML5-6.0`). Tutti e tre i campi sono obbligatori. |
| **Redirection** | Percorso di reindirizzamento, precompilato con `/systanciaHTML5-6.0/`. Obbligatorio. |

> **Certificato del server HTML5**
>
> A ogni aggiunta la console ricorda: **Warning: the HTML5 server certificate must be on the client used**. In sua assenza, l'avvio delle applicazioni non riesce sulla postazione dell'utente.

## Console merging

Una sezione **richiusa per impostazione predefinita**, con una casella di controllo nel titolo. L'apertura ne abilita il contenuto; la chiusura lo disabilita e lo esclude dal salvataggio. Una volta stabilita la fusione, i moduli di Workplace diventano raggiungibili nella console Bastion e le applicazioni dei due prodotti sono servite dallo stesso portale utente.

| Campo | Descrizione |
|---|---|
| **Authentication Domain** | Dominio di autenticazione di Workplace. Obbligatorio. |
| **Administrator account** | Account di amministratore di tale dominio. Obbligatorio. |
| **Password** | Password di tale account, mascherata. Può restare vuota durante la modifica: viene allora conservato il valore memorizzato. |
| **Use specific certificate authorities to validate the server certificate** | **Disabilitato** finché il protocollo scelto nella sezione [Comunicazione con Workplace](#communication-with-workplace) è `http`. Una volta selezionato, rende obbligatorio il campo successivo. Si seleziona automaticamente quando è già memorizzato un certificato. |
| **Certificate authorities to validate the server certificate (base64 encoding)** | Selettore di file. Il file deve pesare **meno di 20 KB** e il suo contenuto iniziare con `-----BEGIN CERTIFICATE---`; in caso contrario la console risponde **This file is not a valid base64-encoded certificate** e la selezione viene annullata. |

### Test di connettività

Una sottosezione richiudibile, richiusa per impostazione predefinita. Il pulsante **Configuration test** interroga Workplace con i valori attualmente immessi — non è quindi necessario salvare prima di eseguire il test.

| Risultato | Visualizzazione |
|---|---|
| Successo | **Connectivity test succeeded.** seguito da **Workplace version: [version]**, in grassetto |
| Parametri insufficienti | **Incomplete configuration**, in rosso |
| Errore di connessione | **Connectivity test failed.**, in rosso |

## Options

| Campo | Descrizione |
|---|---|
| **Enable Bastion theme** | Applica il tema Bastion ai desktop di Workplace serviti attraverso il reverse proxy. |

## Salvare

Il pulsante **Validate** salva tutte le sezioni attive.

> **Ricaricamento della console**
>
> Se lo stato della **fusione delle console** è cambiato, la console chiede **Do you want to refresh the page so that the option changes can take effect?** sotto il titolo **Confirmation**. Rispondere affermativamente ricarica la pagina, il che fa comparire o scomparire i moduli di Workplace dal menu.
