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

# Workplace association

O módulo **Workplace association** declara a instância do Systancia Workplace à qual o Bastion se liga: o proxy inverso que serve os desktops do Workplace através do Bastion, os HTML5 Edge Gateway utilizados para lançar as aplicações do Workplace e a fusão opcional dos módulos da consola do Workplace na do Bastion.

O ecrã é governado por uma única caixa de verificação, **Enable Workplace association**: enquanto estiver não assinalada, as quatro secções seguintes estão **desativadas**.

> **É a fusão de consolas que revela os módulos do Workplace**
>
> Os ecrãs do âmbito Workplace — contratos de acesso, desktops VDI, anfitriões de virtualização, máquinas virtuais, firewall — só aparecem na consola quando a associação está ativa **e** a secção **Console merging** também está ativa.

## Comunicação com o Workplace

| Campo | Descrição |
|---|---|
| **Internal URL** | Linha composta: uma lista suspensa de protocolo (**http** ou **https**), depois `://`, depois o endereço interno do servidor Workplace. Obrigatório. Escolher **http** desativa e desmarca a opção de certificado da secção [Console merging](#console-merging). |
| **Virtualhost IP (external IP)** | Endereço externo sob o qual o Bastion expõe o Workplace. O prefixo `https://` é apresentado, fixo, antes do campo de entrada. Obrigatório. |

## Reverse Proxy

| Campo | Descrição |
|---|---|
| **Site** | Site através do qual o Bastion alcança o Workplace para ler e escrever definições a partir da consola. Obrigatório. Os sites através dos quais os **utilizadores** alcançam os desktops do Workplace são definidos, em vez disso, nos contratos de acesso. |
| **Login attribute** | Nome do campo do formulário SSO que transporta o nome do utilizador. Obrigatório. |
| **Password attribute** | Nome do campo do formulário SSO que transporta a palavra-passe. Obrigatório. |
| **Open the Workplace Console at the opening of Bastion** | Quando está assinalado, a consola do Workplace abre-se em cada ligação à consola do Bastion. |

### HTML5 Gateways

Uma subsecção recolhível que enumera os HTML5 Gateway que lançam as aplicações do Workplace. A grelha tem duas colunas, **Full address** e **Redirection**; enquanto não estiver declarado nenhum Edge Gateway, indica **No available gateways**. Acima dela existem três botões: **Add**, **Properties** (seleção simples) e **Delete**.

A janela de adição contém apenas duas etiquetas, a primeira das quais cobre três campos de entrada:

| Campo | Descrição |
|---|---|
| **Full address** | Um `https://` fixo, depois o servidor HTML5, depois `:` e a porta (predefinida `18443`), e depois `/` e o caminho HTML5 (predefinido `systanciaHTML5-6.0`). Os três campos são obrigatórios. |
| **Redirection** | Caminho de redirecionamento, previamente preenchido com `/systanciaHTML5-6.0/`. Obrigatório. |

> **Certificado do servidor HTML5**
>
> Em cada adição, a consola recorda: **Warning: the HTML5 server certificate must be on the client used**. Sem ele, o lançamento das aplicações falha no posto de trabalho do utilizador.

## Console merging

Uma secção **recolhida por predefinição**, com uma caixa de verificação no seu título. Ao expandi-la, ativa-se o seu conteúdo; ao recolhê-la, o conteúdo é desativado e excluído da gravação. Uma vez a fusão estabelecida, os módulos do Workplace passam a estar acessíveis na consola do Bastion e as aplicações dos dois produtos são servidas pelo mesmo portal do utilizador.

| Campo | Descrição |
|---|---|
| **Authentication Domain** | Domínio de autenticação do Workplace. Obrigatório. |
| **Administrator account** | Conta de administrador desse domínio. Obrigatório. |
| **Password** | Palavra-passe dessa conta, ocultada. Pode ficar vazia ao editar: o valor armazenado é então conservado. |
| **Use specific certificate authorities to validate the server certificate** | **Desativado** enquanto o protocolo escolhido na secção [Communication with Workplace](#communication-with-workplace) for `http`. Uma vez assinalado, torna obrigatório o campo seguinte. Assinala-se por si só quando já existe um certificado armazenado. |
| **Certificate authorities to validate the server certificate (base64 encoding)** | Seletor de ficheiros. O ficheiro deve pesar **menos de 20 KB** e o seu conteúdo começar por `-----BEGIN CERTIFICATE---`; caso contrário, a consola responde **This file is not a valid base64-encoded certificate** e a seleção é cancelada. |

### Teste de conetividade

Uma subsecção recolhível, recolhida por predefinição. O botão **Configuration test** consulta o Workplace com os valores atualmente introduzidos — não é, portanto, necessário guardar antes de testar.

| Resultado | Apresentação |
|---|---|
| Sucesso | **Connectivity test succeeded.** seguido de **Workplace version: [version]**, em negrito |
| Parâmetros insuficientes | **Incomplete configuration**, em vermelho |
| Falha de ligação | **Connectivity test failed.**, em vermelho |

## Options

| Campo | Descrição |
|---|---|
| **Enable Bastion theme** | Aplica o tema Bastion aos desktops do Workplace servidos através do proxy inverso. |

## Guardar

O botão **Validate** guarda todas as secções ativas.

> **Recarregamento da consola**
>
> Se o estado da **fusão de consolas** mudou, a consola pergunta **Do you want to refresh the page so that the option changes can take effect?** sob o título **Confirmation**. Responder afirmativamente recarrega a página, o que faz aparecer ou desaparecer os módulos do Workplace no menu.
