Account Management
Notice
Deucalion is only available to valid user accounts! If you don't have an account yet, please check Gaining access.
Register Account
To register your account in our system, access our user portal and fill out the registration form.
- Choose an available username and provide your institutional email address.
- Provide your personal information, such as first and last name, country of residence, gender, and year of birth. The highlighted greeting field is optional.
- Please indicate the institution to which you are affiliated and its type, along with it's research fields.
- If you have a research grant, you must specify the grant number and the funding agency. Otherwise, you must provide a justification for your request.
- You must accept the terms of service and privacy policy, subscribing to the newsletter is optional but recommended.
- Once you get an invitation by email, you must follow the provided link to verify your email address.
- After verifying the email, the following message should appear.
- After our team validates your account, you will receive an email with instructions to complete your account setup. The link expires in 14 days.
- Set your user password. It must contain numbers, lowercase and uppercase letters, special characters, and a minimum length of 8 characters.
- User information page after the account basic setup is complete.
Register Two-Factor Authentication (2FA) App
To access Deucalion through interactive web portals, it is mandatory to set up two-factor authentication.
- Go to the security section on the user account.
- Register a new Two-Factor Authentication App
- Add a label to identify the new App
- With an authenticator app (e.g. Google Authenticator), scan the QR code and finish the registration by providing the 6-digit code displayed in the App.
With this the 2FA configuration is complete.
Setting up SSH key pair
To access Deucalion through SSH console, it is mandatory to register a public SSH key.
Only 256-bit elliptic curve (ed25519) or 4096-bit RSA keys are allowed.
Generate your SSH keys
If you already have an appropriate SSH key pair that you want to use, you may skip to registering your public key. If not, start by generating an SSH key pair as detailed below.
An SSH key pair can be generated using a Linux, macOS, Windows PowerShell terminal. For example, you can use the following command to generate an ed25519 key:
ssh-keygen -t ed25519
You will be prompted for a file name and location where to save the
key. Accept the defaults by pressing ++enter++. Alternatively, you can
choose a custom name and location and add it interactively or as a
command line argument with for example -f /home/username/.ssh/id_ed25519.
Next, you will be asked for a passphrase. Please choose a secure passphrase. It should be at least 8 (preferably 12) characters long and should contain numbers, letters and special characters. Do not leave the passphrase empty.
After that an SSH key pair is created, i.e. a pair of files containing
the public and private keys, e.g. files named id_ed25519
(the private key) and id_ed25519.pub (the public key) in your
/home/username/.ssh/ directory.
If you're using PowerShell, please note that running the shell as a regular user can generate irregular keys. If that's the case please try to run PowerShell as an administrator.
An SSH key pair can be generated with the PuTTygen tool or with MobaXterm (Tools :octicons-arrow-right-16: MobaKeyGen). Both tools are identical.
In order to generate your key pairs, choose the option RSA and set the number of bits to 4096. The, press the Generate button.
You will be requested to move the mouse in the Key area to generate some entropy; do so until the green bar is completely filled.
After that, enter a comment in the Key comment field and a strong passphrase. Please choose a secure passphrase. It should be at least 8 (preferably 12) characters long and should contain numbers, letters and special characters. Do not leave the passphrase empty.
The next step is to save your public and private key. Click on the Save
public key button and save it to the desired location (for example, with
id_ed25519.pub as a name). Do the same with your private key by clicking
on the Save private key button and save it to the desired location (for
example, with id_rsa_macc as a name).
Warning
The private key should never be shared with anyone, not even with CNCA staff. It should also be stored only on your local computer (public key can be safely stored in cloud services). Protect it with a good password! Otherwise, anyone with access to the file system can steal your SSH key.
Register your public key
Now that you have generated your key pair, you need to register your public key in your Deucalion User Portal settings.
To register your key, click on the Settings item of the menu on the right, and then on the Security tab as shown in the figure below.
Then copy and paste the content of your public key file to the text area, and click the Save button.
Please note that there might be up to a 30 minute delay between adding your key and being able to access Deucalion via ssh.
Adding new users to projects (only for PI and CO-PI)
As a project PI or CO-PI, it is your responsibility to add (or deactivate) users to your project. There are two ways to invite users:
-
By email, inviting one user at a time;
-
By uploading a file, inviting multiple users simultaneously.
Inviting by email
In the project edit menu, go to the "Project Members" tab, and click the following button:
Then, insert the user email address you want to invite in the following box:
Finally, click the Add user button. If the email is already registered in the portal, the user is immediately added to the project. Otherwise, the user receives an email invitation to create an account, after which he or she must fill out a form to be added.
Inviting by uploading file
First, download the template to add members with this button, in the project members tab:
For the uploaded file, both CSV and Excel formats are supported. Care should be taken to insert the correct information for each user. Then, upload the file using the following buttons:
If a user with the selected username is already registered in the portal, the submission returns an error and displays the line of the user that must be replaced. If the email is already registered, the associated information is ignored, and the user is automatically added.
The users invited through file upload will receive an email similar to this:
The link forwards the invited user to this page:
While the user don't register himself, his invitation will be shown like this:
Once the user completes registration, they will be automatically added to the project.