TpBasePasswordChannel

TpBasePasswordChannel — a simple X-TELEPATHY-PASSWORD channel

Synopsis

#include <telepathy-glib/telepathy-glib.h>

                    TpBasePasswordChannel;

Object Hierarchy

  GObject
   +----TpBaseChannel
         +----TpBasePasswordChannel

Implemented Interfaces

TpBasePasswordChannel implements TpSvcDBusProperties, TpSvcChannel, TpChannelIface, TpExportableChannel, TpSvcChannelTypeServerAuthentication and TpSvcChannelInterfaceSASLAuthentication.

Properties

  "authentication-method"    gchar*                : Read
  "authorization-identity"   gchar*                : Read
  "available-mechanisms"     GStrv                 : Read
  "can-try-again"            gboolean              : Read
  "default-realm"            gchar*                : Read
  "default-username"         gchar*                : Read
  "has-initial-data"         gboolean              : Read
  "may-save-response"        gboolean              : Read / Write / Construct Only
  "sasl-error"               gchar*                : Read
  "sasl-error-details"       GHashTable_gchararray+GValue_*  : Read
  "sasl-status"              guint                 : Read

Signals

  "finished"                                       : Run Last

Description

This class implements a SASL Authentication channel with the X-TELEPATHY-PASSWORD SASL mechanism. Most of the time, you should not use or instantiate this class directly. It is used by TpSimplePasswordManager behind the scenes. In some special circumstances (e.g. when the authentication channel needs to implement additional interfaces), it may be necessary to create your own custom authentication channels instead of letting TpSimplePasswordManager create them automatically. In this case, you should derive your channel from this class and then pass the channel as an argument to tp_simple_password_manager_prompt_for_channel_async().

Details

TpBasePasswordChannel

typedef struct _TpBasePasswordChannel TpBasePasswordChannel;

Data structure representing a channel implementing a SASL Authentication channel with the X-TELEPATHY-PASSWORD SASL mechanism.

Since 0.13.15

Property Details

The "authentication-method" property

  "authentication-method"    gchar*                : Read

Interface of authentication method.

Default value: ""


The "authorization-identity" property

  "authorization-identity"   gchar*                : Read

Authorization identity.

Default value: ""


The "available-mechanisms" property

  "available-mechanisms"     GStrv                 : Read

The set of mechanisms the server advertised.


The "can-try-again" property

  "can-try-again"            gboolean              : Read

Whether StartMechanism will work in failed states.

Default value: FALSE


The "default-realm" property

  "default-realm"            gchar*                : Read

DefaultRealm.

Default value: ""


The "default-username" property

  "default-username"         gchar*                : Read

DefaultUsername.

Default value: ""


The "has-initial-data" property

  "has-initial-data"         gboolean              : Read

Whether the StartMechanismWithData can be called.

Default value: FALSE


The "may-save-response" property

  "may-save-response"        gboolean              : Read / Write / Construct Only

Whether the client may save the authentication response.

Default value: TRUE


The "sasl-error" property

  "sasl-error"               gchar*                : Read

SASL error.

Default value: ""


The "sasl-error-details" property

  "sasl-error-details"       GHashTable_gchararray+GValue_*  : Read

SASL error details.


The "sasl-status" property

  "sasl-status"              guint                 : Read

The status of the current SASL authentication.

Allowed values: <= 7

Default value: 0

Signal Details

The "finished" signal

void                user_function                      (TpBasePasswordChannel *password,
                                                        GString               *domain,
                                                        guint                  code,
                                                        gint                   message,
                                                        gchar                 *arg4,
                                                        gpointer               user_data)      : Run Last

Emitted when either the password has been provided by the user or the authentication has been aborted.

password :

the password provided by the user, or NULL if the authentication has been aborted

domain :

domain of a GError indicating why the authentication has been aborted, or 0

code :

error code of a GError indicating why the authentication has been aborted, or 0

message :

a message associated with the error, or NULL

user_data :

user data set when the signal handler was connected.

Since 0.13.15