com.inductiveautomation.ignition.gateway.authentication.impl

Class InternalUserSource

java.lang.Object

com.inductiveautomation.ignition.gateway.user.AbstractUserSourceProfile

com.inductiveautomation.ignition.gateway.authentication.impl.InternalUserSource

All Implemented Interfaces:

UserSourceProfile

Direct Known Subclasses:

ADInternalHybridUserSource

public class InternalUserSource
extends AbstractUserSourceProfile

This user source stores users, groups, extended properties, and contact info inside the internal database. It is fully compliant with the user-source editing capabilities of Ignition.

Relevant persistent records:

• InternalUserRecord
• InternalRoleRecord
• InternalUserRoleMapping
• InternalUserExtraPropsRecord
• InternalContactInfoRecord

Field Summary

Fields inherited from class com.inductiveautomation.ignition.gateway.user.AbstractUserSourceProfile

cacheValidationTimeout, context, manager, profileId, profileName

Constructor Summary

Constructors

Constructor and Description
InternalUserSource(GatewayContext context, long profileId, java.lang.String profileName, long cacheTimeout)

Method Summary

Modifier and Type	Method and Description
void	addRole(java.lang.String newName, UICallback ui)
void	addUser(User user, UICallback ui)
void	alterUser(User user, UICallback ui)
AuthenticatedUser	authenticate(AuthChallenge challenge) Called to both verify authentication for a given username/password pair, and to find the security roles for that user.
static long	createDefaultUserSource(GatewayContext context) Creates an internal user source called "default" with user "admin"/"password" and role "Administrator".
protected java.lang.Long	findUserInternalId(PersistenceSession session, User user)
protected java.util.List<ContactInfo>	getContactInfoForUser(PersistenceSession session, InternalUserRecord user)
java.util.Set<UserSourceEditCapability>	getEditFlags() Which of the editing functions are supported?
java.util.Collection<java.lang.String>	getRoles()
protected java.util.List<java.lang.String>	getRolesForUser(PersistenceSession session, InternalUserRecord user)
protected java.util.List<ScheduleAdjustment>	getScheduleAdjustmentsForUser(PersistenceSession session, InternalUserRecord user)
java.util.Collection<User>	getUsers() Retrieve all users from this profile.
protected void	loadExtendedUserProperties(PersistenceSession session, InternalUserRecord userRec, PropertySet user)
protected void	loadUserProperties(InternalUserRecord userRec, User user)
void	removeRole(java.lang.String group, UICallback ui)
void	removeUser(User user, UICallback ui)
void	renameRole(java.lang.String oldName, java.lang.String newName, UICallback ui)
java.lang.String	toString()

Methods inherited from class com.inductiveautomation.ignition.gateway.user.AbstractUserSourceProfile

getCacheValidationTimeout, getName, getProfileId, shutdown, startup

Methods inherited from class java.lang.Object

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

Constructor Detail

InternalUserSource

public InternalUserSource(GatewayContext context,
                          long profileId,
                          java.lang.String profileName,
                          long cacheTimeout)

Method Detail

createDefaultUserSource

public static long createDefaultUserSource(GatewayContext context)
                                    throws java.lang.Exception

Creates an internal user source called "default" with user "admin"/"password" and role "Administrator". Returns the long id of the new profile.

Throws:

java.lang.Exception

authenticate

public AuthenticatedUser authenticate(AuthChallenge challenge)
                               throws java.lang.Exception

Description copied from interface: UserSourceProfile

Called to both verify authentication for a given username/password pair, and to find the security roles for that user.

Returns:

An AuthenticatedUser that contains the user's roles if authentication succeeded, or null if it did not.

Throws:

java.lang.Exception

getUsers

public java.util.Collection<User> getUsers()

Description copied from interface: UserSourceProfile

Retrieve all users from this profile. This can execute slowly (block) if need be. It will be called periodically by the manager and the results will be cached.

loadUserProperties

protected void loadUserProperties(InternalUserRecord userRec,
                                  User user)

getRolesForUser

protected java.util.List<java.lang.String> getRolesForUser(PersistenceSession session,
                                                           InternalUserRecord user)

getContactInfoForUser

protected java.util.List<ContactInfo> getContactInfoForUser(PersistenceSession session,
                                                            InternalUserRecord user)

getScheduleAdjustmentsForUser

protected java.util.List<ScheduleAdjustment> getScheduleAdjustmentsForUser(PersistenceSession session,
                                                                           InternalUserRecord user)

loadExtendedUserProperties

protected void loadExtendedUserProperties(PersistenceSession session,
                                          InternalUserRecord userRec,
                                          PropertySet user)

getRoles

public java.util.Collection<java.lang.String> getRoles()
                                                throws java.lang.Exception

Returns:

a collection of all possible role names for this profile. May be empty

Throws:

java.lang.Exception

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

getEditFlags

public java.util.Set<UserSourceEditCapability> getEditFlags()

Description copied from interface: UserSourceProfile

Which of the editing functions are supported?

Specified by:

getEditFlags in interface UserSourceProfile

Overrides:

getEditFlags in class AbstractUserSourceProfile

addUser

public void addUser(User user,
                    UICallback ui)
             throws java.lang.Exception

Specified by:

addUser in interface UserSourceProfile

Overrides:

addUser in class AbstractUserSourceProfile

Throws:

java.lang.Exception

findUserInternalId

protected java.lang.Long findUserInternalId(PersistenceSession session,
                                            User user)

alterUser

public void alterUser(User user,
                      UICallback ui)
               throws java.lang.Exception

Specified by:

alterUser in interface UserSourceProfile

Overrides:

alterUser in class AbstractUserSourceProfile

Throws:

java.lang.Exception

removeUser

public void removeUser(User user,
                       UICallback ui)
                throws java.lang.Exception

Specified by:

removeUser in interface UserSourceProfile

Overrides:

removeUser in class AbstractUserSourceProfile

Throws:

java.lang.Exception

addRole

public void addRole(java.lang.String newName,
                    UICallback ui)
             throws java.lang.Exception

Specified by:

addRole in interface UserSourceProfile

Overrides:

addRole in class AbstractUserSourceProfile

Throws:

java.lang.Exception

renameRole

public void renameRole(java.lang.String oldName,
                       java.lang.String newName,
                       UICallback ui)
                throws java.lang.Exception

Specified by:

renameRole in interface UserSourceProfile

Overrides:

renameRole in class AbstractUserSourceProfile

Throws:

java.lang.Exception

removeRole

public void removeRole(java.lang.String group,
                       UICallback ui)
                throws java.lang.Exception

Specified by:

removeRole in interface UserSourceProfile

Overrides:

removeRole in class AbstractUserSourceProfile

Throws:

java.lang.Exception