en-GB/about_PSRule_Azure_Configuration.help.txt
|
TOPIC
about_psrule_azure_configuration SHORT DESCRIPTION Describes PSRule configuration options specific to PSRule for Azure. LONG DESCRIPTION PSRule exposes configuration options that can be used to customize execution of `PSRule.Rules.Azure`. This topic describes what configuration options are available. PSRule configuration options can be specified by setting the configuration option in `ps-rule.yaml`. Additionally, configuration options can be configured in a baseline or set at runtime. For details of setting configuration options see [PSRule options][1]. The following configurations options are available for use: - AZURE_AKS_CLUSTER_MINIMUM_VERSION - AZURE_AKS_POOL_MINIMUM_MAXPODS - AZURE_RESOURCE_ALLOWED_LOCATIONS - AZURE_APIM_MINIMUM_CERTIFICATE_LIFETIME - AZURE_PARAMETER_FILE_EXPANSION - AZURE_POLICY_WAIVER_MAX_EXPIRY - AZURE_RESOURCE_GROUP - AZURE_SUBSCRIPTION - AZURE_POLICY_IGNORE_LIST - AZURE_POLICY_RULE_PREFIX - AZURE_APIM_MIN_API_VERSION - AZURE_COSMOS_DEFENDER_PER_ACCOUNT - AZURE_STORAGE_DEFENDER_PER_ACCOUNT [1]: https://aka.ms/ps-rule/options AZURE_AKS_CLUSTER_MINIMUM_VERSION This configuration option determines the minimum version of Kubernetes for AKS clusters and node pools. Rules that check the Kubernetes version fail when the version is older than the version specified. Syntax: configuration: AZURE_AKS_CLUSTER_MINIMUM_VERSION: string # A version string Default: # YAML: The default AZURE_AKS_CLUSTER_MINIMUM_VERSION configuration option configuration: AZURE_AKS_CLUSTER_MINIMUM_VERSION: 1.29.7 Example: # YAML: Set the AZURE_AKS_CLUSTER_MINIMUM_VERSION configuration option to 1.19.7 configuration: AZURE_AKS_CLUSTER_MINIMUM_VERSION: 1.19.7 AZURE_AKS_POOL_MINIMUM_MAXPODS This configuration option determines the minimum allowed max pods setting per node pool. When an AKS cluster node pool is created, a `maxPods` option is used to determine the maximum number of pods for each node in the node pool. Syntax: configuration: AZURE_AKS_POOL_MINIMUM_MAXPODS: integer Default: # YAML: The default AZURE_AKS_POOL_MINIMUM_MAXPODS configuration option configuration: AZURE_AKS_POOL_MINIMUM_MAXPODS: 50 Example: # YAML: Set the AZURE_AKS_POOL_MINIMUM_MAXPODS configuration option to 30 configuration: AZURE_AKS_POOL_MINIMUM_MAXPODS: 30 AZURE_RESOURCE_ALLOWED_LOCATIONS This configuration option specifies a list of allowed locations that resources can be deployed to. Rules that check the location of Azure resources fail when a resource or resource group is created in a different region. By default, `AZURE_RESOURCE_ALLOWED_LOCATIONS` is not configured. The rule `Azure.Resource.AllowedRegions` is skipped when no allowed locations are configured. Syntax: configuration: AZURE_RESOURCE_ALLOWED_LOCATIONS: array # An array of regions Default: # YAML: The default AZURE_RESOURCE_ALLOWED_LOCATIONS configuration option configuration: AZURE_RESOURCE_ALLOWED_LOCATIONS: [] Example: # YAML: Set the AZURE_RESOURCE_ALLOWED_LOCATIONS configuration option to Australia East, Australia South East configuration: AZURE_RESOURCE_ALLOWED_LOCATIONS: - 'australiaeast' - 'australiasoutheast' AZURE_APIM_MINIMUM_CERTIFICATE_LIFETIME This configuration option determines the minimum number of days allowed before certificate expiry. Rules that check certificate lifetime fail when the days remaining before expiry drop below this number. Syntax: configuration: AZURE_APIM_MINIMUM_CERTIFICATE_LIFETIME: integer Default: # YAML: The default AZURE_APIM_MINIMUM_CERTIFICATE_LIFETIME configuration option configuration: AZURE_APIM_MINIMUM_CERTIFICATE_LIFETIME: 30 Example: # YAML: Set the AZURE_APIM_MINIMUM_CERTIFICATE_LIFETIME configuration option to 90 configuration: AZURE_APIM_MINIMUM_CERTIFICATE_LIFETIME: 90 AZURE_PARAMETER_FILE_EXPANSION This configuration option determines if Azure template parameter files will automatically be expanded. By default, parameter files will not be automatically expanded. Parameter files are expanded when PSRule cmdlets with the `-Format File` parameter are used. Syntax: configuration: AZURE_PARAMETER_FILE_EXPANSION: bool Default: # YAML: The default AZURE_PARAMETER_FILE_EXPANSION configuration option configuration: AZURE_PARAMETER_FILE_EXPANSION: false Example: # YAML: Set the AZURE_PARAMETER_FILE_EXPANSION configuration option to enable expansion configuration: AZURE_PARAMETER_FILE_EXPANSION: true AZURE_POLICY_WAIVER_MAX_EXPIRY This configuration option determines the maximum number of days in the future for a waiver policy exemption. Syntax: configuration: AZURE_POLICY_WAIVER_MAX_EXPIRY: integer Default: # YAML: The default AZURE_POLICY_WAIVER_MAX_EXPIRY configuration option configuration: AZURE_POLICY_WAIVER_MAX_EXPIRY: 366 Example: # YAML: Set the AZURE_POLICY_WAIVER_MAX_EXPIRY configuration option to 90 configuration: AZURE_POLICY_WAIVER_MAX_EXPIRY: 90 AZURE_RESOURCE_GROUP This configuration option sets the resource group object used by the `resourceGroup()` function. Configure this option to change the resource group object when using exporting templates for analysis. Provided properties will override the default. Any properties that are not provided with use the defaults as specified below. This configuration option will be ignored when `-ResourceGroup` is used with `Export-AzRuleTemplateData`. Syntax: configuration: AZURE_RESOURCE_GROUP: name: string location: string tags: object properties: provisioningState: string Default: # YAML: The default AZURE_RESOURCE_GROUP configuration option configuration: AZURE_RESOURCE_GROUP: name: 'ps-rule-test-rg' location: 'eastus' tags: { } properties: provisioningState: 'Succeeded' Example: # YAML: Override the location of the resource group object. configuration: AZURE_RESOURCE_GROUP: location: 'australiasoutheast' AZURE_SUBSCRIPTION This configuration option sets the subscription object used by the `subscription()` function. Configure this option to change the subscription object when using exporting templates for analysis. Provided properties will override the default. Any properties that are not provided with use the defaults as specified below. This configuration option will be ignored when `-Subscription` is used with `Export-AzRuleTemplateData`. Syntax: configuration: AZURE_SUBSCRIPTION: subscriptionId: string tenantId: string displayName: string state: string Default: # YAML: The default AZURE_SUBSCRIPTION configuration option configuration: AZURE_SUBSCRIPTION: subscriptionId: 'ffffffff-ffff-ffff-ffff-ffffffffffff' tenantId: 'ffffffff-ffff-ffff-ffff-ffffffffffff' displayName: 'PSRule Test Subscription' state: 'NotDefined' Example: # YAML: Override the display name of the subscription object AZURE_SUBSCRIPTION: displayName: 'My test subscription' AZURE_POLICY_IGNORE_LIST This configuration option configures a custom list policy definitions to ignore when exporting policy to rules. In addition to the custom list, a built-in list of policies are ignored. The built-in list can be found here . Configure this option to ignore policy definitions that: - Already have a rule defined. - Are not relevant to testing Infrastructure as Code. Syntax: configuration: AZURE_POLICY_IGNORE_LIST: array Default: # YAML: The default AZURE_POLICY_IGNORE_LIST configuration option configuration: AZURE_POLICY_IGNORE_LIST: [] Example: # YAML: Add a custom policy definition to ignore configuration: AZURE_POLICY_IGNORE_LIST: - '/providers/Microsoft.Authorization/policyDefinitions/1f314764-cb73-4fc9-b863-8eca98ac36e9' - '/providers/Microsoft.Authorization/policyDefinitions/b54ed75b-3e1a-44ac-a333-05ba39b99ff0' AZURE_POLICY_RULE_PREFIX This configuration option sets the prefix for names of exported rules. Configure this option to change the prefix, which defaults to `Azure`. This configuration option will be ignored when `-Prefix` is used with `Export-AzPolicyAssignmentRuleData`. Syntax: configuration: AZURE_POLICY_RULE_PREFIX: string Default: # YAML: The default AZURE_POLICY_RULE_PREFIX configuration option configuration: AZURE_POLICY_RULE_PREFIX: 'Azure' Example: # YAML: Override the prefix of exported policy rules AZURE_POLICY_RULE_PREFIX: 'AzureCustomPrefix' AZURE_APIM_MIN_API_VERSION This configuration option sets the minimum API version used for control plane API calls to API Management instances. Configure this option to change the minimum API version, which defaults to `'2021-08-01'`. Syntax: configuration: AZURE_APIM_MIN_API_VERSION: string Default: # YAML: The default AZURE_APIM_MIN_API_VERSION configuration option configuration: AZURE_APIM_MIN_API_VERSION: '2021-08-01' Example: # YAML: Set the AZURE_APIM_MIN_API_VERSION configuration option to '2021-12-01-preview' configuration: AZURE_APIM_MIN_API_VERSION: '2021-12-01-preview' AZURE_COSMOS_DEFENDER_PER_ACCOUNT This configuration option enables validation for that each Cosmos DB account is associated with a Microsoft Defender for Cosmos DB resource level plan. Configure this option to enable the per account validation, which defaults to `false`. Syntax: configuration: AZURE_COSMOS_DEFENDER_PER_ACCOUNT: boolean Default: # YAML: The default AZURE_COSMOS_DEFENDER_PER_ACCOUNT configuration option configuration: AZURE_COSMOS_DEFENDER_PER_ACCOUNT: false Example: # YAML: Set the AZURE_COSMOS_DEFENDER_PER_ACCOUNT configuration option to true configuration: AZURE_COSMOS_DEFENDER_PER_ACCOUNT: true AZURE_STORAGE_DEFENDER_PER_ACCOUNT This configuration option enables validation for that each storage account is associated with a Microsoft Defender for Storage resource level plan. Configure this option to enable the per account validation, which defaults to `false`. Syntax: configuration: AZURE_STORAGE_DEFENDER_PER_ACCOUNT: boolean Default: # YAML: The default AZURE_STORAGE_DEFENDER_PER_ACCOUNT configuration option configuration: AZURE_STORAGE_DEFENDER_PER_ACCOUNT: false Example: # YAML: Set the AZURE_STORAGE_DEFENDER_PER_ACCOUNT configuration option to true configuration: AZURE_STORAGE_DEFENDER_PER_ACCOUNT: true NOTE An online version of this document is available at <https://github.com/Azure/PSRule.Rules.Azure/blob/main/docs/concepts/about_PSRule_Azure_Configuration.md>. KEYWORDS - Configuration - Rule |