Package org.keycloak.authentication.forms

Class RegistrationUserCreation

java.lang.Object

org.keycloak.authentication.forms.RegistrationUserCreation

All Implemented Interfaces:

ConfigurableAuthenticatorFactory, FormAction, FormActionFactory, ConfiguredProvider, Provider, ProviderFactory<FormAction>

public class RegistrationUserCreation
extends Object
implements FormAction, FormActionFactory

Version:

$Revision: 1 $

Author:

Bill Burke

Field Summary

Fields

Modifier and Type	Field	Description
static final String	PROVIDER_ID

Constructor Summary

Constructors

Constructor	Description
RegistrationUserCreation()

Method Summary

Modifier and Type	Method	Description
void	buildPage(FormContext context, LoginFormsProvider form)	When a FormAuthenticator is rendering the challenge page, even FormAction.buildPage() method will be called This gives the FormAction the opportunity to add additional attributes to the form to be displayed.
void	close()	This is called when the server shuts down.
boolean	configuredFor(KeycloakSession session, RealmModel realm, UserModel user)	Is this FormAction configured for the current user?
FormAction	create(KeycloakSession session)
List<ProviderConfigProperty>	getConfigProperties()
String	getDisplayType()	Friendly name for the authenticator
String	getHelpText()
String	getId()
UserProfile	getOrCreateUserProfile(FormContext formContext, jakarta.ws.rs.core.MultivaluedMap<String,String> formData)	Get user profile instance for current HTTP request (KeycloakSession) and for given context.
String	getReferenceCategory()	General authenticator type, i.e.
AuthenticationExecutionModel.Requirement[]	getRequirementChoices()	What requirement settings are allowed.
void	init(Config.Scope config)	Only called once when the factory is first created.
boolean	isConfigurable()	Is this authenticator configurable?
boolean	isUserSetupAllowed()	Does this authenticator have required actions that can set if the user does not have this authenticator set up?
void	postInit(KeycloakSessionFactory factory)	Called after all provider factories have been initialized
boolean	requiresUser()	Does this FormAction require that a user be set? For registration, this method will always return false.
void	setRequiredActions(KeycloakSession session, RealmModel realm, UserModel user)	Set actions to configure authenticator
void	success(FormContext context)	Called after all validate() calls of all FormAction providers are successful.
void	validate(ValidationContext context)	This is the first phase of form processing.

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.keycloak.provider.ConfiguredProvider

getConfig

Methods inherited from interface org.keycloak.provider.ProviderFactory

dependsOn, getConfigMetadata, order

Field Details

PROVIDER_ID

public static final String PROVIDER_ID

See Also:

• Constant Field Values

Constructor Details

RegistrationUserCreation

public RegistrationUserCreation()

Method Details

getHelpText

public String getHelpText()

Specified by:

getHelpText in interface ConfiguredProvider

getConfigProperties

public List<ProviderConfigProperty> getConfigProperties()

Specified by:

getConfigProperties in interface ConfiguredProvider

validate

public void validate(ValidationContext context)

Description copied from interface: FormAction

This is the first phase of form processing. Each FormAction.validate() method is called. This gives the FormAction a chance to validate and challenge if user input is invalid.

Specified by:

validate in interface FormAction

buildPage

public void buildPage(FormContext context,
 LoginFormsProvider form)

Description copied from interface: FormAction

When a FormAuthenticator is rendering the challenge page, even FormAction.buildPage() method will be called This gives the FormAction the opportunity to add additional attributes to the form to be displayed.

Specified by:

buildPage in interface FormAction

success

public void success(FormContext context)

Description copied from interface: FormAction

Called after all validate() calls of all FormAction providers are successful.

Specified by:

success in interface FormAction

requiresUser

public boolean requiresUser()

Description copied from interface: FormAction

Does this FormAction require that a user be set? For registration, this method will always return false.

Specified by:

requiresUser in interface FormAction

Returns:

configuredFor

public boolean configuredFor(KeycloakSession session,
 RealmModel realm,
 UserModel user)

Description copied from interface: FormAction

Is this FormAction configured for the current user?

Specified by:

configuredFor in interface FormAction

Returns:

setRequiredActions

public void setRequiredActions(KeycloakSession session,
 RealmModel realm,
 UserModel user)

Description copied from interface: FormAction

Set actions to configure authenticator

Specified by:

setRequiredActions in interface FormAction

isUserSetupAllowed

public boolean isUserSetupAllowed()

Description copied from interface: ConfigurableAuthenticatorFactory

Does this authenticator have required actions that can set if the user does not have this authenticator set up?

Specified by:

isUserSetupAllowed in interface ConfigurableAuthenticatorFactory

Returns:

close

public void close()

Description copied from interface: ProviderFactory

This is called when the server shuts down.

Specified by:

close in interface Provider

Specified by:

close in interface ProviderFactory<FormAction>

getDisplayType

public String getDisplayType()

Description copied from interface: ConfigurableAuthenticatorFactory

Friendly name for the authenticator

Specified by:

getDisplayType in interface ConfigurableAuthenticatorFactory

Returns:

getReferenceCategory

public String getReferenceCategory()

Description copied from interface: ConfigurableAuthenticatorFactory

General authenticator type, i.e. totp, password, cert.

Specified by:

getReferenceCategory in interface ConfigurableAuthenticatorFactory

Returns:

null if not a referenceable category

isConfigurable

public boolean isConfigurable()

Description copied from interface: ConfigurableAuthenticatorFactory

Is this authenticator configurable?

Specified by:

isConfigurable in interface ConfigurableAuthenticatorFactory

Returns:

getRequirementChoices

public AuthenticationExecutionModel.Requirement[] getRequirementChoices()

Description copied from interface: ConfigurableAuthenticatorFactory

What requirement settings are allowed.

Specified by:

getRequirementChoices in interface ConfigurableAuthenticatorFactory

Returns:

create

public FormAction create(KeycloakSession session)

Specified by:

create in interface ProviderFactory<FormAction>

init

public void init(Config.Scope config)

Description copied from interface: ProviderFactory

Only called once when the factory is first created. This config is pulled from keycloak_server.json

Specified by:

init in interface ProviderFactory<FormAction>

postInit

public void postInit(KeycloakSessionFactory factory)

Description copied from interface: ProviderFactory

Called after all provider factories have been initialized

Specified by:

postInit in interface ProviderFactory<FormAction>

getId

public String getId()

Specified by:

getId in interface ProviderFactory<FormAction>

getOrCreateUserProfile

public UserProfile getOrCreateUserProfile(FormContext formContext,
 jakarta.ws.rs.core.MultivaluedMap<String,String> formData)

Get user profile instance for current HTTP request (KeycloakSession) and for given context. This assumes that there is single user registered within HTTP request, which is always the case in Keycloak