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

# Nell'ambito di una prima installazione

## Installazione di CyberElements Identity 7.1

A partire dalla versione 7.1, con CyberElements Identity viene fornito un nuovo programma di installazione. L'eseguibile `Cyberelements Identity Version 7.1.x.exe` installa i seguenti moduli:

- il database, che può essere installato su un server remoto;
- Hpliance, ossia i moduli della precedente generazione 6;
- Identity, il sito web e la relativa API;
- il server di audit.

Installa inoltre, facoltativamente, i seguenti moduli:

- il modulo CyberElements Federation;
- SIP, il motore di provisioning e la relativa API.

Il programma di installazione consente inoltre di disinstallare la versione precedente, solo a partire dalla versione 7.0.

> **Attenzione**
>
> Per configurare il modulo di audit è necessaria un'origine dati ODBC a 32 bit. Consultare [questa pagina](https://docs.cyberelements.io/identity/7.1/it/Installation/InstallDoc/AuditConfiguration/ODBCConnectorConfig/) per creare un'origine dati ODBC.

### Programma di installazione di CyberElements Identity 7.1

Avviare il programma di installazione e fare clic su `Next >`.

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

**Condizioni d'uso**

Accettare le condizioni d'uso, quindi fare clic su `Next >`.

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

**Prerequisiti**

In questa schermata, attendere qualche istante. Il programma di installazione verifica che i prerequisiti siano installati.

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

> **Nota**
>
> Se uno dei prerequisiti non è soddisfatto — ruolo, funzionalità o framework mancante —, il programma di installazione si arresta e un messaggio indica gli elementi mancanti. Consultare la pagina [Prerequisiti tecnici](https://docs.cyberelements.io/identity/7.1/it/Installation/TechnicalPrerequisites/).
>
> ![](https://docs.cyberelements.io/identity/7.1/img/Identity/Identity71-PrerequisiteCheckFailed.png)

Una volta verificati i prerequisiti, fare clic su `Next >`.

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

**Schermata di selezione del file di licenza**

Nella schermata di configurazione della licenza, fare clic su `Browse...` e selezionare il file di licenza.

> **Attenzione**
>
> Se si utilizza un database PostgreSQL, selezionare la casella `Enable preview features (PostgreSQL database)`.

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

Fare clic su `Next >`.

**Disinstallazione delle versioni precedenti**

Questa schermata consente di disinstallare le versioni precedenti già installate. Immettere i percorsi delle versioni precedenti. È inoltre possibile scegliere se disinstallare Systancia Identity Provisioning (SIP) e CyberElements Federation selezionando la casella associata. Fare clic su `Next >`.

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

Il programma di installazione disinstalla Identity; attendere.

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

**Selezione dei componenti**

In questa schermata, selezionare i componenti da installare, quindi fare clic su `Next >`.

> **Nota**
>
> È possibile selezionare i componenti singolarmente selezionando o deselezionando la casella associata, oppure utilizzare le opzioni dell'elenco a discesa:
>
> ![](https://docs.cyberelements.io/identity/7.1/img/Identity/Identity71-SelectComponentsMenuDeroulant.png)
>
> > **Attenzione**
> >
> > Se in precedenza è stata selezionata la casella `Enable preview features`, è obbligatorio deselezionare il componente Hpliance, poiché non è compatibile con i database PostgreSQL.

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

**Selezione della directory di installazione**

Immettere i percorsi di installazione della nuova versione di CyberElements Identity, quindi fare clic su `Next >`.

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

Una volta immesse le informazioni, fare clic su `Next >`.

**Configurazione del database**

Si accede quindi alla schermata di configurazione del database.

Completare la configurazione immettendo l'FQDN o l'indirizzo IP del server di database, il nome del database e il tipo di autenticazione al database (immettere anche le credenziali dell'account di servizio se si seleziona l'autenticazione SQL Server). Quindi fare clic su `Next >`.

> **Esempio con un database SQL Server**
>
> ![](https://docs.cyberelements.io/identity/7.1/img/Identity/Identity71-DatabasConfigurationSQLServer.png)

Una volta configurato il database, fare clic su `Next >`.

**Account di servizio**

Il programma di installazione chiede quindi di immettere gli account di servizio che saranno utilizzati da Identity.

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

- L'account `Identity Service Account` sarà utilizzato per accedere all'applicazione web e alle API SID.
- L'account `Hpliance Service Account` sarà utilizzato per accedere alle vecchie interfacce e ai servizi Windows, come i workflow.

È possibile selezionare la casella `Use Identity Service Account` per utilizzare lo stesso account di servizio in entrambi i casi.

Una volta definiti gli account di servizio, fare clic su `Next >`.

**Configurazione del certificato**

Questa schermata consente di selezionare l'archivio dei certificati e il certificato da utilizzare.

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

Una volta selezionato il certificato, fare clic su `Next >`.

**Configurazione di rete**

Si accede quindi alla schermata di configurazione di rete.

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

- `Host name`: immettere in questo campo l'FQDN del server Identity;
- `Hpliance port`: immettere qui la porta che sarà utilizzata per accedere alle vecchie interfacce;
- `Identity port`: immettere qui la porta che sarà utilizzata per accedere all'applicazione web Identity;
- `Identity API Port`: immettere la porta che sarà utilizzata per accedere alle API Identity;
- `Application Culture`: questo elenco a discesa definisce la lingua predefinita dell'interfaccia Identity. Selezionare `en-US` per l'inglese o `fr-FR` per il francese.

Una volta immesse le informazioni, fare clic su `Next >`.

**Configurazione del server SMTP**

Questa schermata consente di configurare un server SMTP che sarà utilizzato per inviare le varie notifiche. Per configurare il server SMTP, compilare i campi come segue:

> **Nota**
>
> Poiché questo passaggio è facoltativo, è possibile lasciare i campi vuoti se non si desidera configurare un server SMTP.

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

- `SMTP Server Address`: immettere in questo campo l'indirizzo IP del server SMTP che sarà utilizzato (vuoto per impostazione predefinita);
- `SMTP Port`: immettere qui la porta che sarà utilizzata per accedere al server SMTP (valore predefinito: 25);
- `SMTP Mail Address`: immettere in questo campo l'indirizzo e-mail che sarà utilizzato come mittente delle notifiche (vuoto per impostazione predefinita);
- `SMTP Username`: immettere qui il login dell'account che sarà utilizzato per inviare le notifiche (vuoto per impostazione predefinita);
- `SMTP Password`: immettere qui la password dell'account che sarà utilizzato per inviare le notifiche (vuoto per impostazione predefinita).

**Configurazione dell'audit**

> **Attenzione**
>
> Per eseguire questo passaggio, deve essere stata creata un'origine dati ODBC a 32 bit. Consultare [questa pagina](https://docs.cyberelements.io/identity/7.1/it/Installation/InstallDoc/AuditConfiguration/ODBCConnectorConfig/).

Questa schermata consente di configurare il modulo di audit. Compilare i seguenti campi:

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

- `AuditType`: questo campo viene compilato automaticamente.
- `SSOX Login`: immettere in questo campo il login dell'account SSOX che sarà utilizzato per registrare gli audit;
- `SSOX Password`: immettere in questo campo la password dell'account SSOX che sarà utilizzato per registrare gli audit;
- `ODBC DSN (Catalog)`: selezionare dall'elenco a discesa l'origine dati ODBC a 32 bit. Se l'elenco è vuoto, consultare [questa pagina](https://docs.cyberelements.io/identity/7.1/it/Installation/InstallDoc/AuditConfiguration/ODBCConnectorConfig/);
- `Audit Server Address`: immettere in questo campo l'indirizzo IP del server di audit;
- `Audit Server Port`: immettere in questo campo la porta che sarà utilizzata dal server di audit.

Una volta immesse le informazioni, fare clic su `Next >`.

**Configurazione di Federation**

> **Nota**
>
> Questa finestra viene visualizzata se il componente Federation è stato selezionato nel passaggio di selezione dei componenti.

Questa schermata consente di configurare l'installazione di CyberElements Federation. Compilare i seguenti campi:

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

- `Federation Hostname`: immettere in questo campo l'FQDN del server Federation che sarà utilizzato;
- `Federation Port (44350)`: immettere in questo campo la porta che sarà utilizzata da CyberElements Federation (valore predefinito: 44350);
- `Federation Installation Directory`: fare clic sul pulsante `Browse...` per selezionare la directory di installazione di CyberElements Federation;
- `Use Identity Service Account`: selezionare questa casella per utilizzare l'account di servizio Identity come account di servizio Federation. Selezionando questa casella, la definizione dell'account di servizio Federation viene visualizzata in grigio;
- `Federation Service Account`: questa sezione consente di definire l'account di servizio Federation:
    - Selezionare l'ambito dell'account di servizio dall'elenco a discesa.
    - `Domain`: selezionare il dominio dell'account di servizio Federation;
    - `Username`: immettere in questo campo il login dell'account di servizio Federation;
    - `Password`: immettere in questo campo la password dell'account di servizio Federation.

Una volta immesse le informazioni, fare clic su `Next >`.

**Componenti aggiuntivi**

> **Nota**
>
> Questa finestra viene visualizzata se il componente `CyberElements Identity Provisioning (SIP)` è stato selezionato nel passaggio di selezione dei componenti.

Questa schermata consente di configurare l'installazione di SIP. Compilare i seguenti campi:

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

- `SIP Installation Directory`: fare clic sul pulsante `Browse...` per selezionare la directory di installazione di CyberElements Identity Provisioning;
- `Use Identity Service Account`: selezionare questa casella per utilizzare l'account di servizio Identity come account di servizio SIP. Selezionando questa casella, la definizione dell'account di servizio SIP viene visualizzata in grigio;
- `SIP Service Account`: questa sezione consente di definire l'account di servizio SIP:
    - Selezionare l'ambito dell'account di servizio dall'elenco a discesa.
    - `Domain`: selezionare il dominio dell'account di servizio SIP;
    - `Username`: immettere in questo campo il login dell'account di servizio SIP;
    - `Password`: immettere in questo campo la password dell'account di servizio SIP.

Una volta immesse le informazioni, fare clic su `Next >`.

**Configurazione SIP - OIDC**

> **Nota**
>
> Questa finestra viene visualizzata se il componente `CyberElements Identity Provisioning (SIP)` è stato selezionato nel passaggio di selezione dei componenti.

Questa schermata consente di configurare il livello di autenticazione OIDC del Service Provider. Compilare i seguenti campi:

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

- `Port API SIP`: immettere la porta che sarà utilizzata dalle API SIP;
- `Audience`, `Authorization Endpoint`, `Token Endpoint`, `End Session Endpoint`: immettere qui i parametri del Service Provider.

Una volta immesse le informazioni, fare clic su `Next >`.

**Configurazione SIP - Credenziali**

> **Nota**
>
> Questa finestra viene visualizzata se il componente `CyberElements Identity Provisioning (SIP)` è stato selezionato nel passaggio di selezione dei componenti.

Questa schermata consente di configurare le credenziali SIP, che saranno utilizzate in particolare nei file di configurazione. Compilare i seguenti campi:

> **Nota**
>
> Per una prima installazione, si consiglia di mantenere le informazioni predefinite.

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

- `Client ID`: immettere qui l'identificativo del Client;
- `Client Secret`: immettere qui il segreto del Client;
- `HPP Username`: immettere qui il login dell'account HPP;
- `HPP Password`: immettere qui la password dell'account HPP;
- `Use PKCE`: selezionare questa casella per abilitare l'estensione di sicurezza PKCE;
- `Culture`: selezionare `fr-FR` per il francese o `en-US`.

Una volta immesse le informazioni, fare clic su `Next >`.

**Ready to Install**

Questa schermata mostra un riepilogo della configurazione effettuata nel programma di installazione. Verificare che le informazioni siano corrette, quindi fare clic su `Install`.

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

**Installazione**

Attendere qualche istante durante l'installazione di CyberElements Identity, quindi fare clic su `Finish` per completare l'installazione.

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

> **Attenzione**
>
> Durante questa fase, il programma di installazione verifica che Hpliance sia stato installato correttamente. In caso contrario, l'installazione si arresta con il messaggio `Hpliance was not installed properly.` In tal caso, consultare i log di installazione, correggere la causa ed eseguire nuovamente il programma di installazione.
