Package com.floragunn.searchguard.user

Class User

java.lang.Object

com.floragunn.searchguard.user.User

All Implemented Interfaces:

CustomAttributesAware, UserInformation, Serializable

public class User
extends Object
implements Serializable, CustomAttributesAware, UserInformation

A authenticated user and attributes associated to them (like roles, tenant, custom attributes)

Do not subclass from this class!

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	User.Builder

Field Summary

Fields

Modifier and Type	Field	Description
static User	ANONYMOUS
static String	USER_TENANT

Fields inherited from interface com.floragunn.searchguard.user.UserInformation

NONE

Constructor Summary

Constructors

Constructor	Description
User(String name)	Create a new authenticated user without roles and attributes
User(String name, AuthDomainInfo authDomainInfo)
User(String name, AuthDomainInfo authDomainInfo, Collection<String> roles, AuthCredentials customAttributes)	Create a new authenticated user
User(String name, String subName, AuthDomainInfo authDomainInfo, String type, Set<String> roles, Set<String> searchGuardRoles, Object specialAuthzConfig, String requestedTenant, Map<String,Object> structuredAttributes, Map<String,String> attributes, boolean isInjected, boolean authzComplete)
User(String name, Collection<String> roles, AuthCredentials customAttributes)	Deprecated.

Method Summary

Modifier and Type	Method	Description
void	addAttributes(Map<String,String> attributes)	Deprecated. Use structured attributes instead
void	addRole(String role)	Associate this user with a backend role
void	addRoles(Collection<String> roles)	Associate this user with a set of backend roles
void	addSearchGuardRoles(Collection<String> sgRoles)
void	addStructuredAttribute(String key, Object value)
void	addStructuredAttributesByJsonPath(Map<String,com.jayway.jsonpath.JsonPath> jsonPathMap, Object source)
User.Builder	copy()
boolean	equals(Object obj)
static User.Builder	forUser(String username)
String	getAuthDomain()
Map<String,String>	getCustomAttributesMap()	Deprecated. use getStructuredAttributes() instead
String	getName()
String	getRequestedTenant()
Set<String>	getRoles()
Set<String>	getSearchGuardRoles()
Object	getSpecialAuthzConfig()
Map<String,Object>	getStructuredAttributes()
String	getSubName()
String	getType()
int	hashCode()
boolean	isAuthzComplete()
boolean	isInjected()
boolean	isUserInRole(String role)	Check if this user is a member of a backend role
void	setAuthDomain(String authDomain)
void	setInjected(boolean isInjected)
void	setRequestedTenant(String requestedTenant)
String	toString()
String	toStringWithAttributes()

Methods inherited from class java.lang.Object

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

Field Detail

ANONYMOUS

public static final User ANONYMOUS

USER_TENANT

public static final String USER_TENANT

See Also:

Constant Field Values

Constructor Detail

User

public User(String name,
            String subName,
            AuthDomainInfo authDomainInfo,
            String type,
            Set<String> roles,
            Set<String> searchGuardRoles,
            Object specialAuthzConfig,
            String requestedTenant,
            Map<String,Object> structuredAttributes,
            Map<String,String> attributes,
            boolean isInjected,
            boolean authzComplete)

User

public User(String name,
            AuthDomainInfo authDomainInfo,
            Collection<String> roles,
            AuthCredentials customAttributes)

Create a new authenticated user

Parameters:

name - The username (must not be null or empty)

roles - Roles of which the user is a member off (maybe null)

customAttributes - Custom attributes associated with this (maybe null)

Throws:

IllegalArgumentException - if name is null or empty

User

@Deprecated
public User(String name,
            Collection<String> roles,
            AuthCredentials customAttributes)

Deprecated.

User

public User(String name)

Create a new authenticated user without roles and attributes

Parameters:

name - The username (must not be null or empty)

Throws:

IllegalArgumentException - if name is null or empty

User

public User(String name,
            AuthDomainInfo authDomainInfo)

Method Detail

forUser

public static User.Builder forUser(String username)

getName

public final String getName()

Specified by:

getName in interface UserInformation

getSubName

public String getSubName()

Specified by:

getSubName in interface UserInformation

getRoles

public final Set<String> getRoles()

Returns:

A unmodifiable set of the backend roles this user is a member of

addRole

public final void addRole(String role)

Associate this user with a backend role

Parameters:

role - The backend role

addRoles

public final void addRoles(Collection<String> roles)

Associate this user with a set of backend roles

Parameters:

roles - The backend roles

isUserInRole

public final boolean isUserInRole(String role)

Check if this user is a member of a backend role

Parameters:

role - The backend role

Returns:

true if this user is a member of the backend role, false otherwise

addAttributes

@Deprecated
public final void addAttributes(Map<String,String> attributes)

Deprecated.

Use structured attributes instead

getRequestedTenant

public final String getRequestedTenant()

setRequestedTenant

public final void setRequestedTenant(String requestedTenant)

isInjected

public boolean isInjected()

setInjected

public void setInjected(boolean isInjected)

toStringWithAttributes

public final String toStringWithAttributes()

toString

public final String toString()

Overrides:

toString in class Object

hashCode

public final int hashCode()

Overrides:

hashCode in class Object

equals

public final boolean equals(Object obj)

Overrides:

equals in class Object

getCustomAttributesMap

@Deprecated
public final Map<String,String> getCustomAttributesMap()

Deprecated.

use getStructuredAttributes() instead

Get the custom attributes associated with this user

Specified by:

getCustomAttributesMap in interface CustomAttributesAware

Returns:

A modifiable map with all the current custom attributes associated with this user

getStructuredAttributes

public Map<String,Object> getStructuredAttributes()

addStructuredAttribute

public void addStructuredAttribute(String key,
                                   Object value)

addStructuredAttributesByJsonPath

public void addStructuredAttributesByJsonPath(Map<String,com.jayway.jsonpath.JsonPath> jsonPathMap,
                                              Object source)

addSearchGuardRoles

public final void addSearchGuardRoles(Collection<String> sgRoles)

getSearchGuardRoles

public final Set<String> getSearchGuardRoles()

getType

public String getType()

getSpecialAuthzConfig

public Object getSpecialAuthzConfig()

isAuthzComplete

public boolean isAuthzComplete()

copy

public User.Builder copy()

getAuthDomain

public String getAuthDomain()

Specified by:

getAuthDomain in interface UserInformation

setAuthDomain

public void setAuthDomain(String authDomain)