dtcc-onboarding/README.md

23 lines
1.4 KiB
Markdown
Raw Normal View History

2026-03-31 16:06:05 -05:00
## Citrix-in-a-VM for DTCC onboarding
2026-03-31 16:13:15 -05:00
DTCC onboarding process requires you to access a remote Windows desktop via Citrix Workspace.
The Citrix package is a bit finnicky to install and is closed-source and considered insecure for our requirements here at Obsidian. This flake 1) wraps the `citrix_workspace` package with a scraper that automatically downloads the tarball for you, and 2) provides Citrix-in-a-NixOS-Qemu-VM with a convenient init script that copies in your preferred .ica file to launch it with.
The init script looks for ICA files in your XDG download dir (`~/Downloads`) and current working dir (i.e. the repo root).
2026-03-31 16:06:05 -05:00
**Usage of this repository implies you have read and accepted the Citrix EULA found here**: https://www.cloud.com/content/dam/cloud/documents/legal/end-user-agreement.pdf
2026-03-31 16:09:25 -05:00
Notes/future improvements:
- There is still the manual step of logging into myvdi.dtcc.com to download a fresh ICA file each connection attempt. We could look into automating this in the future; it's a bit more involved though.
- We should provide a containerized flake output as well. I don't see why this wouldn't work as a container; the VM feels a bit like bringing a tank to a knife fight. I just needed to get a simple
working demo out before the next wave of onboarding begins and this had the best shot at providing the most stable user experience.
---
2026-03-31 16:06:05 -05:00
Usage:
```bash
# Prompt for ICA file selection and launch the VM.
nix run
```