#include <builtinSASLMechanism.hpp>
Public Member Functions | |
| builtinSASLMechanism (shared_ptr< SASLContext > ctx, const string &name) | |
| ~builtinSASLMechanism () | |
| const string | getName () const |
| bool | step (shared_ptr< SASLSession > sess, const byte_t *challenge, const size_t challengeLen, byte_t **response, size_t *responseLen) |
| bool | isComplete () const |
| bool | hasInitialResponse () const |
| void | encode (shared_ptr< SASLSession > sess, const byte_t *input, const size_t inputLen, byte_t **output, size_t *outputLen) |
| void | decode (shared_ptr< SASLSession > sess, const byte_t *input, const size_t inputLen, byte_t **output, size_t *outputLen) |
Additional Inherited Members | |
| Protected Member Functions inherited from object | |
| object () | |
| object (const object &) | |
| object & | operator= (const object &) |
| virtual | ~object () |
Detailed Description
A built-in authentication mechanism that relies on the GNU SASL library.
Constructor & Destructor Documentation
◆ builtinSASLMechanism()
| builtinSASLMechanism | ( | shared_ptr< SASLContext > | ctx, |
| const string & | name ) |
◆ ~builtinSASLMechanism()
| ~builtinSASLMechanism | ( | ) |
Member Function Documentation
◆ decode()
|
virtual |
Decode data according to negotiated SASL mechanism.
This might mean that data is integrity or privacy protected.
- Parameters
-
sess SASL session input input buffer inputLen length of input buffer output output buffer (allocated bu the function, free with delete[]) outputLen length of output buffer
- Exceptions
-
exceptions::sasl_exception if an error occurred during the encoding of data (in this case, the values in 'output' and 'outputLen' are undetermined)
Implements SASLMechanism.
◆ encode()
|
virtual |
Encode data according to negotiated SASL mechanism.
This might mean that data is integrity or privacy protected.
- Parameters
-
sess SASL session input input buffer inputLen length of input buffer output output buffer (allocated bu the function, free with delete[]) outputLen length of output buffer
- Exceptions
-
exceptions::sasl_exception if an error occurred during the encoding of data (in this case, the values in 'output' and 'outputLen' are undetermined)
Implements SASLMechanism.
◆ getName()
|
virtual |
◆ hasInitialResponse()
|
virtual |
Determine if this mechanism has an optional initial response.
If true, caller should call step() with an empty challenge to get the initial response.
- Returns
- true if this mechanism has an initial response, or false otherwise
Implements SASLMechanism.
◆ isComplete()
|
virtual |
Check whether authentication has completed.
If false, more calls to evaluateChallenge() are needed to complete the authentication process).
- Returns
- true if the authentication has finished, or false otherwise
Implements SASLMechanism.
◆ step()
|
virtual |
Perform one step of SASL authentication.
Accept data from the server (challenge), process it and return data to be returned in response to the server.
If the challenge is empty (challengeLen == 0), the initial response is returned, if this mechanism has one.
- Parameters
-
sess SASL session challenge challenge sent from the server challengeLen length of challenge response response to send to the server (allocated by this function, free with delete[]) responseLen length of response buffer
- Returns
- true if authentication terminated successfully, or false if the authentication process should continue
- Exceptions
-
exceptions::sasl_exception if an error occurred during authentication (in this case, the values in 'response' and 'responseLen' are undetermined)
Implements SASLMechanism.
The documentation for this class was generated from the following files:
