Top | ![]() |
![]() |
![]() |
![]() |
gboolean | authenticated | Read / Write |
char * | mechanism | Read / Write / Construct Only |
CamelService * | service | Read / Write / Construct Only |
char * | service-name | Read / Write / Construct Only |
GObject ╰── CamelSasl ├── CamelSaslAnonymous ├── CamelSaslCramMd5 ├── CamelSaslDigestMd5 ├── CamelSaslGssapi ├── CamelSaslLogin ├── CamelSaslNTLM ├── CamelSaslPlain ├── CamelSaslPOPB4SMTP ╰── CamelSaslXOAuth2
CamelSasl * camel_sasl_new (const gchar *service_name
,const gchar *mechanism
,CamelService *service
);
gboolean camel_sasl_try_empty_password_sync (CamelSasl *sasl
,GCancellable *cancellable
,GError **error
);
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
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.
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
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
gboolean
camel_sasl_get_authenticated (CamelSasl *sasl
);
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.
void camel_sasl_set_authenticated (CamelSasl *sasl
,gboolean authenticated
);
Since: 2.32
const gchar *
camel_sasl_get_service_name (CamelSasl *sasl
);
Since: 2.32
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()
.
the SASL response or NULL
. If an error
occurred, error
will also be set.
[transfer full][nullable]
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.
sasl |
||
token |
a token, or |
[nullable] |
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
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()
.
the SASL response or NULL
. If an
error occurred, error
will also be set.
[transfer full][nullable]
Since: 3.0
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.
sasl |
||
token |
a base64-encoded token |
|
cancellable |
optional GCancellable object, or |
|
error |
Since: 3.0
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_sasl_challenge_base64_finish()
to get the result of
the operation.
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
gchar * camel_sasl_challenge_base64_finish (CamelSasl *sasl
,GAsyncResult *result
,GError **error
);
Finishes the operation started with camel_sasl_challenge_base64()
.
Since: 3.0
GList *
camel_sasl_authtype_list (gboolean include_plain
);
a GList of SASL-supported authtypes. The caller must free the list, but not the contents.
[element-type CamelServiceAuthType][transfer container]
CamelServiceAuthType *
camel_sasl_authtype (const gchar *mechanism
);
a CamelServiceAuthType for the given mechanism, if it is supported.
[transfer none][nullable]
gboolean
camel_sasl_is_xoauth2_alias (const gchar *mechanism
);
Checks whether exists a CamelSasl method for the mechanism
and
whether it derives from CamelSaslXOAuth2. Such mechanisms are
also treated as XOAUTH2, even their real name is different.
whether exists CamelSasl for the given mechanism
,
which also derives from CamelSaslXOAuth2.
Since: 3.28
“authenticated”
property“authenticated” gboolean
Owner: CamelSasl
Flags: Read / Write
Default value: FALSE
“mechanism”
property “mechanism” char *
Owner: CamelSasl
Flags: Read / Write / Construct Only
Default value: NULL
“service”
property“service” CamelService *
Owner: CamelSasl
Flags: Read / Write / Construct Only