asc.ap.ap_win10 role – Deploy the A&P Windows 10 VM(s)

Note

This role is part of the asc.ap 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/ap $HOME/.ansible/collections/ansible_collections/asc/ap.

To use it in a playbook, specify: asc.ap.ap_win10.

Entry point main – Deploy the A&P Windows 10 VM(s)

New in asc.ap 1.0.0

Synopsis

  • Deploys the Windows 10 client VM(s) for the Attack & Penetration environment - a Windows target/workstation alongside the Kali attack hosts - and publishes access through Guacamole.

Parameters

Parameter

Comments

ap_win10_config

dictionary

Configuration options for the `ap_win10` role.

enabled

boolean

Whether to enable the role

Choices:

  • false ← (default)

  • true

vms

list / elements=dictionary

Virtual Machines to deploy (see example file for details)

enable_disk_encryption

boolean

Whether to enable disk encryption

Choices:

  • false

  • true ← (default)

extra_tags

dictionary

Extra tags to add to the VM Example: `{‘engagement_code’: ‘I-12345678’, ‘project’: ‘myproject’}`

Default: {}

guac_title

string

The title to use for the Guacamole connection

Default: "A&P Win10 - <vm_name>"

public_ip

boolean

Whether to assign a public IP to the VM

Choices:

  • false ← (default)

  • true

vm_name

string

The name of the VM

vm_size

string

The size of the VM

Default: "Standard_B2ms"

Authors

  • Ignace De Cock