Users and access (files/users.csv)

users.csv is the single source of truth for people and their access. Each row is a user, and that user’s tags decide what they can reach and which per-user resources are built for them. Access is delivered centrally through Guacamole, so there are no separate VM accounts to hand out or revoke — you change the CSV and redeploy.

File format

A semicolon-separated file with a header row:

firstname;lastname;email;keyboard_layout;tags
Ada;Lovelace;ada.lovelace@example.com;be;guac_admin|sift
Grace;Hopper;grace.hopper@example.com;us;student

Column

Meaning

firstname / lastname

The user’s name; used for display and for generated account names.

email

Identity for single sign-on (Guacamole, OpenVPN) and for any mailbox created for them.

keyboard_layout

Two-letter layout for the user’s remote sessions (for example be, us).

tags

Pipe-separated (|) list of tags. Tags are what grant access and drive per-user behaviour.

How tags work

A tag does one of two things:

  • Grants access to a host. A tag that matches the name of a deployed host gives that user a Guacamole connection to it. This is how access is scoped per person — entirely from this file, without touching any module configuration.

  • Opts the user into a module’s behaviour. Some modules read specific tags to decide what to build for a user: a dedicated analyst VM, a mailbox, a student environment, or an alert subscription.

Because access follows the tags, adding or removing a person’s access is a one-line change here followed by a redeploy; nothing else needs editing.

Common tags

In addition to the tags below, each module documents the tags it reads on its role page — the role pages under the Collections index are the complete, authoritative list.

Tag

Effect

guac_admin

Grants the Guacamole administrator role (full access to every connection).

student

Marks the user as an eXtreme Hacking student (per-student VMs and access).

sift

Deploys a SIFT analyst VM for the user (DFIR) and grants access to it.

win

Grants access to the Windows analyst workstation(s) (DFIR).

mail

Creates a mailbox for the user on the mail server.

ai_alert

Subscribes the user to the Azure AI Foundry configuration-change and cost alerts.

Worked examples

  • Ada;Lovelace;ada.lovelace@example.com;be;guac_admin|sift — Ada is a Guacamole administrator (sees every connection) and gets her own SIFT analyst VM with a connection to it, keyed to a Belgian keyboard layout.

  • Grace;Hopper;grace.hopper@example.com;us;student — Grace is enrolled as an eXtreme Hacking student, so her student VMs are built and she is given access to them, with a US layout.

  • A user with no tags has an identity but no access or resources until a tag is added.