本部分说明如何在 JBoss 应用程序服务器上通过使用安装程序的图形用户界面版本安装 Identity Manager User Application。
浏览找到包含安装文件的目录,如表 5-2中所述。
从命令行起动平台的安装程序:
java -jar IdmUserApp.jar
从下拉菜单中选择一种语言,然后单击
。阅读许可证协议,单击我接受许可证协议中的条款,然后单击 。
阅读安装向导的“介绍”页,然后单击下一步。
选择 JBoss 应用程序服务器平台,然后单击
。如果不想迁移数据库,请单击部分 5.5.4, 指定 WAR 的位置。
,然后继续如果要使用来自版本 3.0 或版本 3.01 User Application 的现有数据库,则必须进行数据库的迁移。
校验已启动了要迁移的数据库。
单击安装程序的“数据迁移”页中的
。单击install.properties 文件。
浏览 Identity Manager 3.0 或 3.01 User Application 安装目录中的通过指定以前安装的 install.properties 文件的位置,可以减少必须在下面页面中指定的项目的数目。
系统要求您确认数据库类型、主机名和端口。确认这些内容后,单击
。User Application 安装程序更新 User Application,并将 V3.0 或 3.0.1 数据库中的数据迁移到 V3.5.1 所使用的数据库。有迁移数据库的信息及其其他步骤,请参见《Identity Manager User Application:迁移指南》。
如果 Identity Manager User Application WAR 文件所在的目录不同于安装程序,安装程序将提示提供 WAR 的路径。
如果 WAR 在默认位置,请单击
。或者,要指定 WAR 文件的位置,单击
并选择某个位置。在“选择安装文件夹”页,选择安装 User Application 的位置。如果要记住和使用默认位置,单击恢复默认文件夹;如果要为安装文件选择其他位置,单击 并浏览某个位置。
选择要使用的数据库平台。
如果使用的是 Oracle 数据库,安装程序将询问所使用的版本。选择使用的版本。
单击下一步,然后继续部分 5.5.7, 指定数据库主机和端口。
填写以下字段:
填写以下字段:
单击下一步,然后继续部分 5.5.9, 指定 Java 根目录。
单击
浏览 Java 根文件夹。要使用默认位置,请单击 。在此页上,为 User Application 指定查找 JBoss 应用程序服务器的位置。
此安装过程不安装 JBoss 应用程序服务器:有关安装 JBoss 应用程序服务器的指导,请参见部分 5.1.1, 安装 JBoss 应用程序服务器和 MySQL 数据库。
提供根文件夹、主机和端口:
填写以下字段:
(可选)要对 User Application 启用 Novell Audit 日志记录,请执行下列操作:
填写以下字段:
单击下一步,然后继续部分 5.5.14, 配置 User Application。
指定是要导入现有主密钥还是新建主密钥。导入现有主密钥的情况例如:
将安装从临时系统移到生产系统,并想继续访问过去临时系统中使用的数据库。
已将 User Application 安装在 JBoss 群集中的第一个成员上,现在在群集中的后续成员上执行安装。
由于磁盘故障,需要恢复 User Application。必须重新安装 User Application,并指定以前安装过程中所使用的同一个经过加密的主密钥。这样可以获得以前存储的加密数据的访问权。
单击
导入现有主密钥,或者单击 新建主密钥。单击
。安装过程中会将经过加密的主密钥写到安装目录中的 master-key.txt 文件中。
如果选择部分 5.5.14, 配置 User Application。完成安装后,必须手动记录主密钥,如部分 5.9.1, 记录主密钥中所述。
,跳至如果选择步骤 3。
,继续如果选择导入现有经过加密的主密钥,请将密钥剪切和粘贴到安装过程窗口。
在 User Application 安装过程中,可以设置 User Application 配置参数。其中大部分参数都还可以于安装在 configupdate.sh 或 configupdate.bat 中进行配置,有关例外的项,参见参数说明中的注释。
对于群集,对其中每个成员指定相同的 User Application 配置参数。
设置基本 User Application 配置参数(参见表 5-4中的说明),然后继续步骤 2。
表 5-4 User Application 配置:基本参数
设置类型 |
字段 |
说明 |
---|---|---|
eDirectory 连接设置 |
|
必需。 指定 LDAP 服务器的主机名或 IP 地址,及其安全端口。例如: myLDAPhost |
|
为 LDAP 服务器指定非安全端口。例如:389。 |
|
|
为 LDAP 服务器指定安全端口。例如:636。 |
|
|
必需。 指定 LDAP 管理员的身份凭证。该用户必须已经存在。 User Application 使用此帐户来建立与身份库 的管理连接。 此值已使用主密钥进行过加密。 |
|
|
必需。 指定 LDAP 管理员口令。此口令已使用主密钥进行过加密。 |
|
|
允许没有登录的用户访问 LDAP 公开匿名帐户。 |
|
|
允许没有登录的用户访问允许的入口小程序。身份库 中必须已经存在此用户帐户。要启用 LDAP Guest,必须取消选择 。要禁用 Guest 用户,请选择 。 |
|
|
指定 LDAP Guest 口令。 |
|
|
通过选中此选项,可以要求所有使用 Admin 帐户的通讯都通过安全套接字进行(不选中此选项则相反)。 |
|
|
通过选中此选项,可以要求所有使用已登录 帐户的通讯都采用安全套接字执行(不选中此选项则相反)。 |
|
eDirectory DN |
|
必需。 指定根树枝的 LDAP 判别名。 如果没有在目录抽象层中指定搜索根,则将该判别名用作默认的实体定义搜索根。 |
|
必需。 指定以前在部分 5.3, 创建 User Application 驱动程序中创建的 User Application 驱动程序的判别名。 例如,如果驱动程序为 UserApplicationDriver,驱动程序集称为 MyDriverSet,并且驱动程序集位于环境 o=myCompany 中,则可以输入以下值: cn=UserApplicationDriver,cn=myDriverSet,o=myCompany |
|
|
必需。身份库 中有权执行所指定 User Application 用户树枝的管理任务的现有用户。该用户可以使用 User Application 的 选项卡管理入口。如果 User Application 管理员参与 iManager、Designer for Identity Manager 或 User Application(IDM User Application:管理指南》。 选项卡)中显示的工作流程管理任务,则必须授予此管理员对 User Application 驱动程序中包含的对象实例的相应受托者权利。有关细节,请参见《要在部署 User Application 之后更改指派,必须使用 User Application 中的 页面。 |
|
|
Identity Manager 3.5.1 的供应版本中可以使用此角色。供应应用程序管理员使用 选项卡( 选项卡下方)来管理供应工作流程功能。用户可以通过 User Application 的 选项卡使用这些功能。在将用户指定为供应应用程序管理员之前,身份库 中必须存在此用户。要在部署 User Application 之后更改指派,必须使用 User Application中的 页面。 |
|
eDirectory DN(续) |
|
必需。 指定用户树枝的 LDAP 判别名 (DN) 或完全限定的 LDAP 名称。 这定义用户和组的搜索范围。允许该树枝中(及其下)的用户登录 User Application。 重要说明:如果要使该用户能够执行工作流程,请确保在 User Application 驱动程序设置过程中指定的 User Application 管理员在该树枝中存在。 |
|
必需。 指定组树枝的 LDAP 判别名 (DN) 或完全限定的 LDAP 名称。 由目录抽象层中的实体定义使用。 |
|
eDirectory 证书 |
|
必需。 指定应用程序服务器用于运行的、JDK 密钥存储区 (cacerts) 文件的完整路径,或单击小浏览器按钮,然后浏览找到 cacerts 文件。 在 Linux 或 Solaris 上,用户必须具有写此文件的权限。 |
|
必需。 指定 cacerts 口令。默认值为 changeit。 |
|
电子邮件 |
|
指定主管 Identity Manager User Application 的应用程序服务器。 例如: myapplication serverServer 此值将替换电子邮件模板中的 $HOST$ 令牌。所建立的 URL 是指向供应请求任务和批准通知的链接。 |
|
用于替换供应请求任务和批准通知所用的电子邮件模板中的 $PORT$ 令牌。 |
|
|
用于替换供应请求任务和批准通知所用的电子邮件模板中的 $SECURE_PORT$ 令牌。 |
|
|
指定供应电子邮件中发送邮件用户的电子邮件。 |
|
|
指定供应电子邮件所使用的 SMTP 电子邮件主机。这可以是 IP 地址或 DNS 名。 |
|
口令管理 |
|
通过此功能,可以指定外部忘记口令 WAR 中的“忘记口令”页,或外部忘记口令 WAR 用于通过万维网服务回拨 User Application 的 URL。 如果选中 ,则必须提供 和 的值。如果没有选择/jsps/pwdmgt/ForgotPassword.jsf (开头没有 http(s) 协议)。这将用户重定向到内置于 User Application 的“忘记口令”功能,而不是外部 WAR。 ,则 IDM 将使用默认的内部口令管理功能。 |
|
此 URL 指向“忘记口令”功能页。指定外部或内部口令管理 WAR 中的 ForgotPassword.jsf 文件。有关细节,请参见使用口令 WAR。 |
|
|
如果使用的是外部口令管理 WAR,需提供外部口令管理 WAR 用来通过万维网服务回调 User Application 的路径,例如 https:// idmhost:sslport/idm。 |
如果要设置其他 User Application 配置参数,请单击显示高级选项。(通过滚动查看整个面板。)表 5-5说明了“高级选项”参数。
如果不想设置此步骤中所述的其他参数,请跳至 步骤 3。
表 5-5 User Application 配置:所有参数
设置类型 |
字段 |
说明 |
---|---|---|
eDirectory 连接设置 |
|
必需。 为 LDAP 服务器指定主机名或 IP 地址。例如: myLDAPhost |
|
为 LDAP 服务器指定非安全端口。例如:389。 |
|
|
为 LDAP 服务器指定安全端口。例如:636。 |
|
|
必需。 指定 LDAP 管理员的身份凭证。该用户必须已经存在。 User Application 使用此帐户来建立与身份库 的管理连接。 此值已使用主密钥进行过加密。 |
|
|
必需。 指定 LDAP 管理员口令。此口令已使用主密钥进行过加密。 |
|
|
允许没有登录的用户访问 LDAP 公开匿名帐户。 |
|
|
允许没有登录的用户访问允许的入口小程序。身份库 中必须已经存在此用户帐户。要启用 LDAP Guest,必须取消选择 。要禁用 Guest 用户,请选择 。 |
|
|
指定 LDAP Guest 口令。 |
|
|
通过选中此选项,可以要求所有使用 Admin 帐户的通讯都通过安全套接字进行(不选中此选项则相反)。 |
|
|
通过选中此选项,可以要求所有使用已登录用户帐户的通讯都通过安全套接字进行(不选中此选项则相反)。 |
|
eDirectory DN |
|
必需。 指定根树枝的 LDAP 判别名。 如果没有在目录抽象层中指定搜索根,则将该判别名用作默认的实体定义搜索根。 |
|
必需。 指定以前在部分 5.3, 创建 User Application 驱动程序中创建的 User Application 驱动程序的判别名。 例如,如果驱动程序为 UserApplicationDriver,驱动程序集称为 myDriverSet,并且驱动程序集位于环境 o=myCompany 中,则可以输入以下值: cn=UserApplicationDriver,cn=myDriverSet,o=myCompany |
|
|
必需。身份库 中有权执行所指定 User Application 用户树枝的管理任务的现有用户。该用户可以使用 User Application 的 选项卡管理入口。如果 User Application 管理员参与 iManager、Designer for Identity Manager 或 User Application(IDM User Application:管理指南》。 选项卡)中显示的工作流程管理任务,则必须授予此管理员 User Application 驱动程序中包含的对象实例的相应受托者权限。有关细节,请参见《要在部署 User Application 之后更改指派,必须使用 User Application 中的 页面。 |
|
|
Identity Manager 3.5.1 的供应版本中可以使用此角色。供应应用程序管理员管理 User Application 的 选项卡中可用的供应工作流程功能。在将用户指定为供应应用程序管理员之前,身份库 中必须存在此用户。要在部署 User Application 之后更改指派,必须使用 User Application 中的 页面。 |
|
元目录用户身份 |
|
必需。 指定用户树枝的 LDAP 判别名 (DN) 或完全限定的 LDAP 名称。 这定义用户和组的搜索范围。 允许该树枝中(及其下)的用户登录 User Application。 重要说明:如果要使该用户能够执行工作流程,请确保在 User Application 驱动程序设置过程中指定的 User Application 管理员在该树枝中存在。 |
|
LDAP 用户对象类(通常为 inetOrgPerson)。 |
|
|
代表用户的登录名的 LDAP 属性(比如 CN)。 |
|
|
用作查找用户或组时的标识符的 LDAP 属性。这不同于登录属性,登录属性仅在登录时使用,在用户/组搜索时不使用。 |
|
|
可选。代表用户的组成员资格的 LDAP 属性。 不要在该名称中使用空格。 |
|
元目录用户组 |
|
必需。 指定组树枝的 LDAP 判别名 (DN) 或完全限定的 LDAP 名称。 由目录抽象层中的实体定义使用。 |
|
LDAP 组对象类(通常是 groupofNames)。 |
|
|
代表用户组成员资格的属性。 不要在该名称中使用空格。 |
|
|
如果需要使用动态组,请选择该选项。 |
|
|
LDAP 动态组对象类(一般 dynamicGroup)。 |
|
eDirectory 证书 |
|
必需。 指定应用程序服务器用于运行的 JRE 的密钥存储区 (cacerts) 文件的完整路径,或单击浏览器按钮,然后浏览找到 cacerts 文件。 User Application 安装过程中将修改密钥存储区文件。 在 Linux 或 Solaris 上,用户必须具有写此文件的权限。 |
|
必需。 指定 cacerts 口令。默认值为 changeit。 |
|
私用密钥存储区 |
|
私用密钥存储区包含 User Application 的私用密钥和证书。保留. 如果保留为空的话,将采用默认路径 /jre/lib/security/cacerts。 |
|
口令为 changeit,除非另行指定。此口令已使用主密钥进行过加密。 |
|
|
别名为 novellIDMUserApp,除非另行指定。 |
|
|
口令为 novellIDM,除非另行指定。 此口令已使用主密钥进行过加密。 |
|
可信密钥存储区 |
|
可信密钥存储区包含所有用于验证数字签名的可信签名者的证书。如果此路径为空的话, User Application 将从系统属性 javax.net.ssl.trustStore 中获取路径。如果那里没有路径,则假定为 jre/lib/security/cacerts。 |
|
如果此字段为空的话, User Application 将从系统属性 javax.net.ssl.trustStorePassword 中获取口令。如果那里没有值,则使用 changeit。此口令已使用主密钥进行过加密。 |
|
Novell Audit 数字签名和证书密钥 |
|
包容 Novell Audit 数字签名密钥和证书。 |
|
|
显示数字签名证书。 |
|
|
显示数字签名私用密钥。此密钥已使用主密钥进行过加密。 |
iChain 设置 |
|
如果选中了此选项,则 User Application 支持同时注销 User Application 和 iChain® 或 Novell Access Manager。注销时, User Application 检查是否存在 iChain 或 Novell Access Manager Cookie,如果存在 Cookie,则将用户重路由到 ICS 注销页。 |
|
iChain 或 Novell Access Manager 注销页的 URL,其中该 URL 是 iChain 或 Novell Access Manager 预期的主机名。如果启用了 ICS 日志记录并且用户要注销 User Application,则将用户重路由到此页面。 |
|
电子邮件 |
|
指定主管 Identity Manager User Application 的应用程序服务器。 例如: myapplication serverServer 此值将替换电子邮件模板中的 $HOST$ 令牌。所建立的 URL 是指向供应请求任务和批准通知的链接。 |
|
用于替换供应请求任务和批准通知所用的电子邮件模板中的 $PORT$ 令牌。 |
|
|
用于替换供应请求任务和批准通知所用的电子邮件模板中的 $SECURE_PORT$ 令牌。 |
|
|
指非安全协议 HTTP。用于替换供应请求任务和批准通知所用的电子邮件模板中的 $PROTOCOL$ 令牌。 |
|
|
指安全协议 HTTPS。用于替换供应请求任务和批准通知所使用电子邮件模板中的 $SECURE_PROTOCOL$ 令牌。 |
|
|
指定供应电子邮件中发送电子邮件的用户。 |
|
|
指定供应电子邮件所使用的 SMTP 电子邮件主机。这可以是 IP 地址或 DNS 名。 |
|
口令管理 |
|
|
|
通过此功能,可以指定外部忘记口令 WAR 中的“忘记口令”页,或外部忘记口令 WAR 用于通过万维网服务回拨 User Application 的 URL。 如果选择 ,则必须提供 和 的值。如果没有选择/jsps/pwdmgt/ForgotPassword.jsf (开头没有 http(s) 协议)。这将用户重定向到内置于 User Application 的“忘记口令”功能,而不是外部 WAR。 ,则 IDM 将使用默认的内部口令管理功能。 |
|
|
此 URL 指向“忘记口令”功能页。指定外部或内部口令管理 WAR 中的 ForgotPassword.jsf 文件。有关细节,请参见使用口令 WAR。 |
|
|
|
如果使用的是外部口令管理 WAR,需提供外部口令管理 WAR 用来通过万维网服务回调 User Application 的路径,例如 https:// idmhost:sslport/idm。 |
杂项 |
|
应用程序会话超时。 |
|
如果客户安装使用在线证书状态协议 (OCSP),请提供统一资源标识符 (URI)。例如,格式为 http://host:port/ocspLocal。OCSP URI 在线更新可信证书的状态。 |
|
|
授权配置文件的完全限定名。 |
|
树枝对象 |
|
选择要使用的每个数字对象类型。 |
|
有以下标准树枝可供选择:位置、国家/地区、组织单位、组织和域。也可以在 iManager 中自己定义树枝,然后在 下面添加这些树枝。 |
|
|
列出与树枝对象类型相关的属性类型名称。 |
|
|
指定可作为树枝的身份库 中的对象类的 LDAP 名称。 有关树枝的信息,请参见《Novell iManager 2.6 管理指南》。 |
|
|
提供树枝对象的属性名称。 |
注:安装后,可以编辑此文件中的大部分设置。要执行此操作,请运行安装子目录中的 configupdate.sh 底稿或 Windows configupdate.bat 文件。请记住,在群集中,此文件中的设置对于群集中的所有成员必须保持一致。
完成设置配置之后,单击确定,然后继续部分 5.5.15, 校验选择并安装。
通过
配置参数,可以指定包含“忘记口令”功能的 WAR 的位置。可以对 User Application 指定外部或内部 WAR。使用安装过程或 configupdate 实用程序。
在 User Application 配置参数中,选中
配置参数复选框。对于
配置参数,指定外部口令 WAR 的位置。包括主机和端口,比如 http://localhost:8080/ExternalPwd/jsps/pwdmgt/ForgotPassword.jsf。外部口令 WAR 可以位于保护 User Application 的防火墙之外。
对于https:// idmhost:sslport/idm。
,需提供外部口令管理 WAR 用于通过万维网服务回调 User Application 的路径,比如返回链接必须使用 SSL,以确保与 User Application 进行安全万维网服务通讯。另请参见部分 5.9.3, 配置 JBoss 服务器之间的 SSL 通讯。
如果使用了安装程序,请阅读此步骤中的信息,然后继续步骤 6。
如果使用 configupdate 实用程序更新安装根目录中的外部口令 WAR,请阅读此步骤并手动将 WAR 重命名为在步骤 6。
中指定的第一个目录。然后,继续在安装结束之前,安装程序将 IDMPwdMgt.war(安装程序中附带)重命名为指定的第一个目录。经过重命名的 IDMPwdMgt.war 称为外部口令 WAR。例如,如果指定的是 http://www.idmpwdmgthost.com/ExternalPwd/jsps/pwdmgt/ForgotPassword.jsf,安装程序会将 IDMPwdMgt.war 重命名为 ExternalPwd.war。安装程序将重命名过的 WAR 移至安装根目录。
手动将 ExternalPwd.war 复制到运行外部口令 WAR 功能的远程 JBoss 服务器部署目录。
不要选择
。接受
的默认位置,或者提供另一个口令 WAR 的 URL。接受
的默认值。阅读“安装前摘要”页,校验所选择的安装参数。
如有必要,使用
返回到前面的安装页,对安装参数作出更改。User Application 配置页的值没有保存下来,因此,在重新指定安装中的以前页面之后,必须重新输入 User Application 配置值。
当安装和配置参数满意之后,返回“安装前摘要”页,然后单击
。如果安装成功完成,没有错误,请转至部分 5.9, 安装后的任务。
如果安装提示出现错误或警告,请检查日志忘记以确定问题:
Identity_Manager_User_Application_InstallLog.log 保存基本安装任务的结果
Novell-Custom-Install.log 记录了有关安装过程中所执行的 User Application 配置
欲获得解决问题的帮助,请参见部分 5.11, 查错。