Web サービス・アクセスに対する基本認証の使用可能化

クライアント・アプリケーションが Web サービスにアクセスできるように基本認証を構成することができます。

このタスクについて

保護された Web サービス・リソースにアクセスするために基本認証と共に Web サービス・クライアント・アプリケーションを使用する必要がある場合、クライアントは、サービス・プロバイダーと通信するときにユーザー名とパスワードを要求に含める必要があります。

手順

server.xml ファイルで jaxws-2.2、 servlet-3.0(または servlet-3.1)、および appSecurity-2.0 フィーチャーを有効にします。
```
<featureManager>
  <feature>jaxws-2.2</feature>
  <feature>servlet-3.0</feature>
  <feature>appSecurity-2.0</feature>
</featureManager>
```

server.xml ファイルでログイン・レルムを構成し、レルムをサービス・プロバイダーにバインドします。

<application id="TransportSecurityProvider" name="TransportSecurityProvider"
             location="TransportSecurityProvider.war" type="ear">
        <application-bnd>
            <security-role name="Employee">
                <user name="employee0" />
                <group name="employeeGroup" />
            </security-role>        
            <security-role name="Manager">
                <user name="manager0" />
            </security-role>
            <security-role name="AllAuthenticated">
                <special-subject type="ALL_AUTHENTICATED_USERS" />
            </security-role>
        </application-bnd>
    </application>
    
    <basicRegistry id="basic" realm="BasicRealm">
        <user name="employee0" password="emp0pwd" />
        <user name="employee1" password="emp1pwd" />
        <user name="manager0" password="mgr0pwd" />
        <group name="employeeGroup">
            <member name="employee0" />
            <member name="employee1" />
        </group>
    </basicRegistry>

Web サービス・エンドポイントを指定することによって、サービス・プロバイダーを構成します。

Web サービスを作成します。

@WebService(serviceName = "SayHelloPojoService",
            portName = "SayHelloPojoPort")
public class SayHelloPojoService implements SayHelloService {
	...
}

@WebService(serviceName = "SayHelloStatelessService",
            portName = "SayHelloStatelessPort",
            endpointInterface = "com.ibm.ws.jaxws.transport.server.security.SayHelloService")
@Stateless(name = "SayHelloSessionBean")
public class SayHelloStatelessService implements SayHelloLocal {
	...
}

サービス・プロバイダーの ibm-ws-bnd.xml ファイルを構成します。

<?xml version="1.0" encoding="UTF-8"?>
<webservices-bnd xmlns="http://websphere.ibm.com/xml/ns/javaee" 
		xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
		xsi:schemaLocation="http://websphere.ibm.com/xml/ns/javaee http://websphere.ibm.com/xml/ns/javaee/ibm-ws-bnd_1_0.xsd" 
		version="1.0">
	<http-publishing>
		<webservice-security> 
			<security-constraint>
				<web-resource-collection>
					<web-resource-name>Only Managers</web-resource-name>
					<url-pattern>/manager/*</url-pattern>
					<http-method>GET</http-method>
					<http-method>POST</http-method>
				</web-resource-collection>
				<auth-constraint id="AuthConstraint_manager">
					<role-name>Manager</role-name>
				</auth-constraint>
			</security-constraint>
			<security-constraint>
				<web-resource-collection>
					<web-resource-name>Employees</web-resource-name>
					<url-pattern>/employee/*</url-pattern>
					<http-method>GET</http-method>
					<http-method>POST</http-method>
				</web-resource-collection>
				<auth-constraint id="AuthConstraint_employee">
					<role-name>Employee</role-name>
				</auth-constraint>
			</security-constraint>
			<!-- SECURITY ROLES -->
			<security-role id="Staff">
				<role-name>Employee</role-name>
				<role-name>Manager</role-name>
			</security-role>
			<!-- AUTHENTICATION METHOD: Basic authentication -->
			<login-config id="LoginConfig">
				<auth-method>BASIC</auth-method>
				<realm-name>Authentication</realm-name>
			</login-config>                    
		</webservice-security>
	</http-publishing>
</webservices-bnd>

注:

ibm-ws-bnd.xml ファイルは、Web アプリケーションの /WEB-INF ディレクトリー、または EJB ベースの Web サービス・アプリケーション (JAR アーカイブ) の /META-INF ディレクトリーになければなりません。
ibm-ws-bnd.xml ファイル内の login-config エレメントは、EJB ベースの Web サービス・アプリケーション (JAR アーカイブ) でのみ有効になります。 Web アプリケーションの場合、login-config エレメントは無視され、web.xml ファイル内の同じエレメントの値が使用されます。

Web サービス・エンドポイントを指定することによって、サービス・クライアントを構成します。例えば、クライアント・アプリケーションは TransportSecurityClient.warという名前の Web アプリケーションです。

server.xml ファイルでクライアント・アプリケーションを構成します。

<application id="TransportSecurityClient" name="TransportSecurityClient" 
		location="TransportSecurityClient.war"
		context-root="TransportSecurityClient" type="war" />

クライアント・アプリケーションの ibm-ws-bnd.xml ファイルを構成します。

<?xml version="1.0" encoding="UTF-8"?>
<webservices-bnd xmlns="http://websphere.ibm.com/xml/ns/javaee" 
		xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
		xsi:schemaLocation="http://websphere.ibm.com/xml/ns/javaee http://websphere.ibm.com/xml/ns/javaee/ibm-ws-bnd_1_0.xsd"
		version="1.0">
	<!-- POJO service reference binding-->
	<service-ref name="service/SayHelloPojoService">
		<port name="SayHelloPojoPort" 
				namespace="http://ibm.com/ws/jaxws/transport/security/"
				username="employee1"
				password="{xor}OjIvbi8oOw=="
				/>
	</service-ref>
	<!-- Stateless service reference binding-->
	<service-ref name="service/SayHelloStatelessService">
		<port name="SayHelloStatelessPort" 
				namespace="http://ibm.com/ws/jaxws/transport/security/"
				username="employee1"
				password="{xor}OjIvbi8oOw=="
				/>
	</service-ref>
</webservices-bnd>

注:

ibm-ws-bnd.xml ファイルは、クライアント Web アプリケーションの /WEB-INF ディレクトリーになければなりません。
username 属性と password 属性の値は、 server.xml ファイル内の basicRegistry エレメントのユーザー名とパスワードと一致している必要があります。パスワードは、 securityUtility コマンドを使用してエンコードできます。

wsdl ロケーションを使用してクライアント・スタブを生成します。

@WebServiceClient(name = "SayHelloPojoService",
                  targetNamespace = "http://ibm.com/ws/jaxws/transport/security/",
                  wsdlLocation = "https://localhost:8020/TransportSecurityProvider/unauthorized/employPojoService?wsdl")
public class SayHelloPojoService
                extends Service
{...}

@WebServiceClient(name = "SayHelloStatelessService",
    targetNamespace = "http://ibm.com/ws/jaxws/transport/security/",
    wsdlLocation = "https://localhost:8020/TransportSecurityProvider/unauthorized/EmployStatelessService?wsdl")
public class SayHelloStatelessService
                extends Service
{...}

@WebServiceRef アノテーションを使用して、Web サービスをサーブレットに注入します。例えば、 TestJaxWsTransportSecurityServletなどです。

@WebServiceRef(name = "service/SayHelloPojoService")
SayHelloPojoService pojoService;

@WebServiceRef(name = "service/SayHelloStatelessService")
SayHelloStatelessService statelessService;