Inputs & Outputs

ADGroup

  • Contains information about an Azure AD Group

AD Group Keys

name: Group name

object_id: Group ID

ADUser

  • Contains information about an Azure AD User

AD User Keys

name: User display name

principal_name: User principal name

object_id: User ID

AzureClient

  • Contains Azure authentication details using a service principal

  • It is used as an input to many of the actions in this plugin

Generating API Access Keys

See this Azure article for information about creating a service principal.

Supplying Credentials

You should always use a PPA Vault integration to provide credentials to a plugin action.

Required Keys

tenant_id: Azure Tenant ID

client_id: Azure Client ID

client_secret: Azure Client Secret

Example

1
2
3
4
azure_client:
  tenant_id: your_tenant_id
  client_id: your_client_id
  client_secret: your_client_secret

ResourceGroup

  • Contains information about an Azure Resource Group

ResourceGroup Keys

name: Resource name

location: Resource location

tags: Dictionary of tags

SecurityGroup

  • Contains information about an Azure Network Security Group

SecurityGroup Keys

id: Resource ID (including Resource Group)

name: Resource name

location: Resource location

tags: Dictionary of tags

SecurityGroupRule

  • Contains information about an Azure Network Security Group rule

SecurityGroupRule Keys

Name: Rule name

description: Rule description

protocol: Protocol (tcp, udp, or * for any)

direction: Direction (inbound or outbound)

access: Access (allow or deny)

priority: Rules are processed in priority order; the lower the number, the higher the priority.

source_port_range: Source port range

source_address_prefix: Source address

source_address_prefixes: Source addresses (if multiple)

destination_port_range: Destination port range

destination_address_prefix: Destination address

destination_address_prefixes: Destination addresses (if multiple)

VirtualMachine

  • Contains information about an Azure Virtual Machine instance

VirtualMachine Keys

id: Resource ID (including Resource Group)

name: Resource name

type: Resource type

location: Resource location

tags: Dictionary of tags

vm_id: VM unique ID