Tomcat 配置用户认证服务供C#客户端调用

时间 2019-11-09

标签 tomcat 配置用户认证服务 c# 客户端调用栏目 Tomcat 繁體版

原文原文链接

项目里，遇到的一个小问题来好好的总结一下。由于咱们这个项目是用Java写的服务端发布WebService，客户端呢使用C#来调用WebService（本人之前搞过一段时间C#客户端，还总结了一个MVP框架AngelFrame，发布在： http://www.cnblogs.com/wgp13x/p/99c2adc52d8f0dff30a038841ac32872.html ），固然C#调用Java发布的 WebService能够利用很多第三方项目，好比Axis2，咱们就用的这个，网上也有不少介绍。不过咱们项目要求，要使用证书，客户端须要安装证书才能正常使用 WebService，这个网上不多有，下面就是我配置成功之后的总结啦，分享给你们。

摘要：本人找了很久也没在网上找到一份完整的讲Tomcat 七、 Axic2 发布带用户认证的WebService、C#客户端调用这个服务的配置步骤，通常都是讲java客户端调用。本文便是对这一过程完成后的一个总结，详细的一步步的教你怎么使用证书，在服务端发布带用户认证的服务，在C#客户端使用这一服务。

关键词： Tomcat,Axic2,WebServcie,Java,C#,服务,用户认证,证书

前提：已经使用axic2在 Tomcat上发布了一个不带用户认证的WebServcie，而且C#客户端能够正确调用它。

需求：使用证书，将服务配置成带用户认证的，而且 C#客户端能够正确使用它。

说明：如下是在Tomcat下配置用户认证的具体步骤。

步骤一：

首先，你得有对证书，证书的生成办法网上都有，我再略讲一遍吧。

咱们使用JDK自带的keytool工具来生成证书。命令行进入JDK下的bin目录，运行keytool命令。里面的各类参数，生成路径、有效时间、别名、“您的名字与姓氏是什么？”、“您所在的州或省份名称是什么?”、“密码”等均可以按照须要来填，这里略过哈。

 
        keytool -genkey - 
        v  
        - 
        alias  
        tomcat -keyalg RSA -keystore D:\tomcat.keystore -validity 36500

 
        keytool -genkey - 
        v  
        - 
        alias  
        mykey -keyalg RSA -storetype PKCS12 -keystore D:\lpClient.p12 -validity 36500

 
        keytool - 
        export  
        - 
        alias  
        mykey -keystore D:\lpClient.p12 -storetype PKCS12 -storepass password -rfc - 
        file  
        D:\lpClient.cer

 
        keytool - 
        import  
        - 
        v  
        - 
        file  
        D:\lpClient.cer -keystore D:\tomcat.keystore

 
        keytool -list -keystore D:\tomcat.keystore

 
        keytool -keystore D:\lpServer.keystore - 
        export  
        - 
        alias  
        tomcat - 
        file  
        D:\lpServer.cer

这样就生成了咱们须要的三个文件：tomcat.keystore、lpClinet.p12、lpServer.cer。html

步骤二：

在Tomcat conf\server.xml文件中添加如下代码段。

<Connector port="8443" protocol="HTTP/1.1" SSLEnabled="true"

maxThreads="150" scheme="https" secure="true"

clientAuth="false" sslProtocol="TLS"

keystoreFile="D:\\tomcat.keystore" keystorePass="password"

truststoreFile="D:\\tomcat.keystore" truststorePass="password" />

注意：clientAuth="false"，先不进行客户端认证，使C#客户端可以正常添加服务引用，不然C#客户端添加不上服务引用。

在D:\目录下放置tomcat.keystore，密码按实际状况而配。

步骤三：

在Tomcat conf\web.xml文件尾部添加如下代码段，使其默认使用Https协议，这样一来，全部的Http请求就会自动转变为Https请求啦。这步也能够略过，若是你的项目不强制使用Https协议的话。

<login-config>

<auth-method>CLIENT-CERT</auth-method>

<realm-name>Client Cert Users-only Area</realm-name>

</login-config>

<security-constraint>

<web-resource-collection>

<web-resource-name>SSL</web-resource-name>

<url-pattern>/*</url-pattern>

</web-resource-collection>

<user-data-constraint>

<transport-guarantee>CONFIDENTIAL</transport-guarantee>

</user-data-constraint>

</security-constraint>

步骤四：

在webapps\WebContent\WEB-INF\conf文件中添加如下代码段。

<transportReceiver name="http"

class="org.apache.axis2.transport.http.AxisServletListener">

</transportReceiver>

<transportReceiver name="https"

class="org.apache.axis2.transport.http.AxisServletListener">

</transportReceiver>

这一步是配置端口号。而后就是，启动Tomcat服务器，发布服务了，你可使用浏览器查看服务是否发布成功，这就没必要多说了吧。由于刚刚配置的clientAuth="false"，先不进行客户端认证，因此不用安装证书就能够正常查看。java

步骤五：

在Windows客户端正确安装证书，并配置好受信任的根证书颁发机构。证书的安装办法网上都有，在这里我再略述一遍吧，具体的过程以下：

双击 lpClinet.p12，一直默认下一步，正确输入设置的密码，安装到“我的”下。双击lpServer.cer，安装到“受信任的根证书颁发机构”下。

步骤六：

在C#客户端添加相应的服务引用，注意使用的是Soap12。先不作如下配置，启动C#客户端，判断https链接是否成功。成功后可继续按照下面的代码进行配置，放在App.conf里。

<textMessageEncoding maxReadPoolSize="64" maxWritePoolSize="16"

messageVersion="Soap12" writeEncoding="utf-8">

<readerQuotas maxDepth="32" maxStringContentLength="8192" maxArrayLength="16384"

maxBytesPerRead="4096" maxNameTableCharCount="16384" />

</textMessageEncoding>

<httpsTransport manualAddressing="false" maxBufferPoolSize="524288"

maxReceivedMessageSize="65536" allowCookies="false" authenticationScheme="Anonymous"

bypassProxyOnLocal="false" decompressionEnabled="true" hostNameComparisonMode="StrongWildcard"

keepAliveEnabled="true" maxBufferSize="65536" proxyAuthenticationScheme="Anonymous"

realm="" transferMode="Buffered" unsafeConnectionNtlmAuthentication="false"

useDefaultWebProxy="true" requireClientCertificate="true" />

</binding>

<endpoint address="https://192.1.11.108:8443/WebContent/services/TaskService.TaskServiceHttpsSoap12Endpoint/"

behaviorConfiguration="endpointBehavior1" binding="customBinding" bindingConfiguration="TaskServiceSoap12Binding"

contract="TaskService.TaskServicePortType" name="TaskServiceHttpsSoap12Endpoint" />

</client>

</serviceCertificate>

</clientCredentials>

</behavior>

</endpointBehaviors>

</behaviors>

注意：要在这里配置到客户端的证书，endpointBehaviors、clientCredentials...请按照实际的配置为准，请耐心阅读，当心配置。

步骤七：

正确添加服务引用后，即可以更改Tomcat conf\server.xml文件中的 clientAuth="true"，设置其进行客户端认证。这时再重启Tomcat服务器，在浏览器中输入服务地址，就会发现这时浏览器让你选择一个证书，而后选择 lpClinet证书后便可正确的查看服务了，这样服务端就配置正确喽。

再次启动C#客户端，判断https链接是否成功，能正确访问服务，并进行调用便说明一切配置成功。这时，若将证书删除，或更改步骤六中的配置，访问服务便不会成功。