aboutsummaryrefslogtreecommitdiffstats
path: root/roles/freeipa_system_account/README.md
blob: 68e4341fb0438d402256dace3ce99445c5338a21 (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
37
FreeIPA System Account
======================

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

The `freeipa_system_account` role creates a FreeIPA [system account](https://www.freeipa.org/page/HowTo/LDAP#System_Accounts)
with the provided username and password.

System accounts are limited to LDAP queries only; they have no POSIX attributes,
cannot log into any systems, etc.


Variables
---------

This role **accepts** the following variables:

Variable                  | Default | Description
--------------------------|---------|------------
`system_account_username` |    | System account username
`system_account_password` |    | System account password


Usage
-----

Example tasks:

````yaml
- name: create system account for ldap binds
  include_role:
    name: freeipa_system_account
  vars:
    system_account_username: apache
    system_account_password: s3cret
````