1.1 A Docker telepítésének rendszerkövetelményei és előfeltételei

1.1.1 Rendszerkövetelmények

Mivel az OpenText Identity Console Docker-konténerként futtatható, az OpenText Identity Console telepítésének rendszerkövetelményeiről és a támogatott platformokról a Docker dokumentációja nyújt további információt.

1.1.2 Előfeltételek

  • Telepítse a Docker 20.10.9-ce vagy újabb verzióját. Ha további információra van szüksége a Docker telepítéséről a platformja alapján, keresse fel a Docker telepítéséről szóló weblapot.

  • Az OpenText Identity Console-kiszolgáló és a háttérkiszolgáló közötti adatcsere titkosításához/dekódolásához be kell szereznie egy pkcs12 kiszolgálói tanúsítványt a kapcsolódó titkos kulccsal. Ez a kiszolgálói tanúsítvány a http-kapcsolat védelmére szolgál. Bármelyik külső hitelesítésszolgáltató által létrehozott kiszolgálói tanúsítványokat használhat. További információt a Kiszolgálótanúsítvány-objektumok létrehozása című fejezetben talál. A kiszolgálói tanúsítványnak tartalmaznia kell a tulajdonos alternatív nevét az OpenText Identity Console-kiszolgáló IP-címével és DNS-címével együtt. A kiszolgálói tanúsítvány objektum létrehozását követően .pfx formátumban exportálnia kell azt.

  • Az előző lépésben beszerzett kiszolgálói tanúsítványok hitelesítésszolgáltatói aláírásának az érvényesítéséhez minden egyes fához be kell szereznie egy .pem formátumú hitelesítésszolgáltatói tanúsítványt. Ez a legfelső szintű hitelesítésszolgáltatói tanúsítvány egy biztonságos LDAP-kommunikáció létesítését is lehetővé teszi az ügyfél és az OpenText Identity Console-kiszolgáló között. Az OpenText eDirectory hitelesítésszolgáltatói tanúsítványát (SSCert.pem) például a következő helyről szerezheti be: /var/opt/novell/eDirectory/data/SSCert.pem.

  • (Választható) A One SSO Provider (OSP) használata esetén engedélyezheti az egyszeri bejelentkezéses hitelesítést a felhasználók számára az OpenText Identity Console portáljához. Az OpenText Identity Console telepítése előtt telepítenie kell az OSP-t. Az OSP konfigurálásához a OpenText Identity Console számára kövesse a képernyőn megjelenő utasításokat, és adja meg a konfigurációs paraméterek szükséges értékeit. Ha egy meglévő OSP-kiszolgálóhoz szeretné regisztrálni az OpenText Identity Console-t, az /opt/netiq/idm/apps/tomcat/conf/ mappában lévő ism-configuration.properties fájlhoz manuálisan hozzá kell adnia a következőt:

    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

    MEGJEGYZÉS:

    • Az OSP-vel csak egyetlen OpenText eDirectory-fához lehet csatlakozni, mivel az OSP nem támogatja több OpenText eDirectory-fa használatát.

    • Az OpenText Identity Console nem támogatja a harmadik féltől származó OSP-t.

    • NAM-integrált környezetben az OSP-vel ellátott OpenText Identity Console jelenleg nem támogatott.

  • Győződjön meg arról, hogy a gazdagéphez teljesen meghatározott gazdanevet tartalmazó, megfelelő DNS-bejegyzés található az /etc/hosts fájlban.

  • Ha az OpenText Identity Console-t Edge böngészőben szeretné használni, a teljes funkcionalitáshoz le kell töltenie a Microsoft Edge legújabb verzióját.

MEGJEGYZÉS:Ha az OpenText Identity Console-t a Mozilla Firefoxban használja, előfordulhat, hogy az Origin Mismatch (Eredeteltérés) hibaüzenet jelenik meg, és a művelet sikertelen lesz. A hibaelhárításhoz végezze el az alábbi lépéseket:

  1. Frissítse a Firefoxot a legújabb verzióra.

  2. Írja be az about:config szöveget a Firefox URL-mezőjébe, és nyomja le az Enter billentyűt.

  3. Keressen az Origin szóra.

  4. Kattintson duplán a network.http.SendOriginHeader beállításra, és módosítsa az értékét 1-re.

1.1.3 A környezet beállítása

Előfordulhat, hogy létre kell hoznia egy bizonyos paramétereket tartalmazó konfigurációs fájlt. Ha az OSP-vel szeretné konfigurálni az OpenText Identity Console-t, a konfigurációs fájlban meg kell adni az OSP adott paramétereit. Hozza létre például az alábbi edirapi.conf fájlt OSP-paraméterekkel:

MEGJEGYZÉS:Meg kell adnia az OpenText eDirectory-fa nevét az osp-redirect-url mezőben.

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"

Amennyiben OSP nélkül szeretné konfigurálni az OpenText Identity Console-t, hozzon létre egy konfigurációs fájlt az alább látható módon, az OSP-paraméterek nélkül:

[OpenText Identity Console 1.9]

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

MEGJEGYZÉS:

  • Távolítsa el az edir-hosts paramétert a konfigurációs fájlból, és vegye fel az auto-fetch paramétert.

  • Ha az auto-fetch = false (automatikus lekérés = hamis), manuálisan kell átmásolnia a hitelesítésszolgáltatói tanúsítványt a cert mappába.

[OpenText Identity Console 1.8 és korábbi]

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

MEGJEGYZÉS:Ha több OpenText eDirectory-fával kívánja konfigurálni az OpenText Identity Console-t, kihagyhatja az „ldapserver”, az „ldapuser” és az „ldappassword” paramétert, és létrehozhatja a konfigurációs fájlt.

Táblázat 1-1 A konfigurációs fájlban szereplő konfigurációs paraméterek leírása

Konfigurációs paraméterek

Leírás

listen

Adja meg a 9000-es értéket az OpenText Identity Console kiszolgáló figyelőportjaként a konténeren belül.

ldapserver

Adja meg az OpenText eDirectory kiszolgáló IP-címét és portszámát.

ldapuser

Adja meg az OpenText eDirectory-felhasználó felhasználónevét. Ez a paraméter OSP-bejelentkezés esetén hitelesítő adatként szolgál az OpenText eDirectory irányába proxyt használó hitelesítésvezérlő használatával kezdeményezett LDAP-hívásokhoz. Az LDAP-felhasználónak rendszergazdai jogokkal kell rendelkeznie az OpenText eDirectory-fához.

ldappassword

Az LDAP-felhasználó jelszavának a megadására szolgál.

pfxpassword

A pkcs12 kiszolgálóitanúsítvány-fájl jelszavának a megadására szolgál.

ospmode

Az OSP OpenText Identity Console-ba való integrálásához adja meg az igaz értéket. Ha hamis értékre állítja, az OpenText Identity Console LDAP-bejelentkezést fog használni.

osp-token-endpoint

Ez az URL-cím használható bizonyos attribútumok lekéréséhez az OSP-kiszolgálótól a hitelesítési token érvényességének ellenőrzése céljából.

osp-authorize-url

A hitelesítési token beszerzésére szolgáló hitelesítő adatok megadásához a felhasználó által használt URL-cím.

osp-logout-url

Ezt az URL-címet használhatja a felhasználó és az OSP-kiszolgáló közötti kapcsolat befejezésére.

osp-redirect-url

Az OSP-kiszolgáló a hitelesítési token megadása után erre az URL-címre irányítja át a felhasználót.

MEGJEGYZÉS:Az OpenText Identity Console konfigurálásakor ügyeljen arra, hogy az OpenText eDirectory-fa nevét kisbetűvel adja meg. Amennyiben a fa nevét nem kisbetűvel adja meg, a bejelentkezés az OpenText Identity Console-kiszolgálóra sikertelen lehet.

osp-client-id

Az OpenText Identity Console-nak az OSP-ben történő regisztrálásakor megadott OSP-ügyfélazonosító megadására szolgál.

ospclientpass

Az OpenText Identity Console-nak az OSP-ben történő regisztrálásakor megadott OSP-ügyféljelszó megadására szolgál.

ospcert

Az OSP-kiszolgáló hitelesítésszolgáltatói tanúsítványa helyének a megadására szolgál.

bcert

Az OpenText Identity Console hitelesítésszolgáltatói tanúsítványa helyének a megadására szolgál.

loglevel

A naplózási fájlban szerepeltetni kívánt naplózási szintek megadására szolgál. Ez a paraméter „fatal” (végzetes), „error” (hiba), „warn” (figyelmeztetés) vagy „info” (információ) értékre állítható be.

check-origin

Ha ez true (igaz) értékre van állítva, az OpenText Identity Console kiszolgáló összehasonlítja a kérések eredeti értékét. A választható lehetőségek a true (igaz) vagy a false (hamis). Az origin paraméter akkor is kötelező, ha a check-origin paraméter értéke false (hamis) a DNS-konfiguráció használatakor.

origin

Az OpenText Identity Console összehasonlítja a kérések származási értékét az ebben a mezőben megadott értékekkel.

MEGJEGYZÉS:Az OpenText Identity Console 1.4 verziótól kezdve ez a paraméter független a check-origin paramétertől, és használata a DNS-konfiguráció használata esetén kötelező.

maxclients

Azon ügyfelek maximális száma, akik egyidejűleg hozzáférhetnek az Identity Console-hoz. A korlátot meghaladó minden további ügyfélnek sorban kell várakoznia.

auto-fetch (automatikus lekérés)

Az OpenText Identity Console 1.9-es verziójától kezdve kiválaszthatja, hogy automatikusan lekéri-e a hitelesítésszolgáltatói tanúsítványt.

edir-hosts(1.8 és korábbi)

Az edir-host egy paraméter, amely az OpenText eDirectory IP-címét (címeit) tartalmazza, amelyet az OpenText Identity Console-on keresztül szeretne csatlakoztatni.

MEGJEGYZÉS:

  • Az ospmode konfigurációs paraméter csak akkor használandó, ha az OSP integrálását tervezi az OpenText Identity Console-lal.

  • Ha az Identity Applications (Identity Apps) fürt módban van konfigurálva az OpenText Identity Manager beállításában, meg kell adnia a terheléselosztó-kiszolgáló DNS-nevét a konfigurációs fájl osp-token-endpoint, osp-authorize-url és osp-logout-url mezőjében. Amennyiben az OSP-kiszolgáló adatait megadja ezekben a mezőkben, az OpenText Identity Console-bejelentkezés sikertelen lesz.

  • Ha az OpenText Identity Console ugyanazzal az OSP-példánnyal van konfigurálva, mint az Identity Apps és az OpenText Identity Reporting, az egyszeri bejelentkezés (hitelesítési szolgáltatás) akkor lép érvénybe, amikor bejelentkezik az OpenText Identity Console portáljára.

  • Az OpenText Identity Console 1.4-es verziójától kezdődően az OSP HTTPS URL-címét 2048 bites kulcsot tartalmazó tanúsítványokkal kell érvényesíteni.

  • Ha szeretné korlátozni az OpenText Identity Console portáljához való hozzáférést a különböző tartományokról, állítsa a samesitecookie paramétert strict értékre. Ha szeretné engedélyezni az OpenText Identity Console portáljához való hozzáférést a különböző tartományokról, állítsa a samesitecookie paramétert lax értékre. Ha a paramétert nem adja meg a konfiguráció során, a rendszer a böngészőbeállításokat veszi figyelembe.

Ha elkészült a konfigurációs fájllal, folytassa a műveletet a konténer telepítésével. További információ: Az OpenText Identity Console telepítése Docker-konténerként.