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

# Workplace association

**Workplace association** -moduuli ilmoittaa sen Systancia Workplace -instanssin, johon Bastion liittyy: reverse proxyn, joka tarjoaa Workplace-työpöydät Bastion-tuotteen kautta, HTML5- Edge Gateway -palvelimet, joita käytetään Workplace-sovellusten käynnistämiseen, ja Workplace- konsolimoduulien valinnaisen yhdistämisen Bastion-tuotteen konsoliin.

Näyttöä ohjaa yksi valintaruutu, **Enable Workplace association**: niin kauan kuin sitä ei ole valittu, neljä alla olevaa osiota ovat **poissa käytöstä**.

> **Konsolien yhdistäminen tuo Workplace-moduulit näkyviin**
>
> Workplace-alueen näytöt — access contract -sopimukset, VDI-työpöydät, virtualisointi- hostit, virtuaalikoneet, palomuuri — näkyvät konsolissa vain, kun liitos on aktiivinen **ja** myös **Console merging** -osio on aktiivinen.

## Yhteydenpito Workplace-tuotteeseen

| Kenttä | Kuvaus |
|---|---|
| **Internal URL** | Yhdistetty rivi: protokollan pudotusvalikko (**http** tai **https**), sitten `://`, sitten Workplace-palvelimen sisäinen osoite. Pakollinen. **http**-valinta poistaa käytöstä osion [Console merging](#console-merging) sertifikaattiasetuksen ja poistaa sen valinnan. |
| **Virtualhost IP (external IP)** | Ulkoinen osoite, jolla Bastion julkaisee Workplace-tuotteen. Etuliite `https://` näytetään kiinteänä syöttökentän edessä. Pakollinen. |

## Reverse Proxy

| Kenttä | Kuvaus |
|---|---|
| **Site** | Se site-kohde, jonka kautta Bastion tavoittaa Workplace-tuotteen lukeakseen ja kirjoittaakseen asetuksia konsolista. Pakollinen. Ne site-kohteet, joiden kautta **käyttäjät** tavoittavat Workplace-työpöydät, määritellään sen sijaan sopimuksissa. |
| **Login attribute** | Sen SSO-lomakkeen kentän nimi, joka sisältää käyttäjänimen. Pakollinen. |
| **Password attribute** | Sen SSO-lomakkeen kentän nimi, joka sisältää salasanan. Pakollinen. |
| **Open the Workplace Console at the opening of Bastion** | Kun valittu, Workplace-konsoli avautuu jokaisen Bastion-konsoliin muodostetun yhteyden yhteydessä. |

### HTML5 Gateways

Laajennettava alaosio, joka luettelee HTML5 Gateway -palvelimet, jotka käynnistävät Workplace-sovellukset. Taulukossa on kaksi saraketta, **Full address** ja **Redirection**; niin kauan kuin yhtään Edge Gateway -palvelinta ei ole ilmoitettu, siinä lukee **No available gateways**. Sen yläpuolella on kolme painiketta: **Add**, **Properties** (yksittäisvalinta) ja **Delete**.

Lisäysikkunassa on vain kaksi nimikettä, joista ensimmäinen kattaa kolme syöttökenttää:

| Kenttä | Kuvaus |
|---|---|
| **Full address** | Kiinteä `https://`, sitten HTML5-palvelin, sitten `:` ja portti (oletus `18443`), sitten `/` ja HTML5-polku (oletus `systanciaHTML5-6.0`). Kaikki kolme syöttökenttää ovat pakollisia. |
| **Redirection** | Uudelleenohjauspolku, esitäytetty arvolla `/systanciaHTML5-6.0/`. Pakollinen. |

> **HTML5-palvelimen sertifikaatti**
>
> Jokaisen lisäyksen yhteydessä konsoli muistuttaa: **Warning: the HTML5 server certificate must be on the client used**. Ilman sitä sovellusten käynnistys epäonnistuu käyttäjän työasemalla.

## Console merging

Osio, joka on **oletuksena kiinni** ja jonka otsikossa on valintaruutu. Sen avaaminen ottaa käyttöön sen sisällön; sulkeminen poistaa sisällön käytöstä ja jättää sen tallennuksen ulkopuolelle. Kun yhdistäminen on käytössä, Workplace-moduulit ovat saavutettavissa Bastion-konsolissa, ja molempien tuotteiden sovellukset tarjotaan samasta käyttäjäportaalista.

| Kenttä | Kuvaus |
|---|---|
| **Authentication Domain** | Workplace-tuotteen todennusalue. Pakollinen. |
| **Administrator account** | Kyseisen alueen järjestelmänvalvojan tili. Pakollinen. |
| **Password** | Kyseisen tilin salasana, peitettynä. Voi jäädä tyhjäksi muokkauksessa: tällöin tallennettu arvo säilytetään. |
| **Use specific certificate authorities to validate the server certificate** | **Poissa käytöstä**, kun osiossa [Communication with Workplace](#communication-with-workplace) valittu protokolla on `http`. Kun se on valittu, seuraava kenttä muuttuu pakolliseksi. Se valitsee itsensä, kun sertifikaatti on jo tallennettu. |
| **Certificate authorities to validate the server certificate (base64 encoding)** | Tiedostonvalitsin. Tiedoston on oltava **alle 20 KB** ja sen sisällön on alettava merkkijonolla `-----BEGIN CERTIFICATE---`; muussa tapauksessa konsoli vastaa **This file is not a valid base64-encoded certificate** ja valinta peruutetaan. |

### Yhteystesti

Laajennettava alaosio, oletuksena kiinni. **Configuration test** -painike kysyy Workplace-tuotteelta parhaillaan syötetyillä arvoilla — ennen testiä ei siis tarvitse tallentaa.

| Tulos | Näyttö |
|---|---|
| Onnistuminen | **Connectivity test succeeded.** ja sen jälkeen **Workplace version: [version]**, lihavoituna |
| Riittämättömät parametrit | **Incomplete configuration**, punaisella |
| Yhteysvirhe | **Connectivity test failed.**, punaisella |

## Options

| Kenttä | Kuvaus |
|---|---|
| **Enable Bastion theme** | Soveltaa Bastion-teemaa reverse proxyn kautta tarjottaviin Workplace-työpöytiin. |

## Tallentaminen

**Validate**-painike tallentaa kaikki aktiiviset osiot.

> **Konsolin lataaminen uudelleen**
>
> Jos **konsolien yhdistämisen** tila on muuttunut, konsoli kysyy **Do you want to refresh the page so that the option changes can take effect?** otsikon **Confirmation** alla. Myöntävä vastaus lataa sivun uudelleen, mikä saa Workplace-moduulit ilmestymään valikkoon tai katoamaan siitä.
