io.quarkus.vertx.http.runtime

Class FormAuthConfig

java.lang.Object

io.quarkus.vertx.http.runtime.FormAuthConfig

public class FormAuthConfig
extends Object

config for the form authentication mechanism

Field Summary

Fields

Modifier and Type	Field and Description
String	cookieName The cookie that is used to store the persistent session
boolean	enabled If form authentication is enabled
String	errorPage The error page
String	landingPage The landing page to redirect to if there is no saved page to redirect back to
String	locationCookie Option to control the name of the cookie used to redirect the user back to where he want to get access to.
String	loginPage The login page
Duration	newCookieInterval How old a cookie can get before it will be replaced with a new cookie with an updated timeout, also referred to as "renewal-timeout".
String	passwordParameter The password field name.
String	postLocation The post location.
boolean	redirectAfterLogin Option to disable redirect to landingPage if there is no saved page to redirect back to.
Duration	timeout The inactivity (idle) timeout When inactivity timeout is reached, cookie is not renewed and a new login is enforced.
String	usernameParameter The username field name.

Constructor Summary

Constructors

Constructor and Description
FormAuthConfig()

Method Summary

Methods inherited from class java.lang.Object

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

Field Detail

enabled

@ConfigItem
public boolean enabled

If form authentication is enabled

loginPage

@ConfigItem(defaultValue="/login.html")
public String loginPage

The login page

postLocation

@ConfigItem(defaultValue="/j_security_check")
public String postLocation

The post location.

usernameParameter

@ConfigItem(defaultValue="j_username")
public String usernameParameter

The username field name.

passwordParameter

@ConfigItem(defaultValue="j_password")
public String passwordParameter

The password field name.

errorPage

@ConfigItem(defaultValue="/error.html")
public String errorPage

The error page

landingPage

@ConfigItem(defaultValue="/index.html")
public String landingPage

The landing page to redirect to if there is no saved page to redirect back to

redirectAfterLogin

@ConfigItem(defaultValue="true")
public boolean redirectAfterLogin

Option to disable redirect to landingPage if there is no saved page to redirect back to. Form Auth POST is followed by redirect to landingPage by default.

locationCookie

@ConfigItem(defaultValue="quarkus-redirect-location")
public String locationCookie

Option to control the name of the cookie used to redirect the user back to where he want to get access to.

timeout

@ConfigItem(defaultValue="PT30M")
public Duration timeout

The inactivity (idle) timeout When inactivity timeout is reached, cookie is not renewed and a new login is enforced.

newCookieInterval

@ConfigItem(defaultValue="PT1M")
public Duration newCookieInterval

How old a cookie can get before it will be replaced with a new cookie with an updated timeout, also referred to as "renewal-timeout". Note that smaller values will result in slightly more server load (as new encrypted cookies will be generated more often), however larger values affect the inactivity timeout as the timeout is set when a cookie is generated. For example if this is set to 10 minutes, and the inactivity timeout is 30m, if a users last request is when the cookie is 9m old then the actual timeout will happen 21m after the last request, as the timeout is only refreshed when a new cookie is generated. In other words no timeout is tracked on the server side; the timestamp is encoded and encrypted in the cookie itself and it is decrypted and parsed with each request.

cookieName

@ConfigItem(defaultValue="quarkus-credential")
public String cookieName

The cookie that is used to store the persistent session

Constructor Detail

FormAuthConfig

public FormAuthConfig()