> Source: https://docs.cyberelements.io/bastion/4.6/pt/Installation/ClientAndAgent/ClientInstallation/

# Instalação do cliente CyberElements Bastion

O cliente CyberElements Bastion é instalado no posto de trabalho do utilizador e é necessário para as ações seguintes:

- Controlos de conformidade que requerem acesso ao sistema operativo:
    - Antispyware
    - Antivírus
    - MD5
    - Navegador
    - OS
    - Firewall
    - Sistema
- Início de aplicações que não podem ser acedidas diretamente a partir do navegador (SSH, RDP, VNC, VPN ou túnel genérico, entre outros)

## Onde transferir o cliente?

O cliente pode ser transferido a partir da consola de administração ou do portal do utilizador.

> **Consola de administração**
>
> 1. Aceda ao espaço de trabalho «Configurations» através do botão situado no canto superior esquerdo: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/Open_Configurations_workspace_CLR.png)
> 2. Abra o mosaico «Toolbox» ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/Configurations_Toolbox_tile_CLR.png)
> 3. Obtenha o instalador correspondente ao sistema operativo desejado no primeiro separador, «Integration Tools»![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/Configurations_Toolbox_clr_Integration_tools.png)

> **Portal do utilizador**
>
> 1. Inicie sessão no portal do utilizador
> 2. Clique no ícone de transferências situado no canto superior direito: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/User_Portal_Select_Downloads_Icon_CLR.png)
> 3. Transfira o cliente CyberElements Bastion correspondente ao seu sistema operativo: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/User_Portal_Downloads_List_clr.png)

## Instalação do cliente Microsoft Windows

> **Direitos de administrador necessários**
>
> São necessários direitos de administrador para instalar o cliente.

> **Compatibilidade do cliente**
>
> Para saber se o cliente é compatível com as diferentes versões do Microsoft Windows, consulte [a matriz de compatibilidade](https://docs.cyberelements.io/bastion/4.6/pt/CompatibilityMatrix/).

### Instalação gráfica

1. Execute o instalador `setup_Cleanroom_Client.exe` como administrador (se necessário, será apresentado um pedido de execução como administrador).
2. Clique em Next na primeira janela: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/Setup_CLR_Client_1st_screen.png)
3. Aceite as condições de utilização: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/Setup_CLR_Client_2nd_screen.png)
4. No terceiro ecrã, indique o diretório de instalação, instale o Cleanroom Desktop se quiser que as aplicações sejam apresentadas no desktop e instale os componentes OpenVPN se o utilizador dispuser de aplicações VPN standard: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/Setup_CLR_Client_3rd_screen.png)
5. (Se o Cleanroom Desktop tiver de ser instalado) A janela seguinte pedir-lhe-á que preencha várias definições: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/Setup_CLR_Client_4th_screen.png)
    - `Server Name`: endereço IP ou nome DNS do servidor Mediation
    - `Organization`: nome da organização à qual o cliente se irá ligar
    - `Domain`: nome do domínio de ligação do CyberElements Bastion
    - `Domain choice`: definição do controlo que o utilizador tem sobre a escolha do domínio; existem três níveis:
        1. `force`: a seleção do domínio é imposta ao utilizador
        2. `serial`: o cliente utilizará a autenticação em cascata para a seleção do domínio, pelo que esta deve estar configurada na organização
        3. `user`: o utilizador escolhe livremente o domínio de ligação
6. (Se o Cleanroom Desktop tiver de ser instalado) Escolha se o Cleanroom Desktop deve ser iniciado automaticamente na abertura da sessão e se deve ser executado após a instalação: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/Setup_CLR_Client_5th_screen.png)
7. Por último, inicie a instalação do cliente: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/Setup_CLR_Client_6th_screen.png)

### Instalação silenciosa por linha de comandos

Para instalar o cliente de forma silenciosa através da linha de comandos, existem quatro possibilidades:

1. Instalação apenas do cliente:

   ```
   1
   ```
2. Instalação do cliente e dos controladores OpenVPN:

   ```
   1
   ```
3. Instalação do cliente e dos componentes Cleanroom Desktop:

   ```
   1
   ```
4. Instalação do cliente, dos controladores OpenVPN e dos componentes Cleanroom Desktop:

   ```
   1
   ```

Quando os componentes Cleanroom Desktop são instalados, é necessário definir várias variáveis:

- `CL_DOMAIN`: nome do domínio de ligação do CyberElements Bastion
- `CL_ORGA`: nome da organização à qual o cliente se irá ligar
- `CL_SRV_NAME`: endereço IP ou nome DNS do servidor Mediation
- `CL_DOM_CHOICE`: definição do controlo que o utilizador tem sobre a escolha do domínio; existem três níveis:
    1. `force`: a seleção do domínio é imposta ao utilizador
    2. `serial`: o cliente utilizará a autenticação em cascata para a seleção do domínio, pelo que esta deve estar configurada na organização
    3. `user`: o utilizador escolhe livremente o domínio de ligação

### Extração do MSI

1. Abra uma linha de comandos ou uma consola PowerShell
2. Coloque-se na pasta onde se encontra o cliente Windows do CyberElements Bastion.
3. Execute um comando semelhante ao seguinte, adaptando o diretório de destino `C:\temp` se necessário:

   ```
   1
   ```
4. O cliente `Cleanroom Client.msi` estará disponível no diretório definido na etapa anterior

## Instalação do cliente macOS

> **Direitos de administrador necessários**
>
> São necessários direitos de administrador para instalar o cliente.

> **Compatibilidade do cliente**
>
> Para verificar a compatibilidade do cliente com as diferentes versões do macOS, consulte [a matriz de compatibilidade](https://docs.cyberelements.io/bastion/4.6/pt/CompatibilityMatrix/).

### Instalação do cliente

1. Depois de transferir o cliente `IPdivaClient.dmg`, execute-o.
2. Aparece a janela seguinte. Arraste e largue o ícone do cliente para Applications: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/Setup_CLR_Client_MacOS_1st_screen.png)
3. A instalação está concluída, mas na primeira utilização terá de confirmar a abertura e autorizar o acesso do cliente à rede local: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/Setup_CLR_Client_MacOS_3rd_screen.png) ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/Setup_CLR_Client_MacOS_4th_screen.png)

> **Para os Mac com processador ARM**
>
> Na primeira utilização do cliente pode aparecer a mensagem seguinte, que sugere a instalação do Rosetta. O Rosetta tem de estar instalado para que o cliente funcione. ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/Setup_CLR_Client_MacOS_2nd_screen.png)

### Instalação dos componentes VPN

Se utilizar aplicações VPN, é necessário instalar outro componente: `IPdivaVPN.pkg`.

1. Depois de transferir o cliente `IPdivaVPN.pkg`, execute-o.
2. O instalador começa com uma introdução que pode ser ignorada sem qualquer ação adicional: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/Setup_CLR_Client_VPN_MacOS_1st_screen.png)
3. Em seguida, tem de aceitar as condições gerais: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/Setup_CLR_Client_VPN_MacOS_2nd_screen.png)
4. Configure a instalação para todos os utilizadores: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/Setup_CLR_Client_VPN_MacOS_3rd_screen.png)
5. Se necessário, indique o disco de instalação da aplicação: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/Setup_CLR_Client_VPN_MacOS_4th_screen.png)
6. Confirme o fim da instalação: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/Setup_CLR_Client_VPN_MacOS_5th_screen.png)

## Instalação do cliente Ubuntu

> **Direitos de superutilizador necessários**
>
> São necessários direitos de superutilizador para instalar os pré-requisitos.

> **Compatibilidade do cliente**
>
> Para conhecer a compatibilidade do cliente com as diferentes versões do Ubuntu, consulte [a matriz de compatibilidade](https://docs.cyberelements.io/bastion/4.6/pt/CompatibilityMatrix/).

1. Transfira o cliente adequado ao Ubuntu `gateclient_linux_x64*.tar.xz`.
2. Abra um terminal e navegue até ao diretório onde se encontra o cliente.
3. Instale os pré-requisitos e o cliente com os comandos seguintes:

```
1
2
3
4
```
