cookbook 'openldap-grid', '~> 0.2.6'
openldap-grid (6) Versions 0.2.6 Follow0
Installs/Configures openldap
cookbook 'openldap-grid', '~> 0.2.6', :supermarket
knife supermarket install openldap-grid
knife supermarket download openldap-grid
openldap-grid Cookbook
This cookbook sets up OpenLDAP client, server and nss-ldapd.
Contents
Requirements
None.
Attributes
openldap::default
| Key | Type | Description, example | Default |
|---|---|---|---|
['openldap']['with_ssl_cert_cookbook'] |
Boolean | make it work with ssl_cert cookbook. (ver. 0.1.1 or later) | false |
['openldap']['ssl_cert']['ca_name'] |
String | CA name used by ssl_cert (ver. 0.1.1 or later) | nil |
['openldap']['ssl_cert']['common_name'] |
String | Server common name useed by ssl_cert. (ver. 0.1.1 or later) | node['fqdn'] |
['openldap']['client']['URI'] |
String | ldap://ldap.example.com ldap://ldap-master.example.com:666 | nil |
['openldap']['client']['BASE'] |
String | dc=example,dc=com | nil |
['openldap']['client']['SIZELIMIT'] |
String | 12 | nil |
['openldap']['client']['TIMELIMIT'] |
String | 15 | nil |
['openldap']['client']['DEREF'] |
String | never | nil |
['openldap']['client']['TLS_CACERT'] |
String | /etc/ssl/certs/cacert.pem | nil |
['openldap']['client']['TLS_REQUEST'] |
String | never,allow,try,demand* | nil |
['openldap']['client']['TLS_CHECKPEER'] |
String | yes*,no | nil |
['openldap']['client']['SASL_MECH'] |
String | GSSAPI | nil |
['openldap']['client']['<ldap.conf key>'] |
String | other ldap.conf key | |
['openldap']['nss-ldapd']['uri'] |
Strig | ldap://127.0.0.1/ |
|
['openldap']['nss-ldapd']['base'] |
String | dc=example,dc=net |
|
['openldap']['nss-ldapd']['<nscd.conf key>'] |
String | other nscd.conf key | |
['openldap']['ldap_lookup_nameservices'] |
Array | ['passwd', 'group'] | empty |
['openldap']['server']['enabled'] |
Boolean |
slapd service enabled (ver. 0.2.6 or later) |
true |
['openldap']['server']['extra_schema']['samba'] |
Boolean | add the schema for Samba (ver. 0.2.3 or later) | false |
['openldap']['server']['ldaps'] |
Boolean | enable ldaps (ver. 0.1.2 or later) | false |
['openldap']['server']['KRB5_KTNAME'] |
String | e.g. '/etc/krb5.keytab' (ver. 0.1.2 or later) |
nil |
Usage
Just include openldap-grid::recipe in your node's run_list:
{
"name":"my_node",
"run_list": [
"recipe[openldap-grid::client]",
"recipe[openldap-grid::server]",
"recipe[openldap-grid::nss-ldapd]"
]
}
SSL CA certificate management by ssl_cert cookbook
If node['openldap']['with_ssl_cert_cookbook'] is true, node['openldap']['client']['TLS_CACERT'] and node['openldap']['nss-ldapd']['tls_cacertfile'] are overridden by the file path based on ['openldap']['ssl_cert']['ca_name'] attribute.
SSL server keys and certificates management by ssl_cert cookbook
- create vault items.
$ ruby -rjson -e 'puts JSON.generate({"private" => File.read("ldap.grid.example.com.prod.key")})' \
> > ~/tmp/ldap.grid.example.com.prod.key.json
$ ruby -rjson -e 'puts JSON.generate({"public" => File.read("ldap.grid.example.com.prod.crt")})' \
> > ~/tmp/ldap.grid.example.com.prod.crt.json
$ cd $CHEF_REPO_PATH
$ knife vault create ssl_server_keys ldap.grid.example.com.prod \
> --json ~/tmp/ldap.grid.example.com.prod.key.json
$ knife vault create ssl_server_certs ldap.grid.example.com.prod \
> --json ~/tmp/ldap.grid.example.com.prod.crt.json
- grant reference permission to the ldap host
$ knife vault update ssl_server_keys ldap.grid.example.com.prod -S 'name:ldap*.grid.example.com' $ knife vault update ssl_server_certs ldap.grid.example.com.prod -S 'name:ldap*.grid.example.com'
- modify run_list and attributes
run_list( #'recipe[ssl_cert::server_key_pairs]', # gitlab-grid <= 0.2.5 'recipe[opeldap-grid::server]', ) override_attributes( 'ssl_cert' => { #'common_names' => [ # 'ldap.grid.example.com', # gitlab-grid <= 0.2.5 #], }, 'openldap' => { 'with_ssl_cert_cookbook' => true, 'ssl_cert' => { 'common_name' => 'ldap.grid.example.com', }, # ... }, )
License and Authors
- Author:: whitestar at osdn.jp
Copyright 2013-2018, whitestar
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
| ssl_cert >= 0.3.5 |
Contingent cookbooks
There are no cookbooks that are contingent upon this one.
CHANGELOG for openldap-grid
0.2.6
- adds the
['openldap']['server']['enabled']attribute. - improves CA certificates and server key pair deployment.
- refactors specs.
0.2.5
- refactoring.
0.2.4
- bug fix: key access group modification.
- updates documents.
0.2.3
- adds Samba schema setup feature.
0.2.2
- refactoring.
- updates the
ssl_certcookbook dependency.
0.2.1
- Cleanup for FoodCritic and RuboCop.
0.2.0
- rename cookbook.
CHANGELOG for openldap
0.1.2
- adds the
['openldap']['server']['ldaps']attribute. - adds
['openldap']['server']['KRB5_KTNAME']attribute.
0.1.1
- adds the
serverrecipe. - adds linkage with
ssl_certcookbook.
0.1.0
- Initial release of openldap
Collaborator Number Metric
0.2.6 failed this metric
Failure: Cookbook has 0 collaborators. A cookbook must have at least 2 collaborators to pass this metric.
Contributing File Metric
0.2.6 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a CONTRIBUTING.md file
Foodcritic Metric
0.2.6 passed this metric
No Binaries Metric
0.2.6 passed this metric
Testing File Metric
0.2.6 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a TESTING.md file
Version Tag Metric
0.2.6 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must include a tag that matches this cookbook version number
0.2.6 failed this metric
0.2.6 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a CONTRIBUTING.md file
Foodcritic Metric
0.2.6 passed this metric
No Binaries Metric
0.2.6 passed this metric
Testing File Metric
0.2.6 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a TESTING.md file
Version Tag Metric
0.2.6 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must include a tag that matches this cookbook version number
0.2.6 passed this metric
0.2.6 passed this metric
Testing File Metric
0.2.6 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a TESTING.md file
Version Tag Metric
0.2.6 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must include a tag that matches this cookbook version number
0.2.6 failed this metric
0.2.6 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must include a tag that matches this cookbook version number
