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

# Bħala parti minn installazzjoni għall-ewwel darba

## Installazzjoni ta’ CyberElements Identity 7.1

Mill-verżjoni 7.1 ’il quddiem, jitwassal installatur ġdid ma’ CyberElements Identity. L-eżekutibbli `Cyberelements Identity Version 7.1.x.exe` jinstalla l-moduli li ġejjin:

- il-bażi tad-dejta, li tista’ tiġi installata fuq server remot;
- Hpliance, jiġifieri l-moduli tal-ġenerazzjoni 6 preċedenti;
- Identity, is-sit web u l-API tiegħu;
- is-server tal-awditu.

Jinstalla wkoll, b’mod fakultattiv, il-moduli li ġejjin:

- il-modulu CyberElements Federation;
- SIP, il-magna tal-provvediment u l-API tagħha.

L-installatur jista’ wkoll jiddiżinstalla l-verżjoni preċedenti, mill-verżjoni 7.0 biss.

> **Twissija**
>
> Huwa meħtieġ sors tad-dejta ODBC ta’ 32 bit biex jiġi kkonfigurat il-modulu tal-awditu. Irreferi għal [din il-paġna](https://docs.cyberelements.io/identity/7.1/mt/Installation/InstallDoc/AuditConfiguration/ODBCConnectorConfig/) biex toħloq sors tad-dejta ODBC.

### Installatur ta’ CyberElements Identity 7.1

Ħaddem l-installatur u kklikkja `Next >`.

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

**Termini tal-użu**

Aċċetta t-termini tal-użu, imbagħad ikklikkja `Next >`.

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

**Prerekwiżiti**

F’dan l-iskrin, stenna ftit. L-installatur jiċċekkja li l-prerekwiżiti huma installati.

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

> **Nota**
>
> Jekk wieħed mill-prerekwiżiti ma jiġix issodisfat — rwol, funzjonalità jew framework nieqes —, l-installatur jieqaf u messaġġ jispeċifika l-elementi neqsin. Irreferi għall-paġna [Prerekwiżiti tekniċi](https://docs.cyberelements.io/identity/7.1/mt/Installation/TechnicalPrerequisites/).
>
> ![](https://docs.cyberelements.io/identity/7.1/img/Identity/Identity71-PrerequisiteCheckFailed.png)

Ladarba l-prerekwiżiti jiġu ċċekkjati, ikklikkja `Next >`.

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

**Skrin tal-għażla tal-fajl tal-liċenzja**

Fl-iskrin tal-konfigurazzjoni tal-liċenzja, ikklikkja `Browse...` u agħżel il-fajl tal-liċenzja tiegħek.

> **Twissija**
>
> Jekk tintuża bażi tad-dejta PostgreSQL, immarka l-kaxxa `Enable preview features (PostgreSQL database)`.

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

Ikklikkja `Next >`.

**Diżinstallazzjoni tal-verżjonijiet preċedenti**

Dan l-iskrin jagħtik il-possibbiltà li tiddiżinstalla l-verżjonijiet preċedenti diġà installati. Daħħal il-mogħdijiet għall-verżjonijiet preċedenti. Tista’ tagħżel ukoll jekk Systancia Identity Provisioning (SIP) u CyberElements Federation għandhomx jiġu diżinstallati billi timmarka l-kaxxa assoċjata. Ikklikkja `Next >`.

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

L-installatur qed jiddiżinstalla Identity; jekk jogħġbok stenna.

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

**Għażla tal-komponenti**

F’dan l-iskrin, agħżel il-komponenti li trid tinstalla, imbagħad ikklikkja `Next >`.

> **Nota**
>
> Tista’ tagħżel il-komponenti wieħed wieħed billi timmarka jew tneħħi l-marka mill-kaxxa assoċjata, jew tuża l-għażliet tal-menu drop-down:
>
> ![](https://docs.cyberelements.io/identity/7.1/img/Identity/Identity71-SelectComponentsMenuDeroulant.png)
>
> > **Twissija**
> >
> > Jekk qabel immarkajt il-kaxxa `Enable preview features`, trid tneħħi l-għażla tal-komponent Hpliance, peress li mhuwiex kompatibbli mal-bażijiet tad-dejta PostgreSQL.

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

**Għażla tal-folder tal-installazzjoni**

Daħħal il-mogħdijiet tal-installazzjoni għall-verżjoni l-ġdida ta’ CyberElements Identity, imbagħad ikklikkja `Next >`.

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

Ladarba tiddaħħal l-informazzjoni, ikklikkja `Next >`.

**Konfigurazzjoni tal-bażi tad-dejta**

Imbagħad tasal fl-iskrin tal-konfigurazzjoni tal-bażi tad-dejta.

Imla l-konfigurazzjoni billi tdaħħal l-FQDN jew l-indirizz IP tas-server tal-bażi tad-dejta, l-isem tal-bażi tad-dejta u t-tip ta’ awtentikazzjoni tal-bażi tad-dejta (daħħal ukoll il-kredenzjali tal-kont tas-servizz jekk tagħżel l-awtentikazzjoni SQL Server). Imbagħad ikklikkja `Next >`.

> **Eżempju b’bażi tad-dejta SQL Server**
>
> ![](https://docs.cyberelements.io/identity/7.1/img/Identity/Identity71-DatabasConfigurationSQLServer.png)

Ladarba l-bażi tad-dejta tiġi kkonfigurata, ikklikkja `Next >`.

**Kontijiet tas-servizz**

Imbagħad l-installatur jitolbok iddaħħal il-kontijiet tas-servizz li se jintużaw minn Identity.

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

- Il-kont `Identity Service Account` se jintuża għall-aċċess għall-applikazzjoni web u għall-APIs SID.
- Il-kont `Hpliance Service Account` se jintuża għall-aċċess għall-interfaċċji l-qodma u għas-servizzi Windows bħall-flussi tax-xogħol.

Tista’ timmarka l-kaxxa `Use Identity Service Account` biex tuża l-istess kont tas-servizz fiż-żewġ każijiet.

Ladarba l-kontijiet tas-servizz jiġu ddefiniti, ikklikkja `Next >`.

**Konfigurazzjoni taċ-ċertifikat**

Dan l-iskrin jagħtik il-possibbiltà li tagħżel il-maħżen taċ-ċertifikati u ċ-ċertifikat li għandu jintuża.

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

Ladarba ċ-ċertifikat jintgħażel, ikklikkja `Next >`.

**Konfigurazzjoni tan-netwerk**

Imbagħad tasal fl-iskrin tal-konfigurazzjoni tan-netwerk.

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

- `Host name`: Daħħal l-FQDN tas-server Identity tiegħek f’dan il-qasam;
- `Hpliance port`: Daħħal hawn il-port li se jintuża għall-aċċess għall-interfaċċji l-qodma;
- `Identity port`: Daħħal hawn il-port li se jintuża għall-aċċess għall-applikazzjoni web Identity;
- `Identity API Port`: Daħħal il-port li se jintuża għall-aċċess għall-APIs Identity;
- `Application Culture`: Dan il-menu drop-down jiddefinixxi l-lingwa default tal-interfaċċja Identity. Agħżel `en-US` għall-Ingliż jew `fr-FR` għall-Franċiż.

Ladarba tiddaħħal l-informazzjoni, ikklikkja `Next >`.

**Konfigurazzjoni tas-server SMTP**

Dan l-iskrin jagħtik il-possibbiltà li tikkonfigura server SMTP li se jintuża biex jintbagħtu n-notifiki varji. Biex tikkonfigura s-server SMTP, imla l-oqsma kif ġej:

> **Nota**
>
> Peress li dan il-pass huwa fakultattiv, tista’ tħalli l-oqsma vojta jekk ma tridx tikkonfigura server SMTP.

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

- `SMTP Server Address`: daħħal f’dan il-qasam l-indirizz IP tas-server SMTP li se jintuża (vojt b’mod default);
- `SMTP Port`: daħħal hawn il-port li se jintuża għall-aċċess għas-server SMTP (valur default: 25);
- `SMTP Mail Address`: daħħal f’dan il-qasam l-indirizz tal-email li se jintuża bħala l-mittent tan-notifiki (vojt b’mod default);
- `SMTP Username`: daħħal hawn il-login tal-kont li se jintuża biex jintbagħtu n-notifiki (vojt b’mod default);
- `SMTP Password`: daħħal hawn il-password tal-kont li se jintuża biex jintbagħtu n-notifiki (vojt b’mod default).

**Konfigurazzjoni tal-awditu**

> **Twissija**
>
> Biex twettaq dan il-pass, irid ikun inħoloq sors tad-dejta ODBC ta’ 32 bit. Irreferi għal [din il-paġna](https://docs.cyberelements.io/identity/7.1/mt/Installation/InstallDoc/AuditConfiguration/ODBCConnectorConfig/).

Dan l-iskrin jagħtik il-possibbiltà li tikkonfigura l-modulu tal-awditu. Imla l-oqsma li ġejjin:

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

- `AuditType`: Dan il-qasam jimtela awtomatikament.
- `SSOX Login`: Daħħal f’dan il-qasam il-login tal-kont SSOX li se jintuża biex jinħażnu l-awditi;
- `SSOX Password`: Daħħal f’dan il-qasam il-password tal-kont SSOX li se jintuża biex jinħażnu l-awditi;
- `ODBC DSN (Catalog)`: Agħżel is-sors tad-dejta ODBC ta’ 32 bit tiegħek mill-menu drop-down. Jekk din il-lista hija vojta, irreferi għal [din il-paġna](https://docs.cyberelements.io/identity/7.1/mt/Installation/InstallDoc/AuditConfiguration/ODBCConnectorConfig/);
- `Audit Server Address`: Daħħal f’dan il-qasam l-indirizz IP tas-server tal-awditu tiegħek;
- `Audit Server Port`: Daħħal f’dan il-qasam il-port li se jintuża mis-server tal-awditu.

Ladarba tiddaħħal l-informazzjoni, ikklikkja `Next >`.

**Konfigurazzjoni ta’ Federation**

> **Nota**
>
> Din it-tieqa tidher jekk il-komponent Federation ikun intgħażel matul il-pass tal-għażla tal-komponenti.

Dan l-iskrin jagħtik il-possibbiltà li tikkonfigura l-installazzjoni ta’ CyberElements Federation. Imla l-oqsma li ġejjin:

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

- `Federation Hostname`: daħħal f’dan il-qasam l-FQDN tas-server Federation li se jintuża;
- `Federation Port (44350)`: daħħal f’dan il-qasam il-port li se jintuża minn CyberElements Federation (valur default: 44350);
- `Federation Installation Directory`: ikklikkja l-buttuna `Browse...` biex tagħżel il-folder tal-installazzjoni ta’ CyberElements Federation;
- `Use Identity Service Account`: Immarka din il-kaxxa biex tuża l-kont tas-servizz Identity bħala l-kont tas-servizz Federation. Meta timmarka din il-kaxxa, id-definizzjoni tal-kont tas-servizz Federation tidher bil-griż;
- `Federation Service Account`: Din it-taqsima tagħtik il-possibbiltà li tiddefinixxi l-kont tas-servizz Federation:
    - Agħżel l-ambitu tal-kont tas-servizz mill-menu drop-down.
    - `Domain`: Agħżel id-dominju tal-kont tas-servizz Federation;
    - `Username`: daħħal f’dan il-qasam il-login tal-kont tas-servizz Federation;
    - `Password`: daħħal f’dan il-qasam il-password tal-kont tas-servizz Federation.

Ladarba tiddaħħal l-informazzjoni, ikklikkja `Next >`.

**Komponenti addizzjonali**

> **Nota**
>
> Din it-tieqa tidher jekk il-komponent `CyberElements Identity Provisioning (SIP)` ikun intgħażel matul il-pass tal-għażla tal-komponenti.

Dan l-iskrin jagħtik il-possibbiltà li tikkonfigura l-installazzjoni ta’ SIP. Imla l-oqsma li ġejjin:

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

- `SIP Installation Directory`: ikklikkja l-buttuna `Browse...` biex tagħżel il-folder tal-installazzjoni ta’ CyberElements Identity Provisioning;
- `Use Identity Service Account`: Immarka din il-kaxxa biex tuża l-kont tas-servizz Identity bħala l-kont tas-servizz SIP. Meta timmarka din il-kaxxa, id-definizzjoni tal-kont tas-servizz SIP tidher bil-griż;
- `SIP Service Account`: Din it-taqsima tagħtik il-possibbiltà li tiddefinixxi l-kont tas-servizz SIP:
    - Agħżel l-ambitu tal-kont tas-servizz mill-menu drop-down.
    - `Domain`: Agħżel id-dominju tal-kont tas-servizz SIP;
    - `Username`: daħħal f’dan il-qasam il-login tal-kont tas-servizz SIP;
    - `Password`: daħħal f’dan il-qasam il-password tal-kont tas-servizz SIP.

Ladarba tiddaħħal l-informazzjoni, ikklikkja `Next >`.

**Konfigurazzjoni ta’ SIP - OIDC**

> **Nota**
>
> Din it-tieqa tidher jekk il-komponent `CyberElements Identity Provisioning (SIP)` ikun intgħażel matul il-pass tal-għażla tal-komponenti.

Dan l-iskrin jagħtik il-possibbiltà li tikkonfigura s-saff tal-awtentikazzjoni OIDC tal-fornitur tas-servizz (Service Provider). Imla l-oqsma li ġejjin:

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

- `Port API SIP`: Daħħal il-port li se jintuża mill-APIs SIP;
- `Audience`, `Authorization Endpoint`, `Token Endpoint`, `End Session Endpoint`: Daħħal hawn il-parametri tal-fornitur tas-servizz (Service Provider) tiegħek.

Ladarba tiddaħħal l-informazzjoni, ikklikkja `Next >`.

**Konfigurazzjoni ta’ SIP - Kredenzjali**

> **Nota**
>
> Din it-tieqa tidher jekk il-komponent `CyberElements Identity Provisioning (SIP)` ikun intgħażel matul il-pass tal-għażla tal-komponenti.

Dan l-iskrin jagħtik il-possibbiltà li tikkonfigura l-kredenzjali SIP, li se jintużaw b’mod partikolari fil-fajls tal-konfigurazzjoni. Imla l-oqsma li ġejjin:

> **Nota**
>
> Għal installazzjoni għall-ewwel darba, huwa rakkomandat li żżomm l-informazzjoni default.

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

- `Client ID`: Daħħal hawn l-identifikatur tal-klijent (Client);
- `Client Secret`: Daħħal hawn is-sigriet tal-klijent (Client);
- `HPP Username`: Daħħal hawn il-login tal-kont HPP;
- `HPP Password`: Daħħal hawn il-password tal-kont HPP;
- `Use PKCE`: Immarka din il-kaxxa biex tattiva l-estensjoni tas-sigurtà PKCE;
- `Culture`: Agħżel `fr-FR` għall-Franċiż jew `en-US`.

Ladarba tiddaħħal l-informazzjoni, ikklikkja `Next >`.

**Ready to Install**

Dan l-iskrin juri sommarju tal-konfigurazzjoni magħmula fl-installatur. Iċċekkja li l-informazzjoni hija korretta, imbagħad ikklikkja `Install`.

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

**Installazzjoni**

Stenna ftit waqt li CyberElements Identity qed jiġi installat, imbagħad ikklikkja `Finish` biex tlesti l-installazzjoni.

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

> **Twissija**
>
> Matul din il-fażi, l-installatur jiċċekkja li Hpliance ġie installat b’mod korrett. Jekk dan ma jkunx il-każ, l-installazzjoni tieqaf bil-messaġġ `Hpliance was not installed properly.` F’dak il-każ, iċċekkja r-reġistri tal-installazzjoni, irranġa l-kawża u erġa’ ħaddem l-installatur.
