Package com.sun.identity.saml2.protocol

Interface RequestAbstract

All Superinterfaces:

XmlSerializable

All Known Subinterfaces:

ArtifactResolve, AssertionIDRequest, AttributeQuery, AuthnQuery, AuthnRequest, LogoutRequest, ManageNameIDRequest, NameIDMappingRequest, SubjectQueryAbstract, XACMLAuthzDecisionQuery

All Known Implementing Classes:

com.sun.identity.saml2.protocol.impl.RequestAbstractImpl, XACMLAuthzDecisionQueryImpl

@SupportedAll
public interface RequestAbstract
extends XmlSerializable

This interface defines methods for setting and retrieving attributes and elements associated with a SAML request message used in SAML protocols.

Method Summary

Modifier and Type	Method	Description
String	getConsent()	Returns the value of the Consent attribute.
String	getDestination()	Returns the value of the Destination attribute.
Extensions	getExtensions()	Returns the Extensions Object.
String	getID()	Returns the value of the ID attribute.
Date	getIssueInstant()	Returns the value of IssueInstant attribute.
Issuer	getIssuer()	Returns the Issuer Object.
String	getSignature()	Returns the Signature Object as a string.
String	getVersion()	Returns the value of the Version attribute.
boolean	isMutable()	Returns true if object is mutable.
boolean	isSignatureValid(Set<X509Certificate> verificationCerts)	Return whether the signature is valid or not.
boolean	isSigned()	Returns true if message is signed.
void	makeImmutable()	Makes this object immutable.
void	setConsent(String consent)	Sets the value of the Consent attribute.
void	setDestination(String destinationURI)	Sets the value of the Destination attribute.
void	setExtensions(Extensions extensions)	Sets the Extensions Object.
void	setID(String id)	Sets the value of the ID attribute.
void	setIssueInstant(Date dateTime)	Sets the value of IssueInstant attribute.
void	setIssuer(Issuer nameID)	Sets the Issuer object.
void	setVersion(String version)	Sets the value of the Version attribute.
void	sign(org.forgerock.openam.saml2.crypto.signing.SigningConfig signingConfig)	Signs the Request.

Methods inherited from interface com.sun.identity.saml2.common.XmlSerializable

toDocumentFragment, toXMLString, toXMLString

Method Detail

setIssuer

void setIssuer(Issuer nameID)
        throws SAML2Exception

Sets the Issuer object.

Parameters:

nameID - the new Issuer object.

Throws:

SAML2Exception - if the object is immutable.

See Also:

getIssuer()

getIssuer

Issuer getIssuer()

Returns the Issuer Object.

Returns:

the Issuer object.

See Also:

setIssuer(Issuer)

getSignature

String getSignature()

Returns the Signature Object as a string.

Returns:

the Signature object as a string.

sign

void sign(org.forgerock.openam.saml2.crypto.signing.SigningConfig signingConfig)
   throws SAML2Exception

Signs the Request.

Parameters:

signingConfig - The signing configuration.

Throws:

SAML2Exception - if it could not sign the Request.

setExtensions

void setExtensions(Extensions extensions)
            throws SAML2Exception

Sets the Extensions Object.

Parameters:

extensions - the Extensions object.

Throws:

SAML2Exception - if the object is immutable.

See Also:

getExtensions()

getExtensions

Extensions getExtensions()

Returns the Extensions Object.

Returns:

the Extensions object.

See Also:

setExtensions(Extensions)

setID

void setID(String id)
    throws SAML2Exception

Sets the value of the ID attribute.

Parameters:

id - the new value of ID attribute.

Throws:

SAML2Exception - if the object is immutable.

See Also:

getID()

getID

String getID()

Returns the value of the ID attribute.

Returns:

the value of ID attribute.

See Also:

setID(String)

setVersion

void setVersion(String version)
         throws SAML2Exception

Sets the value of the Version attribute.

Parameters:

version - the value of Version attribute.

Throws:

SAML2Exception - if the object is immutable.

See Also:

getVersion()

getVersion

String getVersion()

Returns the value of the Version attribute.

Returns:

value of Version attribute.

See Also:

setVersion(String)

setIssueInstant

void setIssueInstant(Date dateTime)
              throws SAML2Exception

Sets the value of IssueInstant attribute.

Parameters:

dateTime - new value of the IssueInstant attribute.

Throws:

SAML2Exception - if the object is immutable.

See Also:

getIssueInstant()

getIssueInstant

Date getIssueInstant()

Returns the value of IssueInstant attribute.

Returns:

value of the IssueInstant attribute.

See Also:

setIssueInstant(Date)

setDestination

void setDestination(String destinationURI)
             throws SAML2Exception

Sets the value of the Destination attribute.

Parameters:

destinationURI - new value of Destination attribute.

Throws:

SAML2Exception - if the object is immutable.

See Also:

getDestination()

getDestination

String getDestination()

Returns the value of the Destination attribute.

Returns:

the value of Destination attribute.

See Also:

setDestination(String)

setConsent

void setConsent(String consent)
         throws SAML2Exception

Sets the value of the Consent attribute.

Parameters:

consent - new value of Consent attribute.

Throws:

SAML2Exception - if the object is immutable.

See Also:

getConsent()

getConsent

String getConsent()

Returns the value of the Consent attribute.

Returns:

value of Consent attribute.

See Also:

setConsent(String)

isSigned

boolean isSigned()

Returns true if message is signed.

Returns:

true if message is signed.

isSignatureValid

boolean isSignatureValid(Set<X509Certificate> verificationCerts)
                  throws SAML2Exception

Return whether the signature is valid or not.

Parameters:

verificationCerts - Certificates containing the public keys which may be used for signature verification; This certificate may also may be used to check against the certificate included in the signature.

Returns:

true if the signature is valid; false otherwise.

Throws:

SAML2Exception - if the signature could not be verified

makeImmutable

void makeImmutable()

Makes this object immutable.

isMutable

boolean isMutable()

Returns true if object is mutable.

Returns:

true if object is mutable.