SAML-Sender-Vouches-Token von externem STS über WSS-APIs mit Nachrichtenschutz anfordern

Sie können SAML-Token mit der Subjektbestätigungsmethode Sender-Vouches von einem externen Sicherheitstokenservice (STS) anfordern. Die angeforderten SAML-Sender-Vouches-Token können Sie in Web-Service-Anforderungsnachrichten über das Programmiermodell Java™ API for XML-Based Web Services (JAX-WS) und WSS-APIs (Web Services Security APIs) mit Nachrichtenschutz senden.

Vorbereitende Schritte

Für diese Task müssen Sie mit dem Programmiermodell JAX-WS, den WSS-APIs, mit SAML-Konzepten, mit dem SSL-Transportschutz, mit X.509-Sicherheitstoken sowie mit Richtliniensätzen zum Konfigurieren und Verwalten von Web-Service-Einstellungen vertraut sein.

Informationen zu diesem Vorgang

Sie können ein SAML-Token mit der Subjektbestätigungsmethode Sender-Vouches von einem externen STS anfordern und dieses dann in Web-Service-Anforderungsnachrichten von einem Web-Service-Client aus über WSS-APIs mit Nachrichtenschutz senden.

Mit diesem Produkt wird kein Standardrichtliniensatz bereitgestellt, der SAML-Token mit der Subjektbestätigungsmethode Sender-Vouches erfordert. Lesen Sie hier, wie die Client- und Providerbindungen für das SAML-Sender-Vouches-Token konfiguriert werden, und informieren Sie sich darüber, wie eine Web-Services-Security-Richtlinie erstellt wird, die SAML-Token mit der Subjektbestätigungsmethode Sender-Vouches erfordert, und wie eine angepasste Bindungskonfiguration erstellt wird. Die Richtlinie und die Bindung müssen Sie dem Web-Service-Provider zuordnen. Das in dieser Task beschriebene Codebeispiel setzt voraus, dass die Web-Service-Providerrichtlinie erfordert, dass die SAML-Token und die Hauptteile der Nachrichten digital mit einem X.509-Sicherheitstoken signiert sind.

Die für diese Task verwendete Web-Service-Clientanwendung ist eine modifizierte Version des Clientcodes in der Beispielanwendung JaxWSServicesSamples, die zum Download verfügbar ist. In der Prozedur sind Codeauszüge des Beispiels beschrieben. Außerdem wird ein vollständiger, sofort einsatzfähiger Beispiel-Web-Service-Client bereitgestellt.

Vorgehensweise

  1. Ermitteln Sie den Web-Service-Client, mit dem Sie einen Web-Service-Provider aufrufen möchten, und fordern Sie diesen Client an.

    Fügen Sie mit diesem Client über WSS-APIs programmgestützt SAML-Token in SOAP-Anforderungsnachrichten ein.

    Der in dieser Prozedur verwendete Web-Service-Client ist eine modifizierte Version des Clientcodes, der in der Web-Service-Beispielanwendung JaxWSServicesSamples enthalten ist.

    Führen Sie die folgenden Schritte aus, um den Beispiel-Web-Service-Client anzufordern und über WSS-APIs zu modifizieren, um SAML-Sender-Vouches-Token programmgesteuert in SOAP-Anforderungsnachrichten übergeben zu können:

    1. Laden Sie die Beispielanwendung JaxWSServicesSamples herunter. Das Beispiel JaxWSServicesSamples ist standardmäßig nicht installiert.
    2. Fordern Sie den Clientcode für JaxWSServicesSamples an.

      Zu Demonstrationszwecken verwendet diese Prozedur eine modifizierte Version des Thin-Client-Beispiels Echo, das Teil des Beispiels JaxWSServicesSamples ist. Die Datei SampleClient.java des Web Services Thin Client "Echo" befindet sich im Verzeichnis src\SampleClientSei\src\com\ibm\was\wssample\sei\cli. Die Beispielklassendatei ist in der Datei WSSampleClientSei.jar enthalten.

      Die Unternehmensanwendung JaxWSServicesSamples.ear und die unterstützenden JAR-Dateien (Java-Archiv) befinden sich im Verzeichnis installableApps in der Beispielanwendung "JaxWSServicesSamples".

    3. Implementieren Sie die Datei JaxWSServicesSamples.ear auf dem Anwendungsserver. Nachdem Sie die Datei JaxWSServicesSamples.ear implementiert haben, können Sie den Code des Beispiel-Web-Service-Clients anhand der Beispielanwendung testen.

    Anstatt den Beispiel-Web-Service-Client zu verwenden, können Sie auch die Codefragmente hinzufügen, um in Ihrer eigenen Web-Service-Clientanwendung SAML-Token über WSS-APIs programmgestützt in SOAP-Anforderungsnachrichten zu übergeben. Das Beispiel in dieser Prozedur nutzt einen Web Services Thin Client für JAX-WS. Sie können aber auch einen verwalteten Client verwenden.

  2. Geben Sie an, dass der SSL-Nachrichtenschutz verwendet werden soll. Geben Sie mit der folgenden JVM-Eigenschaft an, dass die SAML-Tokenanforderung beim STS mit SSL geschützt werden soll:
    -Dcom.ibm.SSL.ConfigURL=file:Profilstammverzeichnis\properties\ssl.client.props
    Alternativ können Sie mit einer Java-Systemeigenschaft im Beispielclientcode die SSL-Konfigurationsdatei definieren, z. B.
    System.setProperty("com.ibm.SSL.ConfigURL", "file:Profilstammverzeichnis/properties/ssl.client.props");
  3. Fügen Sie die JAR-Datei des Thin Client für JAX-WS zum Klassenpfad hinzu. Fügen Sie die Datei Stammverzeichnis_des_Anwendungsservers/runtimes/com.ibm.jaxws.thinclient_8.5.0.jar zum Klassenpfad hinzu. Lesen Sie die Informationen zum Testen von Clients mit Unterstützung für Web Services, um zu erfahren, wie diese JAR-Datei zum Klassenpfad hinzugefügt wird.
  4. Fordern Sie das SAML-Token von einem externen STS an. Das folgende Codefragment veranschaulicht die Anforderung des SAML-Sender-Vouches-Tokens. Hierbei wird vorausgesetzt, dass ein externer STS so konfiguriert ist, dass er ein Benutzernamenstoken akzeptiert und nach der Validierung ein SAML-2.0-Token mit Sender-Vouches ausstellt.
    // SAML-Token von externem STS anfordern
    WSSFactory factory = WSSFactory.getInstance();
    String STS_URI  = "https://externalstsserverurl:port/TrustServerWST13/services/RequestSecurityToken";
    String ENDPOINT_URL = "http://localhost:9080/WSSampleSei/EchoService";
    WSSGenerationContext gencont1 = factory.newWSSGenerationContext();
    WSSConsumingContext concont1 = factory.newWSSConsumingContext();
    HashMap<Object, Object> cbackMap1 = new HashMap<Object, Object>();
    cbackMap1.put(SamlConstants.STS_ADDRESS, STS_URI);
    cbackMap1.put(SamlConstants.SAML_APPLIES_TO, ENDPOINT_URL);
    cbackMap1.put(SamlConstants.TRUST_CLIENT_WSTRUST_NAMESPACE, "http://docs.oasis-open.org/ws-sx/ws-trust/200512");
    cbackMap1.put(SamlConstants.TRUST_CLIENT_COLLECTION_REQUEST, "false");
    cbackMap1.put(SamlConstants.TOKEN_TYPE, WSSConstants.SAML.SAML11_VALUE_TYPE);
    cbackMap1.put(SamlConstants.CONFIRMATION_METHOD, "sender-vouches");
    
    SAMLGenerateCallbackHandler cbHandler1 = new SAMLGenerateCallbackHandler(cbackMap1);
    
    // UNT zur Trust-Anforderung hinzufügen
    UNTGenerateCallbackHandler utCallbackHandler = new UNTGenerateCallbackHandler("testuser", "testuserpwd");
    SecurityToken ut = factory.newSecurityToken(UsernameToken.class, utCallbackHandler);
    
    gencont1.add(ut);
    
    cbHandler1.setWSSConsumingContextForTrustClient(concont1);
    cbHandler1.setWSSGenerationContextForTrustClient(gencont1);
    SecurityToken samlToken = factory.newSecurityToken(SAMLToken.class, cbHandler1, "system.wss.generate.saml");
    
    System.out.println("SAMLToken id = " + samlToken.getId());
    1. Geben Sie mit der Methode WSSFactory newSecurityToken an, wie das SAML-Token von einem externen STS angefordert werden soll.
      Geben Sie folgende Methode an, um das SAML-Token zu erstellen:
      WSSFactory  newSecurityToken(SAMLToken.class, callbackHandler, "system.wss.generate.saml")
      Das Anfordern eines SAML-Tokens erfordert die Java-Sicherheitsberechtigung wssapi.SAMLTokenFactory.newSAMLToken. Verwenden Sie das Richtlinientool, um zu der Datei mit der Java-Sicherheitsrichtlinie oder der Datei was.policy des Anwendungsclients die folgende Richtlinienanweisung hinzuzufügen:
      permission java.security.SecurityPermission "wssapi.SAMLTokenFactory.newSAMLToken"

      Der Parameter SAMLToken.class gibt den Typ des zu erstellenden Sicherheitstokens an.

      Das Objekt callbackHandler enthält Parameter, die die Merkmale des anzufordernden SAML-Tokens definieren, und weitere Parameter, die erforderlich sind, um den STS zu erreichen und das SAML-Token anzufordern. Das Objekt SAMLGenerateCallbackHandler gibt die in der folgenden Tabelle beschriebenen Konfigurationsparameter an.
      Tabelle 1. Eigenschaften von SAMLGenerateCallbackHandler. In der folgenden Tabelle sind die Konfigurationsparameter für das Objekt SAMLGenerateCallbackHandler bei Verwendung der Bestätigungsmethode Sender-Vouches beschrieben.
      Eigenschaft Beschreibung Erforderlich
      SamlConstants.CONFIRMATION_METHOD Gibt an, dass die Bestätigungsmethode sender-vouches verwendet werden soll Ja
      SamlConstants.TOKEN_TYPE

      Gibt den Tokentyp an

      Wenn einem Web-Service-Client Richtliniensätze zugeordnet sind, wird diese Eigenschaft nicht von der Web-Services-Security-Laufzeit verwendet.

      Geben Sie den Tokenwerttyp mit dem Attribut valueType der tokenGenerator-Bindungskonfiguration an.

      Das Beispiel in dieser Prozedur nutzt ein SAML-1.1-Token. Sie können aber auch den Wert WSSConstants.SAML.SAML20_VALUE_TYPE verwenden.

      Ja
      SamlConstants.STS_ADDRESS

      Gibt die Adresse des Sicherheitstokenservice an

      In der Task in diesem Artikel ist der Wert dieser Eigenschaft beispielsweise auf https gesetzt, um anzugeben, dass die SAML-Tokenanforderung mit SSL geschützt werden soll.

      Sie müssen die Eigenschaft -Dcom.ibm.SSL.ConfigURL setzen, damit SSL verwendet werden kann, um die SAML-Tokenanforderung beim STS zu schützen.

      Ja
      SamlConstants.SAML_APPLIES_TO Gibt die Adresse des Ziel-STS an, an der Sie das SAML-Token verwenden möchten Nein
      SamlConstants.TRUST_CLIENT_COLLECTION_REQUEST Gibt an, ob beim STS ein einzelnes, in einem Element RequestSecurityToken (RST) eingeschlossenes Token angefordert werden soll oder eine Gruppe von RST-Elementen, die in nur einem Element RequestSecurityTokenCollection (RSTC) eingeschlossen sind.

      Standardmäßig wird ein Einzeltoken angefordert, das in einem Element RequestSecurityToken (RST) vom STS eingeschlossen ist.

      Wenn Sie für diese Eigenschaft den Wert true angeben, werden mehrere Token in einer Gruppe von RST-Elementen angefordert, die in einem einzelnen Element RequestSecurityTokenCollection (RSTC) vom STS eingeschlossen ist.

      Nein
      SamlConstants.TRUST_CLIENT_WSTRUST_NAMESPACE Gibt den in der WS-Trust-Anforderung enthaltenen WS-Trust-Namespace an

      Der Standardwert ist WSTrust 1.3.

      Nein

      Außerdem werden im Objekt SAMLGenerateCallbackHandler eine WSSGenerationContext-Instanz und eine WSSConsumingContext-Instanz definiert. Die WSSGenerationContext-Instanz muss ein Objekt UNTGenerateCallbackHandler mit Informationen zur Erstellung des Benutzernamenstokens enthalten, das Sie an den STS senden wollen.

      Der Parameter system.wss.generate.saml gibt das für die Erstellung des SAML-Tokens zu verwendende JAAS-Anmeldemodul (Java Authentication and Authorization Service) an. Sie müssen eine JVM-Eigenschaft angeben, um eine JAAS-Konfigurationsdatei mit der erforderlichen JAAS-Anmeldekonfiguration zu definieren. Beispiel:
      -Djava.security.auth.login.config=Profilstammverzeichnis/properties/wsjaas_client.conf 
      Alternativ können Sie eine Java-Systemeigenschaft im Beispielclientcode setzen, um eine JAAS-Anmeldekonfigurationsdatei anzugeben, z. B.
      System.setProperty("java.security.auth.login.config", "Profilstammverzeichnis/properties/wsjaas_client.conf");
    2. Fordern Sie die Token-ID des erstellten SAML-Tokens an.
      Verwenden Sie als einfachen Test für das von Ihnen erstellte SAML-Token die folgende Anweisung:
      System.out.println("SAMLToken id = " + samlToken.getId())
  5. Fügen Sie das SAML-Token zum SOAP-Sicherheitsheader von Web-Service-Anforderungsnachrichten hinzu.
    1. Initialisieren Sie den Web-Service-Client und konfigurieren Sie die SOAPAction-Eigenschaften. Diese Aktionen veranschaulicht das folgende Codebeispiel:
      // Web-Service-Client initialisieren
      EchoService12PortProxy echo = new EchoService12PortProxy();
      echo._getDescriptor().setEndpoint(endpointURL);
      
      // SOAPAction-Eigenschaften konfigurieren
      BindingProvider bp = (BindingProvider) (echo._getDescriptor().getProxy());
      Map<String, Object> requestContext = bp.getRequestContext();
      requestContext.put(BindingProvider.ENDPOINT_ADDRESS_PROPERTY, endpointURL);
      requestContext.put(BindingProvider.SOAPACTION_USE_PROPERTY,	Boolean.TRUE);
      requestContext.put(BindingProvider.SOAPACTION_URI_PROPERTY, "echoOperation");
      			
      // WSSGenerationContext initialisieren
      WSSGenerationContext gencont = factory.newWSSGenerationContext();
      gencont.add(samlToken);	
    2. Initialisieren Sie den WSSGenerationContext. Das folgende Codefragment veranschaulicht die Verwendung des gencont-Objekts vom Typ WSSGenerationContext für die Initialisierung eines Generierungskontexts für das Einfügen des SAMLToken in eine Web-Service-Anforderungsnachricht.
      // WSSGenerationContext initialisieren
      WSSGenerationContext gencont = factory.newWSSGenerationContext();
      gencont.add(samlToken);	
      Speziell der Methodenaufruf gencont.add(samlToken) gibt an, dass das SAML-Token in eine Anforderungsnachricht eingefügt werden soll. Diese Operation erfordert, dass der Clientcode über die folgende Java-2-Sicherheitsberechtigung verfügt:
       permission javax.security.auth.AuthPermission "modifyPrivateCredentials"
  6. Fügen Sie ein X.509-Token für den Nachrichtenschutz über die WSS-API hinzu.
    Im folgenden Beispielcode werden die Schlüsseldatei dsig-sender.ks und der Beispielschlüssel SOAPRequester verwendet. In einer Produktionsumgebung dürfen Sie den Beispielschlüssel nicht verwenden. Das folgende Codefragment veranschaulicht das Hinzufügen von eines X.509-Tokens für den Nachrichtenschutz.
    // X.509-Token für Nachrichtenschutz hinzufügen
        X509GenerateCallbackHandler x509callbackHandler = new X509GenerateCallbackHandler(
            	null, 
            		"Profilstammverzeichnis/etc/ws-security/samples/dsig-sender.ks",
            	"JKS", 
            	"client".toCharArray(), 
            	"soaprequester", 
            	"client".toCharArray(), 
            	"CN=SOAPRequester, OU=TRL, O=IBM, ST=Kanagawa, C=JP", null);
    
       SecurityToken x509 = factory.newSecurityToken(X509Token.class,
       x509callbackHandler, "system.wss.generate.x509");
    
       WSSSignature sig = factory.newWSSSignature(x509);
       sig.setSignatureMethod(WSSSignature.RSA_SHA1);
                    	
       WSSSignPart sigPart = factory.newWSSSignPart();
       sigPart.setSignPart(samlToken);
       	  sigPart.addTransform(WSSSignPart.TRANSFORM_STRT10);
       	  sig.addSignPart(sigPart);
       sig.addSignPart(WSSSignature.BODY);
    1. Erstellen Sie ein WSSSignature-Objekt mit dem X509-Token. Die folgende Codezeile erstellt ein WSSSignature-Objekt mit dem X509-Token:
      WSSSignature sig = factory.newWSSSignature(x509);
    2. Fügen Sie den signierten Teil für den Nachrichtenschutz hinzu. Die folgende Codezeile gibt an, dass WSSSignature.BODY als signierter Teil hinzugefügt werden soll:
      sig.addSignPart(WSSSignature.BODY);
    3. Fügen Sie zum Sicherheitsheader von SOAP-Nachrichten das Element timestamp hinzu. Die Richtliniensätze SAML20 SenderVouches WSHTTPS und SAML11 SenderVouches WSHTTPS erfordern, dass Web-Service-Anforderungsnachrichten und -Antwortnachrichten im Sicherheitsheader von SOAP-Nachrichten ein Element timestamp enthalten. Im folgenden Codefragment generiert der Methodenaufruf factory.newWSSTimestamp() die Zeitmarke (timestamp) und der Methodenaufruf gencont.add(timestamp) fügt die Zeitmarke in die Anforderungsnachricht ein:
      // Zeitmarke hinzufügen
      WSSTimestamp timestamp = factory.newWSSTimestamp();
         gencont.add(timestamp);
      sig.addSignPart(WSSSignature.TIMESTAMP);
                  
      gencont.add(sig);
              	
      			
      WSSConsumingContext concont = factory.newWSSConsumingContext();
    4. Konfigurieren Sie mit dem Umsetzungsalgorithmus STR-Transform die SAML-Tokensignatur.
      Zum Angeben des Umsetzungsalgorithmus SecurityTokenReference ist ein separater Teil WSSSignPart erforderlich, der vom Attribut WSSSignPart.TRANSFORM_STRT10 repräsentiert wird. Ein SAML-Token kann nicht direkt digital signiert werden. Mithilfe dieses Attributs kann die Web-Services-Security-Laufzeitumgebung ein Element SecurityTokenReference generieren, das auf das SAML-Token verweist und das Token mit der SecurityTokenReference-Umsetzung digital signiert. Die folgende Codezeile gibt an, dass das Attribut WSSSignPart.TRANSFORM_STRT10 verwendet werden soll:
      WSSSignPart sigPart = factory.newWSSSignPart();
      sigPart.setSignPart(samlToken);
      sigPart.addTransform(WSSSignPart.TRANSFORM_STRT10);
    5. Fügen Sie das Objekt WSSGenerationContext zum Web-Service-Objekt RequestContext hinzu. Das Objekt WSSGenerationContext enthält jetzt alle Sicherheitsinformationen, die für das Formatieren einer Anforderungsnachricht erforderlich sind. Der Methodenaufruf gencont.process(requestContext) ordnet das Objekt WSSGenerationContext dem Web-Service-Objekt RequestContext zu, damit die Web-Services-Security-Laufzeitumgebung den erforderlichen SOAP-Sicherheitsheader formatieren kann. Beispiel:
      // Objekt WSSGenerationContext zum Web-Service-Objekt RequestContext hinzufügen
      gencont.process(requestContext);
  7. Validieren Sie die digitale Signatur und die Integrität der Antwortnachricht mit dem X.509-Token. Falls die Providerrichtlinie vorschreibt, dass die Antwortnachricht digital signiert sein soll, müssen Sie das X.509-Token initialisieren.
    1. Ein Objekt X509ConsumeCallbackHandler wird mit einem Truststore, der Datei dsig-receiver.ks und einem Zertifikatspfadobjekt initialisiert, um die digitale Signatur des Providers zu validieren. Das Objekt X509ConsumeCallbackHandler wird mit der folgenden Codezeile initialisiert:
      X509ConsumeCallbackHandler callbackHandlerVer = new X509ConsumeCallbackHandler( 
       "Profilstammverzeichnis/etc/ws-security/samples/dsig-receiver.ks",
                "JKS",
                 "server".toCharArray(), 
                  certList, 
                        java.security.Security.getProvider("IBMCertPath"));
    2. Ein Verifizierungsobjekt WSSVerification wird erstellt, zu dem der Nachrichtenhauptteil hinzugefügt wird, damit die Web-Services-Security-Laufzeitumgebung die digitale Signatur validiert.
      Das Objekt WSSVerification wird mit der folgenden Codezeile initialisiert:
      WSSVerification ver = factory.newWSSVerification(X509Token.class, callbackHandlerVer);
      Das Objekt WSSConsumingContext enthält jetzt alle Sicherheitsinformationen, die für das Formatieren einer Anforderungsnachricht erforderlich sind. Der Methodenaufruf concont.process(requestContext) ordnet das Objekt WSSConsumingContext der Antwortmethode zu. Beispiel:
      // Objekt WSSConsumingContext zum Web-Service-Objekt RequestContext hinzufügen
      concont.process(requestContext);

Ergebnisse

Sie haben ein SAML-Token mit der Subjektbestätigungsmethode Sender-Vouches von einem externen STS angefordert. Das angeforderte Token haben Sie dann mit Web-Service-Anforderungsnachrichten mit Nachrichtenschutz über das JAX-WS-Programmiermodell und WSS-APIs gesendet.

Beispiel

Das folgende Codebeispiel ist eine vollständige, sofort einsatzfähige Web-Service-Clientanwendung, die veranschaulicht, wie ein SAML-Token von einem externen STS angefordert und in Web-Service-Anforderungsnachrichten mit Nachrichtenschutz gesendet wird. Dieser Beispielcode veranschaulicht die oben beschriebenen Prozedurschritte.

/**
 * Der folgende Quellcode ist von der IBM Corporation erstellter Beispielcode, der
 * mit der Einschränkung bereitgestellt wird, dass er nur zur Unterstützung für die Nutzung
 * der Technologie verwendet werden darf. Der Code wird ohne Wartung (auf "as-is"-Basis) und
 * ohne Gewährleistung zur Verfügung gestellt. IBM ist nicht haftbar für Schäden, die Ihnen aus
 * der Nutzung des Beispielcodes entstehen, selbst wenn IBM auf die Möglichkeit solche
 * Schäden hingewiesen wurde.
 */
package com.ibm.was.wssample.sei.cli;

import com.ibm.was.wssample.sei.echo.EchoService12PortProxy;
import com.ibm.was.wssample.sei.echo.EchoStringInput;
import com.ibm.websphere.wssecurity.callbackhandler.SAMLGenerateCallbackHandler;
import com.ibm.websphere.wssecurity.callbackhandler.UNTGenerateCallbackHandler;
import com.ibm.websphere.wssecurity.wssapi.token.UsernameToken;
import com.ibm.websphere.wssecurity.wssapi.WSSConsumingContext;
import com.ibm.websphere.wssecurity.wssapi.WSSFactory;
import com.ibm.websphere.wssecurity.wssapi.WSSGenerationContext;
import com.ibm.websphere.wssecurity.wssapi.WSSTimestamp;
import com.ibm.websphere.wssecurity.wssapi.token.SAMLToken;
import com.ibm.websphere.wssecurity.wssapi.token.SecurityToken;
import com.ibm.websphere.wssecurity.callbackhandler.X509ConsumeCallbackHandler;
import com.ibm.websphere.wssecurity.callbackhandler.X509GenerateCallbackHandler;
import com.ibm.websphere.wssecurity.wssapi.WSSException;
import com.ibm.websphere.wssecurity.wssapi.signature.WSSSignPart;
import com.ibm.websphere.wssecurity.wssapi.signature.WSSSignature;
import com.ibm.websphere.wssecurity.wssapi.verification.WSSVerification;
import com.ibm.websphere.wssecurity.wssapi.token.X509Token;
import com.ibm.wsspi.wssecurity.core.token.config.WSSConstants;
import com.ibm.wsspi.wssecurity.saml.config.SamlConstants;

import java.io.FileInputStream;
import java.io.FileNotFoundException;
import java.io.InputStream;
import java.security.InvalidAlgorithmParameterException;
import java.security.NoSuchAlgorithmException;
import java.security.NoSuchProviderException;
import java.security.cert.CertStore;
import java.security.cert.CertificateException;
import java.security.cert.CertificateFactory;
import java.security.cert.CollectionCertStoreParameters;
import java.security.cert.X509Certificate;
import java.util.HashSet;
import java.util.Set;
import java.util.HashMap;
import java.util.Map;

import javax.xml.ws.BindingProvider;

public class SampleSamlSVClient {
		private String urlHost = "localhost";
		private String urlPort = "9080";
	private static final String CONTEXT_BASE = "/WSSampleSei/";
	private static final String ECHO_CONTEXT12 = CONTEXT_BASE+"EchoService12";  
	private String message = "HELLO";
		private String uriString = "http://" + urlHost + ":" + urlPort;
	private String endpointURL = uriString + ECHO_CONTEXT12;
	private String input = message;

	/**
	 * main()
	 * 
	 * Befehlszeilenargumente siehe printusage()
	 * 
	 * @param args
	 */
	public static void main(String[] args) {
		SampleSamlSVClient sample = new SampleSamlSVClient();
		sample.CallService();
	}

	/**
	 	 * CallService-Parameter wurden gelesen. Jetzt können die Serviceproxyklassen aufgerufen werden.
	 * 
	 */
	void CallService() {
		String response = "ERROR!:";
		try  {    
			    			    System.setProperty("com.ibm.SSL.ConfigURL", "Profilstammverzeichnis/properties/ssl.client.props");
			    			    System.setProperty("java.security.auth.login.config", "Profilstammverzeichnis/properties/wsjaas.conf");			

// SAML-Token von externem STS anfordern
WSSFactory factory = WSSFactory.getInstance();
String STS_URI  = "https://externalstsserverurl:port/TrustServerWST13/services/RequestSecurityToken";
String ENDPOINT_URL = "http://localhost:9080/WSSampleSei/EchoService";
WSSGenerationContext gencont1 = factory.newWSSGenerationContext();
WSSConsumingContext concont1 = factory.newWSSConsumingContext();
HashMap<Object, Object> cbackMap1 = new HashMap<Object, Object>();
cbackMap1.put(SamlConstants.STS_ADDRESS, STS_URI);
cbackMap1.put(SamlConstants.SAML_APPLIES_TO, ENDPOINT_URL);
cbackMap1.put(SamlConstants.TRUST_CLIENT_WSTRUST_NAMESPACE, "http://docs.oasis-open.org/ws-sx/ws-trust/200512");
cbackMap1.put(SamlConstants.TRUST_CLIENT_COLLECTION_REQUEST, "false");
cbackMap1.put(SamlConstants.TOKEN_TYPE, WSSConstants.SAML.SAML11_VALUE_TYPE);
cbackMap1.put(SamlConstants.CONFIRMATION_METHOD, "sender-vouches");

SAMLGenerateCallbackHandler cbHandler1 = new SAMLGenerateCallbackHandler(cbackMap1);

// UNT zur Trust-Anforderung hinzufügen
UNTGenerateCallbackHandler utCallbackHandler = new UNTGenerateCallbackHandler("testuser", "testuserpwd");
SecurityToken ut = factory.newSecurityToken(UsernameToken.class, utCallbackHandler);

gencont1.add(ut);

cbHandler1.setWSSConsumingContextForTrustClient(concont1);
cbHandler1.setWSSGenerationContextForTrustClient(gencont1);
SecurityToken samlToken = factory.newSecurityToken(SAMLToken.class, cbHandler1, "system.wss.generate.saml");

System.out.println("SAMLToken id = " + samlToken.getId());
			
	        	        // Web-Service-Client initialisieren
			EchoService12PortProxy echo = new EchoService12PortProxy();
			echo._getDescriptor().setEndpoint(endpointURL);

			// SOAPAction-Eigenschaften konfigurieren
			BindingProvider bp = (BindingProvider) (echo._getDescriptor().getProxy());
			Map<String, Object> requestContext = bp.getRequestContext();
			requestContext.put(BindingProvider.ENDPOINT_ADDRESS_PROPERTY, endpointURL);
			requestContext.put(BindingProvider.SOAPACTION_USE_PROPERTY,	Boolean.TRUE);
			requestContext.put(BindingProvider.SOAPACTION_URI_PROPERTY, "echoOperation");
			
			// WSSGenerationContext initialisieren
			WSSGenerationContext gencont = factory.newWSSGenerationContext();
	        gencont.add(samlToken);		        
	        // X.509-Token für Nachrichtenschutz hinzufügen
            X509GenerateCallbackHandler x509callbackHandler = new X509GenerateCallbackHandler(
        			null, 
        				"Profilstammverzeichnis/etc/ws-security/samples/dsig-sender.ks",
        			"JKS", 
        			"client".toCharArray(), 
        			"soaprequester", 
        			"client".toCharArray(), 
        			"CN=SOAPRequester, OU=TRL, O=IBM, ST=Kanagawa, C=JP", null);

            SecurityToken x509 = factory.newSecurityToken(X509Token.class,
            x509callbackHandler, "system.wss.generate.x509");

            WSSSignature sig = factory.newWSSSignature(x509);
            sig.setSignatureMethod(WSSSignature.RSA_SHA1);
                	
            WSSSignPart sigPart = factory.newWSSSignPart();
            sigPart.setSignPart(samlToken);
            	  sigPart.addTransform(WSSSignPart.TRANSFORM_STRT10);
            	  sig.addSignPart(sigPart);
            sig.addSignPart(WSSSignature.BODY);
            
	        // Zeitmarke hinzufügen
	        WSSTimestamp timestamp = factory.newWSSTimestamp();
			gencont.add(timestamp);
        	sig.addSignPart(WSSSignature.TIMESTAMP);
            
        	gencont.add(sig);
        	
			
        	WSSConsumingContext concont = factory.newWSSConsumingContext();
        	
        		// Verarbeitung der Zeitmarke in der Antwortnachricht vorbereiten
	     	concont.add(WSSConsumingContext.TIMESTAMP); 
	        
	     		     	// Verfizierung der digitalen Signatur in der Antwortnachricht vorbereiten
	        X509Certificate x509cert = null;
	        try  {    
	                	                InputStream is = new FileInputStream("Profilstammverzeichnis/etc/ws-security/samples/intca2.cer");
	                CertificateFactory cf = CertificateFactory.getInstance("X.509");
	                	                x509cert = (X509Certificate) cf.generateCertificate(is);
	        } catch(FileNotFoundException e1){
	                throw new WSSException(e1);
	        } catch (CertificateException e2) {
	                throw new WSSException(e2);
	        }
	        Set<Object> eeCerts = new HashSet<Object>();
	        eeCerts.add(x509cert);  

	        	  java.util.List<CertStore> certList = new java.util.ArrayList<CertStore>();
	        	        CollectionCertStoreParameters certparam = new CollectionCertStoreParameters(eeCerts);

	        CertStore cert = null;
	        try  {    
	                	                cert = CertStore.getInstance("Collection", certparam, "IBMCertPath");
	        } catch (NoSuchProviderException e1) {
	                throw new WSSException(e1);
	        } catch (InvalidAlgorithmParameterException e2) {
	                throw new WSSException(e2);
	        } catch (NoSuchAlgorithmException e3) {
	                	                throw new WSSException(e3);
	        }
	        if(certList != null ){
	                certList.add(cert);
	        }

	        X509ConsumeCallbackHandler callbackHandlerVer = new X509ConsumeCallbackHandler( 
	        			        		"Profilstammverzeichnis/etc/ws-security/samples/dsig-receiver.ks",
	        		"JKS",
	        		"server".toCharArray(), 
	        		certList, 
	        			        		java.security.Security.getProvider("IBMCertPath"));

	        	        WSSVerification ver = factory.newWSSVerification(X509Token.class, callbackHandlerVer);

	        	        ver.addRequiredVerifyPart(WSSVerification.BODY);
	        concont.add(ver);
						
	        gencont.process(requestContext);
	        concont.process(requestContext);
	        
	        // Eingabeobjekt erstellen
			EchoStringInput echoParm = 
				new com.ibm.was.wssample.sei.echo.ObjectFactory().createEchoStringInput();
			echoParm.setEchoInput(input);
			System.out.println(">> CLIENT: SEI Echo to " + endpointURL);		
						
			// Service aufrufen
			response = echo.echoOperation(echoParm).getEchoResponse();
						
			System.out.println(">> CLIENT: SEI Echo invocation complete.");
			System.out.println(">> CLIENT: SEI Echo response is: " + response);
		} catch (Exception e)  {
			System.out.println(">> CLIENT: ERROR: SEI Echo EXCEPTION.");
			e.printStackTrace();
		}
	}
}
Wenn diese Beispiel-Web-Service-Clientanwendung ordnungsgemäß ausgeführt wird, empfangen Sie Nachrichten wie die folgenden:
SAMLToken id = _6CDDF0DBF91C044D211271166233407
Retrieving document at 'file:Profilstammverzeichnis/.../wsdl/'.
>> CLIENT: SEI Echo to http://localhost:9443/WSSampleSei/EchoService12
>> CLIENT: SEI Echo invocation complete.
>> CLIENT: SEI Echo response is: SOAP12==>>HELLO

Symbol, das den Typ des Artikels anzeigt. Taskartikel



Symbol für Zeitmarke Letzte Aktualisierung: 25.05.2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=twbs_configsamlsendervouches_msglevel_requeststs
Dateiname:twbs_configsamlsendervouches_msglevel_requeststs.html