This document describes how to set up SSH Credentials in the Portal.
To connect to assets using SSH, SSH Credentials can be set up in the portal.
Adding SSH Credentials
Although username+password only configurations is allowed, a private SSH-key is STRONGLY recommended for this operation.
Check if SSH is installed.
Open a command terminal and run the
If SSH is installed it will display some help text.
Create the key by running the
To generate a SSH-key run the
- Log in to OUTSCAN.
- In the Portal, click the Account button in the upper right corner.
- Click the Credentials box.
- Click + Add credentials.
Setting up SSH Credentials
- In the drop-down menu select SSH.
- Enter a Role.
- Enter a Username.
Enter a Password.
The password field can be used by both or either the authentication step or the substitute user command. In practice neither Password or Private key will be required to do anything, however, there are no such requirement asserted by the UI or API today.
Select Substitute user command: sudo, doas, sesu, dzdo, pfexec from the drop down menu, or provide a custom command on the line beneath.
The use of the following commands is to execute commands with a different user/privilege escalation.
Command Description sudo This command is found in most of the Linux based systems (or can be installed). Used to execute commands as a different user (other than the one used to log in). From the tools perspective, it uses root account to perform the commands. doas It is an OpenBSD based command. 95% of its features are like sudo. https://man.openbsd.org/doas sesu It is an IBM implementation of su. dzdo Used in Linux/Unix (can be installed at will). An alternative to sudo. pfexec Mostly used in Solaris. custom It gives a flexibility to use a custom defined privilege escalation command. When this option is selected, a field labeled SSH custom user command is ungrayed for typing in the custom command.
- Click the blue Upload Private Key button.
- This opens a file upload window.
- Select a file. See Requirements section on how to create a private key in SSH.
- Click Open button lower right corner to upload.
Add the passphrase to the private key.
This is required if you have uploaded a private key and that private key is encrypted with a passphrase.
- Click blue Add button.
© 2024 Outpost24® All rights reserved. This document may only be redistributed unedited and unaltered. This document may be cited and referenced only if clearly crediting Outpost24® and this document as the source. Any other reproduction and redistribution in print or electronically is strictly prohibited without explicit permission.
Outpost24® and OUTSCAN™ are trademarks of Outpost24® and its affiliated companies. All other brand names, product names or trademarks belong to their respective owners.