cookbook 'cr_ad_membership', '~> 0.1.1'
cr_ad_membership (2) Versions 0.1.1 Follow0
Join or leave active directory (multiplatform)
cookbook 'cr_ad_membership', '~> 0.1.1', :supermarket
knife supermarket install cr_ad_membership
knife supermarket download cr_ad_membership
cr_ad_membership
Ad Membership. A cookbook for joining and leaving Active Directory multiplatform.
This project is a part of Cooking Robot group.
How to use
This cookbook provide a default recipe that join AD and a custom resource if you whan a better control of AD junction.
The default recipe
The default recipe join an Active directory with the following attributes:
-
node['ad_membership']['ou']: Organization unit to join -
node['ad_membership']['user']: Admin username. You might use the vault to keep instead of attributes credentials. -
node['ad_membership']['password']: Admin password. You might use the vault to keep instead of attributes credentials. -
node['ad_membership']['hide_users']: Array of username you don't want to appears on the login screen (like local admins). -
node['ad_membership']['domain']: Domain name (FQDN) to join.
The default recipe also configure CIFS tools and Kerberos to use SSO on apps and shares on Linux.
Notes:
- On linux platform, the ou attribute is ignored.
- On windows platform, the hide_users is ignored.
Vault Items
You may use Chef Vault for storing identifiants to join AD. The vault item used bu recipe is passwords:ads. The item must have two keys : user and Password.
CIFS recipe
Use this recipe with the ad_membership resource. This recipe configure CIFS to use Kerberos for network shares.
The resource
This cookbook provide a resource to join or leave AD :
ad_membership node['ad_membership']['domain'] do domain_name node['ad_membership']['domain'] domain_user node['ad_membership']['user'] domain_password node['ad_membership']['password'] ou_path node['ad_membership']['ou'] workgroup_name node['ad_membership']['workgroup'] end
Action can be :join to join AD and :leave.
Be careful, hostname may not have more than 15 characters AD DS maximum limits.
Dependent cookbooks
| line >= 0.0.0 |
| cr_inifile >= 0.0.0 |
Contingent cookbooks
There are no cookbooks that are contingent upon this one.
cr_ad_join CHANGELOG
This file is used to list changes made in each version of the cr_ad_membership cookbook.
0.1.1
- Add error message if machine hostname reach the maximum length
0.1.0
Initial release.
Collaborator Number Metric
0.1.1 failed this metric
Failure: Cookbook has 0 collaborators. A cookbook must have at least 2 collaborators to pass this metric.
Contributing File Metric
0.1.1 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
Cookstyle Metric
0.1.1 failed this metric
Chef/Deprecations/ResourceWithoutUnifiedTrue: Set `unified_mode true` in Chef Infra Client 15.3+ custom resources to ensure they work correctly in Chef Infra Client 18 (April 2022) when Unified Mode becomes the default. (https://docs.chef.io/workstation/cookstyle/chef_deprecations_resourcewithoutunifiedtrue): cr_ad_membership/resources/ad_membership.rb: 1
Chef/Modernize/ConditionalUsingTest: Use ::File.exist?('/foo/bar') instead of the slower 'test -f /foo/bar' which requires shelling out (https://docs.chef.io/workstation/cookstyle/chef_modernize_conditionalusingtest): cr_ad_membership/recipes/default.rb: 68
Chef/Modernize/ConditionalUsingTest: Use ::File.exist?('/foo/bar') instead of the slower 'test -f /foo/bar' which requires shelling out (https://docs.chef.io/workstation/cookstyle/chef_modernize_conditionalusingtest): cr_ad_membership/recipes/default.rb: 77
Chef/Modernize/ConditionalUsingTest: Use ::File.exist?('/foo/bar') instead of the slower 'test -f /foo/bar' which requires shelling out (https://docs.chef.io/workstation/cookstyle/chef_modernize_conditionalusingtest): cr_ad_membership/recipes/default.rb: 89
Chef/RedundantCode/NamePropertyIsRequired: Resource properties marked as name properties should not also be required properties (https://docs.chef.io/workstation/cookstyle/chef_redundantcode_namepropertyisrequired): cr_ad_membership/resources/ad_membership.rb: 4
Run with Cookstyle Version 7.32.1 with cops Chef/Deprecations,Chef/Correctness,Chef/Sharing,Chef/RedundantCode,Chef/Modernize,Chef/Security,InSpec/Deprecations
No Binaries Metric
0.1.1 passed this metric
Testing File Metric
0.1.1 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.1.1 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.1.1 failed this metric
0.1.1 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
Cookstyle Metric
0.1.1 failed this metric
Chef/Deprecations/ResourceWithoutUnifiedTrue: Set `unified_mode true` in Chef Infra Client 15.3+ custom resources to ensure they work correctly in Chef Infra Client 18 (April 2022) when Unified Mode becomes the default. (https://docs.chef.io/workstation/cookstyle/chef_deprecations_resourcewithoutunifiedtrue): cr_ad_membership/resources/ad_membership.rb: 1
Chef/Modernize/ConditionalUsingTest: Use ::File.exist?('/foo/bar') instead of the slower 'test -f /foo/bar' which requires shelling out (https://docs.chef.io/workstation/cookstyle/chef_modernize_conditionalusingtest): cr_ad_membership/recipes/default.rb: 68
Chef/Modernize/ConditionalUsingTest: Use ::File.exist?('/foo/bar') instead of the slower 'test -f /foo/bar' which requires shelling out (https://docs.chef.io/workstation/cookstyle/chef_modernize_conditionalusingtest): cr_ad_membership/recipes/default.rb: 77
Chef/Modernize/ConditionalUsingTest: Use ::File.exist?('/foo/bar') instead of the slower 'test -f /foo/bar' which requires shelling out (https://docs.chef.io/workstation/cookstyle/chef_modernize_conditionalusingtest): cr_ad_membership/recipes/default.rb: 89
Chef/RedundantCode/NamePropertyIsRequired: Resource properties marked as name properties should not also be required properties (https://docs.chef.io/workstation/cookstyle/chef_redundantcode_namepropertyisrequired): cr_ad_membership/resources/ad_membership.rb: 4
Run with Cookstyle Version 7.32.1 with cops Chef/Deprecations,Chef/Correctness,Chef/Sharing,Chef/RedundantCode,Chef/Modernize,Chef/Security,InSpec/Deprecations
No Binaries Metric
0.1.1 passed this metric
Testing File Metric
0.1.1 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.1.1 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.1.1 failed this metric
Chef/Modernize/ConditionalUsingTest: Use ::File.exist?('/foo/bar') instead of the slower 'test -f /foo/bar' which requires shelling out (https://docs.chef.io/workstation/cookstyle/chef_modernize_conditionalusingtest): cr_ad_membership/recipes/default.rb: 68
Chef/Modernize/ConditionalUsingTest: Use ::File.exist?('/foo/bar') instead of the slower 'test -f /foo/bar' which requires shelling out (https://docs.chef.io/workstation/cookstyle/chef_modernize_conditionalusingtest): cr_ad_membership/recipes/default.rb: 77
Chef/Modernize/ConditionalUsingTest: Use ::File.exist?('/foo/bar') instead of the slower 'test -f /foo/bar' which requires shelling out (https://docs.chef.io/workstation/cookstyle/chef_modernize_conditionalusingtest): cr_ad_membership/recipes/default.rb: 89
Chef/RedundantCode/NamePropertyIsRequired: Resource properties marked as name properties should not also be required properties (https://docs.chef.io/workstation/cookstyle/chef_redundantcode_namepropertyisrequired): cr_ad_membership/resources/ad_membership.rb: 4
Run with Cookstyle Version 7.32.1 with cops Chef/Deprecations,Chef/Correctness,Chef/Sharing,Chef/RedundantCode,Chef/Modernize,Chef/Security,InSpec/Deprecations
0.1.1 passed this metric
Testing File Metric
0.1.1 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.1.1 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.1.1 failed this metric
0.1.1 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
