1.1 Požadavky na systém a předpoklady pro instalaci v Dockeru

1.1.1 Požadavky na systém

Konzoli OpenText Identity Console lze spustit jako kontejner Dockeru. Další informace o požadavcích na systém a podporovaných platformách pro její instalaci najdete v dokumentaci k Dockeru.

1.1.2 Předpoklady

Nainstalujte Docker 20.10.9-ce nebo novější. Další informace o instalaci Dockeru podle své platformy naleznete v části Instalace dockeru.
Je nutné získat certifikát serveru pkcs12 se soukromým klíčem k šifrování a dešifrování výměny dat mezi serverem konzole OpenText Identity Console a backendovým serverem. Tento certifikát serveru se používá k zabezpečení připojení přes HTTP. Můžete použít certifikáty serveru vygenerované libovolnou externí certifikační agenturou. Další informace najdete v tématu Creating a Server Certificate Object (Vytvoření objektu certifikátu serveru). Certifikát serveru by měl obsahovat alternativní název subjektu s adresou IP a DNS serveru konzole OpenText Identity Console. Jakmile vytvoříte objekt certifikátu serveru, je třeba jej exportovat ve formátu in.pfx.
K ověření podpisu certifikační agentury u certifikátů serveru je třeba pro všechny stromy získat certifikát certifikační agentury ve formátu .pem. Tento kořenový certifikát certifikační agentury zároveň zajišťuje zabezpečenou komunikaci LDAP mezi klientem a serverem OpenText Identity Console. Můžete například získat certifikát certifikační agentury služby eDirectory CA (SSCert.pem) z umístění /var/opt/novell/OpenText eDirectory/data/SSCert.pem.
(Volitelné) Pomocí poskytovatele One SSO Provider (OSP) můžete uživatelům na portálu OpenText Identity Console zpřístupnit ověřování službou Single Sign-on. Poskytovatele OSP je nutné nainstalovat před instalací konzole OpenText Identity Console. Poskytovatele OSP pro konzoli OpenText Identity Console nakonfigurujte podle pokynů na obrazovce a zadejte povinné hodnoty konfiguračních parametrů. Pokud chcete konzoli OpenText Identity Console registrovat k existujícímu serveru OSP, je třeba do souboru ism-configuration.properties ve složce /opt/netiq/idm/apps/tomcat/conf/ přidat následující 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:
- S poskytovatelem OSP se můžete připojit pouze k jednomu stromu služby OpenText eDirectory, protože poskytovatel OSP nepodporuje více stromů.
- Poskytovatel OSP třetí strany není v OpenText Identity Console podporován.
- V integrovaném prostředí NAM není konzole OpenText Identity Console s poskytovatelem OSP v současné době podporována.
Pro hostitelský počítač musíte mít k dispozici správný záznam DNS v umístění /etc/hosts s úplným názvem hostitele.
Pokud chcete konzoli OpenText Identity Console používat v prohlížeči Edge, je třeba k plnohodnotnému fungování stáhnout nejnovější verzi prohlížeče.

POZNÁMKA:Při používání konzole OpenText Identity Console v prohlížeči Mozilla Firefox může operace selhat a může se zobrazit chybová zpráva o neshodě zdroje. Tyto potíže odstraníte takto:

Aktualizujte Firefox na nejnovější verzi.
Do pole pro adresu URL v prohlížeči Firefox zadejte about:config a stiskněte klávesu Enter.
Vyhledejte výraz „origin“.
Poklepejte na položku network.http.SendOriginHeader a změňte její hodnotu na 1.

1.1.3 Nastavení prostředí

Možná bude nutné vytvořit konfigurační soubor s konkrétními parametry. Pokud chcete konfigurovat konzoli OpenText Identity Console pomocí poskytovatele OSP, musíte do konfiguračního souboru zadat parametry specifické pro tohoto poskytovatele. Vytvořte tedy například níže uvedený soubor edirapi.conf s parametry poskytovatele OSP:

POZNÁMKA:Do pole osp-redirect-url je nutné zadat název 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"

Jestliže chcete konzoli OpenText Identity Console konfigurovat bez poskytovatele OSP, vytvořte konfigurační soubor tak, jak je vidět níže, bez parametrů OSP:

[OpenText Identity Console 1.9]

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

POZNÁMKA:

Odeberte parametr edir-hosts z konfiguračního souboru a přidejte parametr auto-fetch.
Pokud auto-fetch = false, musíte ručně zkopírovat certifikát certifikační agentury do složky cert.

[OpenText Identity Console 1.8 a starší]

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

POZNÁMKA:Pokud chcete konzoli OpenText Identity Console nakonfigurovat s několika stromy služby OpenText eDirectory, můžete přeskočit parametry „ldapserver“, „ldapuser“ a „ldappassword“ a vytvořit konfigurační soubor.

Tabulka 1-1 Popis konfiguračních parametrů v konfiguračním souboru:

Konfigurační parametry	Popis
listen	Jako port naslouchacího procesu serveru konzole OpenText Identity Console v kontejneru zadejte 9000.
ldapserver	Zadejte adresu IP a číslo portu hostitelského serveru OpenText eDirectory.
ldapuser	Zadejte uživatelské jméno uživatele služby OpenText eDirectory. Tento parametr se používá jako pověření k inicializaci volání LDAP do služby OpenText eDirectory za použití řízení autorizace prostřednictvím proxy v případě přihlášení poskytovatele OSP. Uživatel LDAP musí mít na daném stromu služby OpenText eDirectory práva supervizora.
ldappassword	Zadejte heslo uživatele LDAP.
pfxpassword	Zadejte heslo souboru certifikátu serveru pkcs12.
ospmode	Pokud chcete s konzolí OpenText Identity Console integrovat poskytovatele OSP, zadejte hodnotu True. Jestliže nastavíte hodnotu False, bude se u konzole OpenText Identity Console používat přihlášení LDAP.
osp-token-endpoint	Tato adresa URL se používá k načtení určitých atributů ze serveru OSP s cílem ověřit platnost ověřovacího tokenu.
osp-authorize-url	Tuto adresu URL používá uživatel k poskytnutí pověření, aby mohl získat ověřovací token.
osp-logout-url	Tuto adresu URL použijte k ukončení relace mezi uživatelem a serverem OSP.
osp-redirect-url	Na tuto adresu URL přesměruje server OSP uživatele po udělení ověřovacího tokenu. POZNÁMKA:Při konfiguraci konzole OpenText Identity Console nezapomeňte zadat název stromu OpenText eDirectory malými písmeny. Jestliže název stromu není zadán malými písmeny, nemusí se přihlášení k serveru OpenText Identity Console zdařit.
osp-client-id	Zadejte ID klienta OSP použité při registraci konzole OpenText Identity Console u poskytovatele OSP.
ospclientpass	Zadejte heslo klienta OSP použité při registraci konzole OpenText Identity Console u poskytovatele OSP.
ospcert	Zadejte umístění certifikátu certifikační agentury serveru OSP.
bcert	Zadejte umístění certifikátu certifikační agentury konzole OpenText Identity Console.
loglevel	Zadejte úrovně protokolování, které chcete zahrnout do souboru protokolu. Tento parametr lze nastavit na hodnoty „fatal“, „error“, „warn“ nebo „info“.
check-origin	Pokud je tato možnost nastavena na hodnotu True, server konzole OpenText Identity Console porovná původní hodnotu požadavků. Dostupné možnosti jsou True nebo False. Parametr origin je povinný, i když je hodnota parametru check-origin při použití konfigurace DNS nastavena na False.
origin	Konzole OpenText Identity Console porovná hodnotu parametru origin požadavků s hodnotami zadanými v tomto poli. POZNÁMKA:Počínaje verzí konzole OpenText Identity Console 1.4 je tento parametr nezávislý na parametru check-origin a je povinný, pokud se používá konfigurace DNS.
maxclients	Maximální počet souběžně připojených klientů s přístupem ke konzole IDConsole. Případní další klienti nad tento limit musí čekat ve frontě.
auto-fetch	Počínaje verzí OpenText Identity Console 1.9 můžete zvolit automatické načtení certifikátu certifikační agentury.
edir-hosts (1.8 a starší)	edir-host je parametr obsahující adresy IP OpenText eDirectory, které chcete připojit pomocí OpenText Identity Console.

POZNÁMKA:

Parametr konfigurace ospmode je vhodné použít jen v případě, že plánujete s konzolí OpenText Identity Console integrovat poskytovatele OSP.
Pokud máte aplikace Identity Applications (Identity Apps) v nastavení nástroje OpenText Identity Manager konfigurovány v režimu clusteru, musíte v konfiguračním souboru do polí osp-token-endpoint, osp-authorize-url a osp-logout-url zadat název DNS serveru vyrovnávání zatížení. Pokud do těchto polí zadáte informace o serveru OSP, přihlášení ke konzoli OpenText Identity Console se nezdaří.
Jestliže je konzole OpenText Identity Console konfigurována se stejnou instancí poskytovatele OSP jako aplikace Identity Apps a OpenText Identity Reporting, uplatní se při přihlašování na portál OpenText Identity Console ověřovací služba Single Sign-on.
Adresa HTTPS URL poskytovatele OSP musí být počínaje verzí konzole OpenText Identity Console 1.4 ověřena pomocí certifikátů obsahujících 2048bitový klíč nebo vyšší.
Chcete-li omezit přístup k portálu OpenText Identity Console z jiných domén, nastavte parametr samesitecookie na hodnotu strict. Chcete-li povolit přístup k portálu OpenText Identity Console z jiných domén, nastavte parametr samesitecookie na hodnotu lax. Pokud parametr během konfigurace nezadáte, uplatní se jako výchozí nastavení prohlížeče.

Jakmile budete mít konfigurační soubor připraven, pokračujte nasazením kontejneru. Další informace najdete v části Instalace konzole OpenText Identity Console jako kontejneru Dockeru.