Attempts to acquire the current Veriplace user identifier, if it isn't already present in the current state.

Namespace:  Veriplace.Web
Assembly:  Veriplace.Client (in Veriplace.Client.dll) Version: 1.7.0.25986 (1.7.0.0)

Syntax

C#
public void RequireUser()
Visual Basic (Declaration)
Public Sub RequireUser
Visual C++
public:
void RequireUser()

Remarks

If the user has already been acquired, or set explicitly in the User property, the method returns immediately. Otherwise, it redirects to the Veriplace server to begin a user discovery transaction. If the server can detect the current user without interaction, it redirects immediately back to your application; otherwise it prompts the user to log in (unless you have disabled this by setting UserInteractionAllowed to false) and redirects back once they have done so.

When your application receives the callback, it will be to the same URL and with the same HTTP parameters as the initial request, but with an additional token to indicate that the user is now available. You do not need to check for this token; just call RequireUser(state) as you did before, and this time the method will return normally.

Exceptions

ExceptionCondition
Veriplace.Web..::.RespondedExceptionif the client has sent a redirect response; stop handling the request and return in this case
Veriplace.Client..::.UserDiscoveryExceptionif the current user could not be determined
Veriplace.Client..::.UnexpectedExceptionif there was an unexpected I/O error or OAuth error from the server

See Also