asc.dfir.core_dfir role – Deploy the DFIR environment’s core infrastructure

Note

This role is part of the asc.dfir collection (version 2.0.0).

It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.

To install it use: git clone git@ssh.dev.azure.com:v3/cloudasc/iac-ansible-collections/dfir $HOME/.ansible/collections/ansible_collections/asc/dfir.

To use it in a playbook, specify: asc.dfir.core_dfir.

Entry point main – Deploy the DFIR environment’s core infrastructure

Synopsis

  • Deploys the DFIR environment’s own networking - virtual networks, the storage/processing subnets and the peerings back to the core services network - on top of asc.core.

  • The other dfir_* roles depend on this role being enabled first.

Parameters

Parameter

Comments

core_dfir_config

dictionary

‘core_dfir’ role configuration

enabled

boolean

Whether to enable the core DFIR infrastructure

Choices:

  • false ← (default)

  • true

core_dfir_vnets_config

dictionary

added in asc.dfir 2.0.0

Virtual networks for the DFIR environment, keyed by vnet name.

Each vnet takes address_space (a CIDR) and subnets, a dict of subnet name to its address_space; a subnet may set allow_all: true to add an allow-all inbound NSG rule.

Merged with the other modules’ vnets into common_vnets_config. See the role defaults for the default layout.

core_dfir_vnets_peering

list / elements=dictionary

added in asc.dfir 2.0.0

Virtual network peerings for the DFIR environment, each a primary/secondary pair of vnet names.

Merged with the other modules’ peerings into common_vnets_peering; each peering is created in both directions.

Default: [{"primary": "services", "secondary": "dfir"}, {"primary": "services", "secondary": "dfirservices"}, {"primary": "dfir", "secondary": "dfirservices"}]

primary

string / required

Name of the first vnet.

secondary

string / required

Name of the second vnet.

Authors

  • Ignace De Cock