Difference between revisions of "Using ssh"

From UW-Math Wiki
Jump to navigation Jump to search
(updated to relfect our current systems and methods)
Line 1: Line 1:
 
= Using ssh to Access Math Department Resources=
 
= Using ssh to Access Math Department Resources=
  
The University of Wisconsin-Madison Department of Mathematics maintains two login servers for ssh connections from outside the department.
 
  
# login0.math.wisc.edu: To connect to this server, you must have an IP address that corresponds to a wisc.edu host address. You can use the campus wireless[https://it.wisc.edu/services/wireless-uwnet/ | UWNet], [https://it.wisc.edu/services/wireless-eduroam/ | Eduroam], or [https://it.wisc.edu/services/wiscvpn/ | WiscVPN]. Other names for this server are bing.math.wisc.edu and login.math.wisc.edu.
+
The University of Wisconsin-Madison Department of Mathematics maintains a login server for SSH connections from outside the department. It is named '''login.math.wisc.edu'''.
# login1.math.wisc.edu. To connect to this server, you must use an ssh key. For instructions on using an ssh key, see below. Another name for this server is abel.math.wisc.edu.
 
  
To access Math Department resources via ssh, you must first use an ssh client to connect to either login0 or login1. You can then ssh to the system of your choice within the department.
+
== Connecting ==
 +
To connect from a university network or from outside the university with a VPN:
 +
* Server name: login.math.wisc.edu
 +
* Port: 22
 +
* Authentication method: '''password''' or '''SSH key'''
 +
* To connect this way, you must have an IP address that corresponds to a wisc.edu host address. You can use the campus wireless[https://it.wisc.edu/services/wireless-uwnet/ | UWNet], [https://it.wisc.edu/services/wireless-eduroam/ | Eduroam], or [https://it.wisc.edu/services/wiscvpn/ | WiscVPN].
 +
* Example SSH command to connect: <pre>ssh login.math.wisc.edu</pre>
 +
 
 +
To connect from '''outside''' the university:
 +
* Server name: login.math.wisc.edu
 +
* Port: 8022
 +
* Authentication method: '''SSH key only'''
 +
* Example SSH command to connect: <pre>ssh -p 8022 login.math.wisc.edu</pre>
 +
 
 +
== Connecting to other servers ==
 +
 
 +
To access Math Department resources via SSH, you must first use an SSH client to connect to login.math.wisc.edu. You can then SSH to the system of your choice within the department.
  
 
For example, suppose you wished to run a sage program on one of the research servers. For simplicity sake, the research servers have aliases (nicknames) magma0, magma1, ..., magma19, with the more powerful machines having the lowest numbers.
 
For example, suppose you wished to run a sage program on one of the research servers. For simplicity sake, the research servers have aliases (nicknames) magma0, magma1, ..., magma19, with the more powerful machines having the lowest numbers.
  
To start your sage program, you might use an ssh client on your laptop to connect to login0.math.wisc.edu then run ssh again on login0 to connect to magma0. Please do not run research programs on login0 or login1. While these machines may have all the tools necessary to test programs, they are not powerful enough to handle more than the most trivial of tasks. If you run a program that uses a lot of resources on login0 or login1, you may prevent users (including yourself) from accessing these machines.
+
To start your sage program, you might use an SSH client on your laptop to connect to login.math then run SSH again on login.math to connect to magma0. Please do not run research programs on login.math! While this machine may have all the tools necessary to test programs, it is  not powerful enough to handle more than the most trivial of tasks. If you run a program that uses a lot of resources on login.math, you may prevent users (including yourself) from accessing these machines or significantly reduce it's responsiveness.
 +
 
 
===Generating an ssh Key===
 
===Generating an ssh Key===
  
The IT staff recommends that you generate an ssh key to  use when moving from one machine to another within the department network. Using an ssh key is both easier and more secure than retyping your password when you are moving from one Math Department machine to another. To use an ssh key, do the following.
+
The IT staff recommends that you generate an SSH key to  use when moving from one machine to another within the department network. Using an SSH key is both easier and more secure than retyping your password when you are moving from one Math Department machine to another. To use an SSH key, do the following.
  
# Log onto any Linux workstation or research server in the department. You can use ssh as explained above to connect to login0 or login1 for this purpose.
+
# Log onto any Linux workstation or research server in the department. You can use SSH as explained above to connect to login.math  for this purpose.
# At the prompt, type "ssh-keygen". Accept the default values. You need not enter a passphrase, so just press enter.
+
# If you are logged in to a desktop GUI, open a terminal window.
 +
# At the prompt, type "ssh-keygen". Accept the default values. You need not enter a passphrase, but it is more secure if you do. You can just press enter at the prompt to not use a passphrase.
 
# Add the key you just generated to your authorized_keys file. Type, "cat ~/.ssh/id_rsa.pub  >> ~/.ssh/authorized_keys"
 
# Add the key you just generated to your authorized_keys file. Type, "cat ~/.ssh/id_rsa.pub  >> ~/.ssh/authorized_keys"
# To test, type, "ssh magma0". You should be connected to magma0 without having to retype your password.
+
# To test, type, "ssh magma0". You should be connected to magma0 without having to retype your password unless you chose to use a passphrase. Then you would be prompted for that password instead of your user account password.
  
Note: The login server login1.math.wisc.edu requires the use of ssh keys to connect. You can use this same ssh key for that purpose. Instructions for doing so are different for each ssh client and are therefore beyond the scope of this document. Consult your client's documentation (or google) or ask a member of the IT staff for assistance.
+
Note: The login server login.math requires the use of SSH keys to connect from outside university networks. You can use this same SSH key for that purpose. Instructions for doing so are different for each ssh client and are therefore beyond the scope of this document. Consult your client's documentation (or do an internet search) or ask a member of the IT staff for assistance.

Revision as of 09:17, 10 May 2022

Using ssh to Access Math Department Resources

The University of Wisconsin-Madison Department of Mathematics maintains a login server for SSH connections from outside the department. It is named login.math.wisc.edu.

Connecting

To connect from a university network or from outside the university with a VPN:

  • Server name: login.math.wisc.edu
  • Port: 22
  • Authentication method: password or SSH key
  • To connect this way, you must have an IP address that corresponds to a wisc.edu host address. You can use the campus wireless| UWNet, | Eduroam, or | WiscVPN.
  • Example SSH command to connect:
    ssh login.math.wisc.edu

To connect from outside the university:

  • Server name: login.math.wisc.edu
  • Port: 8022
  • Authentication method: SSH key only
  • Example SSH command to connect:
    ssh -p 8022 login.math.wisc.edu

Connecting to other servers

To access Math Department resources via SSH, you must first use an SSH client to connect to login.math.wisc.edu. You can then SSH to the system of your choice within the department.

For example, suppose you wished to run a sage program on one of the research servers. For simplicity sake, the research servers have aliases (nicknames) magma0, magma1, ..., magma19, with the more powerful machines having the lowest numbers.

To start your sage program, you might use an SSH client on your laptop to connect to login.math then run SSH again on login.math to connect to magma0. Please do not run research programs on login.math! While this machine may have all the tools necessary to test programs, it is not powerful enough to handle more than the most trivial of tasks. If you run a program that uses a lot of resources on login.math, you may prevent users (including yourself) from accessing these machines or significantly reduce it's responsiveness.

Generating an ssh Key

The IT staff recommends that you generate an SSH key to use when moving from one machine to another within the department network. Using an SSH key is both easier and more secure than retyping your password when you are moving from one Math Department machine to another. To use an SSH key, do the following.

  1. Log onto any Linux workstation or research server in the department. You can use SSH as explained above to connect to login.math for this purpose.
  2. If you are logged in to a desktop GUI, open a terminal window.
  3. At the prompt, type "ssh-keygen". Accept the default values. You need not enter a passphrase, but it is more secure if you do. You can just press enter at the prompt to not use a passphrase.
  4. Add the key you just generated to your authorized_keys file. Type, "cat ~/.ssh/id_rsa.pub >> ~/.ssh/authorized_keys"
  5. To test, type, "ssh magma0". You should be connected to magma0 without having to retype your password unless you chose to use a passphrase. Then you would be prompted for that password instead of your user account password.

Note: The login server login.math requires the use of SSH keys to connect from outside university networks. You can use this same SSH key for that purpose. Instructions for doing so are different for each ssh client and are therefore beyond the scope of this document. Consult your client's documentation (or do an internet search) or ask a member of the IT staff for assistance.