asc.xhack.students_redir role – This role deploys a redirector machine per student in the xHack infrastructure.

Note

This role is part of the asc.xhack collection (version 1.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/xhack $HOME/.ansible/collections/ansible_collections/asc/xhack.

To use it in a playbook, specify: asc.xhack.students_redir.

Entry point main – This role deploys a redirector machine per student in the xHack infrastructure.

New in asc.xhack 1.0.0

Synopsis

  • This role deploys a redirector machine per student in the xHack infrastructure.

  • The machine is used to redirect traffic from the student’s VMs to a C2 server. It is deployed in a dedicated subnet. No redirector software is installed, the students will have to deploy it themselves (e.g. nginx or HAProxy).

  • Operating System is Ubuntu 22.04 LTS.

Parameters

Parameter

Comments

students_redir

dictionary

Configuration options for the `students_redir` role.

enabled

boolean

Whether to enable the role

Choices:

  • false ← (default)

  • true

monitor

boolean

Whether to enable monitoring of the VM

Choices:

  • false ← (default)

  • true

vm_size

string

Size of the VM to deploy (Azure VM size)

Default: "Standard_B2ms"

vm_suffix

string

Suffix to append to the VM name

Default: "redir"

Authors

  • Lorenzo Bernardi