simp-beaker-helpers 1.0.0

checksums.yaml

@@ -0,0 +1,15 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    ZDlhMjkxYTRmMTM5NDg4ZWY2OTk2OWQyM2E4NDgyZGJmNmVlYTkzYw==
+  data.tar.gz: !binary |-
+    ZGQ3MzBlZDg2MTNiYmUwYWQwYmNkZjdhMDQxZjg1M2E0MGM2ZjVjNw==
+SHA512:
+  metadata.gz: !binary |-
+    ZjJhMjU5YmI3MjlkNmFmMDkzNTc1OTAwMGIyNDFjMmY2MWNmZTRiZTE2OWVj
+    MTg4YTczOTRkY2FjYzViYTA0MGY3OWUwOGFjNDRjYTNiMzkyZWUyZmUwMjY2
+    NDU4YjdlMTY3MmQ1NmM5YzE5MzVmZjI2NDAxODcyOWNhMWUyMTE=
+  data.tar.gz: !binary |-
+    Mzk4MjYzYjBiZjg2YzI2MTA5NDQ3OWRhYjI2NmUyZTA2MDk2ODFmNWJjYTNi
+    NTFkZTA4NmVjNGJlNWIxNGY4OWI2ODliOWJhYzZjMTM0NDM1Y2UzZTY2MDJh
+    YTViOTY0YzI0ZGNkYWFhNTM3NmI4MTlmYjg1YzFhYTRhMzg5YmY=

data/.gitignore

@@ -0,0 +1,5 @@
+*.gem
+*.swp
+Gemfile.lock
+.bundle/
+*.old

data/.travis.yml

@@ -0,0 +1,22 @@
+---
+language: ruby
+cache: bundler
+
+# to provide the cracklib-check
+sudo: required
+before_install:
+    - sudo apt-get update -qq
+    - sudo apt-get install -y libcrack2
+
+rvm:
+  - 1.9.3
+  - 2.0.0
+
+env:
+  - SIMP_SKIP_NON_SIMPOS_TESTS=1
+
+
+script:
+  - 'bundle exec rake spec'
+
+

data/Gemfile

@@ -0,0 +1,13 @@
+# Allow a comma or space-delimited list of gem servers
+if simp_gem_server =  ENV.fetch( 'SIMP_GEM_SERVERS', 'https://rubygems.org' )
+  simp_gem_server.split( / |,/ ).each{ |gem_server|
+    source gem_server
+  }
+end
+
+# read dependencies in from the gemspec
+gemspec
+
+# mandatory gems
+gem 'bundler'
+gem 'rake'

data/LICENSE

@@ -0,0 +1,27 @@
+rubygem-simp-beaker-helpers - methods to help Beaker scaffolding SIMP tests
+
+--
+
+Per Section 105 of the Copyright Act of 1976, these works are not entitled to
+domestic copyright protection under US Federal law.
+
+The US Government retains the right to pursue copyright protections outside of
+the United States.
+
+The United States Government has unlimited rights in this software and all
+derivatives thereof, pursuant to the contracts under which it was developed and
+the License under which it falls.
+
+---
+
+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.

data/README.md

@@ -0,0 +1,140 @@
+# simp-beaker-helpers
+
+Methods to assist beaker acceptance tests for SIMP.
+
+#### Table of Contents
+1. [Overview](#overview)
+2. [Setup](#setup)
+    * [Beginning with simp-beaker-helpers](#beginning-with-simp-beaker-helpers)
+3. [Methods](#methods)
+    * [`copy_fixture_modules_to`](#copy_fixture_modules_to)
+    * [`fix_errata_on`](#fix_errata_on)
+    * [`run_fake_pki_ca_on`](#run_fake_pki_ca_on)
+    * [`copy_pki_to`](#copy_pki_to)
+    * [`copy_keydist_to`](#copy_keydist_to)
+4. [Examples](#examples)
+    * [Prep OS, Generate and copy PKI certs to each SUT](#prep-os-generate-and-copy-pki-certs-to-each-sut)
+5. [License](#license)
+
+## Overview
+
+## Setup
+
+### Beginning with simp-beaker-helpers
+
+Add this to your project's `Gemfile`:
+
+```ruby
+gem 'simp-beaker-helpers'
+```
+
+Add this to your project's `spec/spec_helper_acceptance.rb`:
+```ruby
+require 'simp-beaker-helpers'
+include SIMP::BeakerHelpers
+```
+
+
+
+## Methods
+
+#### `copy_fixture_modules_to`
+
+Copies the local fixture modules (under `spec/fixtures/modules`) onto a list of SUTs
+`copy_fixture_modules_to( suts = hosts )`
+
+
+#### `fix_errata_on`
+
+Apply any OS fixes we need on each SUT
+`fix_errata_on( suts = hosts )`
+
+
+#### `run_fake_pki_ca_on`
+
+Generate a fake openssl CA + certs for each host on a given SUT and copy the
+files back to a local directory.
+
+**NOTE:** this needs to generate everything inside an SUT.  It is assumed the
+SUT will have the appropriate openssl in its environment.
+
+`run_fake_pki_ca_on( ca_sut = master, suts = hosts, local_dir = '' )`
+
+ -  **ca_sut**    = the SUT to generate the CA & certs on
+ -  **suts**      = list of SUTs to generate certs for
+ -  **local_dir** = local path where the CA+cert directory tree should copied back to
+
+#### `copy_pki_to`
+
+Copy a single SUT's PKI certs (with cacerts) onto an SUT.  This simulates the result of `pki::copy`.
+
+The directory structure copied to the SUT is:
+```
+  HOST_PKI_DIR/
+          cacerts/cacert.pem
+          public/fdqn.pub
+          private/fdqn.pem
+
+```
+
+`copy_pki_to(sut, local_pki_dir, sut_pki_dir = '/etc/pki/simp-testing')`
+
+
+#### `copy_keydist_to`
+
+ Copy a CA keydist/ directory of CA+host certs into an SUT
+
+This simulates the output of FakeCA's `gencerts_nopass.sh` into `keydist/`
+
+`def copy_keydist_to( ca_sut = master )`
+
+
+## Examples
+
+### Prep OS, Generate and copy PKI certs to each SUT
+This pattern serves to prepare component modules that use PKI
+
+```ruby
+# spec/spec_acceptance_helpers.rb
+require 'beaker-rspec'
+require 'tmpdir'
+require 'simp/beaker_helpers'
+include Simp::BeakerHelpers
+
+unless ENV['BEAKER_provision'] == 'no'
+  hosts.each do |host|
+    # Install Puppet
+    if host.is_pe?
+      install_pe
+    else
+      install_puppet
+    end
+  end
+end
+
+
+RSpec.configure do |c|
+  # ensure that environment OS is ready on each host
+  fix_errata_on hosts
+
+  # Readable test descriptions
+  c.formatter = :documentation
+
+  # Configure all nodes in nodeset
+  c.before :suite do
+    begin
+      # Install modules and dependencies from spec/fixtures/modules
+      copy_fixture_modules_to( hosts )
+      Dir.mktmpdir do |cert_dir|
+        run_fake_pki_ca_on( default, hosts, cert_dir )
+        hosts.each{ |host| copy_pki_to( host, cert_dir, '/etc/pki/simp-testing' )}
+      end
+    rescue StandardError, ScriptError => e
+      require 'pry'; binding.pry if ENV['PRY']
+    end
+  end
+end
+```
+
+## License
+See [LICENSE](LICENSE)

data/Rakefile

@@ -0,0 +1,141 @@
+$: << File.expand_path( '../lib/', __FILE__ )
+
+require 'rubygems'
+require 'rake/clean'
+require 'fileutils'
+require 'find'
+
+@package='simp-beaker-helpers'
+@rakefile_dir=File.dirname(__FILE__)
+
+
+CLEAN.include "#{@package}-*.gem"
+CLEAN.include 'pkg'
+CLEAN.include 'dist'
+Find.find( @rakefile_dir ) do |path|
+  if File.directory? path
+    CLEAN.include path if File.basename(path) == 'tmp'
+  else
+    Find.prune
+  end
+end
+
+
+desc 'Ensure gemspec-safe permissions on all files'
+task :chmod do
+  gemspec = File.expand_path( "#{@package}.gemspec", @rakefile_dir ).strip
+  spec = Gem::Specification::load( gemspec )
+  spec.files.each do |file|
+    FileUtils.chmod 'go=r', file
+  end
+end
+
+desc 'special notes about these rake commands'
+task :help do
+  puts %Q{
+== environment variables ==
+SIMP_RPM_BUILD     when set, alters the gem produced by pkg:gem to be RPM-safe.
+                   'pkg:gem' sets this automatically.
+  }
+end
+
+desc 'run all RSpec tests'
+task :spec do
+  Dir.chdir @rakefile_dir
+  sh 'bundle exec rspec spec'
+end
+
+desc %q{run all RSpec tests (alias of 'spec')}
+task :test => :spec
+
+namespace :pkg do
+  @specfile_template = "rubygem-#{@package}.spec.template"
+  @specfile          = "build/rubygem-#{@package}.spec"
+
+  # ----------------------------------------
+  # DO NOT UNCOMMENT THIS: the spec file requires a lot of tweaking
+  # ----------------------------------------
+  #  desc "generate RPM spec file for #{@package}"
+  #  task :spec => [:clean, :gem] do
+  #    Dir.glob("pkg/#{@package}*.gem") do |pkg|
+  #      sh %Q{gem2rpm -t "#{@specfile_template}" "#{pkg}" > "#{@specfile}"}
+  #    end
+  #  end
+
+  desc "build rubygem package for #{@package}"
+  task :gem => :chmod do
+    Dir.chdir @rakefile_dir
+    Dir['*.gemspec'].each do |spec_file|
+      cmd = %Q{SIMP_RPM_BUILD=1 bundle exec gem build "#{spec_file}"}
+      sh cmd
+      FileUtils.mkdir_p 'dist'
+      FileUtils.mv Dir.glob("#{@package}*.gem"), 'dist/'
+    end
+  end
+
+
+  desc "build and install rubygem package for #{@package}"
+  task :install_gem => [:clean, :gem] do
+    Dir.chdir @rakefile_dir
+    Dir.glob("dist/#{@package}*.gem") do |pkg|
+      sh %Q{bundle exec gem install #{pkg}}
+    end
+  end
+
+
+  desc "generate RPM for #{@package}"
+    require 'tmpdir'
+    task :rpm, [:mock_root] => [:clean, :gem] do |t, args|
+      mock_root  = args[:mock_root]
+      # TODO : Get rid of this terrible code.  Shoe-horned in until
+      # we have a better idea for auto-decet
+      if mock_root =~ /^epel-6/ then el_version = '6'
+      elsif mock_root =~ /^epel-7/ then el_version = '7'
+      else puts 'WARNING: Did not detect epel version'
+      end
+      tmp_dir = ''
+
+      if tmp_dir = ENV.fetch( 'SIMP_MOCK_SIMPGEM_ASSETS_DIR', false )
+         FileUtils.mkdir_p tmp_dir
+      else
+         tmp_dir = Dir.mktmpdir( "build_#{@package}" )
+      end
+
+      begin
+        Dir.chdir tmp_dir
+        specfile     = "#{@rakefile_dir}/build/rubygem-#{@package}.el#{el_version}.spec"
+        tmp_specfile = "#{tmp_dir}/rubygem-#{@package}.el#{el_version}.spec"
+
+        # We have to copy to a local directory because mock bugs out in NFS
+        # home directories (where SIMP devs often work)
+        FileUtils.cp specfile, tmp_specfile, :preserve => true
+        Dir.glob("#{@rakefile_dir}/dist/#{@package}*.gem") do |pkg|
+          FileUtils.cp pkg, tmp_dir, :preserve => true
+        end
+
+        # Build SRPM from specfile
+        sh %Q{mock -r #{mock_root} --buildsrpm --source="#{tmp_dir}" --spec="#{tmp_specfile}" --resultdir="#{tmp_dir}"}
+
+        # Build RPM from SRPM
+        Dir.glob("#{tmp_dir}/rubygem-#{@package}-*.el#{el_version}*.src.rpm") do |pkg|
+          sh %Q{mock -r #{mock_root} --rebuild "#{pkg}" --resultdir=#{tmp_dir} --no-cleanup-after}
+        end
+
+        sh %Q{ls -l "#{tmp_dir}"}
+
+        # copy RPM back into pkg/
+        Dir.glob("#{tmp_dir}/rubygem-#{@package}-*.el#{el_version}*.rpm") do |pkg|
+          sh %Q{cp "#{pkg}" "#{@rakefile_dir}/dist/"}
+          FileUtils.cp pkg, "#{@rakefile_dir}/dist/"
+        end
+      ensure
+        Dir.chdir @rakefile_dir
+        # cleanup if needed
+        if ! ENV.fetch( 'SIMP_MOCK_SIMPGEM_ASSETS_DIR', false )
+           FileUtils.remove_entry_secure tmp_dir
+        end
+      end
+  end
+end
+
+# vim: syntax=ruby

data/files/pki/clean.sh

@@ -0,0 +1 @@
+rm -rf working demoCA keydist cacertkey ca.cnf

data/files/pki/make.sh

@@ -0,0 +1,58 @@
+DAYS="-days 365"
+REQ="openssl req $SSLEAY_CONFIG"
+CA="openssl ca $SSLEAY_CONFIG -config ca.cnf"
+VERIFY="openssl verify"
+X509="openssl x509"
+
+CATOP=./demoCA
+CAKEY=./cakey.pem
+CACERT=./cacert.pem
+CASERIAL=`uuidgen | cut -f1 -d'-'`
+
+
+keydist=keydist
+
+# start clean
+bash clean.sh
+
+mkdir -p working  "${keydist}" "${keydist}/cacerts"
+
+# Create new CA
+# ------------------------------------------------------------------------------
+dd if=/dev/urandom status=none bs=60 count=1 | openssl base64 -e -nopad | tr -d '\n' > cacertkey
+echo '' >> cacertkey
+mkdir ${CATOP}
+mkdir ${CATOP}/certs
+mkdir ${CATOP}/crl
+mkdir ${CATOP}/newcerts
+mkdir ${CATOP}/private
+echo "01" > ${CATOP}/serial
+touch ${CATOP}/index.txt
+
+echo "== Making CA certificate ..."
+sed "s/^\([[:space:]]*commonName_default\).*/\1 \t\t= Fake Org Fake CA - ${CASERIAL}/" template_ca.cnf > ca.cnf
+
+$REQ -verbose -batch -passout file:cacertkey -new -x509 -keyout ${CATOP}/private/$CAKEY -out ${CATOP}/$CACERT $DAYS
+
+echo "== Making Client certificates ..."
+for hname in $*; do
+  echo "-- $hname"
+  mkdir -p "${keydist}/${hname}/cacerts"
+  sed -e "s/#HOSTNAME#/$hname/" template_host.cnf > "working/${hname}.cnf"
+  echo "-- running openssl req"
+  $REQ -config "working/${hname}.cnf" -new -nodes -keyout ${keydist}/${hname}/${hname}.pem -out working/"${hname}"req.pem -days 360 -batch;
+  echo "-- running openssl ca"
+  $CA -passin file:cacertkey -batch -out ${keydist}/${hname}/${hname}.pub -infiles working/"${hname}"req.pem
+  cat ${keydist}/${hname}/${hname}.pub >> ${keydist}/${hname}/${hname}.pem
+done
+
+echo "== Hashing CA certs"
+cacerts="${keydist}/cacerts"
+hash=`openssl x509 -in ${CATOP}/${CACERT} -hash -noout`;
+cp ${CATOP}/${CACERT} $cacerts/cacert_${CASERIAL}.pem
+cd $cacerts
+ln -s cacert_${CASERIAL}.pem $hash.0
+cd -
+
+chmod -R u+rwX,g+rX,o-rwx $keydist
+#chown -R root:puppet $keydist

data/files/pki/template_ca.cnf

@@ -0,0 +1,259 @@
+#
+# OpenSSL example configuration file.
+# This is mostly being used for generation of certificate requests.
+#
+
+# This definition stops the following lines choking if HOME isn't
+# defined.
+HOME			= .
+RANDFILE		= $ENV::HOME/.rnd
+
+# Extra OBJECT IDENTIFIER info:
+#oid_file		= $ENV::HOME/.oid
+oid_section		= new_oids
+
+# To use this configuration file with the "-extfile" option of the
+# "openssl x509" utility, name here the section containing the
+# X.509v3 extensions to use:
+# extensions		=
+# (Alternatively, use a configuration file that has only
+# X.509v3 extensions in its main [= default] section.)
+
+[ new_oids ]
+
+# We can add new OIDs in here for use by 'ca' and 'req'.
+# Add a simple OID like this:
+# testoid1=1.2.3.4
+# Or use config file substitution like this:
+# testoid2=${testoid1}.5.6
+
+####################################################################
+[ ca ]
+default_ca	= CA_default		# The default ca section
+
+####################################################################
+[ CA_default ]
+
+dir		= ./demoCA		# Where everything is kept
+certs		= $dir/certs		# Where the issued certs are kept
+crl_dir		= $dir/crl		# Where the issued crl are kept
+database	= $dir/index.txt	# database index file.
+new_certs_dir	= $dir/newcerts		# default place for new certs.
+
+certificate	= $dir/cacert.pem 	# The CA certificate
+serial		= $dir/serial 		# The current serial number
+crl		= $dir/crl.pem 		# The current CRL
+private_key	= $dir/private/cakey.pem# The private key
+RANDFILE	= $dir/private/.rand	# private random number file
+
+x509_extensions	= usr_cert		# The extentions to add to the cert
+
+# Comment out the following two lines for the "traditional"
+# (and highly broken) format.
+name_opt 	= ca_default		# Subject Name options
+cert_opt 	= ca_default		# Certificate field options
+
+# Extension copying option: use with caution.
+# copy_extensions = copy
+
+# Extensions to add to a CRL. Note: Netscape communicator chokes on V2 CRLs
+# so this is commented out by default to leave a V1 CRL.
+# crl_extensions	= crl_ext
+
+default_days	= 365			# how long to certify for
+default_crl_days= 30			# how long before next CRL
+default_md	= sha256			# which md to use.
+preserve	= no			# keep passed DN ordering
+
+# A few difference way of specifying how similar the request should look
+# For type CA, the listed attributes must be the same, and the optional
+# and supplied fields are just that :-)
+policy		= policy_anything
+
+# For the CA policy
+[ policy_match ]
+countryName		= match
+stateOrProvinceName	= match
+organizationName	= match
+organizationalUnitName	= optional
+commonName		= supplied
+emailAddress		= optional
+
+# For the 'anything' policy
+# At this point in time, you must list all acceptable 'object'
+# types.
+[ policy_anything ]
+countryName		= optional
+stateOrProvinceName	= optional
+localityName		= optional
+organizationName	= optional
+organizationalUnitName	= optional
+commonName		= supplied
+emailAddress		= optional
+
+####################################################################
+[ req ]
+default_bits		= 2048
+default_keyfile 	= privkey.pem
+distinguished_name	= req_distinguished_name
+attributes		= req_attributes
+x509_extensions	= v3_ca	# The extentions to add to the self signed cert
+
+# Passwords for private keys if not present they will be prompted for
+# input_password = secret
+# output_password = secret
+
+# This sets a mask for permitted string types. There are several options.
+# default: PrintableString, T61String, BMPString.
+# pkix	 : PrintableString, BMPString.
+# utf8only: only UTF8Strings.
+# nombstr : PrintableString, T61String (no BMPStrings or UTF8Strings).
+# MASK:XXXX a literal mask value.
+# WARNING: current versions of Netscape crash on BMPStrings or UTF8Strings
+# so use this option with caution!
+string_mask = nombstr
+
+# req_extensions = v3_req # The extensions to add to a certificate request
+
+[ req_distinguished_name ]
+countryName			= Country Name (2 letter code)
+countryName_default		= ZZ
+countryName_min			= 2
+countryName_max			= 2
+
+#stateOrProvinceName		= State or Province Name (full name)
+#stateOrProvinceName_default	= Berkshire
+
+#localityName			= Locality Name (eg, city)
+#localityName_default		= Newbury
+
+0.organizationName		= Organization Name (eg, company)
+0.organizationName_default	= Fake Org
+
+# we can do this but it is not needed normally :-)
+#1.organizationName		= Second Organization Name (eg, company)
+#1.organizationName_default	= World Wide Web Pty Ltd
+
+organizationalUnitName		= Organizational Unit Name (eg, section)
+organizationalUnitName_default	= Hosts
+
+commonName			= Common Name (eg, your name or your server\'s hostname)
+commonName_max			= 64
+commonName_default 		= Fake Org Fake CA - #SERIAL#
+
+#emailAddress			= Email Address
+#emailAddress_max		= 64
+
+# SET-ex3			= SET extension number 3
+
+[ req_attributes ]
+#challengePassword		= A challenge password
+#challengePassword_min		= 4
+#challengePassword_max		= 20
+#challengePassword_default	= password
+
+unstructuredName		= An optional company name
+
+[ usr_cert ]
+
+# These extensions are added when 'ca' signs a request.
+
+# This goes against PKIX guidelines but some CAs do it and some software
+# requires this to avoid interpreting an end user certificate as a CA.
+
+basicConstraints=CA:FALSE
+
+# Here are some examples of the usage of nsCertType. If it is omitted
+# the certificate can be used for anything *except* object signing.
+
+# This is OK for an SSL server.
+# nsCertType			= server
+
+# For an object signing certificate this would be used.
+# nsCertType = objsign
+
+# For normal client use this is typical
+# nsCertType = client, email
+
+# and for everything including object signing:
+# nsCertType = client, email, objsign
+
+# This is typical in keyUsage for a client certificate.
+# keyUsage = nonRepudiation, digitalSignature, keyEncipherment
+
+# This will be displayed in Netscape's comment listbox.
+nsComment			= "Completely Fake Certificate"
+
+# PKIX recommendations harmless if included in all certificates.
+subjectKeyIdentifier=hash
+authorityKeyIdentifier=keyid,issuer:always
+
+# This stuff is for subjectAltName and issuerAltname.
+# Import the email address.
+subjectAltName=email:copy
+# An alternative to produce certificates that aren't
+# deprecated according to PKIX.
+# subjectAltName=email:move
+
+# Copy subject details
+# issuerAltName=issuer:copy
+
+#nsCaRevocationUrl		= http://www.domain.dom/ca-crl.pem
+#nsBaseUrl
+#nsRevocationUrl
+#nsRenewalUrl
+#nsCaPolicyUrl
+#nsSslServerName
+
+[ v3_req ]
+
+# Extensions to add to a certificate request
+
+basicConstraints = CA:FALSE
+#keyUsage = nonRepudiation, digitalSignature, keyEncipherment
+keyUsage = keyEncipherment
+
+[ v3_ca ]
+
+
+# Extensions for a typical CA
+
+
+# PKIX recommendation.
+
+subjectKeyIdentifier=hash
+
+authorityKeyIdentifier=keyid:always,issuer:always
+
+# This is what PKIX recommends but some broken software chokes on critical
+# extensions.
+#basicConstraints = critical,CA:true
+# So we do this instead.
+basicConstraints = CA:true
+
+# Key usage: this is typical for a CA certificate. However since it will
+# prevent it being used as an test self-signed certificate it is best
+# left out by default.
+# keyUsage = cRLSign, keyCertSign
+
+# Some might want this also
+# nsCertType = sslCA, emailCA
+
+# Include email address in subject alt name: another PKIX recommendation
+# subjectAltName=email:copy
+# Copy issuer details
+# issuerAltName=issuer:copy
+
+# DER hex encoding of an extension: beware experts only!
+# obj=DER:02:03
+# Where 'obj' is a standard or added object
+# You can even override a supported extension:
+# basicConstraints= critical, DER:30:03:01:01:FF
+
+[ crl_ext ]
+
+# CRL extensions.
+# Only issuerAltName and authorityKeyIdentifier make any sense in a CRL.
+
+# issuerAltName=issuer:copy
+authorityKeyIdentifier=keyid:always,issuer:always

data/files/pki/template_host.cnf

@@ -0,0 +1,262 @@
+#
+# OpenSSL example configuration file.
+# This is mostly being used for generation of certificate requests.
+#
+
+# This definition stops the following lines choking if HOME isn't
+# defined.
+HOME			= .
+RANDFILE		= $ENV::HOME/.rnd
+
+# Extra OBJECT IDENTIFIER info:
+#oid_file		= $ENV::HOME/.oid
+oid_section		= new_oids
+
+# To use this configuration file with the "-extfile" option of the
+# "openssl x509" utility, name here the section containing the
+# X.509v3 extensions to use:
+# extensions		=
+# (Alternatively, use a configuration file that has only
+# X.509v3 extensions in its main [= default] section.)
+
+[ new_oids ]
+
+# We can add new OIDs in here for use by 'ca' and 'req'.
+# Add a simple OID like this:
+# testoid1=1.2.3.4
+# Or use config file substitution like this:
+# testoid2=${testoid1}.5.6
+
+####################################################################
+[ ca ]
+default_ca	= CA_default		# The default ca section
+
+####################################################################
+[ CA_default ]
+
+dir		= ./demoCA		# Where everything is kept
+certs		= $dir/certs		# Where the issued certs are kept
+crl_dir		= $dir/crl		# Where the issued crl are kept
+database	= $dir/index.txt	# database index file.
+new_certs_dir	= $dir/newcerts		# default place for new certs.
+
+certificate	= $dir/cacert.pem 	# The CA certificate
+serial		= $dir/serial 		# The current serial number
+crl		= $dir/crl.pem 		# The current CRL
+private_key	= $dir/private/cakey.pem# The private key
+RANDFILE	= $dir/private/.rand	# private random number file
+
+x509_extensions	= usr_cert		# The extentions to add to the cert
+
+input_password = test
+output_password = test
+
+# Comment out the following two lines for the "traditional"
+# (and highly broken) format.
+name_opt 	= ca_default		# Subject Name options
+cert_opt 	= ca_default		# Certificate field options
+
+# Extension copying option: use with caution.
+# copy_extensions = copy
+
+# Extensions to add to a CRL. Note: Netscape communicator chokes on V2 CRLs
+# so this is commented out by default to leave a V1 CRL.
+# crl_extensions	= crl_ext
+
+default_days	= 365			# how long to certify for
+default_crl_days= 30			# how long before next CRL
+default_md	= sha256			# which md to use.
+preserve	= no			# keep passed DN ordering
+
+# A few difference way of specifying how similar the request should look
+# For type CA, the listed attributes must be the same, and the optional
+# and supplied fields are just that :-)
+policy		= policy_anything
+
+# For the CA policy
+[ policy_match ]
+countryName		= match
+stateOrProvinceName	= match
+organizationName	= match
+organizationalUnitName	= optional
+commonName		= supplied
+emailAddress		= optional
+
+# For the 'anything' policy
+# At this point in time, you must list all acceptable 'object'
+# types.
+[ policy_anything ]
+countryName		= optional
+stateOrProvinceName	= optional
+localityName		= optional
+organizationName	= optional
+organizationalUnitName	= optional
+commonName		= supplied
+emailAddress		= optional
+
+####################################################################
+[ req ]
+default_bits		= 2048
+default_keyfile 	= privkey.pem
+distinguished_name	= req_distinguished_name
+attributes		= req_attributes
+x509_extensions	= v3_ca	# The extentions to add to the self signed cert
+
+# Passwords for private keys if not present they will be prompted for
+# input_password = secret
+# output_password = secret
+
+# This sets a mask for permitted string types. There are several options.
+# default: PrintableString, T61String, BMPString.
+# pkix	 : PrintableString, BMPString.
+# utf8only: only UTF8Strings.
+# nombstr : PrintableString, T61String (no BMPStrings or UTF8Strings).
+# MASK:XXXX a literal mask value.
+# WARNING: current versions of Netscape crash on BMPStrings or UTF8Strings
+# so use this option with caution!
+string_mask = nombstr
+
+# req_extensions = v3_req # The extensions to add to a certificate request
+
+[ req_distinguished_name ]
+countryName			= Country Name (2 letter code)
+countryName_default		= ZZ
+countryName_min			= 2
+countryName_max			= 2
+
+#stateOrProvinceName		= State or Province Name (full name)
+#stateOrProvinceName_default	= Berkshire
+
+#localityName			= Locality Name (eg, city)
+#localityName_default		= Newbury
+
+0.organizationName		= Organization Name (eg, company)
+0.organizationName_default	= Fake Org
+
+# we can do this but it is not needed normally :-)
+#1.organizationName		= Second Organization Name (eg, company)
+#1.organizationName_default	= World Wide Web Pty Ltd
+
+organizationalUnitName		= Organizational Unit Name (eg, section)
+organizationalUnitName_default	= Hosts
+
+commonName			= Common Name (eg, your name or your server\'s hostname)
+commonName_max			= 64
+commonName_default		= #HOSTNAME#
+
+#emailAddress			= Email Address
+#emailAddress_max		= 64
+
+# SET-ex3			= SET extension number 3
+
+[ req_attributes ]
+#challengePassword		= A challenge password
+#challengePassword_min		= 4
+#challengePassword_max		= 20
+#challengePassword_default	= password
+
+unstructuredName		= Fake Cert
+
+[ usr_cert ]
+
+# These extensions are added when 'ca' signs a request.
+
+# This goes against PKIX guidelines but some CAs do it and some software
+# requires this to avoid interpreting an end user certificate as a CA.
+
+basicConstraints=CA:FALSE
+
+# Here are some examples of the usage of nsCertType. If it is omitted
+# the certificate can be used for anything *except* object signing.
+
+# This is OK for an SSL server.
+#nsCertType			= server
+
+# For an object signing certificate this would be used.
+# nsCertType = objsign
+
+# For normal client use this is typical
+# nsCertType = client, email
+# nsCertType = client
+
+# and for everything including object signing:
+nsCertType = server, client, email, objsign
+
+# This is typical in keyUsage for a client certificate.
+keyUsage = nonRepudiation, digitalSignature, keyEncipherment
+
+# This will be displayed in Netscape's comment listbox.
+#nsComment			= "Test Certificate"
+
+# PKIX recommendations harmless if included in all certificates.
+subjectKeyIdentifier=hash
+authorityKeyIdentifier=keyid,issuer:always
+
+# This stuff is for subjectAltName and issuerAltname.
+# Import the email address.
+# subjectAltName=email:copy
+# An alternative to produce certificates that aren't
+# deprecated according to PKIX.
+# subjectAltName=email:move
+
+# Copy subject details
+# issuerAltName=issuer:copy
+
+#nsCaRevocationUrl		= http://www.domain.dom/ca-crl.pem
+#nsBaseUrl
+#nsRevocationUrl
+#nsRenewalUrl
+#nsCaPolicyUrl
+#nsSslServerName
+
+[ v3_req ]
+
+# Extensions to add to a certificate request
+
+basicConstraints = CA:FALSE
+keyUsage = nonRepudiation, digitalSignature, keyEncipherment
+
+[ v3_ca ]
+
+
+# Extensions for a typical CA
+
+
+# PKIX recommendation.
+
+subjectKeyIdentifier=hash
+
+authorityKeyIdentifier=keyid:always,issuer:always
+
+# This is what PKIX recommends but some broken software chokes on critical
+# extensions.
+#basicConstraints = critical,CA:true
+# So we do this instead.
+basicConstraints = CA:true
+
+# Key usage: this is typical for a CA certificate. However since it will
+# prevent it being used as an test self-signed certificate it is best
+# left out by default.
+# keyUsage = cRLSign, keyCertSign
+
+# Some might want this also
+# nsCertType = sslCA, emailCA
+
+# Include email address in subject alt name: another PKIX recommendation
+# subjectAltName=email:copy
+# Copy issuer details
+# issuerAltName=issuer:copy
+
+# DER hex encoding of an extension: beware experts only!
+# obj=DER:02:03
+# Where 'obj' is a standard or added object
+# You can even override a supported extension:
+# basicConstraints= critical, DER:30:03:01:01:FF
+
+[ crl_ext ]
+
+# CRL extensions.
+# Only issuerAltName and authorityKeyIdentifier make any sense in a CRL.
+
+# issuerAltName=issuer:copy
+authorityKeyIdentifier=keyid:always,issuer:always

data/lib/simp/beaker_helpers.rb

@@ -0,0 +1,146 @@
+module Simp; end
+
+module Simp::BeakerHelpers
+  VERSION = '1.0.0'
+
+  # Locates .fixture.yml in or above this directory.
+  def fixtures_yml_path
+    fixtures_yml = ''
+    dir          = '.'
+    while( fixtures_yml.empty? && File.expand_path(dir) != '/' ) do
+      file = File.expand_path( '.fixtures.yml', dir )
+      if File.exists? file
+        fixtures_yml = file
+        break
+      end
+    end
+    raise 'ERROR: cannot locate .fixtures.yml!' if fixtures_yml.empty?
+    fixtures_yml
+  end
+
+
+  # returns an Array of puppet modules declared in .fixtures.yml
+  def pupmods_in_fixtures_yml
+    fixtures_yml = fixtures_yml_path
+    data         = YAML.load_file( fixtures_yml )
+    repos        = data.fetch('fixtures').fetch('repositories', {}).keys || []
+    symlinks     = data.fetch('fixtures').fetch('symlinks', {}).keys     || []
+    (repos + symlinks)
+  end
+
+
+  # Ensures that the fixture modules (under `spec/fixtures/modules`) exists.
+  # if any fixture modules are missing, run 'rake spec_prep' to populate the
+  # fixtures/modules
+  def ensure_fixture_modules
+    unless ENV['BEAKER_spec_prep'] == 'no'
+      puts "== checking prepped modules from .fixtures.yml"
+      missing_modules = []
+      pupmods_in_fixtures_yml.each do |pupmod|
+        mod_root = File.expand_path( "spec/fixtures/modules/#{pupmod}", File.dirname( fixtures_yml_path ))
+        missing_modules << pupmod unless File.directory? mod_root
+      end
+      puts "  -- #{missing_modules.size} modules need to be prepped"
+      unless missing_modules.empty?
+        cmd = 'bundle exec rake spec_prep'
+        puts "  -- running spec_prep: '#{cmd}'"
+        %x(#{cmd})
+      else
+        puts "  == all fixture modules present"
+      end
+    end
+  end
+
+  # Copy the local fixture modules (under `spec/fixtures/modules`) onto each SUT
+  def copy_fixture_modules_to( suts = hosts )
+    ensure_fixture_modules
+    suts.each do |sut|
+      # allow spec_prep to provide modules (to support isolated networks)
+      unless ENV['BEAKER_use_fixtures_dir_for_modules'] == 'no'
+        pupmods_in_fixtures_yml.each do |pupmod|
+          mod_root = File.expand_path( "spec/fixtures/modules/#{pupmod}", File.dirname( fixtures_yml_path ))
+          copy_module_to( sut, {:source => mod_root, :module_name => pupmod} )
+        end
+      end
+    end
+  end
+
+
+  # Apply known OS fixes we need to run Beaker on each SUT
+  def fix_errata_on( suts = hosts )
+    suts.each do |sut|
+      # net-tools required for netstat utility being used by be_listening
+      if fact_on(sut, 'osfamily') == 'RedHat' && fact_on(sut, 'operatingsystemmajrelease') == '7'
+        pp = <<-EOS
+          package { 'net-tools': ensure => installed }
+        EOS
+        apply_manifest_on(sut, pp, :catch_failures => false)
+      end
+    end
+  end
+
+
+  # Generate a fake openssl CA + certs for each host on a given SUT
+  #
+  # The directory structure is the same as what FakeCA drops into keydist/
+  #
+  # NOTE: This generates everything within an SUT and copies it back out.
+  #       This is because it is assumed the SUT will have the appropriate
+  #       openssl in its environment, which may not be true of the host.
+  def run_fake_pki_ca_on( ca_sut = master, suts = hosts, local_dir = '' )
+    puts "== Fake PKI CA"
+    pki_dir  = File.expand_path( "../../files/pki", File.dirname(__FILE__))
+    host_dir = '/root/pki'
+    fqdns    = fact_on hosts, 'fqdn'
+
+    on ca_sut, %Q(mkdir -p "#{host_dir}")
+    Dir[ File.join(pki_dir, '*')].each {|f| scp_to( ca_sut, f, host_dir)}
+
+    # generate PKI certs for each SUT
+    Dir.mktmpdir do |dir|
+      pki_hosts_file = File.join(dir, 'pki.hosts')
+      File.open(pki_hosts_file, 'w'){|fh| fqdns.each{|fqdn| fh.puts fqdn}}
+      scp_to(ca_sut, pki_hosts_file, host_dir)
+      # generate certs
+      on ca_sut, "cd #{host_dir}; cat #{host_dir}/pki.hosts | xargs bash make.sh"
+    end
+
+    scp_from( ca_sut, host_dir, local_dir ) unless local_dir.empty?
+  end
+
+
+  # Copy a single SUT's PKI certs (with cacerts) onto an SUT.
+  #
+  # This simulates the result of pki::copy
+  #
+  # The directory structure is:
+  #
+  # HOST_PKI_DIR/
+  #         cacerts/cacert.pem
+  #         public/fdqn.pub
+  #         private/fdqn.pem
+  def copy_pki_to(sut, local_pki_dir, sut_pki_dir = '/etc/pki/simp-testing')
+      fqdn = fact_on(sut, 'fqdn')
+      local_host_pki_tree   = File.join(local_pki_dir,'pki','keydist',fqdn)
+      ###local_cacert_pki_tree = File.join(local_pki_dir,'pki','keydist','cacerts')
+      local_cacert = File.join(local_pki_dir,'pki','demoCA','cacert.pem')
+      on sut, %Q(mkdir -p "#{sut_pki_dir}/public" "#{sut_pki_dir}/private" "#{sut_pki_dir}/cacerts")
+      scp_to(sut, "#{local_host_pki_tree}/#{fqdn}.pem",   "#{sut_pki_dir}/private/")
+      scp_to(sut, "#{local_host_pki_tree}/#{fqdn}.pub",   "#{sut_pki_dir}/public/")
+      ###scp_to(sut, local_cacert_pki_tree, sut_pki_dir)
+      scp_to(sut, local_cacert, "#{sut_pki_dir}/cacerts/")
+  end
+
+
+  # Copy a CA keydist/ directory of CA+host certs into an SUT
+  #
+  # This simulates the output of FakeCA's gencerts_nopass.sh to keydist/
+  #
+  # FIXME: update keydist to use a more flexible path
+  def copy_keydist_to( ca_sut = master )
+    modulepath = on(ca_sut, 'puppet config print  modulepath --environment production' ).output.chomp.split(':')
+    on ca_sut, "rm -rf #{modulepath.first}/pki/files/keydist/*"
+    on ca_sut, "cp -a /root/pki/keydist/ #{modulepath.first}/pki/files/"
+    on ca_sut, "chgrp -R puppet #{modulepath.first}/pki/files/keydist"
+  end
+end

data/simp-beaker-helpers.gemspec

@@ -0,0 +1,28 @@
+# -*- encoding: utf-8 -*-
+$LOAD_PATH.unshift File.expand_path('../lib', __FILE__)
+require 'simp/beaker_helpers.rb'
+
+Gem::Specification.new do |s|
+  s.name        = 'simp-beaker-helpers'
+  s.date        = Date.today.to_s
+  s.summary     = 'beaker helper methods for SIMP'
+  s.description = <<-EOF
+    Beaker helper methods to stick in spec_acceptance_helper.rb
+  EOF
+  s.version     = Simp::BeakerHelpers::VERSION
+  s.license     = 'Apache-2.0'
+  s.authors     = ['Chris Tessmer']
+  s.email       = 'simp@simp-project.org'
+  s.homepage    = 'https://github.com/simp/rubygem-simp-beaker-helpers'
+  s.metadata = {
+                 'issue_tracker' => 'https://simp-project.atlassian.net'
+               }
+
+  s.add_runtime_dependency 'beaker', '~> 2'
+
+  ### s.files = Dir['Rakefile', '{bin,lib,spec}/**/*', 'README*', 'LICENSE*'] & `git ls-files -z .`.split("\0")
+  s.files       = `git ls-files`.split("\n")
+  s.test_files  = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+
+end

metadata

@@ -0,0 +1,72 @@
+--- !ruby/object:Gem::Specification
+name: simp-beaker-helpers
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Chris Tessmer
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-09-07 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: beaker
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2'
+description: ! '    Beaker helper methods to stick in spec_acceptance_helper.rb
+
+'
+email: simp@simp-project.org
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .travis.yml
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- files/pki/clean.sh
+- files/pki/make.sh
+- files/pki/template_ca.cnf
+- files/pki/template_host.cnf
+- lib/simp/beaker_helpers.rb
+- simp-beaker-helpers.gemspec
+homepage: https://github.com/simp/rubygem-simp-beaker-helpers
+licenses:
+- Apache-2.0
+metadata:
+  issue_tracker: https://simp-project.atlassian.net
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.8
+signing_key: 
+specification_version: 4
+summary: beaker helper methods for SIMP
+test_files: []