2.2 安裝 OpenText Identity Console 1.8 及更舊版本

2.2.1 安裝獨立 OpenText Identity Console (非 Docker)

您可以使用下列其中一種方式，安裝 OpenText Identity Console：

附註：建議在同一台機器上安裝 OpenText Identity Consoley 和 OpenText eDirectory，該機器必須至少有一個可用 OpenText eDirectory 例項。

執行互動式安裝

本節說明如何使用互動式安裝方法，安裝獨立的 OpenText Identity Console。

  1. 登入軟體授權和下載入口網站，然後瀏覽至「軟體下載」頁面。

  2. 選取下列項目：

    • 產品：OpenText eDirectory

    • 產品名稱：OpenText eDirectory per User Sub SW E-LTU

    • 版本：9.2

  3. 下載並擷取最新的 OpenText Identity Console 組建。

  4. 瀏覽至您擷取 Identity Console 組建 > IdentityConsole_<version>_Linux 的目錄。

  5. 以根或根相等的使用者身分登入時，執行以下指令：

    ./identityconsole_install

  6. 閱讀「簡介」內容，然後按 ENTER。

  7. 輸入 'y' 以接受授權合約。這將會在您的系統上安裝所有必要的 RPM。

  8. 輸入 Identity Console 伺服器的主機名稱 (FQDN)/IP 位址。例如：10.10.33.100

    如果您按 Enter 鍵，而不指定 IP 位址，預設將會使用系統的 IP 位址/主機名稱。

  9. 輸入 Identity Console 要監聽的連接埠號碼。預設值為 9000。

  10. (有條件) 根據需求，執行下列其中一項作業：

    • 如果您不想整合 OSP 與 Identity Console，請選擇「n」並繼續 步驟 11。

    • 如果您要整合 OSP 與 Identity Console，請選擇「y」並為下列步驟提供輸入：

      1. 使用 LDAPS 連接埠號碼輸入 eDirectory/Identity Vault 伺服器的網域名稱/IP 位址。

        例如：

        192.168.1.1:636

      2. 輸入 eDirectory/Identity Vault 使用者名稱。

        範例：

        cn=admin,ou=org_unit,o=org

      3. 輸入 eDirectory/Identity Vault 密碼。

      4. 再次輸入 eDirectory/Identity Vault 密碼以確認密碼。

      5. 輸入 OSP 伺服器網域名稱/IP 位址和 SSO 伺服器 SSL 連接埠號碼。

      6. 輸入 OSP 用戶端 ID 和 OSP 用戶端密碼。

      7. 輸入 eDirectory/Identity Vault 網路樹名稱。

  11. 指定要連線的 eDirectory-hosts。您可以擇一提供 IP 位址或網域名稱。例如：localhost:636,xx.xx.xx.xx:636 或 edir.domain.com:636

    如果您想要將 OpenText Identity Console 連線至 OpenText 多個 eDirectory 樹狀結構，請以逗號分隔其 IP 位址或網域名稱。

    附註：如果您想要將 OpenText Identity Console 連線至多個 OpenText eDirectory 樹狀結構，請輸入以逗號分隔的 IP 位址或網域名稱。

  12. (有條件) 執行下列其中一項作業以輸入 CA 證書：

    • 如果您要從伺服器輸入 CA 證書，請輸入「y」，然後按下 Enter 鍵。然後輸入有 LDAPS 連接埠編號的 eDirectory 伺服器網域名稱/IP 位址。

      例如：10.10.10.10:636

    • 如果您不想從伺服器輸入 CA 證書，請輸入「n」，然後按下 Enter 鍵。然後手動提供 CA 證書目錄路徑的位置。

    • 如果您輸入「q」，安裝就會終止。

  13. (有條件) 執行下列其中一項作業以產生伺服器證書：

    • 如果您要產生伺服器證書，請輸入「y」，然後按下 Enter 鍵。為下列步驟提供輸入：

      1. 輸入有 LDAPS 連接埠編號的 eDirectory 伺服器網域名稱或 IP 位址。

      2. 輸入 eDirectory 使用者名稱。例如，cn=admin,o=novell。

      3. 輸入 eDirectory 使用者密碼。

      4. 重新輸入 eDirectory 使用者密碼。

      5. 輸入伺服器證書名稱。

        範例：servercert

      6. 輸入伺服器證書密碼。

        範例：password@123

      7. 重新輸入伺服器證書密碼。

        範例：password@123

    • 如果您已經有想要使用的伺服器證書，請輸入「n」，然後按下 Enter 鍵。為下列步驟提供輸入：

      1. 手動指定伺服器證書目錄路徑的位置。

        例如，/home/cert/ckes.pfx

      2. 輸入伺服器證書密碼。

      3. 重新輸入伺服器證書密碼。

附註：

  • 您可以在 /var/opt/novell/eDirAPI/log 目錄中找到下列記錄檔案：

    • Edirapi.log：此檔案會記錄 edirapi 事件與針對問題進行偵錯。

    • Edirapi_audit.log：此檔案會記錄 edirapi 稽核事件。此記錄會遵循 CEF 稽核格式。

    • Identityconsole_install.log：此檔案會記錄 OpenText Identity Console 事件。

  • 您可以在 /var/log/messages 檔案中，檢查 OpenText Identity Console 的啟動和停止操作記錄。

  • 產生 CA 證書和伺服器證書，請務必從擷取位置的 IdentityConsole_<version>_Linux 目錄執行 OpenText Identity Console 安裝程式。

  • 如果安裝失敗，則不需要解除安裝現有的 OpenText Identity Console，使用者反而可以執行下列指令：

    /usr/bin/identityconsoleConfigure

產生證書的公用程式

您可以選擇使用下列工具或公用程式，取得其他樹狀結構的 CA 證書和伺服器證書。

附註：您可以在 opt/novell/eDirAPI/sbin 路徑中，取得 CA 和伺服器證書的程序檔。

產生 CA 證書

  1. 下載並擷取最新的 OpenText Identity Console 組建。

  2. 瀏覽至擷取 OpenText Identity Console 組建 > IdentityConsole_<version>_Linux 的目錄。

  3. 以根或根相等的使用者身分登入時，執行以下指令。

    ./get_cacert

  4. 輸入具有 LDAPS 連接埠編號的 eDirectory IP 位址。例如：10.10.10.10:636。

將可信的根證書從伺服器成功複製到 /tmp/SSCert.pem。

產生伺服器證書

  1. 下載並擷取最新的 OpenText Identity Console 組建。

  2. 瀏覽至擷取 OpenText Identity Console 組建 > IdentityConsole_<version>_Linux 的目錄。

  3. 以根或根相等的使用者身分登入時，執行以下指令。

    ./get_servercert <eDirectory IP address with LDAPS port number> <eDirectory/Identity Vault username> <userpassword> <server certificate name> <server certificate password> <path_of_CA _certificate with filename> <path of server certificate with filename>

    範例：

    ./get_servercert 10.10.10.10:636 cn=admin,ou=org_unit,o=org password keys password /var/opt/novell/eDirectory/data/SSCert.pem /home/user/keys.pfx

以靜默模式安裝

靜默安裝可讓您安裝 OpenText Identity Console，不需任何互動式輸入。若要使用此方法，您必須定義在 silent_properties 檔案中安裝 OpenText Identity Console 的選項，然後從指令行執行安裝程序。若要建立 ilent_properties 檔案，您可以使用 OpenText Identity Console 1.7.2 版及更新版本隨附的 create_silent_properties 公用程式。在產生內容檔案後，系統會使用來自該檔案的資訊，以靜默方式完成安裝。

在開始靜默安裝之前，請確定您符合所有先決條件。

若要產生靜默內容檔案：

  1. 瀏覽至您擷取 OpenText Identity Console 組建位置中的 IdentityConsole_<version>_Linux 目錄。

  2. 執行下列指令以使用 create_Silent _properties 公用程式：

    ./create_silent_properties

  3. 輸入 Identity Console 伺服器的主機名稱或 IP 位址。例如：10.0.0.1

  4. 輸入您要用來監聽 Identity Console 的連接埠編號。例如：9000。

  5. (有條件) 根據需求，執行下列其中一項作業：

    • 如果您不想整合 OSP 與 Identity Console，請選擇「n」並繼續步驟 6。

    • 如果您要整合 OSP 與 Identity Console，請選擇「y」並為下列步驟提供輸入：

      1. 使用 LDAPS 連接埠號碼輸入 eDirectory/Identity Vault 伺服器的網域名稱/IP 位址。

        例如：

        192.168.1.1:636

      2. 輸入 eDirectory/Identity Vault 使用者名稱。

        範例：

        cn=admin,ou=org_unit,o=org

      3. 輸入 eDirectory/Identity Vault 密碼。

      4. 再次輸入 eDirectory/Identity Vault 密碼以確認密碼。

      5. 輸入 OSP 伺服器網域名稱/IP 位址和 SSO 伺服器 SSL 連接埠號碼。

      6. 輸入 OSP 用戶端 ID 和 OSP 用戶端密碼。

      7. 輸入 eDirectory/Identity Vault 網路樹名稱。

  6. 輸入您要 Identity Console 用來建立連線的 eDirectory 伺服器主機名稱或 IP 位址。例如：10.10.10.10:636。

  7. 輸入您要 Identity Console 用來建立連線的 eDirectory 伺服器主機名稱或 IP 位址。例如：10.10.10.10:636。

  8. 輸入伺服器證書的目錄路徑，包括檔案名稱。例如 /home/cert/keys.pfx。

  9. 輸入伺服器證書密碼。

  10. 重新輸入伺服器證書密碼。

    IdentityConsole_<version>_Linux 位置中已成功產生 silent_properties 檔案。

若要執行靜默安裝：

  1. 產生 silent_properties 檔案後，請執行下列指令，以靜默模式執行安裝程式：

    ./identityconsole_install -s silent_properties

  2. 輸入有 LDAPS 連接埠編號的 eDirectory 伺服器網域名稱/IP 位址。例如：10.10.10.10:636

您可以在 Identity Console 安裝 > identityconsole_install.log 檔案中找到與安裝相關的記錄。

具有獨立 OpenText Identity Console 的多個樹狀結構

若要將 OpenText Identity Console 與多個 OpenText eDirectory 樹狀結構連線，您必須在 /etc/opt/novell/eDirAPI/conf/ 的 edirapi.conf 檔案中，提供以逗號分隔的 OpenText eDirectory IP 和 LDAPS 連接埠。此外，您必須將 CA 證書從所有 OpenText eDirectory 樹狀結構複製到 /etc/opt/novell/eDirAPI/cert/ 目錄。

例如，若要將 OpenText Identity Console 連線至三個 OpenText eDirectory 樹狀結構，請以下列格式提供 IP 位址：

edir-hosts="10.0.0.1:636,10.0.0.2:636,10.0.0.3:636"

然後如下所示複製 CA 證書：

cp /home/user/SSCert1.pem /etc/opt/novell/eDirAPI/cert/SSCert1.pem
cp /home/user/SSCert2.pem /etc/opt/novell/eDirAPI/cert/SSCert2.pem
cp /home/user/SSCert3.pem /etc/opt/novell/eDirAPI/cert/SSCert3.pem

執行下列其中一個指令以重新啟動 OpenText Identity Console：

  • /usr/bin/identityconsole restart
  • systemctl restart netiq-identityconsole.service

在獨立 OpenText Identity Console 中修改伺服器證書

請執行下列步驟，以在獨立 OpenText Identity Console 中修改伺服器證書：

  1. 執行 NLPCERT 以儲存金鑰：

    su - nds -c "LD_LIBRARY_PATH=/opt/novell/lib64/:/opt/novell/eDirectory/lib64/:/opt/netiq/common/openssl/lib64/ /opt/novell/eDirAPI/sbin/nlpcert -i /Expiredcert/noexpire/new-keys.pfx -o /etc/opt/novell/eDirAPI/conf/ssl/private/cert.pem"

  2. 重新啟動 OpenText Identity Console：

    systemctl restart netiq-identityconsole.service

正在停止並重新啟動獨立 OpenText Identity Console

  • 若要停止，請執行下列其中一個指令：

    /usr/bin/identityconsole stop

    或者

    systemctl stop netiq-identityconsole.service

  • 若要重新啟動，請執行下列其中一個指令：

    /usr/bin/identityconsole restart

    或者

    systemctl restart netiq-identityconsole.service

  • 若要啟動，請執行下列其中一個指令：

    /usr/bin/identityconsole start

    或者

    systemctl start netiq-identityconsole.service

2.2.2 在 Windows 安裝 OpenText Identity Console 工作站

OpenText Identity Console (1.5 版及更新版本) 可以在 Windows 啟動作為工作站，且需要執行中的 REST 服務。因此，當啟動時，eDirAPI 程序將在 edirapi.exe cmd 提示中執行。如果您關閉 edirapi.exe 終端機，OpenText Identity Console 將無法再運作。

下列程序說明如何在 Windows 執行 OpenText Identity Console。

  1. 登入軟體授權和下載入口網站，然後瀏覽至「軟體下載」頁面。

  2. 選取下列項目：

    • 產品：OpenText eDirectory

    • 產品名稱：eDirectory per User Sub SW E-LTU

    • 版本：9.2

  3. 下載與擷取 IdentityConsole_<version>_workstation_win_x86_64.zip。

  4. 視系統組態而定，瀏覽至擷取的資料夾，安裝 NICI_w32 或 NICI_wx64。

  5. (有條件) 如果您已有要使用的 keys.pfx 和 SSCert.pem 檔案，請將該檔案手動複製至 C:\IdentityConsole_<version>_workstation_win_x86_64\eDirAPI\cert 中的 cert 資料夾。

    然後繼續步驟 9。

  6. (有條件) 如果想要產生 CA 證書，請瀏覽至 eDirAPI 資料夾，在 Power Shell 中執行 get_cacert.exe 二進位檔案 (位於 C:\IdentityConsole_<version>_workstation_win_x86_64\eDirAPI)，並提供下列詳細資料：

    • 使用 LDAPS 連接埠編號 eDirectory/Identity Vault 伺服器的網域名稱/IP 位址。

    • 具有證書名稱的受信任根 CA 證書路徑。

    例如：

    get_cacert.exe 10.10.10.125:636 C:\IdentityConsole_<version>_workstation_win_x86_64\eDirAPI\cert\SSCert.pem

    會產生 SSCert.pem 檔案。

  7. (有條件) 如果您想要產生伺服器證書，請透過 power shell 執行 get_servercert.exe 二進位檔案，並提供下列詳細資料：

    • 使用 LDAPS 連接埠編號 eDirectory/Identity Vault 伺服器的網域名稱/IP 位址。

    • eDirectory/Identity Vault 使用者名稱。

    • eDirectory/Identity Vault 密碼。

    • 伺服器證書名稱。

    • 伺服器證書密碼.

    • 具有證書名稱的受信任根 CA 證書路徑。

    • 具有證書名稱的受信任根伺服器證書路徑 (key.pfx 為硬式編碼)。

    例如：

    get_servercert.exe 10.10.10.125:636 cn=admin,o=novell novell keys novell C:\IdentityConsole_<version>_workstation_win_x86_64\eDirAPI\cert\SSCert.pem C:\IdentityConsole_<version>_workstation_win_x86_64\eDirAPI\cert\keys.pfx

    隨即產生 keys.pfx 檔案。

  8. 將檔案 keys.pfx 和 SSCert.pem (在 步驟：6 及步驟：7 中產生) 手動複製至 cert 資料夾。

  9. 瀏覽至擷取的資料夾，連按兩下 configure.bat 檔案，然後在命令提示中輸入伺服器證書 (keys.pfx) 密碼。

    附註：如果伺服器證書已變更，請使用新證書的密碼重新執行 configure.bat 檔案。

  10. 瀏覽至擷取的資料夾，然後連按兩下 run.bat 檔案。

    eDirAPI 程序終端機 (edirapi.exe) 開始執行，並顯示 Identity Console 登入頁面。

附註：

  • 針對 OpenText Identity Console 應用程式的後續登入，請連按兩下 run.bat。隨即會出現登入頁面。

    如果 eDirAPI 程序終端機 (edirapi.exe) 已執行，請從已解壓縮組建的資料夾執行 identityconsole.exe。

  • 使用者可以在：\IdentityConsole_<version>_workstation_win_x86_64\eDirAPI\log 中找到下列記錄

    edirapi.log - 這是用於記錄 edirapi 中的不同事件和除錯問題。

    edirapi_audit.log - 這是用於記錄 edirapi 的稽核事件。記錄會遵循 CEF 稽核格式。

  • 工作站模式不支援 OSP 登入。

  • OpenText Identity Console 工作站會在連接埠 9000 監聽。請勿修改 edirapi_win.conf 檔案。

產生證書的公用程式

您可以選擇使用下列公用程式，為其他 OpenText eDirectory 樹狀結構取得 CA 證書和伺服器證書。

附註：您可以在 opt/novell/eDirAPI/sbin 路徑中，取得 CA 和伺服器證書的程序檔。

產生 CA 證書

  1. 下載並擷取最新的 OpenText Identity Console 組建。

  2. 瀏覽至擷取 OpenText Identity Console 組建的目錄。範例：C:\IdentityConsole_<version>_workstation_win_x86_64\eDirAPI

  3. 透過命令提示執行下列二進位檔案。

    get_cacert.exe

  4. 提供 eDirectory IP 位址和 LDAPS 連接埠編號。

    範例：get_cacert.exe 10.10.10.125:636

    會產生 SSCert.pem 檔案。將 SSCert.pem 手動複製到 cert 資料夾。

產生伺服器證書

  1. 瀏覽至擷取 OpenText Identity Console 組建的資料夾。

    範例：IdentityConsole_<version>_win

  2. 透過命令提示執行 get_servercert.exe help，以取得更多說明選項。

    • 使用 LDAPS 連接埠編號 eDirectory/Identity Vault 伺服器的網域名稱/IP 位址。

    • eDirectory/Identity Vault 使用者名稱。

    • eDirectory/Identity Vault 密碼。

    • 伺服器證書名稱。

    • 伺服器證書密碼.

    • 具有證書名稱的受信任根證書路徑。

      若要產生伺服器證書，請透過命令提示執行下列指令：

      範例：

      get_servercert.exe 10.10.10.125:636 cn=admin,o=novell novell keys novell SSCert.pem

      隨即產生 keys.pfx 檔案。將 key.pfx 手動複製到 cert 資料夾。

具有 OpenText Identity Console 作為工作站的多個樹狀結構

OpenText Identity Console 允許使用者透過取得樹狀結構的個別 CA 證書，來連線至多個樹狀結構。

  1. 關閉 OpenText Identity Console 工作站和 eDirAPI 終端機。

  2. 將 CA 證書 SSCert.pem 複製到下列位置：IdentityConsole_<version>_workstation_win_x86_64\eDirAPI\cert。

    例如，如果您要連線至三個 eDirectory 樹狀結構，請將 CA 證書分別複製為 SSCert1.pem、SSCert2.pem 和 SSCert3.pem。

  3. 瀏覽到組建擷取所在的資料夾並連按兩下 run.bat 檔案 (Windows 批次檔案)。

關閉並重新啟動 OpenText Identity Console 工作站

若要關閉應用程式和程序：

  1. 關閉 OpenText Identity Console 桌面視窗應用程式。

  2. 透過關閉 eDirAPI 程序終端機來停止 eDirAPI 程序。

若要重新啟動 OpenText Identity Console 工作站，請瀏覽至組建擷取所在的資料夾並連按兩下 run.bat 檔案 (Windows 批次檔案)。

附註：如果 eDirAPI 程序終端機已在執行中，請從組建擷取所在的資料夾執行 identityconsole.exe 以重新啟動 OpenText Identity Console 工作站。

2.2.3 將 OpenText Identity Console 安裝為 Docker 容器

請參閱將 OpenText Identity Console 安裝為 Docker 容器一節。

2.2.4 在 Azure Kubernetes Services 中安裝 OpenText Identity Console

請參閱在 Azure Kubernetes Services 中安裝 OpenText Identity Console 一節。