Module/Rule.RootCertificate/Convert/RootCertificateRule.Convert.psm1
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 |
# Copyright (c) Microsoft Corporation. All rights reserved. # Licensed under the MIT License. using module .\..\..\Common\Common.psm1 using module .\..\..\Rule\Rule.psm1 using module .\..\RootCertificateRule.psm1 $exclude = @($MyInvocation.MyCommand.Name,'Template.*.txt') $supportFileList = Get-ChildItem -Path $PSScriptRoot -Exclude $exclude foreach ($supportFile in $supportFileList) { Write-Verbose "Loading $($supportFile.FullName)" . $supportFile.FullName } # Header <# .SYNOPSIS Convert the contents of an xccdf check-content element into a Root Certificate object .DESCRIPTION The RootCertificateRule class is used to extract the DoD Root Certificate details from the check-content of the xccdf. Once a STIG rule is identified a Root Certificate rule, it is passed to the RootCertificateRule class for parsing and validation. #> class RootCertificateRuleConvert : RootCertificateRule { <# .SYNOPSIS Empty constructor for SplitFactory #> RootCertificateRuleConvert () { } <# .SYNOPSIS Converts an xccdf stig rule element into a Root Certificate Rule .PARAMETER XccdfRule The STIG rule to convert #> RootCertificateRuleConvert ([xml.xmlelement] $XccdfRule) : base ($XccdfRule, $true) { $this.SetRootCertificateName() $this.SetRootCertificateThumbprint() if ($this.IsOrganizationalSetting()) { $this.SetRootCertificateOrganizationValueTestString() } $this.SetDscResource() } # Methods <# .SYNOPSIS Extracts the Root Certificate Name from the check-content and sets the Certificate Name .DESCRIPTION Gets the Root Certificate Name from the xccdf content. If the value that is returned is not valid, the parser status is set to fail. #> [void] SetRootCertificateName () { $certificateName = Set-RootCertificateName -CheckContent $this.SplitCheckContent if (-not $this.SetStatus($certificateName)) { $this.set_CertificateName($certificateName) } } <# .SYNOPSIS Extracts the Root Certificate Thumbprint from the check-content and sets the Certificate Thumbprint .DESCRIPTION Gets the Root Certificate Thumbprint from the xccdf content. If the value that is returned is not valid, the parser status is set to fail. #> [void] SetRootCertificateThumbprint() { $thumbprint = Set-RootCertificateThumbprint -CheckContent $this.SplitCheckContent if (-not $this.SetStatus($thumbprint)) { $this.set_Thumbprint($thumbprint) } } <# .SYNOPSIS Sets organizational value to required because all certificates require a location parameter defined by config .DESCRIPTION The organizational settings is always required for root certificate rules #> [bool] IsOrganizationalSetting () { if ($null -ne $this.CertificateName) { return $true } else { return $false } } <# .SYNOPSIS Set the organizational value .DESCRIPTION Extracts the organizational value from the Certificate Name and then sets the value #> [void] SetRootCertificateOrganizationValueTestString () { $rootCertificateOrganizationValueTestString = Get-RootCertificateOrganizationValueTestString -CertificateName $this.CertificateName if (-not $this.SetStatus($rootCertificateOrganizationValueTestString)) { $this.set_OrganizationValueTestString($rootCertificateOrganizationValueTestString) $this.set_OrganizationValueRequired($true) } } hidden [void] SetDscResource () { if ($null -eq $this.DuplicateOf) { $this.DscResource = 'CertificateDSC' } else { $this.DscResource = 'None' } } static [bool] Match ([string] $CheckContent) { if ($CheckContent -match 'CN=DoD') { return $true } return $false } <# .SYNOPSIS Tests if a rule contains multiple checks .DESCRIPTION Search the rule text to determine if multiple {0} are defined #> static [bool] HasMultipleRules ([string] $CheckContent) { return (Test-MultipleRootCertificateRule -CheckContent ([RootCertificateRule]::SplitCheckContent($CheckContent))) } <# .SYNOPSIS Splits a rule into multiple checks .DESCRIPTION Once a rule has been found to have multiple checks, the rule needs to be split. This method splits a windows feature into multiple rules. Each split rule id is appended with a dot and letter to keep reporting per the ID consistent. An example would be is V-1000 contained 2 checks, then SplitMultipleRules would return 2 objects with rule ids V-1000.a and V-1000.b .PARAMETER CheckContent The rule text from the check-content element in the xccdf #> static [string[]] SplitMultipleRules ([string] $CheckContent) { return (Split-MultipleRootCertificateRule -CheckContent ([RootCertificateRule]::SplitCheckContent($CheckContent))) } } |