ILoginEvents

This interface describes a Layer Two extensibility point. Components can implement this interface and an instance of the implementing class will be created by MEF on startup. Login events fire as the Authenticate instance host workflow runs. The IComponentActivity interface passed to each event allows you to pause or cancel the workflow so you can deliver UI.

See also: LoginEventsHandler

Methods

void AfterAuthenticate(IComponentActivity context, IClientConnection connection, Guid accountID, bool success)

Called immediately after authentication to notify you of the resolved accountID and success.

void AfterPermissionCheck(IComponentActivity context, IConnectionIdentity identity, bool success)

Called just after the user is tested for WellKnown.Permissions.Login permission.

void AfterSessionReconnect(IComponentActivity context, IConnectionIdentity identity)

Called during authenticate if the user is reconnecting with correct SessionID and Session Key. In this case BeforeAuthenticate, AfterAuthenticate, BeforeSessionSetup, and AfterSessionSetup events are not fired.

void AfterSessionSetup(IComponentActivity context, IClientConnection connection, IConnectionIdentity identity, bool success)

Called after the user's session has been set up (on the service provider and root) and their IConnectionIdentity has been created.

void BeforeAuthenticate(IComponentActivity context, IClientConnection connection)

Called at the very beginning of authentication. You can examine the connection, its remote address, user agent properties (client type), etc. The connection has no connection identity yet, since it hasn't authenticated.

void BeforePermissionCheck(IComponentActivity context, IConnectionIdentity identity)

Called just before the user is tested for WellKnown.Permissions.Login permission. This is a great time to add the connection to a dynamic group that might get them that permission if they're not already getting it from some EntityGroup.

void BeforeSessionSetup(IComponentActivity context, IClientConnection connection, Guid accountID)

Called after authentication, but before the user's session and IConnectionIdentity is created.

void LoginComplete(IComponentActivity context, IConnectionIdentity identity, bool success)

Called at the end of login / authentication. This will be the last workflow event from a connection until they start a navigate workflow.

void LoginPaused(IConnectionIdentity identity, WorkflowStep step)

Called to let components know that a authenticate workflow was paused by a component, probably waiting for UI response from the user.