javax.security.authentication.mechanism.http.annotation

Annotation Type RememberMe

@Inherited
 @InterceptorBinding
 @Retention(value=RUNTIME)
 @Target(value=TYPE)
public @interface RememberMe

The RememberMe annotation provides an application the ability to declarative designate that an AuthenticationMechanism effectively "remembers" the authentication and auto applies this with every request.

For the remember me function the credentials provided by the caller are exchanged for a (long-lived) token which is send to the user as the value of a cookie, in a similar way to how the HTTP session ID is send. It should be realized that this token effectively becomes the credential to establish the caller's identity within the application and care should be taken to handle and store the token securely. E.g. by using this feature with a secure transport (SSL/HTTPS), storing a strong hash instead of the actual token, and implementing an expiration policy.

The token is vended by a special purpose IdentityStore-like artifact; an implementation of the RememberMeIdentityStore.

This support is provided via an implementation of an interceptor spec interceptor that conducts the necessary logic.

Example:

 
      @RequestScoped
      @RememberMe
     public class CustomAuthenticationMechanism implements HttpAuthenticationMechanism {
         // ...
     }
 
 

Note: this facility DOES NOT constitute any kind of "session management" system, but instead represents a special purpose authentication mechanism using a long-lived token, that is vended and validated by the RememberMeIdentityStore.

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element and Description
boolean	cookieHttpOnly Flag to indicate that the remember me cookie should not be exposed to client-side scripting code, and should only be sent with HTTP requests.
int	cookieMaxAgeSeconds Max age in seconds for the remember me cookie.
String	cookieName Name of the remember me cookie.
boolean	cookieSecureOnly Flag to indicate that the remember me cookie should only be sent using a secure protocol (e.g.
String	isRememberMeExpression EL expression to determine if remember me should be used.

Element Detail

cookieMaxAgeSeconds

public abstract int cookieMaxAgeSeconds

Max age in seconds for the remember me cookie. Defaults to one day.

Returns:

Max age in seconds

See Also:

Cookie.setMaxAge(int)

Default:

86400

cookieSecureOnly

public abstract boolean cookieSecureOnly

Flag to indicate that the remember me cookie should only be sent using a secure protocol (e.g. HTTPS or SSL).

Returns:

true if the cookie should be sent using a secure protocol only false for any protocol.

See Also:

Cookie.setSecure(boolean)

Default:

true

cookieHttpOnly

public abstract boolean cookieHttpOnly

Flag to indicate that the remember me cookie should not be exposed to client-side scripting code, and should only be sent with HTTP requests.

Returns:

true if the cookie should be sent only with HTTP requests (and not be made available to client-side scripting code), false otherwise.

See Also:

Cookie.setHttpOnly(boolean)

Default:

true

cookieName

public abstract String cookieName

Name of the remember me cookie.

Returns:

The name of the cookie

See Also:

Cookie.getName()

Default:

"JREMEMBERMEID"

isRememberMeExpression

public abstract String isRememberMeExpression

EL expression to determine if remember me should be used. This is evaluated for every request requiring authentication. The expression needs to evaluate to a boolean outcome. All named CDI beans are available to the expression as well as default classes as specified by EL 3.0 for the ELProcessor and the implicit objects "self" which refers to the interceptor target and "httpMessageContext" which refers to the current HttpMessageContext.

Returns:

EL expression to determine if remember me should be used

Default:

""