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

# Ensiasennuksen yhteydessä

## CyberElements Identity 7.1 -tuotteen asennus

Versiosta 7.1 alkaen CyberElements Identity -tuotteen mukana toimitetaan uusi asennusohjelma. Suoritettava tiedosto `Cyberelements Identity Version 7.1.x.exe` asentaa seuraavat moduulit:

- tietokanta, joka voidaan asentaa etäpalvelimelle;
- Hpliance eli entiset sukupolven 6 moduulit;
- Identity eli verkkosivusto ja sen API;
- auditointipalvelin.

Lisäksi se asentaa valinnaisesti seuraavat moduulit:

- CyberElements Federation -moduuli;
- SIP eli provisiointimoottori ja sen API.

Asennusohjelma voi myös poistaa edellisen version asennuksen, mutta vain versiosta 7.0 alkaen.

> **Varoitus**
>
> Auditointimoduulin määrittäminen edellyttää 32-bittistä ODBC-tietolähdettä. Katso ODBC-tietolähteen luomisesta [tämä sivu](https://docs.cyberelements.io/identity/7.1/fi/Installation/InstallDoc/AuditConfiguration/ODBCConnectorConfig/).

### CyberElements Identity 7.1 -asennusohjelma

Käynnistä asennusohjelma ja napsauta painiketta `Next >`.

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

**Käyttöehdot**

Hyväksy käyttöehdot ja napsauta sitten painiketta `Next >`.

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

**Edellytykset**

Odota hetki tässä näytössä. Asennusohjelma tarkistaa, että edellytykset on asennettu.

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

> **Huomautus**
>
> Jos jokin edellytyksistä ei täyty – puuttuva rooli, ominaisuus tai framework –, asennusohjelma pysähtyy ja ilmoitus kertoo puuttuvat kohteet. Katso sivu [Tekniset edellytykset](https://docs.cyberelements.io/identity/7.1/fi/Installation/TechnicalPrerequisites/).
>
> ![](https://docs.cyberelements.io/identity/7.1/img/Identity/Identity71-PrerequisiteCheckFailed.png)

Kun edellytykset on tarkistettu, napsauta painiketta `Next >`.

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

**Lisenssitiedoston valintanäyttö**

Napsauta lisenssin määritysnäytössä painiketta `Browse...` ja valitse lisenssitiedostosi.

> **Varoitus**
>
> Jos käytössä on PostgreSQL-tietokanta, valitse valintaruutu `Enable preview features (PostgreSQL database)`.

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

Napsauta painiketta `Next >`.

**Aiempien versioiden asennuksen poisto**

Tässä näytössä voit poistaa jo asennettujen aiempien versioiden asennuksen. Anna aiempien versioiden polut. Voit myös valita vastaavan valintaruudun avulla, poistetaanko myös Systancia Identity Provisioning (SIP) ja CyberElements Federation. Napsauta painiketta `Next >`.

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

Asennusohjelma poistaa Identity-tuotteen asennuksen; odota hetki.

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

**Komponenttien valinta**

Valitse tässä näytössä asennettavat komponentit ja napsauta sitten painiketta `Next >`.

> **Huomautus**
>
> Voit valita komponentit yksitellen valitsemalla vastaavan valintaruudun tai poistamalla sen valinnan, tai voit käyttää pudotusvalikon vaihtoehtoja:
>
> ![](https://docs.cyberelements.io/identity/7.1/img/Identity/Identity71-SelectComponentsMenuDeroulant.png)
>
> > **Varoitus**
> >
> > Jos valitsit aiemmin valintaruudun `Enable preview features`, sinun on poistettava Hpliance-komponentin valinta, koska se ei ole yhteensopiva PostgreSQL-tietokantojen kanssa.

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

**Asennushakemistojen valinta**

Anna CyberElements Identity -tuotteen uuden version asennuspolut ja napsauta sitten painiketta `Next >`.

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

Kun tiedot on annettu, napsauta painiketta `Next >`.

**Tietokannan määritys**

Seuraavaksi siirryt tietokannan määritysnäyttöön.

Täydennä määritys antamalla tietokantapalvelimen FQDN tai IP-osoite, tietokannan nimi ja tietokannan todennustyyppi (anna myös palvelutilin kirjautumistiedot, jos valitset SQL Server -todennuksen). Napsauta sitten painiketta `Next >`.

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

Kun tietokanta on määritetty, napsauta painiketta `Next >`.

**Palvelutilit**

Seuraavaksi asennusohjelma pyytää antamaan palvelutilit, joita Identity käyttää.

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

- Tiliä `Identity Service Account` käytetään pääsyyn verkkosovellukseen ja SID-rajapintoihin.
- Tiliä `Hpliance Service Account` käytetään pääsyyn vanhoihin käyttöliittymiin ja Windows-palveluihin, kuten workflow'ihin.

Voit valita valintaruudun `Use Identity Service Account`, jos haluat käyttää samaa palvelutiliä molemmissa tapauksissa.

Kun palvelutilit on määritetty, napsauta painiketta `Next >`.

**Sertifikaatin määritys**

Tässä näytössä voit valita sertifikaattisäilön ja käytettävän sertifikaatin.

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

Kun sertifikaatti on valittu, napsauta painiketta `Next >`.

**Verkon määritys**

Seuraavaksi siirryt verkon määritysnäyttöön.

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

- `Host name`: anna tähän kenttään Identity-palvelimesi FQDN;
- `Hpliance port`: anna tähän portti, jota käytetään pääsyyn vanhoihin käyttöliittymiin;
- `Identity port`: anna tähän portti, jota käytetään pääsyyn Identity-verkkosovellukseen;
- `Identity API Port`: anna portti, jota käytetään pääsyyn Identity-rajapintoihin;
- `Application Culture`: tämä pudotusvalikko määrittää Identity-käyttöliittymän oletuskielen. Valitse `en-US`, jos haluat englannin, tai `fr-FR`, jos haluat ranskan.

Kun tiedot on annettu, napsauta painiketta `Next >`.

**SMTP-palvelimen määritys**

Tässä näytössä voit määrittää SMTP-palvelimen, jota käytetään eri ilmoitusten lähettämiseen. Määritä SMTP-palvelin täyttämällä kentät seuraavasti:

> **Huomautus**
>
> Koska tämä vaihe on valinnainen, voit jättää kentät tyhjiksi, jos et halua määrittää SMTP-palvelinta.

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

- `SMTP Server Address`: anna tähän kenttään käytettävän SMTP-palvelimen IP-osoite (oletuksena tyhjä);
- `SMTP Port`: anna tähän portti, jota käytetään pääsyyn SMTP-palvelimelle (oletusarvo: 25);
- `SMTP Mail Address`: anna tähän kenttään sähköpostiosoite, jota käytetään ilmoitusten lähettäjänä (oletuksena tyhjä);
- `SMTP Username`: anna tähän sen tilin kirjautumistunnus, jota käytetään ilmoitusten lähettämiseen (oletuksena tyhjä);
- `SMTP Password`: anna tähän sen tilin salasana, jota käytetään ilmoitusten lähettämiseen (oletuksena tyhjä).

**Auditointien määritys**

> **Varoitus**
>
> Tämän vaiheen suorittaminen edellyttää, että 32-bittinen ODBC-tietolähde on luotu. Katso [tämä sivu](https://docs.cyberelements.io/identity/7.1/fi/Installation/InstallDoc/AuditConfiguration/ODBCConnectorConfig/).

Tässä näytössä voit määrittää auditointimoduulin. Täytä seuraavat kentät:

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

- `AuditType`: tämä kenttä täytetään automaattisesti.
- `SSOX Login`: anna tähän kenttään sen SSOX-tilin kirjautumistunnus, jota käytetään auditointien kirjaamiseen;
- `SSOX Password`: anna tähän kenttään sen SSOX-tilin salasana, jota käytetään auditointien kirjaamiseen;
- `ODBC DSN (Catalog)`: valitse 32-bittinen ODBC-tietolähteesi pudotusvalikosta. Jos luettelo on tyhjä, katso [tämä sivu](https://docs.cyberelements.io/identity/7.1/fi/Installation/InstallDoc/AuditConfiguration/ODBCConnectorConfig/);
- `Audit Server Address`: anna tähän kenttään auditointipalvelimesi IP-osoite;
- `Audit Server Port`: anna tähän kenttään portti, jota auditointipalvelin käyttää.

Kun tiedot on annettu, napsauta painiketta `Next >`.

**Federation-määritys**

> **Huomautus**
>
> Tämä ikkuna tulee näkyviin, jos Federation-komponentti valittiin komponenttien valintavaiheessa.

Tässä näytössä voit määrittää CyberElements Federation -tuotteen asennuksen. Täytä seuraavat kentät:

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

- `Federation Hostname`: anna tähän kenttään käytettävän Federation-palvelimen FQDN;
- `Federation Port (44350)`: anna tähän kenttään portti, jota CyberElements Federation käyttää (oletusarvo: 44350);
- `Federation Installation Directory`: napsauta painiketta `Browse...` ja valitse CyberElements Federation -tuotteen asennushakemisto;
- `Use Identity Service Account`: valitse tämä valintaruutu, jos haluat käyttää Identity-palvelutiliä Federation-palvelutilinä. Kun tämä valintaruutu valitaan, Federation-palvelutilin määritys näkyy harmaana;
- `Federation Service Account`: tässä osiossa voit määrittää Federation-palvelutilin:
    - Valitse palvelutilin laajuus pudotusvalikosta.
    - `Domain`: valitse Federation-palvelutilin toimialue;
    - `Username`: anna tähän kenttään Federation-palvelutilin kirjautumistunnus;
    - `Password`: anna tähän kenttään Federation-palvelutilin salasana.

Kun tiedot on annettu, napsauta painiketta `Next >`.

**Lisäkomponentit**

> **Huomautus**
>
> Tämä ikkuna tulee näkyviin, jos komponentti `CyberElements Identity Provisioning (SIP)` valittiin komponenttien valintavaiheessa.

Tässä näytössä voit määrittää SIP-asennuksen. Täytä seuraavat kentät:

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

- `SIP Installation Directory`: napsauta painiketta `Browse...` ja valitse CyberElements Identity Provisioning -tuotteen asennushakemisto;
- `Use Identity Service Account`: valitse tämä valintaruutu, jos haluat käyttää Identity-palvelutiliä SIP-palvelutilinä. Kun tämä valintaruutu valitaan, SIP-palvelutilin määritys näkyy harmaana;
- `SIP Service Account`: tässä osiossa voit määrittää SIP-palvelutilin:
    - Valitse palvelutilin laajuus pudotusvalikosta.
    - `Domain`: valitse SIP-palvelutilin toimialue;
    - `Username`: anna tähän kenttään SIP-palvelutilin kirjautumistunnus;
    - `Password`: anna tähän kenttään SIP-palvelutilin salasana.

Kun tiedot on annettu, napsauta painiketta `Next >`.

**SIP-määritys – OIDC**

> **Huomautus**
>
> Tämä ikkuna tulee näkyviin, jos komponentti `CyberElements Identity Provisioning (SIP)` valittiin komponenttien valintavaiheessa.

Tässä näytössä voit määrittää Service Providerin OIDC-todennuskerroksen. Täytä seuraavat kentät:

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

- `Port API SIP`: anna portti, jota SIP-rajapinnat käyttävät;
- `Audience`, `Authorization Endpoint`, `Token Endpoint`, `End Session Endpoint`: anna tähän Service Providerisi parametrit.

Kun tiedot on annettu, napsauta painiketta `Next >`.

**SIP-määritys – kirjautumistiedot**

> **Huomautus**
>
> Tämä ikkuna tulee näkyviin, jos komponentti `CyberElements Identity Provisioning (SIP)` valittiin komponenttien valintavaiheessa.

Tässä näytössä voit määrittää SIP-kirjautumistiedot, joita käytetään erityisesti määritystiedostoissa. Täytä seuraavat kentät:

> **Huomautus**
>
> Ensiasennuksessa on suositeltavaa säilyttää oletustiedot.

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

- `Client ID`: anna tähän Client-tunniste;
- `Client Secret`: anna tähän Client-salaisuus;
- `HPP Username`: anna tähän HPP-tilin kirjautumistunnus;
- `HPP Password`: anna tähän HPP-tilin salasana;
- `Use PKCE`: valitse tämä valintaruutu, jos haluat ottaa käyttöön PKCE-tietoturvalaajennuksen;
- `Culture`: valitse `fr-FR`, jos haluat ranskan, tai `en-US`.

Kun tiedot on annettu, napsauta painiketta `Next >`.

**Ready to Install**

Tässä näytössä näkyy yhteenveto asennusohjelmassa tehdystä määrityksestä. Tarkista, että tiedot ovat oikein, ja napsauta sitten painiketta `Install`.

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

**Asennus**

Odota hetki, kun CyberElements Identity asennetaan, ja viimeistele asennus sitten napsauttamalla painiketta `Finish`.

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

> **Varoitus**
>
> Tämän vaiheen aikana asennusohjelma tarkistaa, että Hpliance on asennettu oikein. Jos näin ei ole, asennus pysähtyy ilmoitukseen `Hpliance was not installed properly.` Tarkista siinä tapauksessa asennuslokit, korjaa syy ja suorita asennusohjelma uudelleen.
