dtcc-onboarding/README.md
2026-04-01 10:27:18 -05:00

18 lines
1.3 KiB
Markdown

## Citrix-in-a-VM for DTCC onboarding
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 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.
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.
**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
---
Usage:
```bash
# Prompt for ICA file selection (can leave blank) and launch the VM.
nix run
```