Wt  4.11.1
Public Member Functions | Protected Member Functions | List of all members
Wt::Auth::Saml::Process Class Reference

A SAML authentication process. More...

#include <Wt/Auth/Saml/Process.h>

Inheritance diagram for Wt::Auth::Saml::Process:
[legend]

Public Member Functions

const Serviceservice () const
 Returns the SAML service which spawned this process. More...
 
const WStringerror () const
 Error information, in case authentication or identification failed. More...
 
void startAuthenticate ()
 Starts an authorization and authentication process. More...
 
Signal< Identity > & authenticated ()
 Authentication signal. More...
 
- Public Member Functions inherited from Wt::WObject
void addChild (std::unique_ptr< WObject > child)
 Add a child WObject whose lifetime is determined by this WObject.
 
template<typename Child >
Child * addChild (std::unique_ptr< Child > child)
 Add a child WObject, returning a raw pointer. More...
 
std::unique_ptr< WObjectremoveChild (WObject *child)
 Remove a child WObject, so its lifetime is no longer determined by this WObject.
 
template<typename Child >
std::unique_ptr< Child > removeChild (Child *child)
 Remove a child WObject, so its lifetime is no longer determined by this WObject. More...
 
virtual const std::string id () const
 Returns the (unique) identifier for this object. More...
 
virtual void setObjectName (const std::string &name)
 Sets an object name. More...
 
virtual std::string objectName () const
 Returns the object name. More...
 
void resetLearnedSlots ()
 Resets learned stateless slot implementations. More...
 
template<class T >
void resetLearnedSlot (void(T::*method)())
 Resets a learned stateless slot implementation. More...
 
template<class T >
WStatelessSlot * implementStateless (void(T::*method)())
 Declares a slot to be stateless and learn client-side behaviour on first invocation. More...
 
template<class T >
WStatelessSlot * implementStateless (void(T::*method)(), void(T::*undoMethod)())
 Declares a slot to be stateless and learn client-side behaviour in advance. More...
 
void isNotStateless ()
 Marks the current function as not stateless. More...
 
template<class T >
WStatelessSlot * implementJavaScript (void(T::*method)(), const std::string &jsCode)
 Provides a JavaScript implementation for a method. More...
 
- Public Member Functions inherited from Wt::Core::observable
 observable () noexcept
 Default constructor.
 
virtual ~observable ()
 Destructor. More...
 
template<typename... Args, typename C >
auto bindSafe (void(C::*method)(Args...)) noexcept
 Protects a method call against object destruction. More...
 
template<typename... Args, typename C >
auto bindSafe (void(C::*method)(Args...) const) const noexcept
 Protects a const method call against object destruction. More...
 
template<typename Function >
auto bindSafe (const Function &function) noexcept
 Protects a function against object destruction. More...
 

Protected Member Functions

 Process (const Service &service)
 Constructor. More...
 
- Protected Member Functions inherited from Wt::WObject
virtual WStatelessSlot * getStateless (Method method)
 On-demand stateless slot implementation. More...
 

Additional Inherited Members

- Public Types inherited from Wt::WObject
typedef void(WObject::* Method) ()
 Typedef for a WObject method without arguments.
 

Detailed Description

A SAML authentication process.

The process implements the state machine that is needed to complete a SAML authentication cycle.

Constructor & Destructor Documentation

◆ Process()

Wt::Auth::Saml::Process::Process ( const Service service)
explicitprotected

Constructor.

See also
Service::createProcess()

Member Function Documentation

◆ authenticated()

Signal<Identity>& Wt::Auth::Saml::Process::authenticated ( )

Authentication signal.

This signal indicates the end of an authentication process. If the authentication process was successful, then the parameter is a valid and authentic identity. If the authentication process failed then the identity parameter is invalid, and you can get more information using error().

See also
startAuthenticate(), Service::getIdentity(), Identity::isValid()

◆ error()

const WString& Wt::Auth::Saml::Process::error ( ) const

Error information, in case authentication or identification failed.

The error message contains details when the authenticated() signal indicates an invalid identity.

◆ service()

const Service& Wt::Auth::Saml::Process::service ( ) const

Returns the SAML service which spawned this process.

See also
Service::createProcess()

◆ startAuthenticate()

void Wt::Auth::Saml::Process::startAuthenticate ( )

Starts an authorization and authentication process.

The authentication process ends with the authenticated() signal which signals the obtained identity.

Note
To be able to use a popup (instead of a page redirect), you should connect this method directly to an event signal, since popup windows are blocked in most web browsers unless they are the direct consequence of an event.