Adoptable Cookbooks List

Looking for a cookbook to adopt? You can now see a list of cookbooks available for adoption!
List of Adoptable Cookbooks

Supermarket Belongs to the Community

Supermarket belongs to the community. While Chef has the responsibility to keep it running and be stewards of its functionality, what it does and how it works is driven by the community. The chef/supermarket repository will continue to be where development of the Supermarket application takes place. Come be part of shaping the direction of Supermarket by opening issues and pull requests or by joining us on the Chef Mailing List.

Select Badges

Select Supported Platforms

RSS

windows_schannel (2) Versions 0.1.2

Configures windows schannel security support provider (SSP). Use it to disable support for the protocols like SSL and the RC4 Cipher. One step towards meeting CIS PCI FIPS compliance.

Berkshelf/Librarian
Policyfile
Knife
cookbook 'windows_schannel', '= 0.1.2'
cookbook 'windows_schannel', '= 0.1.2', :supermarket
knife cookbook site install windows_schannel
knife cookbook site download windows_schannel
README
Dependencies
Changelog
Quality

Windows Schannel Cookbook

Description

A cookbook to configure the windows Secure Channel (Schannel) security support provider (SSP). This SSP contains a set of security protocols and ciphers suites commonly used for HTTPS communications. Many of the microsoft provided services and 3rd party software make use of Schannel for their communication so by removing support for a given protocol, removes it for all components.

This can be a double-edge sword, restricting a protocol might be fine for one service and end up breaking another.

Always make sure you test these settings before deploying into production as you could end up shooting yourself in the foot

Using this cookbook should help improve your security posture for the following microsoft services and help towards meeting regulatory compliance (PCI CIS FIPS)

  • Internet Information Services (IIS)
  • Microsoft Remote Desktop (RDP) when configured to use TLS
  • LDAPS (Active Directory)
  • Global Catalog SSL (Active Directory)
  • WinRM/HTTPS (Windows Remote Management)

TODO : Insert image of external scan before and after.

Support for managing the following

Protocols

  • Transport Layer Security (TLS) - v1.0, v1.1, v1.2
  • Secure Socket Layer (SSL) - v2.0, v3.0
  • Private Communications Technology (PCT) - v1.0

Cipher Suites

  • NULL, DES, RC2, RC4, 3DES, AES

Hashes

  • MD5, SHA

Key Exchanges

  • Diffie-Hellman (DH)

Requirements

Platforms

  • Windows Server 2008 (R1, R2)
  • Windows Server 2012 (R1, R2)

Attributes

  • node['windows_schannel']['allow_reboot'] = false changes made to protocols won't take affect until after a restart, this doesn't apply to ciphers and hashes. The default is false change this to true to initiate a reboot after the run.

Other than the allow_reboot attribute all the others are controlled by either setting it to either enable or disable this is CaSe Sensitive

Protocols

  • node['windows_schannel']['pct_v1.0'] = disable
  • node['windows_schannel']['ssl_v2.0'] = disable
  • node['windows_schannel']['ssl_v3.0'] = disable
  • node['windows_schannel']['tls_v1.0'] = enable
  • node['windows_schannel']['tls_v1.1'] = enable
  • node['windows_schannel']['tls_v1.2'] = enable

Ciphers

  • node['windows_schannel']['cipher_null'] = disable
  • node['windows_schannel']['cipher_des'] = disable
  • node['windows_schannel']['cipher_rc2'] = disable
  • node['windows_schannel']['cipher_rc4'] = disable
  • node['windows_schannel']['cipher_3des'] = enable
  • node['windows_schannel']['cipher_aes'] = enable

Hashes

  • node['windows_schannel']['hash_md5'] = enable
  • node['windows_schannel']['hash_sha'] = enable

Key Exchanges

  • node['windows_schannel']['keyEx_dh'] = enable

License & Authors

Copyright 2016, Gary Bright

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.

windows_schannel Cookbook CHANGELOG

This file is used to list changes made in each version of the windows_schannel cookbook.

0.1.2 - (17-06-2016)

  • Fixed some typo's in the README ready for relase to the supermarket.

v0.1.1 (16-06-2016)

  • Changed the attribute values to make it easier to read rather than 1 or 0, means it is now caSe sensitive but I think its worth the trade off as its easier to interpret
  • Added support for Hashes (MD5 and SHA) and Keyexchanges (DH)
  • Refactored the ciphers to loop based on foodcritic
  • Added reboot notifier for protocol changes.

v0.1.0 (20-04-2016)

  • Building the framework of the cookbook.

Foodcritic Metric
            

0.1.2 passed this metric