cookbook 'ca_openldap', '= 0.4.1'
ca_openldap (12) Versions 0.4.1 Follow2
Configures a node to be an OpenLDAP server or client.
cookbook 'ca_openldap', '= 0.4.1', :supermarket
knife supermarket install ca_openldap
knife supermarket download ca_openldap
ca_openldap Chef Cookbook
This cookbook provides several recipes to perform the following actions:
* configure a node to be an OpenLDAP server or OpenLDAP client,
* import specific schemas,
* create a DIT,
* configure the PPolicy module
* enable TLS support
* populate the directory.
This cookbooks only supports OpenLDAP 2.4+, as it is based on the new on line configuration method.
Requirements
Platform:
RedHat and CentOS 6.0+ are the target platforms.
Debian and Ubuntu are planned but currently not supported.
Cookbooks:
- certificate (optional): ca_openldap supports the certificates and the related key file deployed with this cookbook.
Attributes
Common attributes
-
node.ca_openldap.basedn
- base DN of the directory (default:"dc=example,dc=com"
). -
node.ca_openldap.ldap_server
- IP or hostname of the node which hosts the ldap server (default:"localhost"
). -
node.ca_openldap.default_ports.ldap
- Default LDAP port -
node.ca_openldap.ldap_port
- port to connect to the LDAP server (used by the following recipes: client, dit, populate, ppolicy), must be consistent with ca_openldap.default_ports.
Server attributes
-
node.ca_openldap.db_dir
- Directory where the DBD files are created (default:"/var/lib/ldap"
). -
node.ca_openldap.rootdn
- RootDN, relative tonode.ca_openldap.basedn
(default:"cn=Manager"
) -
node.ca_openldap.rootpassword
- Root Password, it is strongly recommended to modify the default value (default:"pa$$word"
) -
node.ca_openldap.ldap_log_level
- Log level - see Slapd config for explanation of supported values (default:"-1"
) -
node.ca_openldap.acls
- ACLs, this is a ruby Array of the ACL to create, each line must comply with the OpenLDAP ACL syntax (default allows to read any attributes (except password) from any authenticated users and to write any attributes that belongs to the current user) -
node.ca_openldap.default_ports.ldap
- Port of the 'clear' LDAP socket, used only when ca_openldap.tls.enable is to:no
or:yes
-
node.ca_openldap.defaut_ports.ldaps
- Port of the TLS socket, used only when ca_openldap.tls.enable is set to:yes
or:exclusive
-
node.ca_openldap.tls.enable
- Configure the TLS access support, accepted values are (default:exclusive
):-
:no
TLS access is not allowed -
:yes
both clear and TLS accesses are allowed -
:exclusive
only TLS access is allowed (node.ca_openldap.ldap_port
shall be correctly set)
-
-
node.ca_openldap.tls.cacert_path
- Path of the directory where the CA certificates are stored (default:"/etc/openldap/cacerts"
). -
node.ca_openldap.tls.cert_file
- Path of the node certificate (default:"/etc/openldap/certs/#{node.fqdn}.pem"
). -
node.ca_openldap.tls.key_file
- Path of the private key related to the node certificate (default:"/etc/openldap/certs/#{node.fqdn}.key"
). -
node.ca_openldap.use_existing_certs_and_key
- boolean configuring the support of certificates deployed with the certificate cookbook. When true, assume the CA certificate, the server certificate and its related key already exist under default directory set by the certificate cookbook (/etc/pki/tls for RHEL). Consequently, the following links are created:-
node.ca_openldap.tls.cert_file
: points to the Server certificate (/etc/pki/tls/certs/<fqdn>.pem for RHEL). -
node.ca_openldap.tls.cacert_path + "/" + cacert_hash + ".0"
: points to the CA certificate chain (/etc/pki/tls/certs/<hostname>-bundle.crt for RHEL), cacert_hash is the X509 hash of the CA certificate file. Additionally the key file (/etc/pki/tls/private/<fqdn>.key) is copied tonode.ca_openldap.tls.key_file
.
-
PPolicy attributes
-
node.ca_openldap.ppolicy_default_config_dn
- DN where the default ppolicy configuration is stored, relatively to thenode.ca_openldap.basedn
(default:"cn=passwordDefault,ou=policies"
). -
node.ca\_openldap.ppolicy\_default\_config
- Default ppolicy configuration, supported attributes are defined by section "Object Class Attributes" in slapo-ppolicy(5) (check default value inattributes/default.rb
)
Schema attributes
-
node.ca_openldap.schema_cookbook
- cookbook name which includes additional schema do set up, schemas are search as cookbook distribution files, under files/default/schemas/ (default: nil) -
node.ca_openldap.additional_schemas
- List of schemas to import in the directory, the suffix ".schema" is added to each item of the list to build the complete file name (default : [])
DIT attributes
-
node.ca_openldap.dit
- JSON structure which defines the DIT, this attribute can be overriden by theca_openldap/dit
data bag item, seedit
recipe for additional information.
Populate attributes
-
node.ca_openldap.populate.update_enable
- when true, populate recipes performs an add or update entry rather than a simple add. -
node.ca_openldap.populate.attributes_to_ignore
- List of attributes not to update when update_enable is true.
Recipes
server
Sets up a slapd daemon on the current node.
This recipe performs the following actions:
* install the relevant packages provided by the distribution
* configure the base DN, root DN and root password according to the related attributes
* enable if requested the TLS support (see dedicated section below)
* set the base directory for the BDB files
* set the slapd log level
* configure ACLs
client
Install the OpenLDAP client packages and configure access to an OpenLDAP Server.
This recipe depends on the common attributes and the node.ca_openldap.use_existing_certs_and_key
and node.ca_openldap.tls.cacert_path
attributes.
dit
Install the DIT based on a provided data bag item.
The DIT is defined by the ca_openldap/dit
data bag item if it exists, otherwise by the node.ca_openldap.dit
attribute.
Each entry of the DIT is defined by an hash, where:
* the key is the part of the DN relative to its parent
* the value is a hash including the following keys:
* "attrs"
: hash defining all attributes of the entry
* "children"
: hash of the children entries
In the case of the data bag item, the DIT structure is found under the "dit"
hash key.
Example of ca_openldap/dit
data bag item:
{ "id": "dit", "dit": { "dc=example,dc=fr": { "attrs": { "objectClass": ["organization", "dcObject"], "description": "root of the directory", "o": "organization" }, "children": { "ou=groups": { "attrs": { "objectClass": ["top", "organizationalUnit"] } }, "ou=users": { "attrs": { "objectClass": ["top", "organizationalUnit"] } } } } } }
schemas
Install additional schemas provided as a file distribution (from another cookbook for example).
See the schema attributes above to configure this recipe.
Each provided schema file must comply with the standard schema format (have a look to the official schemas stored under /etc/openldap/schemas).
populate
Populate the directory based on a provided data bag item.
The data bag item is ca_openldap/populate
. This data bag item shall defines the following entries:
* a "base"
which specify the DN to append to each consecutive branch DN
* a list of branches (under "branches"
) . Each branch is defined by the following entries:
* a "name"
which defines the relative DN of the branch
* a list of default classes (under "default_classes"
) to apply to each consecutive entry
* a list of entries (under "entries"
), each item of this list defines an entry to create or update in the directory under the related branch. An item is a hash where keys and values maps the LDAP attribute names and values.
Example of ca_openldap/populate
data bag item:
{ "id": "populate", "base": "dc=example,dc=fr", "branches": [ { "name": "ou=unixAccounts,ou=users", "default_classes": ["top", "posixAccount", "inetOrgPerson"], "entries": [ { "dn": "uid=test1", "uidNumber": "12001", "uid": "test", "cn": "test", "gidNumber": "12001", "sn": "test user", "userPassword": "pa$$word", "homeDirectory": "/home/test" }, { "dn": "uid=test2", "uidNumber": "12002", "uid": "test2", "cn": "test2", "gidNumber": "12002", "sn": "test user 2", "userPassword": "pa$$word", "homeDirectory": "/home/test2" } ] }, { "name": "ou=groups", "default_classes": ["top", "posixGroup"], "entries": [ { "dn": "cn=test1", "gidNumber": "12001", "memberUid": "test1" }, { "dn": "cn=test2", "gidNumber": "12002", "memberUid": "test2" }, { "dn": "cn=test", "gidNumber": "12000", "memberUid": ["test1", "test2"] } ] } ] }
ppolicy
Configure the PPolicy module.
TLS support
TLS support is managed by the server
recipe and configured by the node.ca_openldap.tls.*
attributes and node.ca_openldap.use_existing_certs_and_key
attribute.
If node.ca_openldap.use_existing_certs_and_key
is set to false, the recipe assumes that the server and CA certificates and the server key are already provided by another cookbook.
Note that openldap expects that CA certificate names should have their names of the form "xxxxx.0", where "xxxxx" is x509 hash of the certificate.
The x509 hash can be easily generated with the following command:
openssl x509 -noout -hash -in /path/to/certificate.pem
If node.ca_openldap.use_existing_certs_and_key
is set to true,
the recipe assumes that the server and CA certificates
were previously deployed by the certificate cookbook under the default locations.
Consequently, the recipe creates two links which point to the server and CA certificates:
* the server certificate link is created under the node.ca_openldap.tls.cert_file
location,
* the CA certification link is created in the node.ca_openldap.tls.cacert_path
directory, with the proper name as explaine above.
Additionaly, the recipe copies the server key to the node.ca_openldap.tls.key_file
location.
Take care to correctly set the node.ca_openldap.ldap_port
attribute
to the LDAPS default port (636) when node.ca_openldap.tls.enable_tls
is set to :exclusive
,
otherwise the dit
and populate
recipes will not work.
License and Author
Author:: Christophe Arguel (christophe.arguel@free.fr)
Copyright:: 2013, Christophe Arguel.
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
Dependent cookbooks
This cookbook has no specified dependencies.
Contingent cookbooks
There are no cookbooks that are contingent upon this one.
CHANGELOG for ca_openldap
This file is used to list changes made in each version of ca_openldap.
0.4.1
- Stringify and convert in lowercase attribute names for the evaluation of attributes to ignore.
0.4
- Support a list of attributes not to update in populate recipe (#7)
0.3
- Raise an exception when entry update fails (#6)
- Fix error when creating DIT if TLS mode is not enable (#7)
- Add support for update mode in populate recipe (#8)
- Fix wrong URI in ldap.conf file (#9)
- Fix error in ppolicy recipe when TLS is not enable (#7)
0.2.3
- Replace gem dependency to activeldap by ssha.
- Allow installation of net-ldap and ssh gems providing path of local gems.
- Force conversion to symbol of node['ca_openldap']['tls']['enable'] value.
0.2.2:
- Manage configuration of default listening ports
- Add a recipe to install and configure ppolicy overlay
- Define Apache 2.0 as the license of this cookbook
0.2.1:
- Fix #2: Compile Error in server recipe on file resource node.ca_openldap.tls.key_file
- Fix #1: Wrong rootdn used for the ppolicy configuration creation
0.2.0:
- Add TLS support based on the certificates and the related key file
previously deployed by the certificate cookbook (see attribute
use_existing_certs_and_key
) - Improve the documentation (see README.md)
0.1.0:
- Initial release of ca_openldap
Check the Markdown Syntax Guide for help with Markdown.
The Github Flavored Markdown page describes the differences between markdown on github and standard markdown.
Foodcritic Metric
0.4.1 failed this metric
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/74d46715636fa577ef4c045e/ca_openldap/recipes/client.rb:30
FC002: Avoid string interpolation where not required: /tmp/cook/74d46715636fa577ef4c045e/ca_openldap/attributes/default.rb:68
FC002: Avoid string interpolation where not required: /tmp/cook/74d46715636fa577ef4c045e/ca_openldap/recipes/ppolicy.rb:39
FC002: Avoid string interpolation where not required: /tmp/cook/74d46715636fa577ef4c045e/ca_openldap/recipes/ppolicy.rb:44
FC014: Consider extracting long ruby_block to library: /tmp/cook/74d46715636fa577ef4c045e/ca_openldap/recipes/dit.rb:33
FC014: Consider extracting long ruby_block to library: /tmp/cook/74d46715636fa577ef4c045e/ca_openldap/recipes/server.rb:96
FC015: Consider converting definition to a LWRP: /tmp/cook/74d46715636fa577ef4c045e/ca_openldap/definitions/openldap.rb:1
FC019: Access node attributes in a consistent manner: /tmp/cook/74d46715636fa577ef4c045e/ca_openldap/recipes/client.rb:30
FC023: Prefer conditional attributes: /tmp/cook/74d46715636fa577ef4c045e/ca_openldap/recipes/server.rb:46
FC048: Prefer Mixlib::ShellOut: /tmp/cook/74d46715636fa577ef4c045e/ca_openldap/definitions/openldap.rb:81
FC048: Prefer Mixlib::ShellOut: /tmp/cook/74d46715636fa577ef4c045e/ca_openldap/definitions/openldap.rb:175
FC048: Prefer Mixlib::ShellOut: /tmp/cook/74d46715636fa577ef4c045e/ca_openldap/libraries/ldap_utils.rb:150
0.4.1 failed this metric
FC002: Avoid string interpolation where not required: /tmp/cook/74d46715636fa577ef4c045e/ca_openldap/attributes/default.rb:68
FC002: Avoid string interpolation where not required: /tmp/cook/74d46715636fa577ef4c045e/ca_openldap/recipes/ppolicy.rb:39
FC002: Avoid string interpolation where not required: /tmp/cook/74d46715636fa577ef4c045e/ca_openldap/recipes/ppolicy.rb:44
FC014: Consider extracting long ruby_block to library: /tmp/cook/74d46715636fa577ef4c045e/ca_openldap/recipes/dit.rb:33
FC014: Consider extracting long ruby_block to library: /tmp/cook/74d46715636fa577ef4c045e/ca_openldap/recipes/server.rb:96
FC015: Consider converting definition to a LWRP: /tmp/cook/74d46715636fa577ef4c045e/ca_openldap/definitions/openldap.rb:1
FC019: Access node attributes in a consistent manner: /tmp/cook/74d46715636fa577ef4c045e/ca_openldap/recipes/client.rb:30
FC023: Prefer conditional attributes: /tmp/cook/74d46715636fa577ef4c045e/ca_openldap/recipes/server.rb:46
FC048: Prefer Mixlib::ShellOut: /tmp/cook/74d46715636fa577ef4c045e/ca_openldap/definitions/openldap.rb:81
FC048: Prefer Mixlib::ShellOut: /tmp/cook/74d46715636fa577ef4c045e/ca_openldap/definitions/openldap.rb:175
FC048: Prefer Mixlib::ShellOut: /tmp/cook/74d46715636fa577ef4c045e/ca_openldap/libraries/ldap_utils.rb:150