com.nimbusds.oauth2.sdk.assertions.saml2

Class SAML2AssertionFactory

java.lang.Object

com.nimbusds.oauth2.sdk.assertions.saml2.SAML2AssertionFactory

@ThreadSafe
public class SAML2AssertionFactory
extends java.lang.Object

Static SAML 2.0 bearer assertion factory.

Related specifications:

• Assertion Framework for OAuth 2.0 Client Authentication and Authorization Grants (RFC 7521).
• Security Assertion Markup Language (SAML) 2.0 Profile for OAuth 2.0 Client Authentication and Authorization Grants (RFC 7522).

Method Summary

Modifier and Type	Method and Description
static org.opensaml.saml2.core.Assertion	create(SAML2AssertionDetails details, java.lang.String xmlDsigAlg, org.opensaml.xml.security.credential.Credential credential) Creates a new SAML 2.0 assertion.
static org.w3c.dom.Element	createAsElement(SAML2AssertionDetails details, java.lang.String xmlDsigAlg, org.opensaml.xml.security.credential.Credential credential) Creates a new SAML 2.0 assertion as an XML element.
static java.lang.String	createAsString(SAML2AssertionDetails details, java.security.interfaces.RSAPrivateKey rsaPrivateKey) Creates a new SAML 2.0 assertion as an XML string, signed with the RSA-SHA256 XML digital signature algorithm (mandatory to implement).
static java.lang.String	createAsString(SAML2AssertionDetails details, java.lang.String xmlDsigAlg, org.opensaml.xml.security.credential.Credential credential) Creates a new SAML 2.0 assertion as an XML string.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

create

public static org.opensaml.saml2.core.Assertion create(SAML2AssertionDetails details,
                                                       java.lang.String xmlDsigAlg,
                                                       org.opensaml.xml.security.credential.Credential credential)

Creates a new SAML 2.0 assertion.

Parameters:

details - The SAML 2.0 bearer assertion details. Must not be null.

xmlDsigAlg - The XML digital signature algorithm. Must not be null.

credential - The appropriate credentials to facilitate signing of the assertion.

Returns:

The SAML 2.0 bearer assertion.

Throws:

SerializeException - If serialisation or signing failed.

createAsElement

public static org.w3c.dom.Element createAsElement(SAML2AssertionDetails details,
                                                  java.lang.String xmlDsigAlg,
                                                  org.opensaml.xml.security.credential.Credential credential)

Creates a new SAML 2.0 assertion as an XML element.

Parameters:

details - The SAML 2.0 bearer assertion details. Must not be null.

xmlDsigAlg - The XML digital signature algorithm. Must not be null.

credential - The appropriate credentials to facilitate signing of the assertion.

Returns:

The SAML 2.0 bearer assertion as an XML element.

Throws:

SerializeException - If serialisation or signing failed.

createAsString

public static java.lang.String createAsString(SAML2AssertionDetails details,
                                              java.lang.String xmlDsigAlg,
                                              org.opensaml.xml.security.credential.Credential credential)

Creates a new SAML 2.0 assertion as an XML string.

Parameters:

details - The SAML 2.0 bearer assertion details. Must not be null.

xmlDsigAlg - The XML digital signature algorithm. Must not be null.

credential - The appropriate credentials to facilitate signing of the assertion.

Returns:

The SAML 2.0 bearer assertion as an XML string. Note that an XML declaration is not present in the output string.

Throws:

SerializeException - If serialisation or signing failed.

createAsString

public static java.lang.String createAsString(SAML2AssertionDetails details,
                                              java.security.interfaces.RSAPrivateKey rsaPrivateKey)

Creates a new SAML 2.0 assertion as an XML string, signed with the RSA-SHA256 XML digital signature algorithm (mandatory to implement).

Parameters:

details - The SAML 2.0 bearer assertion details. Must not be null.

rsaPrivateKey - The private RSA key to sign the assertion. Must not be null.

Returns:

The SAML 2.0 bearer assertion as an XML string. Note that an XML declaration is not present in the output string.

Throws:

SerializeException - If serialisation or signing failed.