ContinuousCompliance/ContinuousCompliance.ps1
|
Set-StrictMode -Version Latest function Install-AzSDKContinuousAssurance { <# .SYNOPSIS This command would help in installing Automation Account in your subscription to setup Continuous Assurance feature of AzSDK .DESCRIPTION This command will install an Automation Account (Name: AzSDKContinuousAssurance) which runs security scan on subscription and resource groups which are specified during installation. Security scan results will be populated in OMS which is configured during installation. Also detailed logs will be stored in storage account (Name: azsdkyyyyMMddHHmmss format). .PARAMETER SubscriptionId Subscription id in which Automation Account needs to be installed .PARAMETER AutomationAccountLocation Location of resource group which contains Automation Account. This is optional. Default location is EastUS2. .PARAMETER ResourceGroupNames Comma separated Application resource group names on which security scan should be performed by Automation Account. .PARAMETER OMSWorkspaceId Workspace ID of OMS where security scan results will be populated .PARAMETER OMSSharedKey Shared key of OMS which is used to monitor security scan results .PARAMETER LoggingOption Gives the flexibility for the users to choose from central sub reports storage mode vs individual sub reports storage in CA Scaling scenario .PARAMETER Preview This enables the preview feature for CA. Currently you need to use this switch to install CA in central scanning mode. .PARAMETER AzureADAppName Name for the Azure Active Directory (AD) Application that will be created in the subscription for running the runbook .PARAMETER TargetSubscriptionIds Comma separated values of target subscriptionIds that will be monitord through CA from a central subscrition. .NOTES .LINK https://aka.ms/azsdkossdocs #> Param( [Parameter(Mandatory = $true, ParameterSetName = "Default")] [Parameter(Mandatory = $true, ParameterSetName = "Preview")] [string] $SubscriptionId , [Parameter(Mandatory = $true, ParameterSetName = "Preview")] [string] $TargetSubscriptionIds, [Parameter(Mandatory = $false, ParameterSetName = "Preview")] [Parameter(Mandatory = $false, ParameterSetName = "Default")] [string] $AutomationAccountLocation="EastUS2", [Parameter(Mandatory = $true, ParameterSetName = "Preview")] [Parameter(Mandatory = $true, ParameterSetName = "Default")] [string] [ValidateNotNullOrEmpty()] $ResourceGroupNames , [Parameter(Mandatory = $true, ParameterSetName = "Preview")] [Parameter(Mandatory = $true, ParameterSetName = "Default")] [string] [ValidateNotNullOrEmpty()] $OMSWorkspaceId, [Parameter(Mandatory = $true, ParameterSetName = "Preview")] [Parameter(Mandatory = $true, ParameterSetName = "Default")] [string] [ValidateNotNullOrEmpty()] $OMSSharedKey, [Parameter(Mandatory = $false, ParameterSetName = "Preview")] [Parameter(Mandatory = $false, ParameterSetName = "Default")] [string] [ValidateNotNullOrEmpty()] $AzureADAppName, [Parameter(Mandatory = $true, ParameterSetName = "Preview")] [CAReportsLocation] $LoggingOption, [Parameter(Mandatory = $true, ParameterSetName = "Preview")] [switch] $Preview ) Begin { [CommandHelper]::BeginCommand($PSCmdlet.MyInvocation); [ListenerHelper]::RegisterListeners(); } Process { try { $ccAccount = [CCAutomation]::new($SubscriptionId, $PSCmdlet.MyInvocation,` $AutomationAccountLocation, $ResourceGroupNames,$OMSWorkspaceId,$OMSSharedKey,` $AzureADAppName); if ($ccAccount) { if($Preview) { $ccAccount.IsPreviewModeEnabled = $true; $ccAccount.TargetSubscriptionIds = $TargetSubscriptionIds; if($null -eq $LoggingOption) { $ccAccount.LoggingOption = [CAReportsLocation]::CentralSub; } else { $ccAccount.LoggingOption = $LoggingOption; } return $ccAccount.InvokeFunction($ccAccount.InstallAzSDKContinuousAssuranceScale) } return $ccAccount.InvokeFunction($ccAccount.InstallAzSDKContinuousAssurance); } } catch { [EventBase]::PublishGenericException($_); } } End { [ListenerHelper]::UnregisterListeners(); } } function Update-AzSDKContinuousAssurance { <# .SYNOPSIS This command would help in updating user configurable properties of Continuous Assurance Automation Account in your subscription .DESCRIPTION This command is helpful if you want to update any of the following properties. 1. App Resource Groups 2. OMS Workspace ID 3. OMS Shared Key 4. Connection in Run as Account 5. Update/Renew Certificate in Run as Account .PARAMETER SubscriptionId Subscription id in which Automation Account exists .PARAMETER ResourceGroupNames Comma separated Application resource group names on which security scan should be performed by Automation Account .PARAMETER OMSWorkspaceId Workspace ID of OMS where security scan results will be populated .PARAMETER OMSSharedKey Shared key of OMS which is used to monitor security scan results .PARAMETER AzureADAppName Name for the Azure Active Directory (AD) Application that will be created to update automation account Connection in Run As Account for running the runbook .PARAMETER UpdateCertificate Switch to update certificate credential for AzureADApp SPN and also upload the certificate to automation account. .PARAMETER TargetSubscriptionIds Comma separated values of targetsubscriptionIds that will get monitored from the central subscription through CA. .PARAMETER LoggingOption This provides the capability to users to store the CA scan logs on central subscription or on individual subscriptions .PARAMETER Preview This enables the preview capabilites of CA. You must provide this option to enable CA in central scanning mode. .NOTES .LINK https://aka.ms/azsdkossdocs #> Param( [Parameter(Mandatory = $true, ParameterSetName = "Default")] [Parameter(Mandatory = $true, ParameterSetName = "Preview")] [string] $SubscriptionId, [Parameter(Mandatory = $true, ParameterSetName = "Preview")] [string] $TargetSubscriptionIds, [Parameter(Mandatory = $false, ParameterSetName = "Default")] [Parameter(Mandatory = $false, ParameterSetName = "Preview")] [ValidateNotNullOrEmpty()] [string] $ResourceGroupNames, [Parameter(Mandatory = $false, ParameterSetName = "Default")] [Parameter(Mandatory = $false, ParameterSetName = "Preview")] [ValidateNotNullOrEmpty()] [string] $OMSWorkspaceId, [Parameter(Mandatory = $false, ParameterSetName = "Default")] [Parameter(Mandatory = $false, ParameterSetName = "Preview")] [ValidateNotNullOrEmpty()] [string] $OMSSharedKey, [Parameter(Mandatory = $false, ParameterSetName = "Default")] [Parameter(Mandatory = $false, ParameterSetName = "Preview")] [ValidateNotNullOrEmpty()] $AzureADAppName, [Parameter(Mandatory = $false, ParameterSetName = "Default")] [Parameter(Mandatory = $false, ParameterSetName = "Preview")] [switch] $FixRuntimeAccount, [Parameter(Mandatory = $false, ParameterSetName = "Default")] [Parameter(Mandatory = $false, ParameterSetName = "Preview")] [switch] $FixModules, [Parameter(Mandatory = $true, ParameterSetName = "Preview")] [CAReportsLocation] $LoggingOption, [Parameter(Mandatory = $true, ParameterSetName = "Preview")] [switch] $Preview ) Begin { [CommandHelper]::BeginCommand($PSCmdlet.MyInvocation); [ListenerHelper]::RegisterListeners(); } Process { try { $ccAccount = [CCAutomation]::new($SubscriptionId, $PSCmdlet.MyInvocation); if ($ccAccount) { if($Preview) { $ccAccount.IsPreviewModeEnabled = $true; $ccAccount.TargetSubscriptionIds = $TargetSubscriptionIds; if($null -eq $LoggingOption) { $ccAccount.LoggingOption = [CAReportsLocation]::CentralSub; } else { $ccAccount.LoggingOption = $LoggingOption; } } return $ccAccount.InvokeFunction($ccAccount.UpdateAzSDKContinuousAssurance,@($ResourceGroupNames,$OMSWorkspaceId,$OMSSharedKey,$AzureADAppName,$FixRuntimeAccount,$FixModules)); } } catch { [EventBase]::PublishGenericException($_); } } End { [ListenerHelper]::UnregisterListeners(); } } function Get-AzSDKContinuousAssurance { <# .SYNOPSIS This command would help in getting details of Continuous Assurance Automation Account in your subscription .DESCRIPTION .PARAMETER SubscriptionId Subscription id in which Automation Account exists .PARAMETER ExhaustiveCheck Does the full scan of CA Setup .PARAMETER Preview This switch enables preview capabilities of AzSDK CA .LINK https://aka.ms/azsdkossdocs #> Param( [Parameter(Mandatory = $true)] [string] $SubscriptionId, [Parameter(Mandatory = $false)] [switch] $ExhaustiveCheck, [Parameter(Mandatory = $false)] [switch] $Preview ) Begin { [CommandHelper]::BeginCommand($PSCmdlet.MyInvocation); [ListenerHelper]::RegisterListeners(); } Process { try { $ccAccount = [CCAutomation]::new($SubscriptionId, $PSCmdlet.MyInvocation); if ($ccAccount) { if($Preview) { $ccAccount.IsPreviewModeEnabled = $true; } $ccAccount.ExhaustiveCheck = $ExhaustiveCheck; return $ccAccount.InvokeFunction($ccAccount.GetAzSDKContinuousAssurance); } } catch { [EventBase]::PublishGenericException($_); } } End { [ListenerHelper]::UnregisterListeners(); } } function Remove-AzSDKContinuousAssurance { <# .SYNOPSIS This command would help in removing resources created by Continuous Assurance installation in your subscription .DESCRIPTION .PARAMETER SubscriptionId Subscription id in which Automation Account exists .PARAMETER DeleteStorageReports Switch to specify whether security scan logs/reports stored in storage account also should be removed permanently. .PARAMETER Force Switch to force this cmdlet to remove CA resources .PARAMETER Preview This enables preview feature of AzSDK CA in central scanning mode. Use this switch along with DeleteStorageReports switch to delete the st .LINK https://aka.ms/azsdkossdocs #> Param( [Parameter(Mandatory = $true, ParameterSetName = "Default")] [Parameter(Mandatory = $true, ParameterSetName = "Preview")] [string] $SubscriptionId , [Parameter(Mandatory = $false, ParameterSetName = "Default")] [Parameter(Mandatory = $true, ParameterSetName = "Preview")] [switch] $DeleteStorageReports, [switch] [Parameter(Mandatory = $false, ParameterSetName = "Default", HelpMessage = "Switch to force this cmdlet to remove CA resources.")] [Parameter(Mandatory = $false, ParameterSetName = "Preview", HelpMessage = "Switch to force this cmdlet to remove CA resources.")] $Force, [Parameter(Mandatory = $true, ParameterSetName = "Preview")] [switch] $Preview ) Begin { [CommandHelper]::BeginCommand($PSCmdlet.MyInvocation); [ListenerHelper]::RegisterListeners(); } Process { try { $ccAccount = [CCAutomation]::new($SubscriptionId, $PSCmdlet.MyInvocation); if ($ccAccount) { if($Preview) { $ccAccount.IsPreviewModeEnabled = $true; } return $ccAccount.InvokeFunction($ccAccount.RemoveAzSDKContinuousAssurance,@($DeleteStorageReports, $Force)); } } catch { [EventBase]::PublishGenericException($_); } } End { [ListenerHelper]::UnregisterListeners(); } } |