Class EmailVerificationConfigurer

java.lang.Object

com.codename1.backend.security.SecurityConfigurer

com.codename1.backend.security.EmailVerificationConfigurer

public final class EmailVerificationConfigurer
extends SecurityConfigurer

The address a mailed verification link opens.

http.emailVerification(Customizer.withDefaults());

GET /verify-email?token=... is a page with one button, and pressing it -- a POST -- records the address as proved and sends the user to /?verified; a link that is no longer good is answered 400. Opening the link proves nothing by itself, because a mail gateway opens every link in a mail before its reader does. The address is open to everyone: a link is often opened on another device than the one that is signed in.

The application mails the link itself, where it takes the address, with linkUrl() as where it leads:

verification.send(username, email, "https://example.com/verify-email");

The work is an EmailVerificationService's: the one given here, or the application's bean of that type.

Method Summary

Modifier and Type	Method	Description
EmailVerificationConfigurer	confirmUrl(String confirmUrl)	The path the link opens; /verify-email unless set.
void	init(HttpSecurity http)	Shares what other parts need to know; nothing by default.
String	linkUrl()	The whole address to give EmailVerificationService.send(String, String, String): the server's address from cn1.security.base-url and the path the link opens.
EmailVerificationConfigurer	service(EmailVerificationService service)	What checks the link, in place of the application's bean.
EmailVerificationConfigurer	successUrl(String successUrl)	Where the user is sent once the address is proved; /?verified unless set.

Methods inherited from class SecurityConfigurer

configure, disable, getBuilder

Methods inherited from class Object

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

Method Details

service

public EmailVerificationConfigurer service(EmailVerificationService service)

What checks the link, in place of the application's bean.

confirmUrl

public EmailVerificationConfigurer confirmUrl(String confirmUrl)

The path the link opens; /verify-email unless set.

successUrl

public EmailVerificationConfigurer successUrl(String successUrl)

Where the user is sent once the address is proved; /?verified unless set.

linkUrl

public String linkUrl()

The whole address to give EmailVerificationService.send(String, String, String): the server's address from cn1.security.base-url and the path the link opens.

Throws

• IllegalStateException: the setting is missing

init

public void init(HttpSecurity http)

Description copied from class: SecurityConfigurer

Shares what other parts need to know; nothing by default.

Overrides:

init in class SecurityConfigurer