1.1 Systémové požiadavky a nevyhnutné podmienky na inštaláciu ako kontajnera Docker

1.1.1 Systémové požiadavky

Keďže aplikáciu OpenText Identity Console možno spúšťať ako kontajner Docker, ďalšie informácie o systémových požiadavkách a podporovaných platformách na inštaláciu aplikácie OpenText Identity Console nájdete v dokumentácii platformy Docker.

1.1.2 Požiadavky

Nainštalujte platformu Docker, verziu 20.10.9-ce alebo novšiu. Ďalšie informácie o tom, ako nainštalovať kontajner Docker v závislosti od vašej platformy, nájdete v časti Inštalácia kontajnera Docker.
Potrebujete získať certifikát servera pkcs12 so súkromným kľúčom na šifrovanie alebo dešifrovanie výmeny dát medzi serverom OpenText Identity Console a backendovým serverom. Tento certifikát servera sa používa na zabezpečenie pripojenia http. Môžete použiť certifikáty servera vygenerované ľubovoľným externým certifikačným úradom. Ďalšie informácie nájdete v časti Creating a Server Certificate Object (Vytvorenie objektu certifikátu servera). Certifikát servera musí obsahovať alternatívny názov subjektu s adresou IP a záznamom DNS servera OpenText Identity Console. Po vytvorení objektu certifikátu servera ho musíte exportovať vo formáte .pfx.
Ak chcete overiť podpis certifikačného úradu na certifikátoch servera získaných v predchádzajúcom kroku, musíte získať certifikát certifikačného úradu pre všetky stromy vo formáte .pem. Tento koreňový certifikát certifikačného úradu okrem toho zaručuje vytvorenie zabezpečenej komunikácie ldap medzi klientom a serverom OpenText Identity Console. Napríklad certifikát certifikačného úradu pre službu OpenText eDirectory (SSCert.pem) môžete získať z cesty /var/opt/novell/eDirectory/data/SSCert.pem.
(Voliteľné) Pomocou služby OSP (One SSO Provider) môžete používateľom povoliť overovanie jediným prihlásením na portál OpenText Identity Console. Službu OSP musíte nainštalovať pred inštaláciou aplikácie OpenText Identity Console. Ak chcete nakonfigurovať OSP pre aplikáciu OpenText Identity Console, postupujte podľa výziev na obrazovke a zadajte požadované hodnoty konfiguračných parametrov. Ak chcete aplikáciu OpenText Identity Console zaregistrovať na existujúcom serveri OSP, do súboru ism-configuration.properties v priečinku /opt/netiq/idm/apps/tomcat/conf/ musíte manuálne pridať nasledujúci text:
```
com.netiq.edirapi.clientID = identityconsole
com.netiq.edirapi.redirect.url = https://<Identity Console Server IP>:<Identity Console Listener Port>/eDirAPI/v1/<eDirectory Tree Name>/authcoderedirect
com.netiq.edirapi.logout.url = https://<Identity Console Server IP>:<Identity Console Listener Port>/eDirAPI/v1/<eDirectory Tree Name>/logoutredirect
com.netiq.edirapi.logout.return-param-name = logoutURL
com.netiq.edirapi.response-types = code,token
com.netiq.edirapi.clientPass._attr_obscurity = NONE
com.netiq.edirapi.clientPass = novell
```
POZNÁMKA:
- Služba OSP vám umožňuje pripojiť sa len k jednému stromu OpenText eDirectory, pretože nepodporuje viacero stromov OpenText eDirectory.
- Služba OSP tretej strany nie je v aplikácii OpenText Identity Console podporovaná.
- V integrovanom prostredí NAM aplikácia OpenText Identity Console so službou OSP nie je v súčasnosti podporovaná.
Uistite sa, že máte v adresári /etc/hosts k dispozícii správnu položku DNS pre hostiteľský počítač s úplným názvom hostiteľa.
Ak chcete používať aplikáciu OpenText Identity Console v prehľadávači Edge, na dosiahnutie úplnej funkčnosti musíte prevziať najnovšiu verziu prehľadávača Microsoft Edge.

POZNÁMKA:Pri používaní aplikácie OpenText Identity Console v prehľadávači Mozilla Firefox môže fungovanie zlyhať s chybovým hlásením Origin Mismatch (Nezhoda pôvodu). Ak chcete problém vyriešiť, vykonajte tieto kroky:

Aktualizujte prehľadávač Firefox na najnovšiu verziu.
Do poľa s adresou v prehľadávači Firefox zadajte text about:config a stlačte kláves Enter.
Vyhľadajte text Origin.
Dvakrát kliknite na položku network.http.SendOriginHeader a zmeňte jej hodnotu na 1.

1.1.3 Nastavenie prostredia

Možno budete musieť vytvoriť konfiguračný súbor obsahujúci určité parametre. Ak chcete konfigurovať aplikáciu OpenText Identity Console pomocou služby OSP, v konfiguračnom súbore musíte zadať špecifické parametre OSP. Vytvorte napríklad nasledujúci súbor edirapi.conf s parametrami služby OSP:

POZNÁMKA:Do poľa osp-redirect-url zadajte názov stromu OpenText eDirectory.

listen = ":9000"
ldapserver = "192.168.1.1:636"
ldapuser = "cn=admin,ou=sa,o=system"
ldappassword = "novell"
pfxpassword = "novell"
ospmode = "true"
osp-token-endpoint = "https://10.10.10.10:8543/osp/a/idm/auth/oauth2/getattributes"
osp-authorize-url = "https://10.10.10.10:8543/osp/a/idm/auth/oauth2/grant"
osp-logout-url = "https://10.10.10.10:8543/osp/a/idm/auth/app/logout"
osp-redirect-url = "https://10.10.10.10:9000/eDirAPI/v1/edirtree/authcoderedirect"
osp-client-id = "identityconsole"
ospclientpass = "novell"
ospcert = "/etc/opt/novell/eDirAPI/cert/SSCert.pem"
bcert = "/etc/opt/novell/eDirAPI/cert/"
loglevel = "error"
check-origin = "true"
origin = "https://10.10.10.10:9000,https://192.168.1.1:8543"

Ak chcete konfigurovať aplikáciu OpenText Identity Console bez služby OSP, vytvorte konfiguračný súbor uvedený nižšie bez parametrov služby OSP:

[OpenText Identity Console 1.9]

listen = ":9000"
pfxpassword = "novell"
ospmode = "false"
bcert = "/etc/opt/novell/eDirAPI/cert/"
auto-fetch = false

POZNÁMKA:

Odstráňte parameter edir-hosts z konfiguračného súboru a pridajte parameter auto-fetch.
Ak auto-fetch = false, musíte manuálne skopírovať certifikát certifikačného úradu do priečinka cert.

[OpenText Identity Console, verzia 1.8 a staršie]

listen = ":9000"
pfxpassword = "novell"
ospmode = "false"
bcert = "/etc/opt/novell/eDirAPI/cert/"
edir-hosts = "<ip_address-1>:636,<ip_address-2>:636"

POZNÁMKA:Ak chcete nakonfigurovať aplikáciu OpenText Identity Console s viacerými stromami OpenText eDirectory, môžete vynechať parametre ldapserver, ldapuser a ldappassword a vytvoriť konfiguračný súbor.

Tabuľka 1-1 Popis konfiguračných parametrov v konfiguračnom súbore

Konfiguračné parametre	Popis
listen	Ako port prijímača servera OpenText Identity Console vnútri kontajnera zadajte port 9000.
ldapserver	Zadajte adresu IP a číslo portu hostiteľského servera OpenText eDirectory.
ldapuser	Zadajte meno používateľa služby OpenText eDirectory. Tento parameter sa používa ako poverenie na iniciáciu volaní ldap do služby OpenText eDirectory pomocou ovládacieho prvku autorizácie proxy v prípade prihlásenia služby OSP. Používateľ ldap musí mať práva supervízora stromu OpenText eDirectory.
ldappassword	Zadajte heslo používateľa LDAP.
pfxpassword	Zadajte heslo súboru certifikátu servera pkcs12.
ospmode	Zadajte hodnotu true na integráciu služby OSP s aplikáciou OpenText Identity Console. Ak nastavíte hodnotu false, aplikácia OpenText Identity Console bude používať prihlásenie ldap.
osp-token-endpoint	Táto adresa URL sa používa na načítanie určitých atribútov zo servera OSP na overenie platnosti overovacieho tokenu.
osp-authorize-url	Túto adresu URL používa používateľ na poskytnutie poverení s cieľom získať overovací token.
osp-logout-url	Pomocou tejto adresy URL ukončite reláciu medzi používateľom a serverom OSP.
osp-redirect-url	Na túto adresu URL presmeruje server OSP používateľa po udelení overovacieho tokenu. POZNÁMKA:Pri konfigurovaní aplikácie OpenText Identity Console nezabudnite uviesť názov stromu OpenText eDirectory malými písmenami. Ak názov stromu nie je zadaný malými písmenami, môže dôjsť k zlyhaniu prihlásenia na server OpenText Identity Console.
osp-client-id	Zadajte identifikátor klienta OSP poskytnutý v čase registrácie aplikácie OpenText Identity Console so službou OSP.
ospclientpass	Zadajte heslo klienta OSP poskytnuté v čase registrácie aplikácie OpenText Identity Console so službou OSP.
ospcert	Zadajte umiestnenie certifikátu CA servera OSP.
bcert	Zadajte umiestnenie certifikátu certifikačného úradu aplikácie OpenText Identity Console.
loglevel	Zadajte úrovne zápisu do denníka, ktoré chcete zahrnúť do súboru denníka. Tento parameter môže byť nastavený na hodnotu fatal, error, warn alebo info.
check-origin	Ak je tento parameter nastavený na hodnotu true, server OpenText Identity Console porovná hodnotu pôvodu požiadaviek. Dostupné sú možnosti true a false. Parameter origin je povinný aj v prípade, že pre parameter check-origin je nastavená hodnota false pri použití konfigurácie DNS.
origin	Aplikácia OpenText Identity Console porovná hodnotu origin požiadaviek s hodnotami zadanými v tomto poli. POZNÁMKA:Od verzie OpenText Identity Console 1.4 je tento parameter nezávislý od parametra check-origin a v prípade použitia konfigurácie DNS je povinný.
maxclients	Maximálny počet súbežne spustených klientov, ktorí môžu získať prístup k objektu IDConsole. Všetci ostatní klienti nad úrovňou tohto limitu musia čakať vo fronte.
auto-fetch	Od verzie OpenText Identity Console 1.9 si môžete vybrať, či chcete automaticky načítať certifikát certifikačného úradu.
edir-hosts (verzia 1.8 a staršie)	edir-host je parameter obsahujúci adresy IP aplikácie OpenText eDirectory, ku ktorej sa chcete pripojiť prostredníctvom aplikácie OpenText Identity Console.

POZNÁMKA:

Konfiguračný parameter ospmode by ste mali použiť, iba ak plánujete integrovať OSP spoločne s aplikáciou OpenText Identity Console.
Ak sú v nastavení aplikácie OpenText Identity Manager nakonfigurované aplikácie Identity Applications (Identity Apps) v režime klastra, musíte v poliach osp-token-endpoint, osp-authorize-url a osp-logout-url konfiguračného súboru zadať názov DNS servera vyrovnávača zaťaženia. Ak v týchto poliach uvediete podrobnosti o serveri OSP, prihlásenie do aplikácie OpenText Identity Console zlyhá.
Ak je aplikácia OpenText Identity Console nakonfigurovaná s rovnakou inštanciou služby OSP ako aplikácie Identity Apps a OpenText Identity Reporting, pri prihlasovaní na portál OpenText Identity Console sa bude používať jediné prihlásenie (overovacia služba).
V prípade verzie OpenText Identity Console 1.4 alebo novšej musí byť adresa HTTPS URL služby OSP overená pomocou certifikátov obsahujúcich 2 048-bitový alebo novší kľúč.
Ak chcete obmedziť prístup na portál OpenText Identity Console z rôznych domén, nastavte parameter samesitecookie na hodnotu strict. Ak chcete povoliť prístup na portál OpenText Identity Console z rôznych domén, nastavte parameter samesitecookie na hodnotu lax. Ak počas konfigurácie nezadáte tento parameter, predvolene sa použijú nastavenia prehľadávača.

Keď je konfiguračný súbor pripravený, pokračujte v nasadení kontajnera. Ďalšie informácie nájdete v časti Inštalácia aplikácie OpenText Identity Console ako kontajnera Docker.