aboutsummaryrefslogtreecommitdiffstats
path: root/roles/polkit/README.md
blob: 1d4574121dbb8a798ac7601b51a6e0501c0d3868 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
Polkit
======

Description
-----------

The `polkit` role simply adds a [polkit rule](https://www.freedesktop.org/software/polkit/docs/latest/polkit.8.html)
to allow a given group to perform privleged operations.

The only time `polkit` escalation must be used (rather than `sudo`) seems to be
when performing privileged operations from the GNOME interface.


Variables
---------

This role **accepts** the following variables:

Variable                         | Default   | Description
---------------------------------|-----------|------------
`polkit_admin_group`             | `wheel`   | Group name for system administrators

This role **exports** the following variables:

Usage
-----

Example playbook:

````yaml
- hosts: all
  roles:
    - role: polkit
      vars:
        polkit_admin_group: sysadmins
````