unused_vngs

Azure Unused Virtual Network Gateways

What It Does

This policy template reports any Azure Virtual Network Gateways that either failed to provision correctly or have no connections configured. Optionally, this report can be emailed and the offending Virtual Network Gateways can be deleted.

How It Works

• The Microsoft.Network/virtualNetworkGateways API endpoint is used to gather a list of all Azure Virtual Network Gateways.
• The Microsoft.Network/virtualNetworkGateways/{id}/connections API endpoint is used to get a list of connections for each Virtual Network Gateway.
• The Azure Virtual Network Gateways list is filtered to just those gateways that were not provisioned successfully or have no connections configured.

Input Parameters

• Email Addresses - A list of email addresses to notify
• Azure Endpoint - Azure Endpoint to access resources
• Allow/Deny Subscriptions - Allow or Deny entered Subscriptions to filter results.
• Allow/Deny Subscriptions List - A list of allowed or denied Subscription IDs/names. Leave blank to check all Subscriptions.
• Allow/Deny Regions - Allow or Deny entered regions to filter results.
• Allow/Deny Regions List - A list of allowed or denied regions. Leave blank to check all Subscriptions.
• Exclusion Tags - The policy will filter resources containing the specified tags from the results. The following formats are supported:
  • Key - Filter all resources with the specified tag key.
  • Key==Value - Filter all resources with the specified tag key:value pair.
  • Key!=Value - Filter all resources missing the specified tag key:value pair. This will also filter all resources missing the specified tag key.
  • Key=~/Regex/ - Filter all resources where the value for the specified key matches the specified regex string.
  • Key!~/Regex/ - Filter all resources where the value for the specified key does not match the specified regex string. This will also filter all resources missing the specified tag key.
• Exclusion Tags: Any / All - Whether to filter instances containing any of the specified tags or only those that contain all of them. Only applicable if more than one value is entered in the Exclusion Tags field.
• Automatic Actions - When this value is set, this policy will automatically take the selected action(s).

Please note that the "Automatic Actions" parameter contains a list of action(s) that can be performed on the resources. When it is selected, the policy will automatically execute the corresponding action on the data that failed the checks, post incident generation. Please leave it blank for manual action. For example if a user selects the "Delete Unused Virtual Network Gateways" action while applying the policy, all the Azure Virtual Network Gateways that didn't satisfy the policy condition will be deleted.

Policy Actions

The following policy actions are taken on any resources found to be out of compliance.

• Send an email report
• Delete unused Azure Virtual Network Gateways after an approval

Prerequisites

This Policy Template uses Credentials for authenticating to datasources -- in order to apply this policy you must have a Credential registered in the system that is compatible with this policy. If there are no Credentials listed when you apply the policy, please contact your Flexera Org Admin and ask them to register a Credential that is compatible with this policy. The information below should be consulted when creating the credential(s).

• Azure Resource Manager Credential (provider=azure_rm) which has the following permissions:

  • Microsoft.Network/connections/read
  • Microsoft.Network/virtualNetworkGateways/read
  • Microsoft.Network/virtualNetworkGateways/delete*

  * Only required for taking action; the policy will still function in a read-only capacity without these permissions.

• Flexera Credential (provider=flexera) which has the following roles:

  • billing_center_viewer

The Provider-Specific Credentials page in the docs has detailed instructions for setting up Credentials for the most common providers.

Supported Clouds

• Azure

Cost

This policy template does not incur any cloud costs.