Story #3193


[Workbench] Regular user should view VMs and repositories, and manage tokens and SSH keys, on an approachable "access" page instead of relying on the generic "view/edit items" pages.

Added by Tom Clegg over 8 years ago. Updated over 8 years ago.

Assigned To:
Radhika Chippada
Target version:
Start date:
Due date:
% Done:


Estimated time:
(Total: 8.00 h)
Story points:


One page, four content areas (3 small "view only" plus one that lets you add/remove SSH keys)

  • VMs I can log in to: show hostname, login name, last login (if available)
    • Note about "See "setting up SSH access" first"?
  • Repositories I can access: name, is_writable, fetch or push-url (depending on whether it is writable)
    • Note about "See "setting up SSH access" first"?
  • Current API token
    • Show the copy-and-paste section (currently shown on the Help tab of the "manage API tokens" page)
Manage SSH keys:
  • Show my existing SSH keys (filter by key_type=="SSH")
  • Delete existing SSH key (confirm with javascript)
  • If no existing SSH keys, explain why you should add one (in order to access shell VM and repository)
  • "Add SSH key" button
    • modal with form, like "setup user"
    • always set key_type to SSH
    • error handling is important (many people will provide bogus keys!) -- e.g., show error message in modal footer
    • Link to "learn more" (opens in a new tab) inside the modal as well
  • "Setting up SSH access" section with the information that currently appears at virtual_machines#index
  • "Edit SSH key" is sort of nice, but not a big priority: it's not much more convenient than deleting an existing key and adding a new one.

In each section, a "Learn more" link opens a new tab with the appropriate page of

Update nav links:
  • Add "Account settings" item, in the email address dropdown, linking to this new page
  • Make generic "show VMs, authorized_keys, API tokens" links show up only for admins, in the gear menu (like the Users item is now)
  • If this means the gear menu is now empty for non-admins, then don't even show the gear menu for non-admin users!
Other notes:
  • Filter ssh keys and api tokens by owner_uuid == current_user.uuid so this page works nicely for admins too.
  • Repo usage is based on permissions, so admins will have push (write) access to all of them.
  • For VMs, only show access based on can_login links with a username. This means admins will only see the VMs on which they have explicitly been given user accounts.
API tokens SSH keys
Virtual machines

Subtasks 3 (0 open3 closed)

Task #3215: Arvados does not tell you your SSH login nameResolvedWard Vandewege07/25/2014

Task #3357: Review 3193-manage-accountResolvedPeter Amstutz07/25/2014

Task #3194: [Blocker] Clarify requirements/implementationResolvedTom Clegg07/04/2014


Related issues

Related to Arvados - Bug #1672: workbench repositories page usabilityRejected12/04/2013

Related to Arvados - Feature #3129: [Workbench] Show API token copy-and-paste block in a pop-up accessible from every pageResolved


Also available in: Atom PDF