Włączanie podstawowego uwierzytelniania dla dostępu do usług Web Service

W celu uzyskania dostępu do usług WWW można skonfigurować podstawowe uwierzytelnianie dla aplikacji klienckich.

Informacje o tej czynności

Jeśli konieczne jest użycie aplikacji klienckiej usługi Web Service z podstawowym uwierzytelnianiem w celu uzyskania dostępu do chronionych zasobów usługi Web Service, klient musi podać nazwę użytkownika i hasło w żądaniu podczas komunikowania się z dostawcą usług.

Procedura

  1. Włącz funkcje jaxws-2.2, servlet-3.0(lub servlet-3.1) i appSecurity-2.0 w pliku server.xml .
    <featureManager>
  <feature>jaxws-2.2</feature>
  <feature>servlet-3.0</feature>
  <feature>appSecurity-2.0</feature>
</featureManager>
  2. Skonfiguruj dziedzinę logowania w pliku server.xml i powiążaj tę dziedzinę z dostawcą usług.
    <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>
  3. Skonfiguruj dostawcę usług, określając punkty końcowe usługi Web Service.
    1. Utwórz usługi Web Service.
      @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 {
	...
}
    2. Skonfiguruj plikibm-ws-bnd.xml dla dostawcy usług.
      <?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>
      Uwaga:
      • Plik ibm-ws-bnd.xml musi znajdować się w katalogu /WEB-INF aplikacji WWW lub w katalogu /META-INF aplikacji usługi Web Service opartej na komponencie EJB (archiwum JAR).
      • Element login-config w pliku ibm-ws-bnd.xml jest używany tylko w aplikacji usługi Web Service opartej na komponencie EJB (archiwum JAR). W przypadku aplikacji WWW element login-config jest ignorowany, a wartość tego samego elementu w pliku web.xml jest używana.
  4. Skonfiguruj klienta usługi, określając punkty końcowe usługi Web Service. Na przykład aplikacja kliencka jest aplikacją WWW o nazwie TransportSecurityClient.war.
    1. Skonfiguruj aplikację kliencką w pliku server.xml .
      <application id="TransportSecurityClient" name="TransportSecurityClient" 
		location="TransportSecurityClient.war"
		context-root="TransportSecurityClient" type="war" />
    2. Skonfiguruj plik ibm-ws-bnd.xml dla aplikacji klienckiej.
      <?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>
      Uwaga:
      • Plik ibm-ws-bnd.xml musi znajdować się w katalogu /WEB-INF aplikacji WWW klienta.
      • Wartości atrybutów username i password muszą być zgodne z nazwą użytkownika i hasłem elementu basicRegistry w pliku server.xml . Hasło może być zakodowane za pomocą komendy securityUtility .
    3. Wygeneruj kody pośredniczące klienta przy użyciu położenia 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
{...}
    4. Użyj adnotacji @WebServiceRef , aby wprowadzić usługę Web Service do serwletu. Na przykład TestJaxWsTransportSecurityServlet.
      @WebServiceRef(name = "service/SayHelloPojoService")
SayHelloPojoService pojoService;

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