SAML-Attribute über WSS-APIs einfügen

Sie können angepasste Attribute über das JAX-WS-Programmiermodell (Java™ API for XML-Based Web Services) und WSS-APIs (Web Services Security APIs) in selbst ausgestellte SAML-Token einfügen.

Vorbereitende Schritte

Für diese Task müssen Sie mit dem Programmiermodell JAX-WS, den WSS-APIs, mit SAML-Konzepten sowie mit Richtliniensätzen zum Konfigurieren und Verwalten von Web-Service-Einstellungen vertraut sein. Gehen Sie wie folgt vor, bevor Sie mit dieser Task beginnen:
  • Lesen Sie die Informationen zur Weitergabe von selbst ausgestellten SAML-Bearer-Token über WSS-APIs.
  • Lesen Sie die Informationen zur Weitergabe von selbst ausgestellten SAML-Sender-Vouches-Token über WSS-APIs mit Nachrichtenschutz.
  • Lesen Sie die Informationen zur Weitergabe von selbst ausgestellten SAML-Sender-Vouches-Token über WSS-APIs mit SSL-Transportschutz.
  • Lesen Sie die Informationen zur Weitergabe von selbst ausgestellten SAML-HoK-Token mit symmetrischem Schlüssel über WSS-APIs.
  • Lesen Sie die Informationen zur Weitergabe von selbst ausgestellten SAML-HoK-Token mit asymmetrischem Schlüssel über WSS-APIs.

Informationen zu diesem Vorgang

Diese Task zeigt Beispielcode, der angepasste Attribute in selbst ausgestellte SAML-Sicherheitstoken einfügt. Dieses Beispiel verwendet die Subjektbestätigungsmethode "Bearer". Sie können Attribute zu SAML-Sicherheitstoken hinzufügen, und derselbe Code kann mit anderen Subjektbestätigungsmethoden verwendet werden.

Vorgehensweise

Fügen Sie beim Erstellen angepasster Attribute SAML-Sicherheitstoken ein, z. B.:
import com.ibm.websphere.wssecurity.wssapi.token.SecurityToken;
import com.ibm.websphere.wssecurity.callbackhandler.SAMLGenerateCallbackHandler;
import com.ibm.websphere.wssecurity.wssapi.token.SAMLToken;
import com.ibm.wsspi.wssecurity.core.token.config.WSSConstants;
import com.ibm.wsspi.wssecurity.saml.config.SamlConstants;
import com.ibm.wsspi.wssecurity.saml.data.SAMLAttribute;

WSSFactory factory = WSSFactory.getInstance();
HashMap<Object, Object> map = new HashMap<Object, Object>();
map.put(SamlConstants.CONFIRMATION_METHOD, "Bearer");
map.put(SamlConstants.Token_REQUEST, "issue");
map.put(SamlConstants.TOKEN_TYPE, WSSConstants.SAML.SAML20_VALUE_TYPE);
	map.put(SamlConstants.SAML_NAME_IDENTIFIER, "Alice");
			map.put(SamlConstants.SIGNATURE_REQUIRED, "true");			
ArrayList<SAMLAttribute> al = new ArrayList<SAMLAttribute>();
String groups[] = {"IBMer", "Texan"};
SAMLAttribute sattribute = new SAMLAttribute("Membership", groups, null,null, null, null);
al.add(sattribute);
String gender[] = {"Female"};
sattribute = new SAMLAttribute("Gender", gender, null,null, null, null);
al.add(sattribute);
map.put(SamlConstants.SAML_ATTRIBUTES, al);
			SAMLGenerateCallbackHandler callbackHandler = new SAMLGenerateCallbackHandler(map);				
	        SecurityToken samlToken = factory.newSecurityToken(SAMLToken.class, callbackHandler, "system.wss.generate.saml");

Ergebnisse

Sie haben angepasste Attribute in ein SAML-Sicherheitstoken eingefügt.

Beispiel

Das folgende Beispiel veranschaulicht die angepassten Attribute in der SAML-Zusicherung (Assertion):
<saml2:Assertion xmlns:saml2="urn:oasis:names:tc:SAML:2.0:assertion"
				              				              Version="2.0"
                       ID="_E62A1CA3C2F21D9A9B1287772824570"
                       IssueInstant="2010-10-22T18:40:24.531Z">
    <saml2:Issuer>example.com</samls2:Issuer>
    <ds:Signature xmlns:ds="http://www.w3.org/2000/09/xmldsig#">
    ...
    </ds:Signature>
    <saml2:Subject>
        <saml2:NameID>Alice</saml2:NameID>
        <saml2:SubjectConfirmation Method="urn:oasis:names:tc:SAML:2.0:cm:bearer"></saml2:SubjectConfirmation>
    </saml2:Subject>
    <saml2:Conditions NotBefore="2010-10-22T18:40:24.531Z"
		                  		                  NotOnOrAfter="2010-10-22T19:40:24.531Z">
    </saml2:Conditions>
    <saml2:AttributeStatement>
        <saml2:Attribute Name="Membership">
            <saml2:AttributeValue>IBMer</saml2:AttributeValue>
            <saml2:AttributeValue>Texan</saml2:AttributeValue>
        </saml2:Attribute>
        <saml2:Attribute Name="Gender">
            <saml2:AttributeValue>Female</saml2:AttributeValue>
        </saml2:Attribute>
    </saml2:AttributeStatement>
</saml2:Assertion>

Nächste Schritte

Fassen Sie den Code mit dem Beispielcode, der im Artikel "Selbst ausgestellte SAML-Bearer-Token über WSS-APIs weitergeben" aufgelistet ist, zusammen, um SAML-Sicherheitstoken zu generieren. Sie können SAML-Attribute in den SAML-Zusicherungen sehen.

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_configsaml_insert_attributes_usingwssapi
Dateiname:twbs_configsaml_insert_attributes_usingwssapi.html