Package org.keycloak.userprofile

Class DefaultAttributes

java.lang.Object

java.util.AbstractMap<K,V>

java.util.HashMap<String,List<String>>

org.keycloak.userprofile.DefaultAttributes

All Implemented Interfaces:

Serializable, Cloneable, Map<String,List<String>>, Attributes

public class DefaultAttributes
extends HashMap<String,List<String>>
implements Attributes

The default implementation for Attributes. Should be reused as much as possible by the different implementations of UserProfileProvider.

One of the main aspects of this implementation is to allow normalizing attributes accordingly to the profile configuration and current context. As such, it provides some common normalization to common profile attributes (e.g.: username, email, first and last names, dynamic read-only attributes).

This implementation is not specific to any user profile implementation.

Author:

Pedro Igor

See Also:

• Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class java.util.AbstractMap

AbstractMap.SimpleEntry<K extends Object,V extends Object>, AbstractMap.SimpleImmutableEntry<K extends Object,V extends Object>

Nested classes/interfaces inherited from interface java.util.Map

Map.Entry<K extends Object,V extends Object>

Field Summary

Fields

Modifier and Type	Field	Description
protected final UserProfileContext	context
static final String	DEFAULT_MAX_LENGTH_ATTRIBUTES
static final String	READ_ONLY_ATTRIBUTE_KEY	To reference dynamic attributes that can be configured as read-only when setting up the provider.
protected final KeycloakSession	session
protected final UserModel	user

Fields inherited from interface org.keycloak.userprofile.Attributes

EMPTY_VALUE

Constructor Summary

Constructors

Constructor	Description
DefaultAttributes(UserProfileContext context, Map<String,?> attributes, UserModel user, UserProfileMetadata profileMetadata, KeycloakSession session)

Method Summary

Modifier and Type	Method	Description
protected void	addDefaultValidators(String name, List<AttributeMetadata> metadatas)
boolean	contains(String name)
protected AttributeContext	createAttributeContext(AttributeMetadata metadata)
protected AttributeMetadata	createUnmanagedAttributeMetadata(String name)
List<String>	get(String name)
AttributeMetadata	getMetadata(String name)
Map<String,List<String>>	getReadable()
Map<String,List<String>>	getUnmanagedAttributes()
Map<String,List<String>>	getWritable()
protected boolean	isAllowUnmanagedAttribute()
protected boolean	isIncludeAttributeIfNotProvided(AttributeMetadata metadata)
boolean	isReadOnly(String name)
protected boolean	isReadOnlyFromMetadata(String attributeName)	Checks whether an attribute is marked as read only by looking at its metadata.
protected boolean	isReadOnlyInternalAttribute(String attributeName)	Returns whether an attribute is read only based on the provider configuration (using provider config), usually related to internal attributes managed by the server.
boolean	isRequired(String name)
protected boolean	isSupportedAttribute(String name)	Checks whether an attribute is support by the profile configuration and the current context.
Set<String>	nameSet()
protected List<String>	normalizeAttributeValues(String name, Object value)	Intentionally kept to protected visibility to allow for custom normalization logic while clients adopt User Profile
protected void	setUserName(Map<String,List<String>> newAttributes, List<String> values)
Map<String,List<String>>	toMap()
boolean	validate(String name, Consumer<ValidationError>... listeners)

Methods inherited from class java.util.HashMap

clear, clone, compute, computeIfAbsent, computeIfPresent, containsKey, containsValue, entrySet, forEach, get, getOrDefault, isEmpty, keySet, merge, put, putAll, putIfAbsent, remove, remove, replace, replace, replaceAll, size, values

Methods inherited from class java.util.AbstractMap

equals, hashCode, toString

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.keycloak.userprofile.Attributes

getFirst

Methods inherited from interface java.util.Map

equals, hashCode

Field Details

READ_ONLY_ATTRIBUTE_KEY

public static final String READ_ONLY_ATTRIBUTE_KEY

To reference dynamic attributes that can be configured as read-only when setting up the provider. We should probably remove that once we remove the legacy provider, because this will come from the configuration.

See Also:

• Constant Field Values

DEFAULT_MAX_LENGTH_ATTRIBUTES

public static final String DEFAULT_MAX_LENGTH_ATTRIBUTES

See Also:

• Constant Field Values

context

protected final UserProfileContext context

session

protected final KeycloakSession session

user

protected final UserModel user

Constructor Details

DefaultAttributes

public DefaultAttributes(UserProfileContext context,
 Map<String,?> attributes,
 UserModel user,
 UserProfileMetadata profileMetadata,
 KeycloakSession session)

Method Details

isReadOnly

public boolean isReadOnly(String name)

Specified by:

isReadOnly in interface Attributes

isReadOnlyFromMetadata

protected boolean isReadOnlyFromMetadata(String attributeName)

Checks whether an attribute is marked as read only by looking at its metadata.

Parameters:

attributeName - the attribute name

Returns:

isRequired

public boolean isRequired(String name)

Specified by:

isRequired in interface Attributes

validate

public boolean validate(String name,
 Consumer<ValidationError>... listeners)

Specified by:

validate in interface Attributes

addDefaultValidators

protected void addDefaultValidators(String name,
 List<AttributeMetadata> metadatas)

get

public List<String> get(String name)

Specified by:

get in interface Attributes

contains

public boolean contains(String name)

Specified by:

contains in interface Attributes

nameSet

public Set<String> nameSet()

Specified by:

nameSet in interface Attributes

getWritable

public Map<String,List<String>> getWritable()

Specified by:

getWritable in interface Attributes

getMetadata

public AttributeMetadata getMetadata(String name)

Specified by:

getMetadata in interface Attributes

getReadable

public Map<String,List<String>> getReadable()

Specified by:

getReadable in interface Attributes

toMap

public Map<String,List<String>> toMap()

Specified by:

toMap in interface Attributes

createAttributeContext

protected AttributeContext createAttributeContext(AttributeMetadata metadata)

normalizeAttributeValues

protected List<String> normalizeAttributeValues(String name,
 Object value)

Intentionally kept to protected visibility to allow for custom normalization logic while clients adopt User Profile

isAllowUnmanagedAttribute

protected boolean isAllowUnmanagedAttribute()

setUserName

protected void setUserName(Map<String,List<String>> newAttributes,
 List<String> values)

isIncludeAttributeIfNotProvided

protected boolean isIncludeAttributeIfNotProvided(AttributeMetadata metadata)

isSupportedAttribute

protected boolean isSupportedAttribute(String name)

Checks whether an attribute is support by the profile configuration and the current context.

This method can be used to avoid unexpected attributes from being added as an attribute because the attribute source is a regular Map and not normalized.

Parameters:

name - the name of the attribute

Returns:

isReadOnlyInternalAttribute

protected boolean isReadOnlyInternalAttribute(String attributeName)

Returns whether an attribute is read only based on the provider configuration (using provider config), usually related to internal attributes managed by the server.

For user-defined attributes, it should be preferable to use the user profile configuration.

Parameters:

attributeName - the attribute name

Returns:

true if the attribute is readonly. Otherwise, returns false

getUnmanagedAttributes

public Map<String,List<String>> getUnmanagedAttributes()

Specified by:

getUnmanagedAttributes in interface Attributes

createUnmanagedAttributeMetadata

protected AttributeMetadata createUnmanagedAttributeMetadata(String name)