<commit_before>puppet-sslcert
==============

Puppet module to manage SSL Certificates on WIndows Server 2008 and upwards<commit_msg>Adding some level of documentation for the module<commit_after>puppet-sslcert
==============

Small define that will allow you to manage Windows certificates. It will manage pfx, cer, der, p7b, sst certificates.

[![Build Status](https://travis-ci.org/opentable/puppet-sslcert.png?branch=master)](https://travis-ci.org/opentable/puppet-sslcert)

Usage
--

    sslcertificate { "Install-PFX-Certificate" :
    	name     => 'mycert.pfx',
    	password => '<PASSWORD>',
    	location => 'C:\',
    }
    
By default, it will store the certificate in Local Machine root store and in the My directory. If you want to change these, then use the parameters as follows:


    sslcertificate { "Install-Intermediate-Certificate" :
    	name       => 'go_daddy_intermediate.p7b',
    	location   => 'C:\',
    	store_dir  => 'CA',
    	root_store => 'LocalMachine'
    }
    
For more details on the different options available with certificate management directories, see [Windows Dev Center](http://msdn.microsoft.com/en-us/library/windows/desktop/aa388136(v=vs.85).aspx).

Please note, you must download the file to the host before trying to install it. E.g:

	file { 'go_daddy_intermediate' :
      ensure  => file,
      path    => 'C:\MyCerts',
      source  => "puppet:///modules/certificates/${name}",
    }

	sslcertificate { "Install-Intermediate-Certificate" :
    	name       => 'go_daddy_intermediate.p7b',
    	location   => 'C:\MyCerts',
    	store_dir  => 'CA',
    	root_store => 'LocalMachine',
    	require    => File['go_daddy_intermediate']
    }   
    
The system sits on top of PowerShell, so if the PowerShell file cannot get to the certificate, then it will not be able to install it.
{'fraction_non_alphanumeric': 0.12329514457174032, 'fraction_numerical': 0.008183306055646482, 'mean_word_length': 3.419277108433735, 'pattern_counts': {'":': 0, '<': 4, '<?xml version=': 0, '>': 19, 'https://': 2, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 1, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '582608', 'n_tokens_mistral': 582, 'n_tokens_neox': 558, 'n_words': 168}