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

# Workplace association

El módulo **Workplace association** declara la instancia de Systancia Workplace a la que Bastion se vincula: el proxy inverso que sirve los escritorios de Workplace a través de Bastion, las HTML5 Edge Gateways utilizadas para iniciar las aplicaciones de Workplace y la fusión opcional de los módulos de la consola de Workplace en la de Bastion.

La pantalla está gobernada por una única casilla, **Enable Workplace association**: mientras está sin marcar, las cuatro secciones siguientes están **desactivadas**.

> **La fusión de consolas es lo que revela los módulos de Workplace**
>
> Las pantallas del ámbito Workplace — contratos de acceso, escritorios VDI, hosts de virtualización, máquinas virtuales, cortafuegos — solo aparecen en la consola cuando la asociación está activa **y** la sección **Console merging** también.

## Comunicación con Workplace

| Campo | Descripción |
|---|---|
| **Internal URL** | Línea compuesta: una lista desplegable de protocolo (**http** o **https**), después `://`, y después la dirección interna del servidor Workplace. Obligatorio. Elegir **http** desactiva y desmarca la opción de certificado de la sección 3. |
| **Virtualhost IP (external IP)** | Dirección externa con la que Bastion expone Workplace. El prefijo `https://` se muestra, fijo, antes del campo de entrada. Obligatorio. |

## Reverse Proxy

| Campo | Descripción |
|---|---|
| **Site** | Sitio a través del cual Bastion accede a Workplace para leer y escribir parámetros desde la consola. Obligatorio. Los sitios por los que los **usuarios** acceden a los escritorios de Workplace se definen, en cambio, en los contratos de acceso. |
| **Login attribute** | Nombre del campo del formulario SSO que lleva el nombre de usuario. Obligatorio. |
| **Password attribute** | Nombre del campo del formulario SSO que lleva la contraseña. Obligatorio. |
| **Open the Workplace Console at the opening of Bastion** | Cuando está marcado, la consola de Workplace se abre en cada conexión a la consola de Bastion. |

### HTML5 Gateways

Una subsección desplegable que enumera las HTML5 Gateways que inician las aplicaciones de Workplace. La cuadrícula tiene dos columnas, **Full address** y **Redirection**; mientras no se declara ninguna Edge Gateway, indica **No available gateways**. Encima hay tres botones: **Add**, **Properties** (selección simple) y **Delete**.

La ventana de adición contiene únicamente dos etiquetas, la primera de las cuales cubre tres campos de entrada:

| Campo | Descripción |
|---|---|
| **Full address** | Un `https://` fijo, después el servidor HTML5, después `:` y el puerto (predeterminado `18443`), y después `/` y la ruta HTML5 (predeterminada `systanciaHTML5-6.0`). Los tres campos son obligatorios. |
| **Redirection** | Ruta de redirección, precargada con `/systanciaHTML5-6.0/`. Obligatoria. |

> **Certificado del servidor HTML5**
>
> En cada adición, la consola recuerda: **Warning: the HTML5 server certificate must be on the client used**. Sin él, el inicio de las aplicaciones falla en el puesto del usuario.

## Console merging

Una sección **contraída de forma predeterminada**, con una casilla en su título. Al desplegarla se activa su contenido; al contraerla se desactiva el contenido y queda excluido del guardado. Una vez establecida la fusión, los módulos de Workplace pasan a ser accesibles en la consola de Bastion y las aplicaciones de ambos productos las sirve el mismo portal de usuario.

| Campo | Descripción |
|---|---|
| **Authentication Domain** | Dominio de autenticación de Workplace. Obligatorio. |
| **Administrator account** | Cuenta de administrador de ese dominio. Obligatoria. |
| **Password** | Contraseña de esa cuenta, oculta. Puede dejarse vacía al modificar: se conserva entonces el valor almacenado. |
| **Use specific certificate authorities to validate the server certificate** | **Desactivado** mientras el protocolo elegido en la sección 1 sea `http`. Una vez marcado, hace obligatorio el campo siguiente. Se marca por sí solo cuando ya hay un certificado almacenado. |
| **Certificate authorities to validate the server certificate (base64 encoding)** | Selector de ficheros. El fichero debe pesar **menos de 20 KB** y su contenido empezar por `-----BEGIN CERTIFICATE---`; de lo contrario, la consola responde **This file is not a valid base64-encoded certificate** y la selección se cancela. |

### Prueba de conectividad

Una subsección desplegable, contraída de forma predeterminada. El botón **Configuration test** consulta Workplace con los valores introducidos en ese momento — no es necesario por tanto guardar antes de probar.

| Resultado | Visualización |
|---|---|
| Éxito | **Connectivity test succeeded.** seguido de **Workplace version: [version]**, en negrita |
| Parámetros insuficientes | **Incomplete configuration**, en rojo |
| Fallo de conexión | **Connectivity test failed.**, en rojo |

## Options

| Campo | Descripción |
|---|---|
| **Enable Bastion theme** | Aplica el tema de Bastion a los escritorios de Workplace servidos a través del proxy inverso. |

## Guardar

El botón **Validate** guarda todas las secciones activas.

> **Recarga de la consola**
>
> Si el estado de la **fusión de consolas** ha cambiado, la consola pregunta **Do you want to refresh the page so that the option changes can take effect?** bajo el título **Confirmation**. Al responder afirmativamente se recarga la página, lo que hace aparecer o desaparecer los módulos de Workplace del menú.
