回页首

构建 Echo Web 服务和 Web 服务客户端

这部分将带您完成通过 Echo Java Bean 来创建 Web 服务和 Web服务客户端的步骤。创建一个名为 Echo.java 并带有如下内容的文件：

package ws;
public class Echo
{
   public String echo(String s)
   {
      return s;
   }
}
                

1. 启动WebSphere Studio。
2. 创建 Web 项目。选择 File =>New => Other。
3. 从左侧菜单中选择 Web并从右侧列表中选择 Dynamic Web Project。单击 Next。
4. 图14 显示了 New Web Project 向导。为项目名称输入 EchoService ，然后单击 Finish：
   图 14. New Web Project 向导
   
   
5. 将 Echo JavaBean 导入到该 Web 项目。选择 File => Import。
6. 选择 File system并单击 Next。
7. 找到您创建 Echo.java 的文件夹，并选择它，在 Into folder文本域中输入 EchoService/JavaSource/ws 。然后单击 Finish：
   图 15. 导入 Echo.java
   
   
8. 运行 Web Service Creation向导。选择 File => New => Other。
9. 从左侧菜单中选择 Web services并从右侧列表中选择 Web service。然后单击 Next。
10. 图16 显示了 Web Services Creation 向导。选择 Java bean Web Service作为 Web 服务类型。选取 Generate a proxy、 Test the generated proxy和 Overwrite files without warning复选框。然后单击 Next：
    图 16. Web Services 向导
    
    
11. 使用在 Service Deployment Configuration页面定义的缺省选项并单击 Next。
12. 在 Web Service Java Bean Selection页面，输入 ws.Echo 作为 Java Bean的类名称。然后单击 Finish。

您已经成功地创建了 Echo Web服务和 Web服务客户端。接下来的部分将向您展示如何配置它们以使用XML 签名。

回页首

保护 Echo Web 服务和 Web 服务客户端的安全

由于 WSS: SOAP 消息安全性（WSS: SOAP MessageSecurity）和 WSS: 用户名令牌概要（WSS: Username Token Profile）还没有最后定稿，所以没有在标准的 JSR-109 部署描述符中配置 XML 签名的标准格式。可以通过 JSR-109部署描述符的 IBM 扩展来提供对 XML 签名的支持。Web Services Editor和 Web Services Client Editor为编辑这些部署描述符提供了非常便利的途径。

签署 SOAP 请求

Web Services Client Editor允许您为签署客户端 SOAP 请求指定密钥。

1. 转到 WebSphere Studio工作台的 EchoServiceClient/WebContent/WEB-INF 文件夹，然后双击 webservicesclient.xml来调出 Web Services Client Editor。
2. 单击 Security Extensions选项卡。图 17 显示了 Web Services Client Editor的安全性扩展页面：
   图 17. Web Services Client Editor 的 Security Extensions页面
   
   
3. 展开 Request Sender Configuration => Integrity部分。单击 Add，并选择 body作为 Reference Part，然后单击 OK：
   图18. 完整性
   
   
4. 单击 Port Binding选项卡以调出端口绑定页面。
5. 在 Security Request Sender Binding Configuration => Key Locators部分，单击 Add。 一个密钥定位器（key locator）指定了用于检索密钥的储存库。
6. 图19 显示了 Key locator 对话框。输入所需信息。用 client_keystore.jks文件所在的位置替换 keystore 路径。如果您为客户端keystore 选择您自己的密码来代替 client123 ，那么请在 key store storepass和 Key pass 栏中输入您的密码。然后单击 OK：
   图 19. Key locator对话框
   
   
7. 在 Security Request Sender Binding Configuration => Signing Information部分，单击 Enable。在本例中签署信息确定用于签署输出SOAP 消息的密钥。
8. 图 20 显示了 Signing information对话框。输入所需的信息，然后单击 OK：
   图 20. Signing information对话框
   
   
9. 保存Web Services Client Editor。

验证服务器响应

Web Services Client Editor还允许您确认 SOAP 响应消息的完整性并验证响应的发送方。

1. 在Web Services Client Editor，单击 Security Extensions选项卡。
2. 在 Security Extensions 页面，展开 Response Receiver Configuration => Required Integrity部分。单击 Add，然后选择 body作为 Reference Part，再单击 OK。
3. 单击 Port Binding选项卡。在 Security Response Receiver Binding Configuration => Certificate Store List=> Collection Certificate Store部分，单击 Add。一个包含了一组证书的证书存储器将被用于检验输入的 X.509安全性令牌。
4. 图 21 显示了 Collection certificate store对话框。输入所需的信息，然后单击 OK：
   图 21. Collection certificate store对话框
   
   
5. 在 Security Response Receiver Binding Configuration => Trust Anchor部分，单击 Add。信任锚（trust anchor）指定了一组用于存放来自信任的CA 的证书的 keystore。
6. 图 22 显示了 Trust anchor对话框。输入所需的信息，然后单击 OK：
   图 22. Trust anchor 对话框
   
   
7. 在 Security Response Receiver Binding Configuration => Signing Information部分，单击 Add。本例中签署信息确定了用于检验输入的SOAP 消息的证书。
8. 图 23 显示了 Signing information对话框。输入所需的信息，然后单击 OK：
   图 23. Signing information 对话框
   
   
9. 保存Web Services Client Editor。

签署 SOAP 响应

继续该场景，您将利用 Web Services Editor来指定用于签署服务器 SOAP 响应的密钥。

1. 转到 EchoService/WebContent/WEB-INF 文件夹，然后双击 webservices.xml以调出 Web ServicesEditor。
2. 单击 Security Extensions选项卡。展开 Response Sender Service Configuration Details => Integrity部分。单击 Add，然后选择 body作为 ReferencePart，再单击 OK。
3. 单击 Binding Configurations选项卡。在 Response Sender Binding Configuration Details => Key Locators部分，单击 Add。
4. 图 24 显示了 Key locator对话框。输入所需的信息，然后单击 OK：
   图 24. Key locator 对话框
   
   
5. 在 Response Sender Binding Configuration Details => Signing Information部分，单击 Enable。
6. 图 25 显示了 Signing information对话框。输入所需的信息，然后单击 OK：
   图 25. Signing information对话框
   
   
7. 保存Web Services Editor。

验证客户端请求

Web Services Editor还允许您检验客户端 SOAP请求的完整性并验证请求的发送方。

1. 在Web Services Editor，单击 Security Extensions选项卡。
2. 在Security Extensions 页面，展开 Request Receiver Service Configuration Details => Required Integrity部分。单击 Add，然后选择 body作为 ReferencePart，再单击 OK。
3. 单击 Binding Configurations选项卡。在 Request Receiver Service Configuration Details => Certificate Store List => Collection Certificate Store部分，单击 Add。
4. 图26 显示了 Collection certificate store对话框。输入所需的信息，然后单击 OK：
   图 26. Collection certificate store 对话框
   
   
5. 在 Request Receiver Service Configuration Details => Trust Anchor部分，单击 Add。
6. 图 27 显示了 Trust anchor对话框。输入所需的信息，然后单击 OK：
   图 27. Trust anchor 对话框
   
   
7. 在 Request Receiver Service Configuration Details => Signing Information部分，单击 Add。
8. 图 28 显示了 Signing information对话框。输入所需的信息，然后单击 OK：
   图 28. Signing information 对话框
   
   
9. 保存Web Services Editor。

在对部署描述符的更改生效之前，必须重启 Echo企业应用程序。

1. 打开服务器透视图。单击菜单 Window => Open Perspective => Others。
2. 选择 Server并单击 OK。
3. 在 Servers 视图，右键单击 Echo企业应用程序部署到的服务器=> Restart Project => DefaultEAR。

回页首

测试 Echo Web 服务

在生成样本 JSP 时，他们缺省地使用 Java 2 Standard Edition（J2SE）的方法来实例化客户端存根。J2SE 方法是单独地基于由JAX-RPC定义的程序设计模块。这意味着客户端存根对象不了解在 JSR-109部署描述符中定义的配置，例如：XML签名配置。为了利用部署配置，JSR-109 需要通过 JNDI查找可用的服务接口（Service Interface）实例化客户端存根。因此，您必须修改生成的样本JSP 以使用 JNDI 查找来代替缺省的 J2SE方法。下列步骤将向您展示如何完成这一工作：

1. 转到 EchoServiceClient/WebContent/sample/Echo文件夹，右键单击，然后选择 Result.jsp => Open With => Text Editor。
2. 如图 29所示修改 Result.jsp 。保存并关闭文本编辑器。
   图 29. Result.jsp
   
   
3. 右键单击 TestClient.jsp => Run on Server。
4. 选择Echo Web 服务部署到的服务器，然后单击 Finish。
5. 单击 echo（java.lang.String）方法，在输入文本域输入 Hello World ，然后单击 Invoke。结果将显示在 Result窗格中。详细情况请参阅图 30：
   图 30. 调用 Echo Web 服务
   
   图 31 和 32 显示在 TCP/IP 侦听服务器中捕获的 SOAP请求和响应。客户端和服务器的 XML 签名被分别附加到SOAP 请求头部和 SOAP 响应头部：
   图 31. SOAP 请求
   
   
   图 32. SOAP 响应
   
   

回页首

结束语

本文提供了对XML 签名和数字证书的介绍。本文讨论了如何使用 IBM Key Management工具和WebSphere Studio V5.1 并利用 XML 签名来构建安全的 Web服务。XML签名允许您确认消息的完整性并验证消息的发送方。XML签名是保护您的 Web服务的众多方法中的一种。本系列的其他文章将涉及保护Web 服务的其他机制。

参考资料

• Organization for the Advancement of Structured Information Standards (OASIS)
  
  
  
  
• Web Services Interoperability (WS-I)
  
  
  
  
• Simple Object Access Protocol (SOAP)
  
  
  
  
• Web Service Description Language (WSDL)
  
  
  
  
• Web Services Security：SOAP Message Security
  
  
  
  
• Web Services Security：Username Token Profile
  
  
  
  
• XML Signature Syntax and Processing
  
  
  
  
• Java API for XML-based Remote Procedure Call (JAX-RPC)
  
  
  
  
• Java Specification Request 109 (JSR-109)
  
  
  
  

关于作者

为本文评分

评论

回页首