riuga/dtcc-onboarding
1
1
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Update readme

Browse Source
This commit is contained in:
Riuga 2026-04-01 10:27:18 -05:00
parent b5cf3140f8
commit d3127d4004
1 changed files with 3 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

11
README.md
View File

@ -2,21 +2,16 @@
DTCC onboarding process requires you to access a remote Windows desktop via Citrix Workspace. 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 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). 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 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
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.
--- ---
Usage: Usage:
```bash ```bash
# Prompt for ICA file selection and launch the VM. # Prompt for ICA file selection (can leave blank) and launch the VM.
nix run nix run
``` ```