Top Description Fields Constructors Methods
jakarta.security.enterprise.authentication.mechanism.http

public Class AuthenticationParameters

extends Object
Class Inheritance
Imports
jakarta.security.enterprise.credential.Credential, jakarta.security.enterprise.identitystore.RememberMeIdentityStore

Parameters that are provided along with an authentication request.

Field Summary

Modifier and TypeField and Description
private Credential
private boolean
private boolean

Constructor Summary

AccessConstructor and Description
public

Method Summary

Modifier and TypeMethod and Description
public AuthenticationParameters

Returns:

the instance of AuthenticationParameters on which this call was made, useful for a fluent/builder style creation of parameters.
credential
(Credential
the credential to be used by the authentication mechanism
credential
)

Sets the credential to be used by the authentication mechanism responding to the authenticate call in which these AuthenticationParameters are passed.

public Credential

Returns:

the credential set as parameter in this instance
getCredential
()

The credential set as parameter in this instance.

public boolean

Returns:

whether a new authentication dialog is required.
isNewAuthentication
()

Whether a new authentication dialog is required.

public boolean

Returns:

whether "remember me" should be used.
isRememberMe
()

Whether "remember me" should be used.

public AuthenticationParameters

Returns:

the instance of AuthenticationParameters on which this call was made, useful for a fluent/builder style creation of parameters.
newAuthentication
(boolean
whether a new authentication dialog is required to be started.
newAuthentication
)

Signal to the authentication mechanism responding to the authenticate call in which these AuthenticationParameters are passed, that an explicit new authentication dialog is required, as opposed to continuing a potentially existing one.

public AuthenticationParameters

Returns:

the instance of AuthenticationParameters on which this call was made, useful for a fluent/builder style creation of parameters.
rememberMe
(boolean
if true the "remember me" feature will be used if authentication succeeds and if so configured.
rememberMe
)

Signals that for this call to the authentication mechanism "remember me" should be applied, IFF the "remember me" feature is configured for the authentication mechanism responding to the authenticate call.

public void
setCredential(Credential
the credential to be set as parameter in this instance.
credential
)

Sets the credential as parameter in this instance.

public void
setNewAuthentication(boolean
whether a new authentication dialog is required
newAuthentication
)

Sets whether a new authentication dialog is required.

public void
setRememberMe(boolean
whether "remember me" should be used.
rememberMe
)

Sets whether "remember me" should be used.

public static AuthenticationParameters

Returns:

a new AuthenticationParameters instance.
withParams
()

Creates a new instance of AuthenticationParameters, useful for a fluent/builder style creation of parameters.

Inherited from java.lang.Object:
cloneequalsfinalizegetClasshashCodenotifynotifyAlltoStringwaitwaitwait

Field Detail

credentialback to summary
private Credential credential
newAuthenticationback to summary
private boolean newAuthentication
rememberMeback to summary
private boolean rememberMe

Constructor Detail

AuthenticationParametersback to summary
public AuthenticationParameters()

Method Detail

credentialback to summary
public AuthenticationParameters credential(Credential credential)

Sets the credential to be used by the authentication mechanism responding to the authenticate call in which these AuthenticationParameters are passed.

Parameters
credential:Credential

the credential to be used by the authentication mechanism

Returns:AuthenticationParameters

the instance of AuthenticationParameters on which this call was made, useful for a fluent/builder style creation of parameters.

getCredentialback to summary
public Credential getCredential()

The credential set as parameter in this instance.

Returns:Credential

the credential set as parameter in this instance

See Also
AuthenticationParameters#credential(Credential)
isNewAuthenticationback to summary
public boolean isNewAuthentication()

Whether a new authentication dialog is required.

Returns:boolean

whether a new authentication dialog is required.

See Also
AuthenticationParameters#newAuthentication(boolean)
isRememberMeback to summary
public boolean isRememberMe()

Whether "remember me" should be used.

Returns:boolean

whether "remember me" should be used.

See Also
AuthenticationParameters#rememberMe(boolean)
newAuthenticationback to summary
public AuthenticationParameters newAuthentication(boolean newAuthentication)

Signal to the authentication mechanism responding to the authenticate call in which these AuthenticationParameters are passed, that an explicit new authentication dialog is required, as opposed to continuing a potentially existing one.

Parameters
newAuthentication:boolean

whether a new authentication dialog is required to be started.

Returns:AuthenticationParameters

the instance of AuthenticationParameters on which this call was made, useful for a fluent/builder style creation of parameters.

rememberMeback to summary
public AuthenticationParameters rememberMe(boolean rememberMe)

Signals that for this call to the authentication mechanism "remember me" should be applied, IFF the "remember me" feature is configured for the authentication mechanism responding to the authenticate call.

If "remember me" is not configured, this parameter is silently ignored.

Parameters
rememberMe:boolean

if true the "remember me" feature will be used if authentication succeeds and if so configured.

Returns:AuthenticationParameters

the instance of AuthenticationParameters on which this call was made, useful for a fluent/builder style creation of parameters.

See Also
RememberMe, RememberMeIdentityStore
setCredentialback to summary
public void setCredential(Credential credential)

Sets the credential as parameter in this instance.

Parameters
credential:Credential

the credential to be set as parameter in this instance.

See Also
AuthenticationParameters#credential(Credential)
setNewAuthenticationback to summary
public void setNewAuthentication(boolean newAuthentication)

Sets whether a new authentication dialog is required.

Parameters
newAuthentication:boolean

whether a new authentication dialog is required

See Also
AuthenticationParameters#newAuthentication(boolean)
setRememberMeback to summary
public void setRememberMe(boolean rememberMe)

Sets whether "remember me" should be used.

Parameters
rememberMe:boolean

whether "remember me" should be used.

See Also
AuthenticationParameters#rememberMe(boolean)
withParamsback to summary
public static AuthenticationParameters withParams()

Creates a new instance of AuthenticationParameters, useful for a fluent/builder style creation of parameters.

Returns:AuthenticationParameters

a new AuthenticationParameters instance.