Build Forge 通常将其服务作为应用程序运行在所提供的 Apache Tomcat 应用程序服务器中。
关于此任务
以下指示信息将 Build Forge 配置为使用 WAS 而非 Tomcat。请按照
使用 WebSphere Application Server 而非 Apache Tomcat部分中的指示信息进行操作,但有一个例外:
rbf-services.war 文件包含名为
web.xml 的文件,您需要将其解压并修改以添加安全性约束。在 WAS 中安装该应用程序之前,需要在修改
war 文件后重新生成该文件,以便可以使用该文件的受保护版本。
要执行此操作,请遵循以下指示信息:
过程
- 浏览至包含 rbf-services.war 文件的目录(Tomcat 服务器根中的 webapps 目录)。 将该文件复制到临时位置,例如 C:\rbf。
- 扩展 WAR 文件。 从命令行中,运行命令:%IBM_JAVA_HOME%\jar –xvf rbf-services.war 以扩展 war 文件的内容。
注: Java 必须可用,且必须已创建 IBM_JAVA_HOME 环境变量。
- 保存 rbf-services.war 文件以便稍后进行检索:
- 对于 Windows:copy rbf-services.war rbf-services.war.bak
- 对于 UNIX 或 Linux:cp rbf-services.war rbf-services.war.bak
- 在 WEB-INF 目录中(从 war 文件中扩展的文件中)查找 web.xml 文件。编辑该文件以添加安全上下文。例如,在文件结束处,在 </web-app> 标记之前,添加以下各行:
<security-constraint id="SecurityConstraint_1">
<web-resource-collection id="WebResourceCollection_1">
<web-resource-name>/*</web-resource-name>
<url-pattern>/AuthServlet/*</url-pattern>
<http-method>GET</http-method>
<http-method>POST</http-method>
<http-method>PUT</http-method>
<http-method>DELETE</http-method>
</web-resource-collection>
<auth-constraint id="AuthConstraint_1">
<description>myconstraint:+:</description>
<role-name>User</role-name>
</auth-constraint>
<user-data-constraint id="UserDataConstraint_1">
<transport-guarantee>NONE</transport-guarantee>
</user-data-constraint>
</security-constraint>
<login-config id="LoginConfig_1">
<auth-method>BASIC</auth-method>
<realm-name>full-qualified-domain</realm-name>
</login-config>
<security-role id="SecurityRole_1">
<role-name>User</role-name>
</security-role>
注: <auth-method> 可以是 WAS 支持的任何 J2EE 认证方法。最常见的认证方法是 FORM,该方法需要附加的配置参数。请参阅 WebSphere 文档,以获取有关在应用程序中配置 FORM 的指示信息。
- 从命令行中,通过运行以下命令重新生成 war 文件(从抽取到的同一目录中调用):
%IBM_JAVA_HOME%\jar –cvf rbf-services.war
此时应该具有已修改的新版本 rbf-services,以通过 J2EE 约束保护 AuthServlet。完成安装指示信息以在 WAS 中运行,并通过应用程序->安装新应用程序来安装该版本的 rbf-services.war。请确保在配置 WAS 时,Build Forge 未运行。
这安装完后,请转至应用程序->企业应用程序。单击应用程序名称以配置该应用程序。在详细属性下,单击名为安全角色到用户/组的映射的链接。选择用户的所有已认证复选框。作出该更改后,请确保保存至主配置。
还需要在 WAS 下启用应用程序安全性。
要执行该操作,请转至安全性->安全管理、应用程序和基础结构。请确保选中了启用应用程序安全性。
此时,重新启动 WAS 服务器,然后重新启动 Build Forge 服务器。
注: rbf-services 此时应该作为 WAS 启动进程的一部分启动,因此 WAS 需要在 Build Forge 之前启动。