Wt
3.7.1
|
A class that represents a user identity. More...
#include <Auth/Identity>
Public Member Functions | |
Identity () | |
Default constructor. More... | |
Identity (const std::string &provider, const std::string &id, const WString &name, const std::string &email, bool emailVerified) | |
Constructor. | |
bool | isValid () const |
Returns whether the identity is valid. More... | |
const std::string & | provider () const |
Returns the provider name. More... | |
const std::string & | id () const |
Returns the id. More... | |
const WString & | name () const |
Returns the name. More... | |
const std::string & | email () const |
Returns an email address. More... | |
bool | emailVerified () const |
Returns whether the email address has been verified. More... | |
Static Public Attributes | |
static const Identity | Invalid |
An invalid identity constant. More... | |
static const std::string | LoginName = "loginname" |
The login name identity. More... | |
A class that represents a user identity.
The identity is the result of an authentication process. Although the most common authentication method (password authentication) only returns a user name, other methods (such as OAuth, client SSL certificates, or an authentication reverse proxy server) may return more information.
At the very least, the user is identified using a unique ID, and it optionally also contains name and email address information.
Wt::Auth::Identity::Identity | ( | ) |
Default constructor.
Creates an invalid identity.
const std::string& Wt::Auth::Identity::email | ( | ) | const |
Returns an email address.
Returns the user's email address, or an empty string if not provided.
bool Wt::Auth::Identity::emailVerified | ( | ) | const |
Returns whether the email address has been verified.
The third party provider may be able to guarantee that the user indeed also control's the given email address (e.g. because the third party hosts that email account for the user).
const std::string& Wt::Auth::Identity::id | ( | ) | const |
Returns the id.
Returns a unique identifier for the user within the scope of this provider.
bool Wt::Auth::Identity::isValid | ( | ) | const |
Returns whether the identity is valid.
An invalid identity is used to indicate for example that no identity information could be obtained.
const WString& Wt::Auth::Identity::name | ( | ) | const |
Returns the name.
Returns the user's name, or an empty string if not provided.
const std::string& Wt::Auth::Identity::provider | ( | ) | const |
Returns the provider name.
This is a unique id that names the source for this identity (e.g. "google-oauth", or "LDAP", or "user" (for a user-chosen identity).
|
static |
An invalid identity constant.
This is an identity that is not isValid().
|
static |
The login name identity.
This is a provider name for the (usually user-controlled) identity, used for example for password-based authentication.