Plasma::AuthorizationManager Class Reference

Allows authorization of access to plasma services. More...

#include <authorizationmanager.h>

Inheritance diagram for Plasma::AuthorizationManager:

List of all members.

Public Types
enum	AuthorizationPolicy { DenyAll = 0, TrustedOnly = 1, PinPairing = 2, Custom = 256 }
Signals
void	readyForRemoteAccess ()
Public Member Functions
void	setAuthorizationInterface (AuthorizationInterface *interface)
void	setAuthorizationPolicy (AuthorizationPolicy policy)
Static Public Member Functions
static AuthorizationManager *	self ()

---

Detailed Description

Allows authorization of access to plasma services.

This is the class where every message to or from another machine passes through. It's responsibilities are:

• creating/keeping a credentials used for message signing.
• verifying credentials of incoming messages.
• testing whether or not the sender is allowed to access the requested resource by testing the request to a set of rules.
• allowing the shell to respond to a remote request that doesn't match any of the rules that are in effect. Besides internal use in libplasma, the only moment you'll need to access this class is when you implement a plasma shell.

Since:

4.4

Definition at line 56 of file authorizationmanager.h.

---

Member Enumeration Documentation

enum Plasma::AuthorizationManager::AuthorizationPolicy

Enumerator:

DenyAll
TrustedOnly	< Don't allow any incoming connections Standard PIN pairing for untrusted connections
PinPairing
Custom	< Only allow connections from trusted machines

Definition at line 61 of file authorizationmanager.h.

---

Member Function Documentation

void Plasma::AuthorizationManager::readyForRemoteAccess

(

)

[signal]

fires when the AuthorizationManager is ready for accesssing remote plasmoids, meaning the private key has been unlocked by the user.

AuthorizationManager * Plasma::AuthorizationManager::self

(

)

[static]

Singleton pattern accessor.

Definition at line 65 of file authorizationmanager.cpp.

void Plasma::AuthorizationManager::setAuthorizationInterface

(

AuthorizationInterface *

interface

)

Register an implementation of AuthorizationInterface.

Use this to make your shell handle authorization requests. This can only be set once to avoid that malicious plugins can change this.

Definition at line 117 of file authorizationmanager.cpp.

void Plasma::AuthorizationManager::setAuthorizationPolicy

(

AuthorizationPolicy

policy

)

Set a policy used for authorizing incoming connections.

You can either use one of the included policies, Default is to deny all incoming connections. This can only be set once to avoid that malicious plugins can change this. This means that you should ALWAYS call this function in any plasma shell, even if you like to use the default DenyAll policy.

Definition at line 82 of file authorizationmanager.cpp.

---

The documentation for this class was generated from the following files:

• authorizationmanager.h
• authorizationmanager.cpp