37.3 以靜默模式安裝 Identity Applications

本節介紹如何執行 Identity Applications 的靜默安裝。靜默安裝期間不需要任何互動,可節省您的時間,當您必須在一個以上的伺服器上進行安裝時更是如此。您只能在受支援的 Linux 電腦上執行靜默安裝。

若要進行安裝準備工作,請檢閱節 37.1, Identity Applications 的安裝核對清單 中列出的活動。另請參閱版本隨附的《版本說明》。

此程序包括以下活動:

37.3.1 在環境中為靜默安裝設定密碼

您可以在環境中設定密碼,而無需在 .properties 檔案中指定組態密碼。在這種情況下,靜默安裝程式將會從環境讀取密碼,而不是從 silent.properties 檔案中讀取。如此可以提高安全性。

您必須為安裝指定以下密碼:

  • NOVL_DB_USER_PASSWORD

  • NOVL_CONFIG_DBADMIN_PASSWORD

  • NOVL_CONFIG_LDAPADMINPASS

  • NOVL_CONFIG_KEYSTOREPASSWORD

Linux

使用 export 指令。例如:

export NOVL_DB_USER_PASSWORD=myPassWord
Windows

使用 set 指令。例如:

set NOVL_DB_USER_PASSWORD=myPassWord

37.3.2 編輯 .properties 檔案

在執行靜默安裝或組態之前,必須編輯 .properties 檔案中的參數值。本節中的表格提供了參數清單。這些參數對應於基本安裝參數,用於設定 RBPM 和 Identity Applications。如需指定參數值的詳細資訊,請參閱節 37.2, 使用引導式程序安裝 Identity Applications 和節 40.0, 完成 Identity Applications 的設定。

  1. 以 root 身分登入您要安裝 Identity Applications 的電腦

  2. 確定 silent.properties 檔案儲存在本地電腦上。

    依預設,該檔案位於 Identity Manager 安裝套件 .iso 影像檔中的 products/rbpm/user_app_install 目錄下。

  3. 開啟 user_app.install.properties 檔案。

  4. 修改 .properties 檔案中的以下參數:

silent.properties 中的參數名稱

Identity Applications 組態參數檔案中的等效參數名稱

NOVL_CONFIG_LDAPHOST=

eDirectory 連接設定:LDAP 主機。

指定 LDAP 伺服器的主機名稱或 IP 位址。

NOVL_CONFIG_LDAPADMIN=

eDirectory 連接設定:LDAP 管理員。

指定 LDAP 管理員的身分證明。此使用者必須已經存在。「使用者應用程式」會使用此帳戶,來建立 Identity Vault 的管理連接。 這個值會根據萬能金鑰進行加密。

NOVL_CONFIG_LDAPADMINPASS=

eDirectory 連接設定:LDAP 管理員密碼。

指定 LDAP 管理員密碼。這個密碼會根據萬能金鑰進行加密。

NOVL_CONFIG_ROOTCONTAINERNAME=

eDirectory DN:根容器 DN。

指定根容器的 LDAP 可辨識名稱。當在目錄抽象層中沒有指定任何搜尋根部時,會將它用做預設實體定義搜尋根部。

NOVL_CONFIG_PROVISIONROOT=

eDirectory DN:提供驅動程式 DN。

指定使用者應用程式驅動程式的可辨識名稱。例如,如果您的驅動程式為 userapplicationdriver、而驅動程式集稱為 mydriverset,並且該驅動程式集位於 o=myCompany 的網路位置,則輸入值:

cn=UserApplicationDriver,cn=
myDriverSet,o=myCompany

NOVL_CONFIG_LOCKSMITH=

eDirectory DN:使用者應用程式管理員。

Identity Vault 中擁有權限執行管理任務 (由「使用者應用程式」使用者容器指定) 的使用者。 此使用者可以使用「使用者應用程式」的「管理」索引標籤來管理入口網站。

如果使用者應用程式管理員參與 iManager、NetIQ Designer for Identity Manager 或使用者應用程式 (申請和核准索引標籤) 中公開的工作流程管理任務,請為此管理員授予適當的託管者權限,使其能夠存取使用者應用程式驅動程式中的物件例項。如需詳細資訊,請參閱《NetIQ Identity Manager - Administrator’s Guide to the Identity Applications》(NetIQ Identity Manager - Identity Applications 管理員指南)。

若要在部署使用者應用程式後變更此指定,請在使用者應用程式的管理 > 安全性頁面中進行變更。

NOVL_CONFIG_PROVLOCKSMITH=

eDirectory DN:佈建應用程式管理員。

Identity Manager 的佈建版本中會提供此使用者。「提供應用程式管理員」會使用「管理」索引標籤下方的「提供」索引標籤來管理「提供工作流程」功能。這些功能可透過「使用者應用程式」的「申請與核准」索引標籤供使用者使用。此使用者必須先存在於 Identity Vault,才能指定為「佈建應用程式管理員」。

若要在部署使用者應用程式後變更此指定,請在使用者應用程式的管理 > 安全性頁面中進行變更。

NOVL_CONFIG_ROLECONTAINERDN=

此角色在 RBPM 中可用。此角色允許成員建立、移除或修改所有角色,授予或撤銷對任何使用者、群組或容器所做的任何角色指定。它還允許其角色成員為任一使用者執行報告。依預設,「使用者應用程式」管理員會指定為此角色。

若要在部署「使用者應用程式」之後更改此指定,請使用「使用者應用程式」中的「角色」>「角色指定」頁面。

NOVL_CONFIG_COMPLIANCECONTAINERDN

法規遵循模組管理員是一個系統角色,允許成員執行「法規遵循」索引標籤上的所有功能。此使用者必須先存在於 Identity Vault 中,才能指定為「法規遵循模組管理員」。

NOVL_CONFIG_USERCONTAINERDN=

中繼目錄使用者身份:使用者容器 DN。

指定使用者容器的輕量目錄存取協定 (Distinguished Name,LDAP) 可辨識名稱 (DN) 或完全合法的 LDAP 名稱。 這會定義使用者和群組的搜尋範圍。此容器中 (和下方) 的使用者可以登入「使用者應用程式」。

重要:如果您想讓使用者可以執行工作流程,請確定「使用者應用程式」驅動程式設定期間指定的「使用者應用程式管理員」存在於此容器中。

NOVL_CONFIG_GROUPCONTAINERDN=

中繼目錄使用者群組:群組容器 DN。

指定群組容器的輕量目錄存取協定 (LDAP) 可辨識名稱 (DN) 或完全合法的 LDAP 名稱。由目錄抽象層內的實體定義使用。

NOVL_CONFIG_KEYSTOREPATH=

eDirectory 證書:金鑰儲存區路徑。必要。

指定 Tomcat 所用 JRE 金鑰儲存區 (cacerts) 檔案的完整路徑。「使用者應用程式」的安裝會修改金鑰儲存區檔案。在 Linux 上,使用者必須具有寫入此檔案的許可權。

NOVL_CONFIG_KEYSTOREPASSWORD=

eDirectory 證書:金鑰儲存區密碼。

指定 cacerts 密碼。 預設值為「changeit」。

NOVL_CONFIG_SECUREADMINCONNECTION=

eDirectory 連接設定:安全管理員連接。

必要

若要求所有使用管理員帳戶的通訊都透過安全通訊端進行 (此選項可能會對效能產生負面影響),請指定 True。如果指定此設定,則無需 SSL 的其他操作可以在不使用 SSL 的情況下執行。

如果管理員帳戶不使用 SSL 通訊,請指定 False。

NOVL_CONFIG_SECUREUSERCONNECTION=

eDIRECTORY 連接設定:安全使用者連接。

必要

若要求所有使用登入之使用者帳戶的通訊都透過安全通訊端進行 (此選項可能會對效能產生嚴重的負面影響),請指定 True。此設定允許不透過 SSL 來執行不需要 SSL 的其他操作。

如果使用者的帳戶不使用 SSL 通訊,請指定 False。

NOVL_CONFIG_SESSIONTIMEOUT=

其他:工作階段逾時。

必要

為應用程式工作階段指定逾時間隔。

NOVL_CONFIG_LDAPPLAINPORT=

eDirectory 連接設定:LDAP 非安全連接埠。

必要

指定 LDAP 伺服器的非安全連接埠。 例如 389。

NOVL_CONFIG_LDAPSECUREPORT=

eDirectory 連接設定:LDAP 安全連接埠。

必要

指定 LDAP 伺服器的安全連接埠,例如 636。

NOVL_CONFIG_ANONYMOUS=

eDirectory 連接設定:使用公用匿名帳戶。

必要

若要允許未登入的使用者存取 LDAP 公用匿名帳戶,請指定 True。

若要啟用 NOVL_CONFIG_GUEST,請指定 False。

NOVL_CONFIG_GUEST=

eDirectory 連接設定:LDAP 訪客。

允許未登入的使用者存取允許的入口網站應用程式。此外,您還必須停用 Guest 使用者帳戶。這個訪客使用者帳戶必須已存在於 Identity Vault。若要停用該帳戶,請選取使用公用匿名帳戶。

NOVL_CONFIG_GUESTPASS=

eDirectory 連接設定:LDAP 訪客密碼。

NOVL_CONFIG_EMAILNOTIFYHOST=

電子郵件:通知範本 HOST 記號。

指定代管 Identity Manager 使用者應用程式的 Tomcat。例如:

myapplication serverServer

此值會取代電子郵件範本中的 $HOST$ 記號。 建構的 URL 是佈建申請任務和核准通知的連結。

NOVL_CONFIG_EMAILNOTIFYPORT=

電子郵件:通知範本 PORT 記號。

用於取代佈建申請任務和核准通知中所使用之電子郵件範本中的 $PORT$ 記號。

NOVL_CONFIG_EMAILNOTIFYSECUREPORT=

電子郵件:通知範本 SECURE PORT 記號。

用於取代佈建申請任務和核准通知中所使用之電子郵件樣板中的 $SECURE_PORT$ 記號。

NOVL_CONFIG_NOTFSMTPEMAILFROM=

電子郵件:SMTP 電子郵件通知寄件者。

必要

指定來自佈建電子郵件中使用者的電子郵件。

NOVL_CONFIG_NOTFSMTPEMAILHOST=

電子郵件:SMTP 電子郵件通知主機。

必要

指定佈建電子郵件所使用的 SMTP 電子郵件主機。可以是 IP 位址或 DNS 名稱。不要使用 localhost。

NOVL_CONFIG_USEEXTPWDWAR=

密碼管理:使用外部密碼 WAR。

若要使用外部密碼管理 WAR,請指定 True,然後指定 NOVL_CONFIG_EXTPWDWARPTH 和 NOVL_CONFIG_EXTPWDWARRTNPATH 的值。

若要使用預設的內部密碼管理功能 /jsps/pwdmgt/ForgotPassword.jsp (開頭沒有 http(s) 通訊協定),請指定 False。這會將使用者重新導向至「使用者應用程式」內建的「忘記密碼」功能,而不是外部 WAR。

NOVL_CONFIG_EXTPWDWARPATH=

密碼管理:忘記密碼連結。

在外部或內部密碼管理 WAR 中指定「忘記密碼」功能頁面 ForgotPassword.jsp 的 URL。或者,接受預設的內部密碼管理 WAR。如需詳細資訊,請參閱節 39.6, 設定忘記密碼管理功能。

NOVL_CONFIG_EXTPWDWARRTNPATH=

密碼管理:忘記密碼回傳連結。

指定使用者在執行完忘記密碼操作後可以使用的忘記密碼返回連結。

NOVL_CONFIG_FORGOTWEBSERVICEURL=

密碼管理:忘記密碼 Web 服務 URL。

代表外部忘記密碼 WAR 將用來回呼至使用者應用程式,以執行核心忘記密碼功能的 URL。請使用以下格式:

https://idmhost:sslport/idm/
pwdmgt/service

NOVL_CONFIG_USEROBJECTATTRIBUTE=

中繼目錄使用者身份:使用者物件類別。

必要

LDAP 使用者物件類別 (通常為 inetOrgPerson)。

NOVL_CONFIG_LOGINATTRIBUTE=

中繼目錄使用者身份:登入屬性。

必要

代表使用者登入名稱的 LDAP 屬性。例如 CN。

NOVL_CONFIG_NAMINGATTRIBUTE=

中繼目錄使用者身份:命名屬性。

必要

此 LDAP 可在查閱使用者或群組時做為識別碼。這和登入屬性不一樣,後者只能用於登入,不可用於使用者/群組搜尋。

NOVL_CONFIG_USERMEMBERSHIPATTRIBUTE=

中繼目錄使用者身分:使用者成員資格屬性。選擇性。

必要

代表使用者群組成員資格的 LDAP 屬性。請勿在此名稱中使用空格。

NOVL_CONFIG_GROUPOBJECTATTRIBUTE=

中繼目錄使用者群組:群組物件類別。

必要

LDAP 群組物件類別 (通常為 groupofNames)。

NOVL_CONFIG_GROUPMEMBERSHIPATTRIBUTE=

中繼目錄使用者群組:群組成員資格屬性。

必要

指定代表使用者群組成員資格的屬性。請勿在此名稱中使用空格。

NOVL_CONFIG_USEDYNAMICGROUPS=

中繼目錄使用者群組:使用動態群組。

必要

若要使用動態群組,請指定 True。

NOVL_CONFIG_DYNAMICGROUPOBJECTCLASS=

中繼目錄使用者群組:動態群組物件類別。

必要

指定 LDAP 動態群組物件類別 (通常為 dynamicGroup)。

NOVL_CONFIG_TRUSTEDSTOREPATH=

可信金鑰儲存區:可信儲存區路徑。

可信金鑰儲存區包含所有可信簽名者的證書。如果此路徑為空,則「使用者應用程式」會從「系統」內容 javax.net.ssl.trustStore 取得路徑。如果該路徑不存在,使用者應用程式將會使用 jre/lib/security/cacerts。

NOVL_CONFIG_TRUSTEDSTOREPASSWORD=

可信金鑰儲存區:可信儲存區密碼。

NOVL_CONFIG_ICSLOGOUTENABLED=

Access Manager 和 iChain 設定:同時登出已啟用。

若要啟用同時登出使用者應用程式和 NetIQ Access Manager 或 iChain 的功能,請指定 True。登出時,使用者應用程式會檢查是否存在 NetIQ Access Manager 或 iChain Cookie,如果存在,則會將使用者重新路由至 ICS 登出頁面。

若要停用同時登出功能,請指定 False。

NOVL_CONFIG_ICSLOGOUTPAGE=

Access Manager 和 iChain 設定:同時登出頁面。

指定 NetIQ Access Manager 或 iChain 登出頁面的 URL,此 URL 是 NetIQ Access Manager 或 iChain 預期使用的主機名稱。如果 ICS 登入已經啟用,且使用者登出了「使用者應用程式」,則該使用者會被重新導向至此頁面。

NOVL_CONFIG_EMAILNOTIFYPROTOCOL=

電子郵件:通知範本 PROTOCOL 記號。

指的是非安全通訊協定 HTTP。用於取代佈建申請任務和核准通知中所使用之電子郵件範本中的 $PROTOCOL$ 記號。

NOVL_CONFIG_EMAILNOTIFYSECUREPROTOCOL=

電子郵件:通知範本 SECURE PORT 記號。

NOVL_CONFIG_OCSPURI=

其他:OCSP URI。

如果用戶端安裝使用線上證書狀態通訊協定 (OCSP),請指定資源識別字串 (URI)。例如,格式為 http://hstport/ocspLocal。OCSP URI 會在線上更新可信證書的狀態。

NOVL_CONFIG_AUTHCONFIGPATH=

其他:授權組態路徑。

授權組態檔案的完全合法名稱。

NOVL_CONFIG_CREATEDIRECTORYINDEX

其他:建立 eDirectory 索引

如果您希望靜默安裝程式在為 NOVL_CONFIG_SERVERDN 指定的 eDirectory 伺服器上建立 manager、ismanager 和 srvprvUUID 屬性的索引,請指定 True。如果此參數設定為 true,則您不能將 NOVL_CONFIG_REMOVEEDIRECTORYINDEX 設定為 true。

為取得最佳效能結果,您應該完成索引的建立。您必須先將索引置於「線上」模式,之後才讓「使用者應用程式」可供使用。

NOVL_CONFIG_REMOVEDIRECTORYINDEX

其他:移除 eDirectory 索引

如果您希望靜默安裝程式移除 NOVL_CONFIG_SERVERDN 中指定伺服器上的索引,請指定 True。如果此參數設定為 true,則您不能將 NOVL_CONFIG_CREATEEDIRECTORYINDEX 設定為 true。

NOVL_CONFIG_SERVERDN

其他:伺服器 DN

指定要建立或移除索引的 eDirectory 伺服器。

NOVL_CREATE_DB

指出建立資料庫的方式。有效值如下:

  • now - 立即建立資料庫

  • file - 將 SQL 輸出寫入檔案

  • startup - 在應用程式啟動時建立資料庫

NOVL_DATABASE_NEW

指出資料庫是新增的還是現有的。如果資料庫是新的,請指定 True。

NOVL_RBPM_SEC_ADMINDN

安全性管理員

此角色會授予各成員安全性網域內的所有功能。

安全性管理員可以對安全性網域內的所有物件執行所有允許的動作。安全性網域允許安全性管理員為 RBPM 中所有網域內的所有物件設定存取許可權。安全性管理員可以設定團隊,還可以指定網域管理員、委託管理員及其他安全性管理員。

NOVL_RBPM_RESOURCE_ADMINDN

資源管理員

此角色會授予各成員資源網域內的所有功能。資源管理員可以對資源網域內的所有物件執行所有允許的動作。

NOVL_RBPM_CONFIG_ADMINDN

此角色會授予各成員組態網域內的所有功能。RBPM 組態管理員可以對組態網域內的所有物件執行所有允許的動作。RBPM 組態管理員控制對 RBPM 中導覽項目的存取權。此外,RBPM 組態管理員還可以設定委託與代理服務、佈建用者介面及工作流程引擎。

RUN_LDAPCONFIG=

指定您要在何時設定 LDAP 設定:現在或以後。值包括:

  • Now - 立即執行 LDAP 設定,具體做法是在 WAR 中填入提供的 LDAP 組態設定。

  • Later – 只安裝使用者應用程式檔案,而不進行 LDAP 設定。

37.3.3 將 eDirectory 證書輸入 Identity Applications

若要在 Identity Applications 與 eDirectory 伺服器之間建立信任連接,請將 eDirectory 證書輸入 Identity Applications。

  1. 從 iManager 輸出 eDirectory 證書︰

    1. 以管理員身分登入 iManager。

    2. 導覽至角色與任務 > NetIQ 證書存取 > 伺服器證書。

    3. 核取 SSL CertificateDNS 核取方塊並按一下輸出。

    4. 在證書下拉清單中選取 SSL CertificateDNS 選項,清除輸出私密金鑰核取方塊,然後選取 DER 輸出格式。

    5. 按下一步。

    6. 按一下儲存輸出的證書,輸出的證書即會儲存到您的本地系統。

  2. 將 eDirectory 證書輸入 Identity Applications︰

    1. 以管理員身分登入要安裝 Identity Applications 的伺服器。

    2. 複製您已從 iManager 輸出的 eDirectory 證書,執行 keytool 指令︰

      keytool -import -trustcacerts -file Cerificate_Path -alias ALIAS_NAME -keystore cacerts

      在 Certificate_Path 中指定儲存在您電腦上的 eDirectory 證書的位置。

      在 ALIAS_NAME 中為證書指定任意別名。例如,

      /opt/netiq/idm/jre/bin/keytool -import -trustcacerts -file /opt /Certificate_Import_Path/EdirCertificate -alias EDIR_CERT -keystore /opt /netiq/idm/jre/lib/security/cacerts

37.3.4 執行 Identity Applications 的靜默安裝

  1. 以 root 使用者身分登入您要安裝 Identity Applications 的電腦。

  2. 開啟一個終端機工作階段。

  3. 指定安裝的相應值。如需詳細資訊,請參閱節 37.3.2, 編輯 .properties 檔案與節 28.2.1, 保護靜默安裝所用的密碼。

  4. 若要啟動適用於您平台的安裝程式,請輸入以下指令:

    • Linux︰./IdmUserApp.bin -i silent -f /您的目錄路徑/silent.properties

    • Windows︰./IdmUserApp.exe -i silent -f /您的目錄路徑/silent.properties

    附註:如果 silent.properties 檔案不在安裝程式程序檔所在的目錄中,則您必須指定該檔案的完整路徑。該程序檔會將所需的檔案解包到暫存目錄,然後啟動靜默安裝。