Setup Guides
Windows 10/11
This guide only applies to Windows 11 and newer versions of Windows 10 (build 1809+). For older versions of Windows, please follow the instructions under "Using PuTTY" or check Microsoft's website on how to enable OpenSSHClient for Windows.
Steps
- Open the Command Prompt app
- At the command line prompt, type
ssh-keygen -t rsa
- You will then be asked to choose a save location for the keys. You can choose the default by pressing
enter
. Then hitenter
two more times to skip creating a passcode. - Still in the terminal paste the following command:
type %UserProfile%\.ssh\id_rsa.pub | ssh [email protected] "cat >> .ssh/authorized_keys
. This will publish your public keytothe engineering servers. If you saved the key to a location other than the default, replace%UserProfile%\.ssh\id_rsa.pub
with this location, such asC:\Users\your_username\.ssh\my_key.pub
. - Enter your password. You will be presented with a Duo two-factor prompt. Enter
1
and press enter. This will send a request to your Duo Mobile app which you will need to accept
- Test your SSH Keys bytyping
ssh [email protected] -i%UserProfile%\.ssh\id_rsa
at the terminal command line prompt. If you saved the key to a location other than the default, replace%UserProfile%\.ssh\id_rsa
with this location, such asC:\Users\your_username\.ssh\my_key
. If successful,you will connect without having to enter a password or do two-factor authentication!
Using your SSH Keys with FileZilla
First, downloadFileZilla (available here)
Open FileZilla and go to File->Site Manager
- Create a New Site and name it "access"
- To the right in the General Tab, Select
SFTP
for the Protocol and enter the Host asaccess.engr.oregonstate.edu.
- For Logon Type select
Key file
, enter your username for User, and then browse to the location of your `id_rsa' file. You may have to change the dropdown to "All files (*.*)" in the File Explorer window to show your "id_rsa" file.
- Click Connect at the bottom and you should now be connected to Flip without the need of two-factor authentication!
macOS
Generating your SSH Key
- Launchthe mac terminal.app (
/Applications/Utilities/Terminal.app
)
- At the command line prompt, type
ssh-keygen -t rsa
- You will then be asked to choose a save location for the keys. You can choose the default by pressing
enter
. Then hitenter
two more times to skip creating a passcode - Still in the terminal, type
ssh-copy-id -i ~/.ssh/id_rsa.pub
[email protected]
. This will publish your public key to the engineering servers. - When prompted enter your password
- You should now see the two-factor Duo authentication. Enter
1
to send a push to your Mobile Duo app - Test your SSH Keys bytyping
ssh access.engr.oregonstate.edu
at the terminal command line prompt. If successful,you will connect without having to enter a password or do two-factor authentication!
Using your SSH Keys with Cyberduck(https://cyberduck.io/)
- LaunchCyberduck and click the Open Connection button
- Set connection type to `SFTP` in the dropdown menu
- Set the server to "access.engr.oregonstate.edu"
- Enter your ONID username
- Do not enter a password and change SSH Private Key from `none` to the location of your `id_rsa` file. If you followed the default settings it should already be listed without needing to browse
- Finally click the Connect button and you will be logged in without the need for a password or 2-factor authentication
Using your SSH Keys with Adobe Dreamweaver
Dreamweaver does not like the the SSH Key format generated by the latest version of OpenSSH and the ssh-keygen untility. If you are running a recent version of macOS, including Mojave. You will need to "downgrade" your id_rsa
file using the folloing command in the Terminal app:
ssh-keygen -p -m PEM -f ~/.ssh/id_rsa
Now continue to set up Dreamweaver:
- From the Dreamweaver site menu, select "Manage Sites":
- Select the remote site connection you want to use SSH Keys with andthen click the pencil icon underneath:
- Next select "Servers" in left hand pane, and the existing server configuration to the right:
Configure as seen below, navigating to the ssh key file at
/Users/[yourUserName]/.ssh/id_rsa
([yourUserName]
is YOUR mac login name)
Given the large amounts of different Linux distributions there is no one guide that will work for all. You can use Steps 1-10 of themacOS Guideto generate your keys and publish them to Flip. From that point on you will need to use your FTP client of your choice.
Using PuTTY
For this you will need:
Steps
- Open up PuTTYGen, click "Generate," and follow the on-screen instructions
- Once the key is generated, you will need to save the public key
Save it to a location you will be able to easily find it and name itid_rsa.pub
- Now you need to save the private key
Ignore the warning about the passcode. Save it to the same location as before and name itid_rsa.ppk
- Using PuTTY, log onto
access.engr.oregonstate.edu
and enter your password when prompted - You will be presented with a Duo two-factor prompt. Enter
1
and press enter. This will send a request to your Duo Mobile app which you will need to accept.
- You are now logged onto
access.engr.oregonstate.edu
- If the directory
.ssh
does not exist, execute the commandmkdir .ssh
followed bychmod 700 .ssh
- Use your favorite command text editor (mine is emacs) to open up
~/.ssh/authorized_keys
which should be an empty file. If it does not exist, create it - From the PuTTY Key Generator windowcopy the key as shown in the image below. Make sure you copy the entire string.
- Back in the editor on
access.engr.oregonstate.edu
paste the copied public key and save the changes
- You now need to set permissions on the file. In the putty window, type
chmod 600 ~/.ssh/authorized_keys
- Back in PuTTY, you want to create a Saved Session you have not done so already
- In Host Name enter
[email protected]
- Below in the Saved Sessions field enter
flip
and click Save
- Click Connect->SSH->Auth->Credentials on the sidebar
- On this screen, Browse to the location of your private key file: id_rsa.ppk. Now click the Open Button at the bottom
- You should now be logged onto Flip without needing to provide a password OR two-factor authorization
- Now we need to set up FileZilla
- Open FileZilla and go to File->Site Manager
- Create a New Site and name it "access"
- To the right in the General Tab, Select
SFTP
for the Protocol and enter the Host asaccess.engr.oregonstate.edu
- For Logon Type select
Key file
, enter your username for User, and then browse to the location of your `id_rsa.ppk' file.
- Click Connect at the bottom and you should now be connected to Flip without the need of two-factor authentication!
Troubleshooting Guide
- Make sure you have enabled your Engineering account.
If you have not, please do so here:http://teach.engr.oregonstate.edu - Make sure you have signed up for DUO.
If not, please do so athttps://duo.oregonstate.edu - Make sure Putty is configured correctly (If Using Putty)
Load your private key (not public key) as per step 14& 16in the Windows 10 guide - Use your ONID username without @oregonstate.edu at the "
login as:
" prompt.
Make sure that in your network home directory, your .ssh directory permission is set to700
(drwx------
) and the .ssh/authorized_keys file permission is600 (-rw-------
)