TlmAuthPlugin

TlmAuthPlugin — an interface for implementing tlm authentication plugins

Functions

Properties

GHashTable * config Read / Write / Construct Only

Signals

Types and Values

Object Hierarchy

    GInterface
    ╰── TlmAuthPlugin

Includes

#include <tlm-auth-plugin.h>

Description

TlmAuthPlugin is an interface for implementing tlm authentication plugins.

The plugin API

Tlm authentication plugins provide authentication events: when they detect a user's intention to login, they issue a signal, containing user's credentials. Tlm acts upon this signal, by checking the credentials and starting a new session.

Example plugins

See example plugin implementation here:

https://github.com/01org/tlm/tree/master/src/plugins/default and here: https://github.com/01org/tlm/tree/master/src/plugins/nfc.

Functions

tlm_auth_plugin_start_authentication ()

gboolean
tlm_auth_plugin_start_authentication (TlmAuthPlugin *self,
                                      const gchar *seat_id,
                                      const gchar *pam_service,
                                      const gchar *user_name,
                                      const gchar *password);

This method should be used by plugin implementations to issue TlmAuthPlugin::authenticate signal.

Parameters

self

a plugin instance

 

seat_id

seat id

 

pam_service

PAM service

 

user_name

user name

 

password

password

 

Types and Values

struct TlmAuthPluginInterface

struct TlmAuthPluginInterface {
   GTypeInterface parent;
};

TlmAuthPluginInterface interface.

Members

GTypeInterface parent;

parent interface type.

 

Property Details

The “config” property

  “config”                   GHashTable *

This property holds a list of key-value pairs of plugin configuration taken from tlm.conf configuration file.

Flags: Read / Write / Construct Only

Signal Details

The “authenticate” signal

gboolean
user_function (TlmAuthPlugin *plugin,
               gchar         *seat_id,
               gchar         *pam_service,
               gchar         *user_name,
               gchar         *password,
               gpointer       user_data)

The signal is issued by the plugin, when a new authentication session should be started.

Parameters

plugin

the plugin which emitted the signal

 

seat_id

seat id

 

pam_service

pam service to be used

 

user_name

username to authenticate

 

password

password to use

 

user_data

user data set when the signal handler was connected.

 

Flags: Run Last