You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 18 Next »

There are two main ways to login to your workspaces.

Roughly said, to workspaces with a Web User Interface the preferred way of logging in is Time-Based One Time Password (TOTP), which also implicates two factor authentication.

On the other hand, Workspaces with a Command Line Interface can be accessed via SSH.

Prerequisites

When following along with one of these step-by-step guides, make sure that you have a running workspace (see Login to the SURF Research Cloud).

Workspace Access with TOTP

Preinstalled services like web access (e.g. R-studio) or other login services that require a username and password can be accessed by using a "time-based one time password" (TOTP).

On the "Profile" tab of the Research Cloud portal you can review your username:

If you have not yet registered for TOTP, you will see a notification like this on the same page:

Click on it, in order to register. You will be presented with a screen with further instructions and a QR-code:


Follow the instructions, there.


If you have more than one CO, make sure that you edit the name of the new entry in your app such that you can recognize which CO it is for.


Once you have registered, you can access your workspaces with TOTP.

Go to your workspaces overview on your Research Cloud Dashboard page and select a workspace with a web interface (like R-Studio, Jupyter Notebook etc.).

Extend the workspace-display by clicking on the downward arrow on the right.

Then, on the lower right, click on the "ACCESS" button.

In a new browser tab, you will be presented with a login dialog (example is for a R-Studio workspace):

The username is the username that is given on your "Profile" tab in the Research Cloud portal.

Have the password generated by your chosen two factor authentication app on your smartphone. In the app, use the entry that matches the CO of the workspace.

That way, you can access your workspace through your browser.


Access a workspace with SSH

SSH access is only needed if you'd like to connect to your server directly.  SSH access to a workspace is only possible by OpenSSH Key.

To access the workspace you need to follow the following 2 steps:

  1. Add the public key into SRAM. (You only have to do that once.)
    This will set your public key into your profile.
  2. Access the workspace with SSH.
    Use your favourite/available own SSH client to connect to your workspace.

Add public key into SRAM. (only has to be done once)

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.

  1. Open the SRAM page : https://sbs.sram.surf.nl/home
  2. In the top right click on the  button to login.
  3. Enter your mail address to be redirect to your SSO login page.
  4. Once you logged click on the 'Profile' button next to the Home.
  5. In the SSH public key enter you public key from you local public key file or browse to the file by clicking on the 'File import' button.
  6. Make sure you key is added into the line.
  7. Click  at the bottom of the page.
  8. The update of the public key can take up to 15 min to replicate.

Access the workspace with your SSH-client

There are several ssh clients to access your workspace and you can use the one you like as long as it supports public keys.

When you are working from a Linux machine, the SSH commands are already installed and ready to be used from a terminal.

On a Mac the SSH command is also available by default.

When you are working from a Windows machine, we recommend GitHub Desktop or MobaXterm.

Separate pages describe how to set up these tools for the Research Cloud:

  • No labels