Session

Session

Object Hierarchy:

Description:

[ CCode ( type_id = "polkit_agent_session_get_type ()" ) ]
public class Session : Object

The Session class is an abstraction used for interacting with the native authentication system (for example PAM) for obtaining authorizations.

This class is typically used together with instances that are derived from the Listener abstract base class.

To perform the actual authentication, Session uses a trusted suid helper. The authentication conversation is done through a pipe. This is transparent; the user only need to handle the request, show_info, show_error and completed signals and invoke response in response to requests.

If the user successfully authenticates, the authentication helper will invoke a method on the PolicyKit daemon (see authentication_agent_response_sync ) with the given cookie. Upon receiving a positive response from the PolicyKit daemon (via the authentication helper), the completed signal will be emitted with the gained_authorization paramter set to true.

If the user is unable to authenticate, the completed signal will be emitted with the gained_authorization paramter set to false.

Namespace: PolkitAgent

Package: polkit-agent-1

Content:

Properties:

public string cookie { owned get; construct; }
The cookie obtained from the PolicyKit daemon
public Identity identity { owned get; construct; }
The identity to authenticate.

Creation methods:

public Session (Identity identity, string cookie)
Creates a new authentication session.

Methods:

public void cancel ()
Cancels an authentication session.
public void initiate ()
Initiates the authentication session.
public void response (string response)
Function for providing response to requests received via the request signal.

Signals:

public signal void completed (bool gained_authorization)
Emitted when the authentication session has been completed or cancelled.
public signal void request (string request, bool echo_on)
Emitted when the user is requested to answer a question.
public signal void show_error (string text)
Emitted when there is information related to an error condition to be displayed to the user.
public signal void show_info (string text)
Emitted when there is information to be displayed to the user.

Inherited Members:

All known members inherited from class GLib.Object