Top |
org.freedesktop.PolicyKit1.AuthenticationAgent Interfaceorg.freedesktop.PolicyKit1.AuthenticationAgent Interface — Authentication Agent Interface |
BeginAuthentication (IN String action_id, IN String message, IN String icon_name, IN Dict<String,String> details, IN String cookie, IN Array<Identity> identities) CancelAuthentication (IN String cookie)
This D-Bus interface is used for communication between the system-wide PolicyKit daemon and one or more authentication agents each running in a user session.
An authentication agent must implement this interface and register (passing the object path of the object implementing the interface) using the RegisterAuthenticationAgent() and UnregisterAuthenticationAgent() methods on the org.freedesktop.PolicyKit1.Authority interface of the PolicyKit daemon.
BeginAuthentication (IN String action_id, IN String message, IN String icon_name, IN Dict<String,String> details, IN String cookie, IN Array<Identity> identities)
Called by the PolicyKit daemon when the authentication agent
needs the user to authenticate as one of the identities in
identities
for the action with the
identifier action_id
.
Upon succesful authentication, the authentication agent must invoke the AuthenticationAgentResponse2() method on the org.freedesktop.PolicyKit1.Authority interface of the PolicyKit daemon before returning. This is normally achieved via the PolkitAgentSession API, which invokes a private setuid helper process to verify the authentication.
The authentication agent should not return until after authentication is complete. If the user dismisses the authentication dialog, the authentication agent should return the org.freedesktop.PolicyKit1.Error.Cancelled error.
|
The identifier for the action that the user is authentication for. |
|
The message to display to the user. This is translated into the locale passed when registering the authentication agent using RegisterAuthenticationAgent(). |
|
The themed icon describing the action or the empty string if no icon is set. |
|
Details about the authentication request. This is a dictionary
of key/value pairs where both key and value are strings.
Known key/value-pairs include
|
|
A cookie identifying the authentication request. |
|
An array of Identity structs that the user can use for authentication. |