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 |
|---|---|
|
The user’s name; used for display and for generated account names. |
|
Identity for single sign-on (Guacamole, OpenVPN) and for any mailbox created for them. |
|
Two-letter layout for the user’s remote sessions (for example |
|
Pipe-separated ( |
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.