Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update ssh and vdi instructions with updated password guidance. #156

Merged
merged 1 commit into from
Jun 26, 2024
+6 −9
Merged

Update ssh and vdi instructions with updated password guidance. #156

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 3 additions & 9 deletions docs/access/ssh.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -98,9 +98,6 @@ To enable this for your EIDF account:

## Accessing From MacOS/Linux

!!! warning
If this is your first time connecting to EIDF using a new account, you have to set a password as described in [Set or change the password for a user account](../services/virtualmachines/quickstart.md#set-or-change-the-password-for-a-user-account).

OpenSSH is installed on Linux and MacOS usually by default, so you can access the gateway natively from the terminal.

Ensure you have created and added an ssh key as specified in the 'Generating and Adding an SSH Key' section above, then run the commands below:
Expand Down Expand Up @@ -144,9 +141,6 @@ Windows will require the installation of OpenSSH-Server to use SSH. Putty or Mob

### Accessing EIDF via a Terminal

!!! warning
If this is your first time connecting to EIDF using a new account, you have to set a password as described in [Set or change the password for a user account](../services/virtualmachines/quickstart.md#set-or-change-the-password-for-a-user-account).

1. Open either Powershell or the Windows Terminal
1. Import the SSH Key you generated above:

Expand Down Expand Up @@ -184,7 +178,7 @@ You will be prompted for a 'TOTP' code upon successful public key authentication

## SSH Aliases

You can use SSH Aliases to access your VMs with a single word.
You can use SSH Aliases to access your VMs with a single command.

1. Create a new entry for the EIDF-Gateway in your ~/.ssh/config file. Using the text editor of your choice (vi used as an example), edit the .ssh/config file:

Expand Down Expand Up @@ -268,6 +262,6 @@ You can use SSH Aliases to access your VMs with a single word.
You can replace the alias name with whatever you like, just change the 'Host' line from saying 'eidf-gateway' to the alias you would like. <br>
The `-J` flag is use to specify that we will access the second specified host by jumping through the first specified host.

## First Password Setting and Password Resets
## sudo, Password Setting and Password Resets

Before logging in for the first time you have to reset the password using the web form in the EIDF Portal following the instructions in [Set or change the password for a user account](../services/virtualmachines/quickstart.md#set-or-change-the-password-for-a-user-account).
You do not have to set a password to log into virtual machines. However, if you have been given sudo permission, you will need to set a password to be able to make use of sudo. You can set (or reset) a password using the web form in the EIDF Portal following the instructions in [Set or change the password for a user account](../services/virtualmachines/quickstart.md#set-or-change-the-password-for-a-user-account).
3 changes: 3 additions & 0 deletions docs/access/virtualmachines-vdi.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -34,6 +34,9 @@ If you have only one connection associated with your VDI user account (typically
automatically connected to the target VM's virtual desktop. Once you are connected to the VM, you will be asked for your
username and password as shown below (if you are participating in a workshop, then you may not be asked for credentials)

!!! warning
If this is your first time connecting to EIDF using a new account, you have to set a password as described in [Set or change the password for a user account](../services/virtualmachines/quickstart.md#set-or-change-the-password-for-a-user-account).

![VM-VDI-connection-login](../images/access/vm-vdi-connection-login.png){: class="border-img"}
*VM virtual desktop connection user account login screen*

Expand Down