The SSH connector is used by the Password Manager Sync Server to reset password on a remote system using the SSH protocol. The connector is installed along with the Password Manager installation.
The SSH connector empowers customers to build their own integrations into MyPass. MyPass lets you specify a hostname, port number, and a remote executable along with the definition of the command line to be called. MyPass will then establish the SSH tunnel to the remote system and call the specified executable with parameters specified by the setup. To transfer the data to the specified program MyPass will either encode Base64 or use custom encryption (To see how to build a custom encryption DLL for MyPass please take a look at the API Integration and implementation guide). From that point it is up to the called executable to set the password on the target system by use of the executable. After being completed, MyPass will automatically mark the transaction to retry and disconnect the SSH tunnel. (waiting time and the number of retries can be set in MyPass). The result passed back to MyPass consists of a return code and a text. There’s 3 possible codes:
- Success (Password has been reset)
- Failure (eg. Network trouble, the remote system is down etc.)
- User not present
If the connection to the SSH tunnel cannot be established or in the event that the SSH tunnel breaks while in operation a failure will be logged by the connector itself. In the event of a success code the transaction will be set accordingly. In the event of a failure code, the automatic retry feature will go into action. Finally a user not present will result in the transaction being aborted, as this indicates that the user ID in question has no account on the target system. The text will along with the code be saved in the MyPass log for the connector (Gateway-SSHconnector.log).