Compare commits

...

12 Commits
v1.2 ... master

7 changed files with 143 additions and 25 deletions

View File

@ -1,3 +1,38 @@
## v1.3.2
### Enhancements
* Add a var to disable the role.
### Fix
* Use flatten to manage packages list.
## v1.3.1
### Enhancements
* Fix E405 Remote package tasks should have a retry.
* Fix E203 Most files should not contain tabs.
## v1.3.0
### Minor changes
* Give the correct path in comment to see ldap_default_authtok value.
* Use to_nice_json to manage packages list.
* flush_handlers don't support when statement.
* Works on Debian Buster.
## v1.2.2
### Enhancement
* Remove unwanted packages.
### Fix
* Set empty dependencies line to fix Galaxy warning.
## v1.2.1
### Enhancement
* Allow to override shell attribute.
## v1.2 ## v1.2

View File

@ -17,12 +17,16 @@ Highly inspired by [Lae's system_ldap role][lae sssd galaxy] with minors updates
## Role Variables ## Role Variables
* **sssd__deploy_state**: The desired state this role should achieve [default: `present`].
* **sssd_pkg_state**: State of new sssd packages [default: `latest`]. * **sssd_pkg_state**: State of new sssd packages [default: `latest`].
* **sssd__unwanted_packages_state**: State of unwanted packages that might interfer with SSSD [default: `absent`].
* **sssd_conf_manage**: If SSSD configuration should be managed with this role [default: `true`]. * **sssd_conf_manage**: If SSSD configuration should be managed with this role [default: `true`].
* **sssd_main_conf_path**: Path to set main SSSD's configuration [default: `/etc/sssd/sssd.conf`]. * **sssd_main_conf_path**: Path to set main SSSD's configuration [default: `/etc/sssd/sssd.conf`].
* **sssd_main_conf_tpl**: Template used to generate the previous config file [default: `etc/sssd/sssd.conf.j2`]. * **sssd_main_conf_tpl**: Template used to generate the previous config file [default: `etc/sssd/sssd.conf.j2`].
* **sssd_mkhomedir**: If home directories should be created at login [default: `true`]. * **sssd_mkhomedir**: If home directories should be created at login [default: `true`].
* **sssd_home_path**: Path where home directories are stored [default: `/home`]. * **sssd_home_path**: Path where home directories are stored [default: `/home`].
* **sssd_shell**: Path to the default shell to use [default: `/bin/bash`].
* **sssd_shell_override**: If shell should be override with the previous value [default: `False`].
* **sssd_sudoers_ldap**: If sudo must look to `sss` the list of sudoers [default: `false`]. * **sssd_sudoers_ldap**: If sudo must look to `sss` the list of sudoers [default: `false`].
* **sssd_nsswitch_manage**: If nsswitch should be managed by the role [default: `false`]. * **sssd_nsswitch_manage**: If nsswitch should be managed by the role [default: `false`].
* **sssd_service_name**: SSSD's service name [default: `sssd`]. * **sssd_service_name**: SSSD's service name [default: `sssd`].
@ -34,6 +38,7 @@ Please see default value by Operating System file in [vars][vars directory] dire
* **sssd_pkg_list**: The list of packages to install to provide `sssd`. * **sssd_pkg_list**: The list of packages to install to provide `sssd`.
* Be careful, `sssd` may need additional packages to be able to establish a TLS connection to a LDAP/AD/… server (such as `ca-certificates`,…). * Be careful, `sssd` may need additional packages to be able to establish a TLS connection to a LDAP/AD/… server (such as `ca-certificates`,…).
* **sssd__unwanted_packages_list**: The list of packages to remove.
## Example Playbook ## Example Playbook
@ -67,6 +72,7 @@ sssd_flush_handlers: True
This role will: This role will:
* Install needed packages to provide `sssd`. * Install needed packages to provide `sssd`.
* Remove packages that might interfer with `sssd` for authentication.
* Manage the default `sssd` configuration file (`/etc/sssd/sssd.conf`). * Manage the default `sssd` configuration file (`/etc/sssd/sssd.conf`).
* Create an additional configuration file to only store the bind_password (`/etc/sssd/conf.d/domain.bind.conf`). * Create an additional configuration file to only store the bind_password (`/etc/sssd/conf.d/domain.bind.conf`).
* Remove `sss` directive for `sudoers` in `/etc/nsswitch.conf` file if `sssd_nsswitch_manage` is set. * Remove `sss` directive for `sudoers` in `/etc/nsswitch.conf` file if `sssd_nsswitch_manage` is set.
@ -94,7 +100,7 @@ Jérémy Gardais
[vars directory]: ./vars [vars directory]: ./vars
[ansible vault]: http://docs.ansible.com/ansible/latest/vault.html [ansible vault]: http://docs.ansible.com/ansible/latest/vault.html
[gogs to github hook]: https://stackoverflow.com/a/21998477 [gogs to github hook]: https://stackoverflow.com/a/21998477
[sssd source]: https://git.ipr.univ-rennes1.fr/cellinfo/ansible.sssd [sssd source]: https://git.ipr.univ-rennes.fr/cellinfo/ansible.sssd
[sssd github]: https://github.com/ipr-cnrs/sssd [sssd github]: https://github.com/ipr-cnrs/sssd
[wtfpl website]: http://www.wtfpl.net/about/ [wtfpl website]: http://www.wtfpl.net/about/
[ipr website]: https://ipr.univ-rennes1.fr/ [ipr website]: https://ipr.univ-rennes1.fr/

View File

@ -1,7 +1,59 @@
--- ---
# .. vim: foldmarker=[[[,]]]:foldmethod=marker
# Package # ipr-cnrs.netdata default variables [[[
# ======================================
# Packages and installation [[[
# -----------------------------
# .. envvar:: sssd_pkg_state [[[
#
# State of the packages to install. Possible options:
#
# ``latest``
# Default. Ensure those packages are in the latest state.
#
# ``absent``
# Default. Ensure to remove those packages.
#
# ``present``
# Ensure to install those packages.
#
sssd_pkg_state: 'latest' sssd_pkg_state: 'latest'
# ]]]
# .. envvar:: sssd__unwanted_packages_state [[[
#
# State of the unwanted packages. Possible options:
#
# ``absent``
# Default. Ensure to remove those packages.
#
# ``present``
# Ensure to install those packages.
#
# ``latest``
# Ensure those packages are in the latest state.
#
# ``Anything else``
# The packages will not be touch.
#
sssd__unwanted_packages_state: 'absent'
# ]]]
# .. envvar:: sssd__deploy_state [[[
#
# What is the desired state which this role should achieve? Possible options:
#
# ``present``
# Default. Ensure that sssd is installed and configured as requested.
#
# ``absent``
# TODO: Ensure that sssd is uninstalled and it's configuration is removed.
#
sssd__deploy_state: 'present'
# ]]]
# ]]]
# Configuration # Configuration
sssd_conf_manage: true sssd_conf_manage: true
@ -9,6 +61,8 @@ sssd_main_conf_path: '/etc/sssd/sssd.conf'
sssd_main_conf_tpl: 'etc/sssd/sssd.conf.j2' sssd_main_conf_tpl: 'etc/sssd/sssd.conf.j2'
sssd_mkhomedir: true sssd_mkhomedir: true
sssd_home_path: '/home' sssd_home_path: '/home'
sssd_shell: '/bin/bash'
sssd_shell_override: False
sssd_sudoers_ldap: false sssd_sudoers_ldap: false

View File

@ -1,22 +1,19 @@
---
dependencies: []
galaxy_info: galaxy_info:
author: "Jérémy Gardais" author: "Jérémy Gardais"
description: "Manage LDAP authentication with SSSD (System Security Services Daemon)." description: "Manage LDAP authentication with SSSD (System Security Services Daemon)."
license: WTFPL license: WTFPL
company: IPR company: IPR
issue_tracker_url: https://git.ipr.univ-rennes1.fr/cellinfo/ansible.sssd/issues issue_tracker_url: https://git.ipr.univ-rennes.fr/cellinfo/ansible.sssd/issues
min_ansible_version: 2.2 min_ansible_version: 2.7
platforms: platforms:
- name: Debian - name: Debian
versions: versions:
- stretch - stretch
#- name: opensuse - buster
# versions:
# - all
# - 12.1
# - 12.2
# - 12.3
# - 13.1
# - 13.2
galaxy_tags: galaxy_tags:
- system - system
- authentication - authentication

View File

@ -1,6 +1,9 @@
--- ---
# .. vim: foldmarker=[[[,]]]:foldmethod=marker
# tasks file for ansible-role-sssd # tasks file for ansible-role-sssd
# Load vars [[[1
- name: Load specific OS vars - name: Load specific OS vars
include_vars: "{{ item }}" include_vars: "{{ item }}"
with_first_found: with_first_found:
@ -8,14 +11,29 @@
- "{{ ansible_distribution|lower }}.yml" - "{{ ansible_distribution|lower }}.yml"
- "{{ ansible_os_family|lower }}.yml" - "{{ ansible_os_family|lower }}.yml"
# Packages # Manage packages [[[1
- name: Install sssd - name: Install sssd
package: package:
name: "{{ item }}" name: "{{ item }}"
state: "{{ sssd_pkg_state }}" state: 'present'
with_items: "{{ sssd_pkg_list }}" with_flattened:
- '{{ sssd_pkg_list | flatten }}'
register: sssd_pkg_result
until: sssd_pkg_result is success
when: (sssd__deploy_state == "present")
# Update nsswitch.conf - name: Remove unwanted packages
package:
name: "{{ item }}"
state: "{{ sssd__unwanted_packages_state }}"
with_flattened:
- '{{ sssd__unwanted_packages_list | flatten }}'
register: sssd_remove_result
until: sssd_remove_result is success
when: (sssd__deploy_state == "present")
# Manage configuration [[[1
## Update nsswitch.conf
- name: CONFIG sudoers nsswitch.conf - name: CONFIG sudoers nsswitch.conf
lineinfile: lineinfile:
dest: /etc/nsswitch.conf dest: /etc/nsswitch.conf
@ -25,7 +43,7 @@
owner: root owner: root
group: root group: root
mode: 0644 mode: 0644
when: not sssd_sudoers_ldap and sssd_nsswitch_manage when: (sssd__deploy_state == "present") and (not sssd_sudoers_ldap and sssd_nsswitch_manage)
# Configuration file # Configuration file
- name: CONFIG sssd.conf - name: CONFIG sssd.conf
@ -36,7 +54,7 @@
owner: root owner: root
group: root group: root
backup: true backup: true
when: sssd_conf_manage when: (sssd__deploy_state == "present") and (sssd_conf_manage)
notify: notify:
- restart sssd - restart sssd
- restart logind - restart logind
@ -54,7 +72,7 @@
[domain/{{ sssd_domain }}] [domain/{{ sssd_domain }}]
#ldap_default_authtok = password for {{ sssd_bind_dn }} after END BLOCK #ldap_default_authtok = password for {{ sssd_bind_dn }} after END BLOCK
{% if sssd_bind_password %}ldap_default_authtok = {{ sssd_bind_password }}{% endif %} {% if sssd_bind_password %}ldap_default_authtok = {{ sssd_bind_password }}{% endif %}
when: sssd_conf_manage when: (sssd__deploy_state == "present") and (sssd_conf_manage)
notify: notify:
- restart sssd - restart sssd
- restart logind - restart logind
@ -63,9 +81,9 @@
lineinfile: lineinfile:
dest: /etc/pam.d/common-account dest: /etc/pam.d/common-account
regexp: 'pam_mkhomedir\.so' regexp: 'pam_mkhomedir\.so'
line: "session required pam_mkhomedir.so umask=0022 skel=/etc/skel/ silent" line: "session required pam_mkhomedir.so umask=0022 skel=/etc/skel/ silent"
state: present state: present
when: sssd_mkhomedir when: (sssd__deploy_state == "present") and (sssd_mkhomedir)
- meta: flush_handlers - name: Flush handlers to be able to use SSSD authentication
when: sssd_flush_handlers meta: flush_handlers

View File

@ -22,7 +22,7 @@ ldap_tls_reqcert = never
ldap_search_base = {{ sssd_search_base }} ldap_search_base = {{ sssd_search_base }}
ldap_default_bind_dn = {{ sssd_bind_dn }} ldap_default_bind_dn = {{ sssd_bind_dn }}
ldap_default_authtok_type = password ldap_default_authtok_type = password
#ldap_default_authtok = ... # See conf.d/default.bind.conf #ldap_default_authtok = ... # See conf.d/{{ sssd_domain }}.conf
cache_credentials = True cache_credentials = True
entry_cache_timeout = 5400 entry_cache_timeout = 5400
@ -34,6 +34,9 @@ entry_cache_timeout = 5400
{# mapping/attribute configuration #} {# mapping/attribute configuration #}
override_homedir = {{ sssd_home_path }}/%u override_homedir = {{ sssd_home_path }}/%u
{% if sssd_shell_override %}
override_shell = {{ sssd_shell }}
{% endif %}
krb5_realm = # krb5_realm = #

View File

@ -2,6 +2,11 @@
# vars file for Debian-based distros # vars file for Debian-based distros
sssd_pkg_list: sssd_pkg_list:
- ca-certificates - ca-certificates
- sssd
- libpam-sss - libpam-sss
- libnss-sss - libnss-sss
- sssd
sssd__unwanted_packages_list:
- libnss-ldap
- nscd
- nslcd