blob: d6af97b78b6897b1f58c29c714842e55d4908e94 [file] [log] [blame]
========
Usage
========
Sample pillars
==============
Client
------
.. code-block:: yaml
openldap:
client:
server:
basedn: dc=example,dc=local
host: ldap.example.local
tls: true
port: 389
auth:
user: cn=admin,dc=example,dc=local
password: dummypass
entry:
people:
type: ou
classes:
- top
- organizationalUnit
entry:
jdoe:
type: cn
# Change attributes that already exists with different content
action: replace
# Delete all other attributes
purge: true
attr:
uid: jdoe
uidNumber: 20001
gidNumber: 20001
gecos: John Doe
givenName: John
sn: Doe
homeDirectory: /home/jdoe
loginShell: /bin/bash
classes:
- posixAccount
- inetOrgPerson
- top
- ldapPublicKey
- shadowAccount
karel:
# Simply remove cn=karel
type: cn
enabled: false
Read more
=========
- https://docs.saltstack.com/en/latest/ref/states/all/salt.states.ldap.html#manage-entries-in-an-ldap-database
Documentation and bugs
======================
* http://salt-formulas.readthedocs.io/
Learn how to install and update salt-formulas
* https://github.com/salt-formulas/salt-formula-openldap/issues
In the unfortunate event that bugs are discovered, report the issue to the
appropriate issue tracker. Use the Github issue tracker for a specific salt
formula
* https://launchpad.net/salt-formulas
For feature requests, bug reports, or blueprints affecting the entire
ecosystem, use the Launchpad salt-formulas project
* https://launchpad.net/~salt-formulas-users
Join the salt-formulas-users team and subscribe to mailing list if required
* https://github.com/salt-formulas/salt-formula-openldap
Develop the salt-formulas projects in the master branch and then submit pull
requests against a specific formula
* #salt-formulas @ irc.freenode.net
Use this IRC channel in case of any questions or feedback which is always
welcome