View source for TracCloud: SSH Keys for SFTP Authentication

{{TracCloudGuideTabs}}
<div class="tcWidgetPage">
<div class="category">
{{TracCloudTechTOC}}
</div>
<big><b>Using SSH Keys for SFTP Authentication</b></big><br>

By default, Redrock will provide a single username and password to access your campus SFTP directory. If you would prefer to authenticate using SSH keys, we'll simply need a copy of your public SSH-RSA key to install on our end. We've included basic instructions below for creating a key pair with a simple CLI tool and logging into the SFTP site using WinSCP. This isn't the only method to accomplish this, there are multiple ways to generate SSH-RSA keys (using rsa-sha2-256 or rsa-sha2-512 algorithm) and many FTP clients available.

<div class="line"></div>

<big>Generating a key pair</big>

Using MacOS or Linux, run the '''ssh-keygen''' command in a terminal. Passphrase should be left blank. Both your private and public key can be found in ~/.ssh (by default). This will generate a 3072-bit pair. If you would prefer to generate a larger key, you can use the -b option. For example, '''ssh-keygen -b 4096'''. [https://www.ssh.com/academy/ssh/putty/windows/puttygen Click here to view instructions for Windows (ssh.com)]

[[File:2631262.png|600px]]<br><br>

'''id_rsa''' is your private key, which should not be shared.

'''id_rsa.pub''' is your public key, which should be provided to Redrock Software.
<hr>
<big>SFTP Clients</big>

After Redrock Software receives your public key(s), you can login using your preferred SFTP client. WinSCP is a common choice, which is shown as an example below.

Edit your site configuration.

[[File:6447724.png|400px]]

[[File:7754403.png|500px]]

Locate the SSH settings and select your private key.

[[File:5471934.png|500px]]

Some SFTP clients (such as WinSCP) may require that the private key be in a PuTTY format. For WinSCP, you can follow the on-screen instructions to convert the key and use the new .ppk file instead. This does not require changing your public key.

[[File:7664159.png|500px]]<br><br>

Save your site configuration settings and connect. If you have any trouble, reach out to Redrock Software at [mailto:helpdesk@go-redrock.com helpdesk@go-redrock.com].

[[Category:TracCloud]]
</div>