> Source: https://docs.cyberelements.io/identity/7.1/pt/Installation/InstallDoc/FirstInstall/

# No âmbito de uma primeira instalação

## Instalação de CyberElements Identity 7.1

A partir da versão 7.1, é fornecido um novo instalador com CyberElements Identity. O executável `Cyberelements Identity Version 7.1.x.exe` instala os módulos seguintes:

- a base de dados, que pode ser instalada num servidor remoto;
- Hpliance, ou seja, os antigos módulos da geração 6;
- Identity, o sítio web e a sua API;
- o servidor de auditoria.

Instala também, opcionalmente, os módulos seguintes:

- o módulo CyberElements Federation;
- SIP, o motor de aprovisionamento e a sua API.

O instalador permite também desinstalar a versão anterior, apenas a partir da versão 7.0.

> **Atenção**
>
> É necessária uma origem de dados ODBC de 32 bits para configurar o módulo de auditoria. Consulte [esta página](https://docs.cyberelements.io/identity/7.1/pt/Installation/InstallDoc/AuditConfiguration/ODBCConnectorConfig/) para criar uma origem de dados ODBC.

### Instalador de CyberElements Identity 7.1

Execute o instalador e clique em `Next >`.

![](https://docs.cyberelements.io/identity/7.1/img/Identity/Identity71-InstallerWelcome.png)

**Condições de utilização**

Aceite as condições de utilização e clique em `Next >`.

![](https://docs.cyberelements.io/identity/7.1/img/Identity/Identity71-LicenceAgreement.png)

**Pré-requisitos**

Neste ecrã, aguarde um momento. O instalador verifica se os pré-requisitos estão instalados.

![](https://docs.cyberelements.io/identity/7.1/img/Identity/Identity71-PrerequisiteCheck.png)

> **Nota**
>
> Se um dos pré-requisitos não for cumprido — papel, funcionalidade ou framework em falta —, o instalador para e uma mensagem indica os elementos em falta. Consulte a página [Pré-requisitos técnicos](https://docs.cyberelements.io/identity/7.1/pt/Installation/TechnicalPrerequisites/).
>
> ![](https://docs.cyberelements.io/identity/7.1/img/Identity/Identity71-PrerequisiteCheckFailed.png)

Depois de verificados os pré-requisitos, clique em `Next >`.

![](https://docs.cyberelements.io/identity/7.1/img/Identity/Identity71-PrerequisiteCheckPassed.png)

**Ecrã de seleção do ficheiro de licença**

No ecrã de configuração da licença, clique em `Browse...` e selecione o seu ficheiro de licença.

> **Atenção**
>
> Se for utilizada uma base de dados PostgreSQL, marque a caixa `Enable preview features (PostgreSQL database)`.

![](https://docs.cyberelements.io/identity/7.1/img/Identity/Identity71-LicenceFileSelection.png)

Clique em `Next >`.

**Desinstalação das versões anteriores**

Este ecrã permite desinstalar as versões anteriores já instaladas. Introduza os caminhos das versões anteriores. Pode também escolher se o Systancia Identity Provisioning (SIP) e o CyberElements Federation devem ser desinstalados, marcando a caixa associada. Clique em `Next >`.

![](https://docs.cyberelements.io/identity/7.1/img/Identity/Identity71-UninstallingPreviousVersions.png)

O instalador desinstala o Identity; aguarde.

![](https://docs.cyberelements.io/identity/7.1/img/Identity/Identity71-Uninstalling.png)

**Seleção dos componentes**

Neste ecrã, selecione os componentes a instalar e clique em `Next >`.

> **Nota**
>
> Pode selecionar os componentes individualmente, marcando ou desmarcando a caixa associada, ou utilizar as opções do menu suspenso:
>
> ![](https://docs.cyberelements.io/identity/7.1/img/Identity/Identity71-SelectComponentsMenuDeroulant.png)
>
> > **Atenção**
> >
> > Se marcou previamente a caixa `Enable preview features`, tem de desmarcar o componente Hpliance, uma vez que não é compatível com as bases de dados PostgreSQL.

![](https://docs.cyberelements.io/identity/7.1/img/Identity/Identity71-SelectComponents.png)

**Seleção do diretório de instalação**

Introduza os caminhos de instalação da nova versão de CyberElements Identity e clique em `Next >`.

![](https://docs.cyberelements.io/identity/7.1/img/Identity/Identity71-SelectInstallationDirectories.png)

Depois de introduzidas as informações, clique em `Next >`.

**Configuração da base de dados**

Acede então ao ecrã de configuração da base de dados.

Preencha a configuração introduzindo o FQDN ou o endereço IP do servidor de base de dados, o nome da base de dados e o tipo de autenticação na base de dados (introduza também as credenciais da conta de serviço se selecionar a autenticação SQL Server). Em seguida, clique em `Next >`.

> **Exemplo com uma base de dados SQL Server**
>
> ![](https://docs.cyberelements.io/identity/7.1/img/Identity/Identity71-DatabasConfigurationSQLServer.png)

Depois de configurada a base de dados, clique em `Next >`.

**Contas de serviço**

Em seguida, o instalador pede-lhe que introduza as contas de serviço que serão utilizadas pelo Identity.

![](https://docs.cyberelements.io/identity/7.1/img/Identity/Identity71-ServiceAccounts.png)

- A conta `Identity Service Account` será utilizada para aceder à aplicação web e às API SID.
- A conta `Hpliance Service Account` será utilizada para aceder às interfaces antigas e aos serviços Windows, como os workflows.

Pode marcar a caixa `Use Identity Service Account` para utilizar a mesma conta de serviço em ambos os casos.

Depois de definidas as contas de serviço, clique em `Next >`.

**Configuração do certificado**

Este ecrã permite selecionar o armazém de certificados e o certificado a utilizar.

![](https://docs.cyberelements.io/identity/7.1/img/Identity/Identity71-CertificateConfiguration.png)

Depois de selecionado o certificado, clique em `Next >`.

**Configuração da rede**

Acede então ao ecrã de configuração da rede.

![](https://docs.cyberelements.io/identity/7.1/img/Identity/Identity71-NetworkPortsConfiguration.png)

- `Host name`: introduza neste campo o FQDN do seu servidor Identity;
- `Hpliance port`: introduza aqui a porta que será utilizada para aceder às interfaces antigas;
- `Identity port`: introduza aqui a porta que será utilizada para aceder à aplicação web Identity;
- `Identity API Port`: introduza a porta que será utilizada para aceder às API Identity;
- `Application Culture`: este menu suspenso define o idioma predefinido da interface Identity. Selecione `en-US` para inglês ou `fr-FR` para francês.

Depois de introduzidas as informações, clique em `Next >`.

**Configuração do servidor SMTP**

Este ecrã permite configurar um servidor SMTP que será utilizado para enviar as diversas notificações. Para configurar o servidor SMTP, preencha os campos da seguinte forma:

> **Nota**
>
> Como esta etapa é opcional, pode deixar os campos vazios se não pretender configurar um servidor SMTP.

![](https://docs.cyberelements.io/identity/7.1/img/Identity/Identity71-SMTPConfiguration.png)

- `SMTP Server Address`: introduza neste campo o endereço IP do servidor SMTP que será utilizado (vazio por predefinição);
- `SMTP Port`: introduza aqui a porta que será utilizada para aceder ao servidor SMTP (valor predefinido: 25);
- `SMTP Mail Address`: introduza neste campo o endereço de correio eletrónico que será utilizado como remetente das notificações (vazio por predefinição);
- `SMTP Username`: introduza aqui o identificador da conta que será utilizada para enviar as notificações (vazio por predefinição);
- `SMTP Password`: introduza aqui a palavra-passe da conta que será utilizada para enviar as notificações (vazio por predefinição).

**Configuração das auditorias**

> **Atenção**
>
> Tem de ter sido criada uma origem de dados ODBC de 32 bits para realizar esta etapa. Consulte [esta página](https://docs.cyberelements.io/identity/7.1/pt/Installation/InstallDoc/AuditConfiguration/ODBCConnectorConfig/).

Este ecrã permite configurar o módulo de auditoria. Preencha os campos seguintes:

![](https://docs.cyberelements.io/identity/7.1/img/Identity/Identity71-AuditConfiguration.png)

- `AuditType`: este campo é preenchido automaticamente.
- `SSOX Login`: introduza neste campo o identificador da conta SSOX que será utilizada para registar as auditorias;
- `SSOX Password`: introduza neste campo a palavra-passe da conta SSOX que será utilizada para registar as auditorias;
- `ODBC DSN (Catalog)`: selecione no menu suspenso a sua origem de dados ODBC de 32 bits. Se esta lista estiver vazia, consulte [esta página](https://docs.cyberelements.io/identity/7.1/pt/Installation/InstallDoc/AuditConfiguration/ODBCConnectorConfig/);
- `Audit Server Address`: introduza neste campo o endereço IP do seu servidor de auditoria;
- `Audit Server Port`: introduza neste campo a porta que será utilizada pelo servidor de auditoria.

Depois de introduzidas as informações, clique em `Next >`.

**Configuração de Federation**

> **Nota**
>
> Esta janela aparece se o componente Federation tiver sido selecionado na etapa de seleção dos componentes.

Este ecrã permite configurar a instalação de CyberElements Federation. Preencha os campos seguintes:

![](https://docs.cyberelements.io/identity/7.1/img/Identity/Identity71-FederationConfiguration.png)

- `Federation Hostname`: introduza neste campo o FQDN do servidor Federation que será utilizado;
- `Federation Port (44350)`: introduza neste campo a porta que será utilizada pelo CyberElements Federation (valor predefinido: 44350);
- `Federation Installation Directory`: clique no botão `Browse...` para selecionar o diretório de instalação de CyberElements Federation;
- `Use Identity Service Account`: marque esta caixa para utilizar a conta de serviço Identity como conta de serviço Federation. Ao marcar esta caixa, a definição da conta de serviço Federation fica esbatida;
- `Federation Service Account`: esta secção permite definir a conta de serviço Federation:
    - Selecione o âmbito da conta de serviço no menu suspenso.
    - `Domain`: selecione o domínio da conta de serviço Federation;
    - `Username`: introduza neste campo o identificador da conta de serviço Federation;
    - `Password`: introduza neste campo a palavra-passe da conta de serviço Federation.

Depois de introduzidas as informações, clique em `Next >`.

**Componentes adicionais**

> **Nota**
>
> Esta janela aparece se o componente `CyberElements Identity Provisioning (SIP)` tiver sido selecionado na etapa de seleção dos componentes.

Este ecrã permite configurar a instalação do SIP. Preencha os campos seguintes:

![](https://docs.cyberelements.io/identity/7.1/img/Identity/Identity71-SIPInstallation.png)

- `SIP Installation Directory`: clique no botão `Browse...` para selecionar o diretório de instalação de CyberElements Identity Provisioning;
- `Use Identity Service Account`: marque esta caixa para utilizar a conta de serviço Identity como conta de serviço SIP. Ao marcar esta caixa, a definição da conta de serviço SIP fica esbatida;
- `SIP Service Account`: esta secção permite definir a conta de serviço SIP:
    - Selecione o âmbito da conta de serviço no menu suspenso.
    - `Domain`: selecione o domínio da conta de serviço SIP;
    - `Username`: introduza neste campo o identificador da conta de serviço SIP;
    - `Password`: introduza neste campo a palavra-passe da conta de serviço SIP.

Depois de introduzidas as informações, clique em `Next >`.

**Configuração do SIP - OIDC**

> **Nota**
>
> Esta janela aparece se o componente `CyberElements Identity Provisioning (SIP)` tiver sido selecionado na etapa de seleção dos componentes.

Este ecrã permite configurar a camada de autenticação OIDC do Service Provider. Preencha os campos seguintes:

![](https://docs.cyberelements.io/identity/7.1/img/Identity/Identity71-ConfigurationSIP-OIDC.png)

- `Port API SIP`: introduza a porta que será utilizada pelas API SIP;
- `Audience`, `Authorization Endpoint`, `Token Endpoint`, `End Session Endpoint`: introduza aqui os parâmetros do seu Service Provider.

Depois de introduzidas as informações, clique em `Next >`.

**Configuração do SIP - Credenciais**

> **Nota**
>
> Esta janela aparece se o componente `CyberElements Identity Provisioning (SIP)` tiver sido selecionado na etapa de seleção dos componentes.

Este ecrã permite configurar as credenciais do SIP, que serão utilizadas nomeadamente nos ficheiros de configuração. Preencha os campos seguintes:

> **Nota**
>
> No caso de uma primeira instalação, recomenda-se manter as informações predefinidas.

![](https://docs.cyberelements.io/identity/7.1/img/Identity/Identity71-ConfigurationSIP-Credentials.png)

- `Client ID`: introduza aqui o identificador do Client;
- `Client Secret`: introduza aqui o segredo do Client;
- `HPP Username`: introduza aqui o identificador da conta HPP;
- `HPP Password`: introduza aqui a palavra-passe da conta HPP;
- `Use PKCE`: marque esta caixa para ativar a extensão de segurança PKCE;
- `Culture`: selecione `fr-FR` para francês ou `en-US`.

Depois de introduzidas as informações, clique em `Next >`.

**Ready to Install**

Este ecrã apresenta um resumo da configuração efetuada no instalador. Verifique se as informações estão corretas e clique em `Install`.

![](https://docs.cyberelements.io/identity/7.1/img/Identity/Identity71-ReadyToInstall.png)

**Instalação**

Aguarde um momento enquanto o CyberElements Identity é instalado e, em seguida, clique em `Finish` para concluir a instalação.

![](https://docs.cyberelements.io/identity/7.1/img/Identity/Identity71-Installing.png)

> **Atenção**
>
> Durante esta fase, o instalador verifica se o Hpliance foi instalado corretamente. Se não for o caso, a instalação para com a mensagem `Hpliance was not installed properly.` Nesse caso, consulte os logs de instalação, corrija a causa e volte a executar o instalador.
