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

# In het kader van een eerste installatie

## Installatie van CyberElements Identity 7.1

Vanaf versie 7.1 wordt bij CyberElements Identity een nieuw installatieprogramma geleverd. Het uitvoerbare bestand `Cyberelements Identity Version 7.1.x.exe` installeert de volgende modules:

- de database, die op een externe server kan worden geïnstalleerd;
- Hpliance, dat wil zeggen de vroegere modules van generatie 6;
- Identity, de website en de bijbehorende API;
- de auditserver.

Daarnaast installeert het optioneel de volgende modules:

- de module CyberElements Federation;
- SIP, de provisioning-engine en de bijbehorende API.

Het installatieprogramma kan bovendien de vorige versie deïnstalleren, uitsluitend vanaf versie 7.0.

> **Waarschuwing**
>
> Er is een 32-bits ODBC-gegevensbron nodig om de auditmodule te kunnen configureren. Raadpleeg [deze pagina](https://docs.cyberelements.io/identity/7.1/nl/Installation/InstallDoc/AuditConfiguration/ODBCConnectorConfig/) om een ODBC-gegevensbron aan te maken.

### Installatieprogramma van CyberElements Identity 7.1

Start het installatieprogramma en klik op `Next >`.

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

**Gebruiksvoorwaarden**

Aanvaard de gebruiksvoorwaarden en klik daarna op `Next >`.

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

**Voorwaarden**

Wacht op dit scherm even. Het installatieprogramma controleert of de voorwaarden zijn geïnstalleerd.

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

> **Opmerking**
>
> Als niet aan een van de voorwaarden is voldaan — ontbrekende rol, functie of framework —, stopt het installatieprogramma en vermeldt een melding de ontbrekende onderdelen. Raadpleeg de pagina [Technische voorwaarden](https://docs.cyberelements.io/identity/7.1/nl/Installation/TechnicalPrerequisites/).
>
> ![](https://docs.cyberelements.io/identity/7.1/img/Identity/Identity71-PrerequisiteCheckFailed.png)

Klik op `Next >` zodra de voorwaarden zijn gecontroleerd.

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

**Scherm voor de selectie van het licentiebestand**

Klik op het scherm voor de licentieconfiguratie op `Browse...` en selecteer uw licentiebestand.

> **Waarschuwing**
>
> Vink het selectievakje `Enable preview features (PostgreSQL database)` aan als een PostgreSQL-database wordt gebruikt.

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

Klik op `Next >`.

**Deïnstallatie van de vorige versies**

Met dit scherm kunt u de reeds geïnstalleerde vorige versies deïnstalleren. Voer de paden naar de vorige versies in. U kunt ook kiezen of Systancia Identity Provisioning (SIP) en CyberElements Federation moeten worden gedeïnstalleerd door het bijbehorende selectievakje aan te vinken. Klik op `Next >`.

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

Het installatieprogramma deïnstalleert Identity; even geduld.

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

**Selectie van de componenten**

Selecteer op dit scherm de te installeren componenten en klik daarna op `Next >`.

> **Opmerking**
>
> U kunt de componenten afzonderlijk selecteren door het bijbehorende selectievakje aan of uit te vinken, of de opties van de vervolgkeuzelijst gebruiken:
>
> ![](https://docs.cyberelements.io/identity/7.1/img/Identity/Identity71-SelectComponentsMenuDeroulant.png)
>
> > **Waarschuwing**
> >
> > Als u eerder het selectievakje `Enable preview features` hebt aangevinkt, moet u de component Hpliance deselecteren, omdat deze niet compatibel is met PostgreSQL-databases.

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

**Selectie van de installatiemappen**

Voer de installatiepaden voor de nieuwe versie van CyberElements Identity in en klik daarna op `Next >`.

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

Klik op `Next >` zodra de gegevens zijn ingevoerd.

**Configuratie van de database**

U komt vervolgens op het scherm voor de configuratie van de database.

Vul de configuratie in door de FQDN of het IP-adres van de databaseserver, de naam van de database en het authenticatietype van de database in te voeren (voer ook de aanmeldgegevens van het serviceaccount in als u SQL Server-authenticatie selecteert). Klik daarna op `Next >`.

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

Klik op `Next >` zodra de database is geconfigureerd.

**Serviceaccounts**

Het installatieprogramma vraagt u vervolgens de serviceaccounts in te voeren die door Identity worden gebruikt.

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

- Het account `Identity Service Account` wordt gebruikt om toegang te krijgen tot de webapplicatie en de SID-API's.
- Het account `Hpliance Service Account` wordt gebruikt om toegang te krijgen tot de oude interfaces en de Windows-services, zoals de workflows.

U kunt het selectievakje `Use Identity Service Account` aanvinken om in beide gevallen hetzelfde serviceaccount te gebruiken.

Klik op `Next >` zodra de serviceaccounts zijn gedefinieerd.

**Configuratie van het certificaat**

Met dit scherm kunt u de certificaatopslag en het te gebruiken certificaat selecteren.

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

Klik op `Next >` zodra het certificaat is geselecteerd.

**Configuratie van het netwerk**

U komt vervolgens op het scherm voor de configuratie van het netwerk.

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

- `Host name`: voer in dit veld de FQDN van uw Identity-server in;
- `Hpliance port`: voer hier de poort in die wordt gebruikt om toegang te krijgen tot de oude interfaces;
- `Identity port`: voer hier de poort in die wordt gebruikt om toegang te krijgen tot de webapplicatie Identity;
- `Identity API Port`: voer de poort in die wordt gebruikt om toegang te krijgen tot de Identity-API's;
- `Application Culture`: deze vervolgkeuzelijst bepaalt de standaardtaal van de Identity-interface. Selecteer `en-US` voor Engels of `fr-FR` voor Frans.

Klik op `Next >` zodra de gegevens zijn ingevoerd.

**Configuratie van de SMTP-server**

Met dit scherm kunt u een SMTP-server configureren die wordt gebruikt om de verschillende notificaties te verzenden. Vul de velden als volgt in om de SMTP-server te configureren:

> **Opmerking**
>
> Aangezien deze stap optioneel is, kunt u de velden leeg laten als u geen SMTP-server wilt configureren.

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

- `SMTP Server Address`: voer in dit veld het IP-adres in van de SMTP-server die wordt gebruikt (standaard leeg);
- `SMTP Port`: voer hier de poort in die wordt gebruikt om toegang te krijgen tot de SMTP-server (standaardwaarde: 25);
- `SMTP Mail Address`: voer in dit veld het e-mailadres in dat als afzender van de notificaties wordt gebruikt (standaard leeg);
- `SMTP Username`: voer hier de aanmeldnaam in van het account dat wordt gebruikt om de notificaties te verzenden (standaard leeg);
- `SMTP Password`: voer hier het wachtwoord in van het account dat wordt gebruikt om de notificaties te verzenden (standaard leeg).

**Configuratie van de audits**

> **Waarschuwing**
>
> Er moet een 32-bits ODBC-gegevensbron zijn aangemaakt om deze stap te kunnen uitvoeren. Raadpleeg [deze pagina](https://docs.cyberelements.io/identity/7.1/nl/Installation/InstallDoc/AuditConfiguration/ODBCConnectorConfig/).

Met dit scherm kunt u de auditmodule configureren. Vul de volgende velden in:

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

- `AuditType`: dit veld wordt automatisch ingevuld.
- `SSOX Login`: voer in dit veld de aanmeldnaam in van het SSOX-account dat wordt gebruikt om de audits vast te leggen;
- `SSOX Password`: voer in dit veld het wachtwoord in van het SSOX-account dat wordt gebruikt om de audits vast te leggen;
- `ODBC DSN (Catalog)`: selecteer uw 32-bits ODBC-gegevensbron in de vervolgkeuzelijst. Raadpleeg [deze pagina](https://docs.cyberelements.io/identity/7.1/nl/Installation/InstallDoc/AuditConfiguration/ODBCConnectorConfig/) als deze lijst leeg is;
- `Audit Server Address`: voer in dit veld het IP-adres van uw auditserver in;
- `Audit Server Port`: voer in dit veld de poort in die door de auditserver wordt gebruikt.

Klik op `Next >` zodra de gegevens zijn ingevoerd.

**Configuratie van Federation**

> **Opmerking**
>
> Dit venster verschijnt als de component Federation is geselecteerd tijdens de stap voor de selectie van de componenten.

Met dit scherm kunt u de installatie van CyberElements Federation configureren. Vul de volgende velden in:

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

- `Federation Hostname`: voer in dit veld de FQDN in van de Federation-server die wordt gebruikt;
- `Federation Port (44350)`: voer in dit veld de poort in die door CyberElements Federation wordt gebruikt (standaardwaarde: 44350);
- `Federation Installation Directory`: klik op de knop `Browse...` om de installatiemap van CyberElements Federation te selecteren;
- `Use Identity Service Account`: vink dit selectievakje aan om het Identity-serviceaccount als Federation-serviceaccount te gebruiken. Wanneer dit selectievakje is aangevinkt, wordt de definitie van het Federation-serviceaccount grijs weergegeven;
- `Federation Service Account`: met deze sectie kunt u het Federation-serviceaccount definiëren:
    - Selecteer het bereik van het serviceaccount in de vervolgkeuzelijst.
    - `Domain`: selecteer het domein van het Federation-serviceaccount;
    - `Username`: voer in dit veld de aanmeldnaam van het Federation-serviceaccount in;
    - `Password`: voer in dit veld het wachtwoord van het Federation-serviceaccount in.

Klik op `Next >` zodra de gegevens zijn ingevoerd.

**Aanvullende componenten**

> **Opmerking**
>
> Dit venster verschijnt als de component `CyberElements Identity Provisioning (SIP)` is geselecteerd tijdens de stap voor de selectie van de componenten.

Met dit scherm kunt u de installatie van SIP configureren. Vul de volgende velden in:

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

- `SIP Installation Directory`: klik op de knop `Browse...` om de installatiemap van CyberElements Identity Provisioning te selecteren;
- `Use Identity Service Account`: vink dit selectievakje aan om het Identity-serviceaccount als SIP-serviceaccount te gebruiken. Wanneer dit selectievakje is aangevinkt, wordt de definitie van het SIP-serviceaccount grijs weergegeven;
- `SIP Service Account`: met deze sectie kunt u het SIP-serviceaccount definiëren:
    - Selecteer het bereik van het serviceaccount in de vervolgkeuzelijst.
    - `Domain`: selecteer het domein van het SIP-serviceaccount;
    - `Username`: voer in dit veld de aanmeldnaam van het SIP-serviceaccount in;
    - `Password`: voer in dit veld het wachtwoord van het SIP-serviceaccount in.

Klik op `Next >` zodra de gegevens zijn ingevoerd.

**SIP-configuratie - OIDC**

> **Opmerking**
>
> Dit venster verschijnt als de component `CyberElements Identity Provisioning (SIP)` is geselecteerd tijdens de stap voor de selectie van de componenten.

Met dit scherm kunt u de OIDC-authenticatielaag van de Service Provider configureren. Vul de volgende velden in:

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

- `Port API SIP`: voer de poort in die door de SIP-API's wordt gebruikt;
- `Audience`, `Authorization Endpoint`, `Token Endpoint`, `End Session Endpoint`: voer hier de parameters van uw Service Provider in.

Klik op `Next >` zodra de gegevens zijn ingevoerd.

**SIP-configuratie - Aanmeldgegevens**

> **Opmerking**
>
> Dit venster verschijnt als de component `CyberElements Identity Provisioning (SIP)` is geselecteerd tijdens de stap voor de selectie van de componenten.

Met dit scherm kunt u de aanmeldgegevens van SIP configureren, die met name in de configuratiebestanden worden gebruikt. Vul de volgende velden in:

> **Opmerking**
>
> Bij een eerste installatie wordt aanbevolen de standaardgegevens te behouden.

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

- `Client ID`: voer hier de identificatie van de Client in;
- `Client Secret`: voer hier het geheim van de Client in;
- `HPP Username`: voer hier de aanmeldnaam van het HPP-account in;
- `HPP Password`: voer hier het wachtwoord van het HPP-account in;
- `Use PKCE`: vink dit selectievakje aan om de PKCE-beveiligingsextensie in te schakelen;
- `Culture`: selecteer `fr-FR` voor Frans of `en-US`.

Klik op `Next >` zodra de gegevens zijn ingevoerd.

**Ready to Install**

Dit scherm toont een samenvatting van de configuratie die in het installatieprogramma is uitgevoerd. Controleer of de gegevens juist zijn en klik daarna op `Install`.

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

**Installatie**

Wacht even terwijl CyberElements Identity wordt geïnstalleerd en klik daarna op `Finish` om de installatie te voltooien.

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

> **Waarschuwing**
>
> Tijdens deze fase controleert het installatieprogramma of Hpliance correct is geïnstalleerd. Is dat niet het geval, dan stopt de installatie met de melding `Hpliance was not installed properly.` Raadpleeg in dat geval de installatielogs, verhelp de oorzaak en voer het installatieprogramma opnieuw uit.
