Top |
Channel Authentication interfacesChannel Authentication interfaces — client-side wrappers for authentication channels |
The ServerAuthentication channel type represents a request for client/UI processes to carry out authentication with a server, including password authentication (prove that you are who you say you are) and captcha authentication (prove that you are not a bot).
TpProxyPendingCall * tp_cli_channel_interface_sasl_authentication_call_abort_sasl (TpChannel *proxy
,gint timeout_ms
,guint in_Reason
,const gchar *in_Debug_Message
,tp_cli_channel_interface_sasl_authentication_callback_for_abort_sasl callback
,gpointer user_data
,GDestroyNotify destroy
,GObject *weak_object
);
Start a AbortSASL method call.
<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>Abort the current authentication try.</p> <p>If the current status is SASL_Status_Server_Failed or SASL_Status_Client_Failed, this method returns successfully, but has no further effect. If the current status is SASL_Status_Succeeded or SASL_Status_Client_Accepted then NotAvailable is raised. Otherwise, it changes the channel's state to SASL_Status_Client_Failed, with an appropriate error name and reason code.</p>
proxy |
the TpProxy |
|
timeout_ms |
the timeout in milliseconds, or -1 to use the default |
|
in_Reason |
Used to pass an 'in' argument: Reason for abort. (TpSASLAbortReason) |
|
in_Debug_Message |
Used to pass an 'in' argument: Debug message for abort. |
|
callback |
called when the method call succeeds or fails;
may be |
|
user_data |
user-supplied data passed to the callback;
must be |
|
destroy |
called with the user_data as argument, after the
call has succeeded, failed or been cancelled;
must be |
|
weak_object |
If not |
a TpProxyPendingCall representing the call in progress. It is borrowed from the object, and will become invalid when the callback is called, the call is cancelled or the TpProxy becomes invalid.
TpProxyPendingCall * tp_cli_channel_interface_sasl_authentication_call_accept_sasl (TpChannel *proxy
,gint timeout_ms
,tp_cli_channel_interface_sasl_authentication_callback_for_accept_sasl callback
,gpointer user_data
,GDestroyNotify destroy
,GObject *weak_object
);
Start a AcceptSASL method call.
<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>If the channel's status is SASL_Status_Server_Succeeded, this method confirms successful authentication and advances the status of the channel to SASL_Status_Succeeded.</p> <p>If the channel's status is SASL_Status_In_Progress, calling this method indicates that the last <tp:member-ref>NewChallenge</tp:member-ref> signal was in fact additional data sent after a successful SASL negotiation, and declares that from the client's point of view, authentication was successful. This advances the state of the channel to SASL_Status_Client_Accepted.</p> <p>In mechanisms where the server authenticates itself to the client, calling this method indicates that the client considers this to have been successful. In the case of <tp:dbus-ref namespace="ofdT.Channel.Type">ServerAuthentication</tp:dbus-ref> channels, this means that the connection manager MAY continue to connect, and MAY advance the <tp:dbus-ref namespace="ofdT">Connection.Status</tp:dbus-ref> to Connected.</p>
proxy |
the TpProxy |
|
timeout_ms |
the timeout in milliseconds, or -1 to use the default |
|
callback |
called when the method call succeeds or fails;
may be |
|
user_data |
user-supplied data passed to the callback;
must be |
|
destroy |
called with the user_data as argument, after the
call has succeeded, failed or been cancelled;
must be |
|
weak_object |
If not |
a TpProxyPendingCall representing the call in progress. It is borrowed from the object, and will become invalid when the callback is called, the call is cancelled or the TpProxy becomes invalid.
TpProxyPendingCall * tp_cli_channel_interface_sasl_authentication_call_respond (TpChannel *proxy
,gint timeout_ms
,const GArray *in_Response_Data
,tp_cli_channel_interface_sasl_authentication_callback_for_respond callback
,gpointer user_data
,GDestroyNotify destroy
,GObject *weak_object
);
Start a Respond method call.
<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>Send a response to the the last challenge received via <tp:member-ref>NewChallenge</tp:member-ref>.</p>
proxy |
the TpProxy |
|
timeout_ms |
the timeout in milliseconds, or -1 to use the default |
|
in_Response_Data |
Used to pass an 'in' argument: The response data. |
|
callback |
called when the method call succeeds or fails;
may be |
|
user_data |
user-supplied data passed to the callback;
must be |
|
destroy |
called with the user_data as argument, after the
call has succeeded, failed or been cancelled;
must be |
|
weak_object |
If not |
a TpProxyPendingCall representing the call in progress. It is borrowed from the object, and will become invalid when the callback is called, the call is cancelled or the TpProxy becomes invalid.
TpProxyPendingCall * tp_cli_channel_interface_sasl_authentication_call_start_mechanism (TpChannel *proxy
,gint timeout_ms
,const gchar *in_Mechanism
,tp_cli_channel_interface_sasl_authentication_callback_for_start_mechanism callback
,gpointer user_data
,GDestroyNotify destroy
,GObject *weak_object
);
Start a StartMechanism method call.
<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>Start an authentication try using <var>Mechanism</var>, without sending initial data (an "initial response" as defined in RFC 4422).</p> <tp:rationale> <p>This method is appropriate for mechanisms where the client cannot send anything until it receives a challenge from the server, such as <code><a href="http://tools.ietf.org/html/rfc2831">DIGEST-MD5</a></code> in "initial authentication" mode.</p> </tp:rationale>
proxy |
the TpProxy |
|
timeout_ms |
the timeout in milliseconds, or -1 to use the default |
|
in_Mechanism |
Used to pass an 'in' argument: The chosen mechanism. |
|
callback |
called when the method call succeeds or fails;
may be |
|
user_data |
user-supplied data passed to the callback;
must be |
|
destroy |
called with the user_data as argument, after the
call has succeeded, failed or been cancelled;
must be |
|
weak_object |
If not |
a TpProxyPendingCall representing the call in progress. It is borrowed from the object, and will become invalid when the callback is called, the call is cancelled or the TpProxy becomes invalid.
TpProxyPendingCall * tp_cli_channel_interface_sasl_authentication_call_start_mechanism_with_data (TpChannel *proxy
,gint timeout_ms
,const gchar *in_Mechanism
,const GArray *in_Initial_Data
,tp_cli_channel_interface_sasl_authentication_callback_for_start_mechanism_with_data callback
,gpointer user_data
,GDestroyNotify destroy
,GObject *weak_object
);
Start a StartMechanismWithData method call.
<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>Start an authentication try using <var>Mechanism</var>, and send <var>Initial_Data</var> as the "initial response" defined in <a href="http://tools.ietf.org/html/rfc4422section-3.3">RFC 4422 §3.3</a>.</p> <tp:rationale> <p>This method is appropriate for mechanisms where the client may send data first, such as <code>PLAIN</code>, or must send data first, such as <code><a href="http://tools.ietf.org/html/rfc2831">DIGEST-MD5</a></code> in "subsequent authentication" mode.</p> <p>Having two methods allows any mechanism where it makes a difference to distinguish between the absence of an initial response (<tp:member-ref>StartMechanism</tp:member-ref>) and a zero-byte initial response (StartMechanismWithData, with Initial_Data empty).</p> </tp:rationale> <p>If the <tp:member-ref>HasInitialData</tp:member-ref> property is false, this indicates that the underlying protocol does not make it possible to send initial data. In such protocols, this method may only be used for the <code>X-TELEPATHY-</code> pseudo-mechanisms (such as <code>X-TELEPATHY-PASSWORD</code>), and will fail if used with an ordinary SASL mechanism.</p> <tp:rationale> <p>For instance, the IRC SASL extension implemented in Charybdis and Atheme does not support initial data - the first message in the exchange only carries the mechanism. This is significant if using <code><a href="http://tools.ietf.org/html/rfc2831">DIGEST-MD5</a></code>, which cannot be used in the faster "subsequent authentication" mode on a protocol not supporting initial data.</p> </tp:rationale>
proxy |
the TpProxy |
|
timeout_ms |
the timeout in milliseconds, or -1 to use the default |
|
in_Mechanism |
Used to pass an 'in' argument: The chosen mechanism. |
|
in_Initial_Data |
Used to pass an 'in' argument: Initial data (an "initial response" in RFC 4422's terminology) to send with the mechanism. |
|
callback |
called when the method call succeeds or fails;
may be |
|
user_data |
user-supplied data passed to the callback;
must be |
|
destroy |
called with the user_data as argument, after the
call has succeeded, failed or been cancelled;
must be |
|
weak_object |
If not |
a TpProxyPendingCall representing the call in progress. It is borrowed from the object, and will become invalid when the callback is called, the call is cancelled or the TpProxy becomes invalid.
void (*tp_cli_channel_interface_sasl_authentication_callback_for_abort_sasl) (TpChannel *proxy
,const GError *error
,gpointer user_data
,GObject *weak_object
);
Signature of the callback called when a AbortSASL method call succeeds or fails.
void (*tp_cli_channel_interface_sasl_authentication_callback_for_accept_sasl) (TpChannel *proxy
,const GError *error
,gpointer user_data
,GObject *weak_object
);
Signature of the callback called when a AcceptSASL method call succeeds or fails.
void (*tp_cli_channel_interface_sasl_authentication_callback_for_respond) (TpChannel *proxy
,const GError *error
,gpointer user_data
,GObject *weak_object
);
Signature of the callback called when a Respond method call succeeds or fails.
void (*tp_cli_channel_interface_sasl_authentication_callback_for_start_mechanism) (TpChannel *proxy
,const GError *error
,gpointer user_data
,GObject *weak_object
);
Signature of the callback called when a StartMechanism method call succeeds or fails.
void (*tp_cli_channel_interface_sasl_authentication_callback_for_start_mechanism_with_data) (TpChannel *proxy
,const GError *error
,gpointer user_data
,GObject *weak_object
);
Signature of the callback called when a StartMechanismWithData method call succeeds or fails.
TpProxySignalConnection * tp_cli_channel_interface_sasl_authentication_connect_to_new_challenge (TpChannel *proxy
,tp_cli_channel_interface_sasl_authentication_signal_callback_new_challenge callback
,gpointer user_data
,GDestroyNotify destroy
,GObject *weak_object
,GError **error
);
Connect a handler to the signal NewChallenge.
<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>Emitted when a new challenge is received from the server, or when a message indicating successful authentication and containing additional data is received from the server.</p> <p>When the channel's handler is ready to proceed, it should respond to the challenge by calling <tp:member-ref>Respond</tp:member-ref>, or respond to the additional data by calling <tp:member-ref>AcceptSASL</tp:member-ref>. Alternatively, it may call <tp:member-ref>AbortSASL</tp:member-ref> to abort authentication.</p>
proxy |
A TpChannel or subclass |
|
callback |
Callback to be called when the signal is received |
|
user_data |
User-supplied data for the callback |
|
destroy |
Destructor for the user-supplied data, which
will be called when this signal is disconnected, or
before this function returns |
|
weak_object |
A GObject which will be weakly referenced; if it is destroyed, this callback will automatically be disconnected |
|
error |
If not |
a TpProxySignalConnection containing all of the
above, which can be used to disconnect the signal; or
NULL
if the proxy does not have the desired interface
or has become invalid.
TpProxySignalConnection * tp_cli_channel_interface_sasl_authentication_connect_to_sasl_status_changed (TpChannel *proxy
,tp_cli_channel_interface_sasl_authentication_signal_callback_sasl_status_changed callback
,gpointer user_data
,GDestroyNotify destroy
,GObject *weak_object
,GError **error
);
Connect a handler to the signal SASLStatusChanged.
Emitted when the status of the channel changes.
proxy |
A TpChannel or subclass |
|
callback |
Callback to be called when the signal is received |
|
user_data |
User-supplied data for the callback |
|
destroy |
Destructor for the user-supplied data, which
will be called when this signal is disconnected, or
before this function returns |
|
weak_object |
A GObject which will be weakly referenced; if it is destroyed, this callback will automatically be disconnected |
|
error |
If not |
a TpProxySignalConnection containing all of the
above, which can be used to disconnect the signal; or
NULL
if the proxy does not have the desired interface
or has become invalid.
TpProxyPendingCall * tp_cli_channel_interface_captcha_authentication_call_answer_captchas (TpChannel *proxy
,gint timeout_ms
,GHashTable *in_Answers
,tp_cli_channel_interface_captcha_authentication_callback_for_answer_captchas callback
,gpointer user_data
,GDestroyNotify destroy
,GObject *weak_object
);
Start a AnswerCaptchas method call.
<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>Answer as many captchas as desired and/or required.</p> <p>Callable in state Local_Pending only. State changes to Remote_Pending.</p>
proxy |
the TpProxy |
|
timeout_ms |
the timeout in milliseconds, or -1 to use the default |
|
in_Answers |
Used to pass an 'in' argument: The mapping of captcha IDs to answer strings. |
|
callback |
called when the method call succeeds or fails;
may be |
|
user_data |
user-supplied data passed to the callback;
must be |
|
destroy |
called with the user_data as argument, after the
call has succeeded, failed or been cancelled;
must be |
|
weak_object |
If not |
a TpProxyPendingCall representing the call in progress. It is borrowed from the object, and will become invalid when the callback is called, the call is cancelled or the TpProxy becomes invalid.
TpProxyPendingCall * tp_cli_channel_interface_captcha_authentication_call_cancel_captcha (TpChannel *proxy
,gint timeout_ms
,guint in_Reason
,const gchar *in_Debug_Message
,tp_cli_channel_interface_captcha_authentication_callback_for_cancel_captcha callback
,gpointer user_data
,GDestroyNotify destroy
,GObject *weak_object
);
Start a CancelCaptcha method call.
<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>Cancel. State changes to Failed with error NotAvailable or Cancelled if it isn't already Failed. All you can do now is to close the channel.</p>
proxy |
the TpProxy |
|
timeout_ms |
the timeout in milliseconds, or -1 to use the default |
|
in_Reason |
Used to pass an 'in' argument: Reason for cancelling. This MAY be used to choose an error response to the remote server, and SHOULD also be reflected in the <tp:member-ref>CaptchaError</tp:member-ref>. (TpCaptchaCancelReason) |
|
in_Debug_Message |
Used to pass an 'in' argument: A textual description of the reason for cancelling, supplied by the Handler. This message SHOULD NOT be sent to the remote server, but SHOULD be copied into the 'debug-message' field of the <tp:member-ref>CaptchaErrorDetails</tp:member-ref> and <tp:dbus-ref namespace="ofdT.Connection">ConnectionError</tp:dbus-ref>. |
|
callback |
called when the method call succeeds or fails;
may be |
|
user_data |
user-supplied data passed to the callback;
must be |
|
destroy |
called with the user_data as argument, after the
call has succeeded, failed or been cancelled;
must be |
|
weak_object |
If not |
a TpProxyPendingCall representing the call in progress. It is borrowed from the object, and will become invalid when the callback is called, the call is cancelled or the TpProxy becomes invalid.
TpProxyPendingCall * tp_cli_channel_interface_captcha_authentication_call_get_captcha_data (TpChannel *proxy
,gint timeout_ms
,guint in_ID
,const gchar *in_Mime_Type
,tp_cli_channel_interface_captcha_authentication_callback_for_get_captcha_data callback
,gpointer user_data
,GDestroyNotify destroy
,GObject *weak_object
);
Start a GetCaptchaData method call.
<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>Fetch and return the captcha data. In protocols where captchas are downloaded out-of-band (for instance via HTTP), the connection manager is expected to do so.</p> <p>Returns an empty array if the type was "qa"</p> <tp:rationale> <p>If audio-based and image-based captchas are both available, we don't want to waste time downloading the audio until/unless the user asks to hear it. The extra D-Bus round-trips are not a problem, since they are expected to be quick compared with the time taken for the user to solve the captcha.</p> </tp:rationale>
proxy |
the TpProxy |
|
timeout_ms |
the timeout in milliseconds, or -1 to use the default |
|
in_ID |
Used to pass an 'in' argument: The ID of the captcha of which to retrieve data. |
|
in_Mime_Type |
Used to pass an 'in' argument: MIME type picked by the Handler, chosen from the list of MIME types received in <tp:member-ref>GetCaptchas</tp:member-ref>. <tp:rationale> XEP-0158 allows the same captcha to be made available in multiple formats, for instance the same spoken question as audio/x-wav, application/ogg and audio/speex. </tp:rationale> |
|
callback |
called when the method call succeeds or fails;
may be |
|
user_data |
user-supplied data passed to the callback;
must be |
|
destroy |
called with the user_data as argument, after the
call has succeeded, failed or been cancelled;
must be |
|
weak_object |
If not |
a TpProxyPendingCall representing the call in progress. It is borrowed from the object, and will become invalid when the callback is called, the call is cancelled or the TpProxy becomes invalid.
TpProxyPendingCall * tp_cli_channel_interface_captcha_authentication_call_get_captchas (TpChannel *proxy
,gint timeout_ms
,tp_cli_channel_interface_captcha_authentication_callback_for_get_captchas callback
,gpointer user_data
,GDestroyNotify destroy
,GObject *weak_object
);
Start a GetCaptchas method call.
<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>Gets information regarding each of the captcha methods available and which and how many need to be successfully answered</p> <p>To call this method successfully, the state must be Local_Pending or Try_Again. If it is Local_Pending, it remains Local_Pending. If called more than once while in Local_Pending state, or if the state is Try_Again, this method fetches a new set of captcha challenges, if possible, and the state returns to Local_Pending.</p> <tp:rationale> <p>For instance, you could call GetCaptchas again from Local_Pending state if the user indicates that they can't understand the initially-offered captcha.</p> <p>This is a method, not a property, so that it can be used to fetch more than one set of captcha challenges, and so that change notification is not required. Only the Handler should call this method and calling GetAll would not reduce round-trips, so the usual reasons to prefer a property do not apply here.</p> </tp:rationale>
proxy |
the TpProxy |
|
timeout_ms |
the timeout in milliseconds, or -1 to use the default |
|
callback |
called when the method call succeeds or fails;
may be |
|
user_data |
user-supplied data passed to the callback;
must be |
|
destroy |
called with the user_data as argument, after the
call has succeeded, failed or been cancelled;
must be |
|
weak_object |
If not |
a TpProxyPendingCall representing the call in progress. It is borrowed from the object, and will become invalid when the callback is called, the call is cancelled or the TpProxy becomes invalid.
void (*tp_cli_channel_interface_captcha_authentication_callback_for_answer_captchas) (TpChannel *proxy
,const GError *error
,gpointer user_data
,GObject *weak_object
);
Signature of the callback called when a AnswerCaptchas method call succeeds or fails.
void (*tp_cli_channel_interface_captcha_authentication_callback_for_cancel_captcha) (TpChannel *proxy
,const GError *error
,gpointer user_data
,GObject *weak_object
);
Signature of the callback called when a CancelCaptcha method call succeeds or fails.
void (*tp_cli_channel_interface_captcha_authentication_callback_for_get_captcha_data) (TpChannel *proxy
,const GArray *out_Captcha_Data
,const GError *error
,gpointer user_data
,GObject *weak_object
);
Signature of the callback called when a GetCaptchaData method call succeeds or fails.
void (*tp_cli_channel_interface_captcha_authentication_callback_for_get_captchas) (TpChannel *proxy
,const GPtrArray *out_Captcha_Info
,guint out_Number_Required
,const gchar *out_Language
,const GError *error
,gpointer user_data
,GObject *weak_object
);
Signature of the callback called when a GetCaptchas method call succeeds or fails.
proxy |
the proxy on which the call was made |
|
out_Captcha_Info |
Used to return an 'out' argument if |
|
out_Number_Required |
Used to return an 'out' argument if |
|
out_Language |
Used to return an 'out' argument if |
|
error |
|
|
user_data |
user-supplied data |
|
weak_object |
user-supplied object |