asc.dfir.dfir_storage role – Deploy the DFIR evidence storage accounts and sync triggers

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.dfir_storage.

Entry point main – Deploy the DFIR evidence storage accounts and sync triggers

Synopsis

  • Deploys the three storage accounts the DFIR workflow is built on: the client SFTP upload account for incoming evidence, the write-once chain-of-custody copy that preserves the original, and the analyst working-copy Azure fileshare mounted on the workstations.

  • It also wires up the file-triggered sync between them so uploads are copied to the immutable original and into the working share automatically.

  • Defender for Storage is set per account from the subscription’s plan. On a classic per-transaction subscription the working copy moves to the per-account plan, because analyst and processing traffic on the share would otherwise be billed per transaction. On the new plan all three accounts override on-upload malware scanning and sensitive data discovery to off, since evidence is expected to contain malware and client data.

Parameters

Parameter

Comments

dfir_storage_config

dictionary

‘dfir_storage’ role configuration

enabled

boolean

Whether to enable the ‘dfir_storage’ role

Choices:

  • false ← (default)

  • true

external_blob_name

string

Blob container name for client-uploaded evidence

Default: "casecontainer"

external_storageaccount_name

string

Name of the client-facing SFTP upload storage account (max 20 chars)

Default: "externalstorage"

internal_blob_name

string

Blob container name for the original-copy storage account

Default: "casecontainer"

internal_storageaccount_name

string

Name of the chain-of-custody original-copy storage account (max 20 chars)

Default: "internalstorage"

networkshare_name

string

Fileshare name mounted on analyst devices for the working copy

Default: "caseshare"

networkshare_quota_gb

integer

Quota of the working-copy fileshare in GiB.

Pay-as-you-go shares bill only the capacity actually used, so the default is the 100 TiB maximum and acts purely as a growth cap.

Default: 102400

sftp_user

string

Local SFTP username for the external upload storage account

Default: "testuser"

workingcopy_storageaccount_name

string

Name of the working-copy storage account, mounted to analyst devices (max 20 chars)

Default: "workingcopy"

Authors

  • Ignace De Cock