Top |
Functions
Properties
gboolean | authenticated | Read / Write |
gchar * | mechanism | Read / Write / Construct Only |
CamelService * | service | Read / Write / Construct Only |
gchar * | service-name | Read / Write / Construct Only |
Object Hierarchy
GObject ╰── CamelSasl ├── CamelSaslAnonymous ├── CamelSaslCramMd5 ├── CamelSaslDigestMd5 ├── CamelSaslGssapi ├── CamelSaslLogin ├── CamelSaslNTLM ├── CamelSaslPlain ╰── CamelSaslPOPB4SMTP
Functions
camel_sasl_new ()
CamelSasl * camel_sasl_new (const gchar *service_name
,const gchar *mechanism
,CamelService *service
);
camel_sasl_try_empty_password_sync ()
gboolean camel_sasl_try_empty_password_sync (CamelSasl *sasl
,GCancellable *cancellable
,GError **error
);
Returns
whether or not sasl
can attempt to authenticate without a
password being provided by the caller. This will be TRUE
for an
authentication method which can attempt to use single-sign-on
credentials, but which can fall back to using a provided password
so it still has the need_password
flag set in its description.
Since: 3.2
camel_sasl_try_empty_password ()
void camel_sasl_try_empty_password (CamelSasl *sasl
,gint io_priority
,GCancellable *cancellable
,GAsyncReadyCallback callback
,gpointer user_data
);
Asynchronously determine whether sasl
can be used for password-less
authentication, for example single-sign-on using system credentials.
When the operation is finished, callback
will be called. You can then
call camel_sasl_try_empty_password_finish()
to get the result of the
operation.
Parameters
sasl |
||
io_priority |
the I/O priority of the request |
|
cancellable |
optional GCancellable object, or |
|
callback |
a GAsyncReadyCallback to call when the request is satisfied |
|
user_data |
data to pass to the callback function |
Since: 3.2
camel_sasl_try_empty_password_finish ()
gboolean camel_sasl_try_empty_password_finish (CamelSasl *sasl
,GAsyncResult *result
,GError **error
);
Finishes the operation started with camel_sasl_try_empty_password()
.
Since: 3.2
camel_sasl_get_authenticated ()
gboolean
camel_sasl_get_authenticated (CamelSasl *sasl
);
Returns
whether or not sasl
has successfully authenticated the
user. This will be TRUE
after it returns the last needed response.
The caller must still pass that information on to the server and
verify that it has accepted it.
camel_sasl_set_authenticated ()
void camel_sasl_set_authenticated (CamelSasl *sasl
,gboolean authenticated
);
Since: 2.32
camel_sasl_get_service_name ()
const gchar *
camel_sasl_get_service_name (CamelSasl *sasl
);
Since: 2.32
camel_sasl_challenge_sync ()
GByteArray * camel_sasl_challenge_sync (CamelSasl *sasl
,GByteArray *token
,GCancellable *cancellable
,GError **error
);
If token
is NULL
, generate the initial SASL message to send to
the server. (This will be NULL
if the client doesn't initiate the
exchange.) Otherwise, token
is a challenge from the server, and
the return value is the response.
Free the returned GByteArray with g_byte_array_free()
.
camel_sasl_challenge ()
void camel_sasl_challenge (CamelSasl *sasl
,GByteArray *token
,gint io_priority
,GCancellable *cancellable
,GAsyncReadyCallback callback
,gpointer user_data
);
If token
is NULL
, asynchronously generate the initial SASL message
to send to the server. (This will be NULL
if the client doesn't
initiate the exchange.) Otherwise, token
is a challenge from the
server, and the asynchronous result is the response.
When the operation is finished, callback
will be called. You can then
call camel_sasl_challenge_finish()
to get the result of the operation.
Parameters
sasl |
||
token |
a token, or |
|
io_priority |
the I/O priority of the request |
|
cancellable |
optional GCancellable object, or |
|
callback |
a GAsyncReadyCallback to call when the request is satisfied |
|
user_data |
data to pass to the callback function |
Since: 3.0
camel_sasl_challenge_finish ()
GByteArray * camel_sasl_challenge_finish (CamelSasl *sasl
,GAsyncResult *result
,GError **error
);
Finishes the operation started with camel_sasl_challenge()
. Free the
returned GByteArray with g_byte_array_free()
.
Since: 3.0
camel_sasl_challenge_base64_sync ()
gchar * camel_sasl_challenge_base64_sync (CamelSasl *sasl
,const gchar *token
,GCancellable *cancellable
,GError **error
);
As with camel_sasl_challenge_sync()
, but the challenge token
and the
response are both base64-encoded.
Parameters
sasl |
||
token |
a base64-encoded token |
|
cancellable |
optional GCancellable object, or |
|
error |
Since: 3.0
camel_sasl_challenge_base64 ()
void camel_sasl_challenge_base64 (CamelSasl *sasl
,const gchar *token
,gint io_priority
,GCancellable *cancellable
,GAsyncReadyCallback callback
,gpointer user_data
);
As with camel_sasl_challenge()
, but the challenge token
and the
response are both base64-encoded.
When the operation is finished, callback
will be called. You can
then call camel_store_challenge_base64_finish()
to get the result of
the operation.
Parameters
sasl |
||
token |
a base64-encoded token |
|
io_priority |
the I/O priority of the request |
|
cancellable |
optional GCancellable object, or |
|
callback |
a GAsyncReadyCallback to call when the request is satisfied |
|
user_data |
data to pass to the callback function |
Since: 3.0
camel_sasl_challenge_base64_finish ()
gchar * camel_sasl_challenge_base64_finish (CamelSasl *sasl
,GAsyncResult *result
,GError **error
);
Finishes the operation started with camel_sasl_challenge_base64()
.
Since: 3.0
camel_sasl_authtype_list ()
GList *
camel_sasl_authtype_list (gboolean include_plain
);
Returns
a GList of SASL-supported authtypes. The caller must free the list, but not the contents.
[element-type CamelServiceAuthType][transfer container]