2018-09-04 07:44:12 -04:00
|
|
|
# puppet-nslcd
|
2015-04-16 18:04:30 -04:00
|
|
|
|
2018-08-21 08:55:29 -04:00
|
|
|
[](https://travis-ci.org/geekix/puppet-nslcd)
|
2015-11-24 11:06:13 -05:00
|
|
|
|
2015-04-16 18:04:30 -04:00
|
|
|
#### Table of Contents
|
|
|
|
|
|
|
|
|
|
1. [Overview](#overview)
|
|
|
|
|
2. [Module Description - What the module does and why it is useful](#module-description)
|
|
|
|
|
3. [Setup - The basics of getting started with nslcd](#setup)
|
|
|
|
|
* [What nslcd affects](#what-nslcd-affects)
|
|
|
|
|
4. [Usage - Configuration options and additional functionality](#usage)
|
|
|
|
|
5. [Reference - An under-the-hood peek at what the module is doing and how](#reference)
|
|
|
|
|
5. [Limitations - OS compatibility, etc.](#limitations)
|
|
|
|
|
6. [Development - Guide for contributing to the module](#development)
|
|
|
|
|
|
|
|
|
|
## Overview
|
|
|
|
|
|
|
|
|
|
This module installs and configured nslcd to get pam/nss data from ldap.
|
|
|
|
|
|
|
|
|
|
## Module Description
|
|
|
|
|
|
|
|
|
|
This module allows you to install and configure the nslcd daemon (and its dependencies), to provide ldap support for
|
|
|
|
|
PAM and NSS.
|
|
|
|
|
|
|
|
|
|
## Setup
|
|
|
|
|
|
|
|
|
|
### What nslcd affects
|
|
|
|
|
|
|
|
|
|
* `nslcd` package and service
|
|
|
|
|
* `/etc/nslcd.conf`
|
|
|
|
|
|
|
|
|
|
## Usage
|
|
|
|
|
|
|
|
|
|
Simply include/contain/required/declare the nslcd class.
|
|
|
|
|
It includes a few sane defaults, so it should work out of the box.
|
|
|
|
|
However, we recommend that you declare the class and override a few parameters:
|
|
|
|
|
|
2018-09-04 07:42:52 -04:00
|
|
|
* In the module
|
|
|
|
|
|
2015-04-16 18:04:30 -04:00
|
|
|
```
|
|
|
|
|
class { 'nslcd':
|
2018-09-04 08:03:57 -04:00
|
|
|
ldap_uris => ['ldap://ldap01.mycompany.com:389','ldap://ldap02.mycompany.com:389'],
|
2018-09-04 07:42:52 -04:00
|
|
|
ldap_search_base => 'dc=company,dc=com'
|
2015-04-16 18:04:30 -04:00
|
|
|
}
|
|
|
|
|
```
|
|
|
|
|
|
2018-09-04 07:42:52 -04:00
|
|
|
* In hieradata
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
nslcd::ldap_uris:
|
|
|
|
|
- 'ldap://ldap01.company.com:389'
|
|
|
|
|
- 'ldap://ldap02.company.com:389'
|
|
|
|
|
nslcd::ldap_search_base: 'dc=company,dc=com'
|
|
|
|
|
```
|
|
|
|
|
|
2015-04-16 18:04:30 -04:00
|
|
|
## Reference
|
|
|
|
|
|
|
|
|
|
*todo*
|
|
|
|
|
|
|
|
|
|
## Limitations
|
|
|
|
|
|
|
|
|
|
The module has been tested with Ubuntu 12.04 and 14.04, Debian 6 and 7, and Puppet 3.7.
|
|
|
|
|
It should work Puppet 3.x.
|
|
|
|
|
For additional OS support, you should contribute it back upstream!
|
|
|
|
|
|
|
|
|
|
The module doesn't support setting the `rootbinddn` and `rootbindpw` attributes, but it can be easily added.
|
|
|
|
|
|
|
|
|
|
## Development
|
|
|
|
|
|
|
|
|
|
If you want to improve this module, send us a patch of pull request!
|
|
|
|
|
|
