Module org.codelibs.saml2.core

Package org.codelibs.saml2.core.authn

Class AuthnRequest

java.lang.Object

org.codelibs.saml2.core.authn.AuthnRequest

public class AuthnRequest
extends Object

AuthNRequest class of Java Toolkit. A class that implements SAML 2 Authentication Request

Constructor Summary

Constructors

Constructor	Description
AuthnRequest(Saml2Settings settings)	Constructs the AuthnRequest object.
AuthnRequest(Saml2Settings settings, boolean forceAuthn, boolean isPassive, boolean setNameIdPolicy)	Deprecated. use AuthnRequest(Saml2Settings, AuthnRequestParams) with AuthnRequestParams(boolean, boolean, boolean) instead
AuthnRequest(Saml2Settings settings, boolean forceAuthn, boolean isPassive, boolean setNameIdPolicy, String nameIdValueReq)	Deprecated. use AuthnRequest(Saml2Settings, AuthnRequestParams) with AuthnRequestParams(boolean, boolean, boolean, String) instead
AuthnRequest(Saml2Settings settings, AuthnRequestParams params)	Constructs the AuthnRequest object.

Method Summary

Modifier and Type	Method	Description
String	getAuthnRequestXml()
String	getEncodedAuthnRequest()
String	getEncodedAuthnRequest(Boolean deflated)
String	getId()
Calendar	getIssueInstant()	Returns the issue instant of this message.
protected String	postProcessXml(String authnRequestXml, AuthnRequestParams params, Saml2Settings settings)	Allows for an extension class to post-process the AuthnRequest XML generated for this request, in order to customize the result.

Methods inherited from class java.lang.Object

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

Constructor Details

AuthnRequest

public AuthnRequest(Saml2Settings settings)

Constructs the AuthnRequest object.

Parameters:

settings - OneLogin_Saml2_Settings

See Also:

• AuthnRequest(Saml2Settings, AuthnRequestParams)

AuthnRequest

@Deprecated
public AuthnRequest(Saml2Settings settings,
 boolean forceAuthn,
 boolean isPassive,
 boolean setNameIdPolicy,
 String nameIdValueReq)

Deprecated.

use AuthnRequest(Saml2Settings, AuthnRequestParams) with AuthnRequestParams(boolean, boolean, boolean, String) instead

Constructs the AuthnRequest object.

Parameters:

settings - OneLogin_Saml2_Settings

forceAuthn - When true the AuthNReuqest will set the ForceAuthn='true'

isPassive - When true the AuthNReuqest will set the IsPassive='true'

setNameIdPolicy - When true the AuthNReuqest will set a nameIdPolicy

nameIdValueReq - Indicates to the IdP the subject that should be authenticated

AuthnRequest

@Deprecated
public AuthnRequest(Saml2Settings settings,
 boolean forceAuthn,
 boolean isPassive,
 boolean setNameIdPolicy)

Deprecated.

use AuthnRequest(Saml2Settings, AuthnRequestParams) with AuthnRequestParams(boolean, boolean, boolean) instead

Constructs the AuthnRequest object.

Parameters:

settings - OneLogin_Saml2_Settings

forceAuthn - When true the AuthNReuqest will set the ForceAuthn='true'

isPassive - When true the AuthNReuqest will set the IsPassive='true'

setNameIdPolicy - When true the AuthNReuqest will set a nameIdPolicy

AuthnRequest

public AuthnRequest(Saml2Settings settings,
 AuthnRequestParams params)

Constructs the AuthnRequest object.

Parameters:

settings - OneLogin_Saml2_Settings

params - a set of authentication request input parameters that shape the request to create

Method Details

postProcessXml

protected String postProcessXml(String authnRequestXml,
 AuthnRequestParams params,
 Saml2Settings settings)

Allows for an extension class to post-process the AuthnRequest XML generated for this request, in order to customize the result.

This method is invoked at construction time, after all the other fields of this class have already been initialised. Its default implementation simply returns the input XML as-is, with no change.

Parameters:

authnRequestXml - the XML produced for this AuthnRequest by the standard implementation provided by AuthnRequest

params - the authentication request input parameters

settings - the settings

Returns:

the post-processed XML for this AuthnRequest, which will then be returned by any call to getAuthnRequestXml()

getEncodedAuthnRequest

public String getEncodedAuthnRequest(Boolean deflated)

Parameters:

deflated - If deflated or not the encoded AuthnRequest

Returns:

the base64 encoded unsigned AuthnRequest (deflated or not)

getEncodedAuthnRequest

public String getEncodedAuthnRequest()

Returns:

base64 encoded, unsigned AuthnRequest (deflated or not)

getAuthnRequestXml

public String getAuthnRequestXml()

Returns:

unsigned plain-text AuthnRequest.

getId

public String getId()

Returns:

the generated id of the AuthnRequest message

getIssueInstant

public Calendar getIssueInstant()

Returns the issue instant of this message.

Returns:

a new Calendar instance carrying the issue instant of this message