Skip to content

ldillonel/PowerStigDsc

 
 

Repository files navigation

PowerStigDsc

master: Build status

dev: Build status

PowerStigDsc is a Windows PowerShell Desired State Configuration (DSC) composite resource to manage the configurable items of the DISA STIG's. This is accomplished by using OSS DSC Resources that are specialized to a specific area of the STIG from the PowerShell gallery. PowerStigDsc depends on an external module PowerStig for the STIG data and multiple DSC resources to apply the setting. All of the required dependencies are defined in the module manifest so they are automatically downloaded if you install PowerStigDsc from the PowerShell Gallery.

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.

Contributing

Please check out common DSC Resources contributing guidelines.

Composite Resources

  • Browser: Provides a mechanism to manage Browser STIG settings.

  • WindowsDnsServer: Provides a mechanism to manage Windows DNS Server STIG settings.

  • WindowsFirewall: Provides a mechanism to manage the Windows Firewall STIG settings.

  • WindowsServer: Provides a mechanism to manage the Windows Server STIG settings.

Browser

Provides a mechanism to manage Browser STIG settings.

Requirements

None

Parameters

  • [String] BrowserName (Mandatory): The version of the Browser that the configuration is applying to.
  • [String] BrowserVersion (Optional): The Browser version of the STIG you want to apply. If no value is provided, the most recent version of the STIG is applied.
  • [Hashtable] Exception (Optional): A hash table of the exceptions that should be applied to the server. The hashtable must be in the format StigId = Exception.
  • [Xml] OrgSetting (Optional): An XML document that contains the values for settings that contain a range of possible values.

Examples

WindowsDnsServer

Provides a mechanism to manage Windows Dns Server STIG settings.

Requirements

None

Parameters

  • [String] OsVersion (Mandatory): The version of the server OS that the configuration is applying to.
  • [String] StigVersion (Optional): The version of the STIG you want to apply. If no value is provided, the most recent version of the STIG is applied.
  • [String] ForestName (Optional): The FQDN of the forest the configuration is being applied to. If a domain name is not applied, the domain of the computer used to generate the configuration is used.
  • [String] DomainName (Optional): The FQDN of the domain the configuration is being applied to. If a domain name is not applied, the domain of the computer used to generate the configuration is used.
  • [Hashtable] Exception (Optional): A hash table of the exceptions to be applied to the server. The hashtable must be in the format StigId = Exception.
  • [Xml] OrgSetting (Optional): This is an XML file that overrides the default settings of allowable ranges in the STIG.
  • [PSObject] SkipRule (Optional): Rule Id/s that you do not want to be applied to the server.
  • [PSObject] SkipRuleType (Optional): Rule type/s that you do not want to be applied to the server.

Examples

WindowsFirewall

Provides a mechanism to manage the Windows Firewall STIG settings.

Requirements

None

Parameters

  • [String] StigVersion (Optional): The version of the STIG you want to apply. If no value is provided, the most recent version of the STIG is applied.
  • [Hashtable] Exception (Optional): A hash table of the exceptions to be applied to the server. The hashtable must be in the format StigId = Exception.
  • [Xml] OrgSetting (Optional): This is an XML file that overrides the default settings of allowable ranges in the STIG.
  • [PSObject] SkipRule (Optional): Rule Id/s that you do not want to be applied to the server.
  • [PSObject] SkipRuleType (Optional): Rule type/s that you do not want to be applied to the server.

Examples

WindowsServer

Provides a mechanism to manage the Windows Server STIG settings.

Requirements

None

Parameters

  • [String] OsVersion (Mandatory): The version of the server OS that the configuration is applying to.
  • [String] OsRole (Mandatory): The role of the computer the configuration applies to.
  • [String] StigVersion (Optional): The version of the STIG you want to apply. If no value is provided, the most recent version of the STIG is applied.
  • [String] ForestName (Optional): The FQDN of the forest the configuration is being applied to. If a domain name is not applied, the domain of the computer used to generate the configuration is used.
  • [String] DomainName (Optional): The FQDN of the domain the configuration is being applied to. If a domain name is not applied, the domain of the computer used to generate the configuration is used.
  • [Hashtable] Exception (Optional): A hash table of the exceptions to be applied to the server. The hashtable must be in the format StigId = Exception.
  • [Xml] OrgSetting (Optional): This is an XML file that overrides the default settings of allowable ranges in the STIG.
  • [PSObject] SkipRule (Optional): Rule Id/s that you do not want to be applied to the server.
  • [PSObject] SkipRuleType (Optional): Rule type/s that you do not want to be applied to the server.

Examples

Versions

Unreleased

  • Added ModuleVersion parameter to each Import-DscResource for all composite resources

1.0.0.0

  • Browser Composite
  • Windows DNS Server Composite
  • Windows Firewall Composite
  • Windows Server Composite

About

A Composite DSC resource to apply and audit DISA STIGs

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • PowerShell 100.0%