aboutsummaryrefslogtreecommitdiffstats
path: root/roles/polkit/README.md
blob: 05015d928ee3f16f8e27e900acb6396985bf3915 (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


Usage
-----

Example playbook:

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