Set Up Your Access to the VitalSource SFTP
The Opt Out Action Reports will be delivered to a publisher-specific SFTP folder on VitalSource’s SFTP. In order to retrieve these files, you will need to set up an SSH Key in order to access our SFTP, regardless of whether you plan to set up automated retrieval processes with your IT Departments, or plan to access the SFTP manually via an SFTP client.
Create an SSH Key
- Open up the “Terminal” Application, which can be found under
- Mac: Finder > Applications > Utilities > Terminal
- PC: Search > Windows Terminal
-
In the terminal window, paste: ssh-keygen -t ed25519
📝If the user is unable to generate an Ed25519 key, paste ssh-keygen -t rsa -b 4096 -C "your_email@example.com" instead. - Press “Enter”
- You will be prompted to enter the file location where you want to save the key. Do not input anything and press “Enter” again.
- You will be promoted to enter a passphrase. Do not input anything and press “Enter” again.
- You will be promoted to enter the passphrase again. Do not input anything and press “Enter” again.
- You should see data stating your key fingerprint is ___ and your key randomart image is ___ followed by the command line.
-
Open the id_ed25519.pub file (right click → Open With → Notepad)
📝If an rsa key was generated instead, open the id_rsa.pub file (right click → Open With → Notepad) - Your SSH key is now in your clipboard.
- Open any text application, ex. Textedit or Word and paste. Your SSH public key will be now be listed. It should begin with ssh-rsa
Once you have set up your SHH Key, you’ll need to provide it to VitalSource in order to for us to set up the authentication that will grant you access to our SFTP.
- Email your integrations contact, provide your Public SSH Key, and ask for the SSH Key to be applied to authenticate access to the VitalSource SFTP folder.
VitalSource will apply the SSH Key and respond back with a confirmation and connection information.
Connecting to the SFTP Server via SFTP Client
The following are instructions to access your Opt Out Action Reports files via an SFTP client (Cyberduck, in this case).
- Create an SSH Key (see above for instructions)
- Download and Install Cyberduck.
-
Open a new Connection: Open Cyberduck and create a new connection by clicking Open Connection button located at the top left of the application.
-
Add Connection Details: From the Open Connection dialogue, click on the dropdown at the top and Select SFTP (SSH Secure File transfer Protocol).
-
Next, look for the dropdown near the bottom that says SSH Private Key. Click the dropdown and select ~/.ssh/id_rsa. (This is where the SSH Key Generation application puts your private key.)
-
Finally, Input the server as sftp.verbasoftware.com and keep the port at 22. Enter your username that integrations contact provided. No password is needed because we are authenticating with SSH Keys so leave that field blank.
-
A successful connection will automatically place you in your user directory.