Table of Contents |
---|
There are two main ways to login to your workspaces.
...
On the other hand, Workspaces with a Command Line Interface can be accessed via SSH.
Table of Contents | ||
---|---|---|
|
Prerequisites
When following along with one of these step-by-step guides, make sure that you have a running workspace (see How to get on board).
Workspace Access to Jupyter Notebooks through SRAM
To log in to a Jupyter Notebook workspace you can just use the same credentials as you use for the Research Cloud portal.
Most probably these are your institute's credentials - or EduID.
Workspace Access with TOTP
Preinstalled services like web access (e.g. R-studio, Jupyter Notebook) or other login services (Windows, Ubuntu Desktop) that require a username and password can be accessed by using a "time-based one time password" (TOTP).
...
For standard catalog items base the basic access doesn't give administrator rights, please . Please add users who need administrator right rights to the "src_co_admin" group of the Collaborative Organisation group in SURF Research Access Management as described here: Workspace roles: Appoint Flag a CO-member a as SRC administrator.
For more explanation about these steps please watch this video that demos the login procedure to a Windows workspace: Windows login [4:14]
...
Authentication from a local Windows computer
Some users with local Windows computers use the Authy desktop application to log in with TOTP.
With Authy, you probably don't see the code that has to be filled in for authentication.
In this case consider to use the open source WinAuth application where right-clicking the displayed QR code suffices:
To couple the Authy Desktop app, paste the image link into the form there and click "verify authenticator":
Info | ||
---|---|---|
| ||
Windows-, and some Linux-workspaces are configured such that only members of the src_co_admin group can get administrator or sudo access. When you are prompted for your password to use your administrator/sudo rights, you fill in the TOTP password that is generated by your authenticator app. |
Workspace access with SSH
SSH access is needed if your workspace has no desktop or web-interface. Or if you want to use the scp command to upload and download data to and from your workspace.
You will need a private/public key-pair to use ssh.
...
Info | ||
---|---|---|
| ||
We advise you to use a key-pair of the RSA format. If you have a key of a different format, you can create another one that is based on RSA. Most key generators use RSA as the default format. When the text of your public key starts with "ssh-rsa" your key-pair is in the RSA format. |
2. Add public key
...
in SRAM. (only has to be done once for a key)
To SSH login to your workspace you have to add your public SSH key into you account. It needs to be added to the SRAM authentication website.
...
There are several ssh clients to access your workspace and you can use the one you like as long as it supports public keys.
Info |
---|
As soon as you generate a new key-pair on your local computer using the same name, the public key that you have submitted here and your local key will not match, anymore. Make sure that you update the public key when the key on your local computer has changed. |
3. Log in with ssh
In your terminal application (or Powershell window) type:
...
Info | ||
---|---|---|
| ||
If you want to read more on ssh on Windows you can check here: https://docs.microsoft.com/en-us/windows-server/administration/openssh/openssh_install_firstuse https://docs.microsoft.com/en-us/windows-server/administration/openssh/openssh_keymanagement You only have to install and configure the SSH client. (In the case of Research Cloud, the "server" is the workspace you will log in to and SSH is already installed, there.) |
Older Windows versions
If you are running older versions of Windows, we recommend GitHub Desktop or MobaXterm.
These separate pages describe how to set up these tools:
Workspace access with SRAM
SURF Research Access Management (SRAM) is a service to manage access to research resources, intended for Dutch led research collaborations.
Jupyter Notebook workspaces that are created after 18st of January 2024 can be accessed using SRAM.
To access a workspace based on SRAM authentication select your institute (or EduID) and follow the instructions on the screen.
Older Jupyter Notebook workspaces or earlier derivates of the Jupyter Notebook catalog item still require TOTP. (See above for TOTP)
You can add SRAM authentication to your own custom-made catalog item. For that, see the page Catalog item with SRAM login.
...