How to setup servers, group and SSH credentials

icon
Note. Enable the NOPASSWD sudo option for SSH users.
icon
Note. Do not use special characters in your password.
icon
Note. If you are using CentOS Stream 9, generate the ECDSA SSH key instead of RSA.

This article describes how to create a local user to log into Roxy-WI, a group for the user and the server, and how to add an SSH key to connect to a new server.

SSH key generation

First, create a local user on the server where you are installing the agent, and select the authentication method for the user. You can either generate an SSH key or set the password, but using the key is more secure. For an SSH key, upload its public part to the server with the command ssh-copy-id -i ~/.ssh/mykey user@host.

Group creation

Then, create a new group for your user and server. To do this, go to the Roxy-WI Admin area => Groups section and click Add. In the pop-up window, enter the group name and group description, if necessary, and click Add.

add_group

User creation

Next, create a new Roxy-WI user for your local user. Go to the Admin area => Users section and click Add. Fill in the following form:

add_user

SSH credentials creation

After that, create a remote user in Roxy-WI. Go to the Admin area => SSH credentials section and click Add. Fill in the form:

add_ssh_cred

If you selected SSH authentication in step 1, upload the private part of the key to Roxy-WI. In the Admin area => SSH credentials section, select the alias name from the previous step, enter the private key in the “Key” field, and click Upload. If your SSH key is protected with a passphrase, enter it in the SSH key passphrase field as well.

upload_ssh

Roxy-WI also encrypts both passwords and SSH passphrases. To ensure that no one but you can decrypt your passwords, generate your own salt.

icon
Note. Ubuntu 21.xx and Centos Stream 9 may have a problem with the RSA key. Therefore, generate an ECDSA key.

Adding a server

Finally, add a new server. Go to the Admin area => Servers section and click Add. Fill in the form:

add_server

Click Add and the server will be added to the Servers tab and to the group you’ve selected.

icon
Note. Make sure that your server group and your user group are the same. Otherwise, the server will only be available in the Servers section and not in any other sections.

To check if the connection with the new server has been successfully established, click Check. If everything is OK, Roxy-WI will display the "Connect accepted" message.