NOTE: This feature only works for runs executed on Scalr.io runners at this time.

SSH keys can be used as a way to authenticate to modules in a Git repository if the workspace cannot access the repository through the VCS provider configuration. SSH keys are created at the account scope and then added to workspaces in the workspace settings.

To create and manage an SSH key, users must have the following permissions at the account scope:

  • ssh-keys:read
  • ssh-keys:create
  • ssh-keys:update

To create a key, go to the account scope, security, and then SSH keys:

Any key created can be used by any workspaces in the account if the user updating the workspace has the ssh-keys:read and the workspaces:link-ssh-key permission assigned.

Keys can be assigned to a workspace in the workspace settings: