dtcc-onboarding/README.md

18 lines
1.3 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.
2026-04-01 10:27:18 -05:00
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 optionally copies in your preferred .ica file to launch it with. If you choose not to select a .ica file, it will just start an `ungoogled-chromium` browser session pointed at `https://myvdi.dtcc.com` where you can log in, download the .ica manually and chromium will be configured to automatically launch it with Citrix `wfica` on download completion.
2026-03-31 16:13:15 -05:00
2026-04-01 10:27:18 -05:00
The init script looks for ICA files in your XDG download dir (`~/Downloads`) and current working dir (i.e. the repo root). Again, this is not required if you just want a browser-based session within the VM instead.
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
---
2026-03-31 16:06:05 -05:00
Usage:
```bash
2026-04-01 10:27:18 -05:00
# Prompt for ICA file selection (can leave blank) and launch the VM.
2026-03-31 16:06:05 -05:00
nix run
```