DataFlex
DataFlex
SSH Tunnel Authenticate with a SecureString Password and Private Key
See more SSH Tunnel Examples
Demonstrates the Chilkat SshTunnel.AuthenticateSecPwPk method, which authenticates using SecureString login and password objects together with a private key. The third argument is the SshKey private key.
Note: The private-key path is relative to the application's current working directory. Absolute paths may also be used. Supply the path to your own key file.
Background: This is the
SecureString form of two-factor tunnel authentication: the password is held encrypted in memory and combined with a private key for servers that require both. It is the most protective option when a deployment mandates two-factor SSH and you also want to minimize plaintext credential exposure in a long-running process.Chilkat DataFlex Downloads
Use ChilkatAx-win32.pkg
Procedure Test
Boolean iSuccess
Handle hoTunnel
Integer iSshPort
String sPassword
Variant vPrivKey
Handle hoPrivKey
String sKeyText
Variant vSecureLogin
Handle hoSecureLogin
Variant vSecurePassword
Handle hoSecurePassword
Boolean iWaitForThreadExit
String sTemp1
Boolean bTemp1
Move False To iSuccess
// Demonstrates the SshTunnel.AuthenticateSecPwPk method, which authenticates using SecureString
// login and password objects together with a private key. The 1st argument is the username, the
// 2nd is the password, and the 3rd is an SshKey private key.
Get Create (RefClass(cComChilkatSshTunnel)) To hoTunnel
If (Not(IsComObjectCreated(hoTunnel))) Begin
Send CreateComObject of hoTunnel
End
// The tunnel forwards accepted local connections to this destination through the SSH server.
Set ComDestHostname Of hoTunnel To "db.internal.example.com"
Set ComDestPort Of hoTunnel To 5432
// Connect to the SSH server. This performs the TCP/proxy connection and SSH handshake, but
// does not authenticate yet.
Move 22 To iSshPort
Get ComConnect Of hoTunnel "ssh.example.com" iSshPort To iSuccess
If (iSuccess = False) Begin
Get ComLastErrorText Of hoTunnel To sTemp1
Showln sTemp1
Procedure_Return
End
// Normally you would not hard-code the password in source. You should instead obtain it
// from an interactive prompt, environment variable, or a secrets vault.
Move "mySshPassword" To sPassword
// Load the SSH private key. LoadText reads the file's text, which is then imported.
Get Create (RefClass(cComChilkatSshKey)) To hoPrivKey
If (Not(IsComObjectCreated(hoPrivKey))) Begin
Send CreateComObject of hoPrivKey
End
Get ComLoadText Of hoPrivKey "qa_data/id_rsa" To sKeyText
Get ComLastMethodSuccess Of hoPrivKey To bTemp1
If (bTemp1 = False) Begin
Get ComLastErrorText Of hoPrivKey To sTemp1
Showln sTemp1
Procedure_Return
End
Get ComFromOpenSshPrivateKey Of hoPrivKey sKeyText To iSuccess
If (iSuccess = False) Begin
Get ComLastErrorText Of hoPrivKey To sTemp1
Showln sTemp1
Procedure_Return
End
// Place the login and password into SecureString objects.
Get Create (RefClass(cComChilkatSecureString)) To hoSecureLogin
If (Not(IsComObjectCreated(hoSecureLogin))) Begin
Send CreateComObject of hoSecureLogin
End
Get ComAppend Of hoSecureLogin "mySshLogin" To iSuccess
Get Create (RefClass(cComChilkatSecureString)) To hoSecurePassword
If (Not(IsComObjectCreated(hoSecurePassword))) Begin
Send CreateComObject of hoSecurePassword
End
Get ComAppend Of hoSecurePassword sPassword To iSuccess
Get pvComObject of hoSecureLogin to vSecureLogin
Get pvComObject of hoSecurePassword to vSecurePassword
Get pvComObject of hoPrivKey to vPrivKey
Get ComAuthenticateSecPwPk Of hoTunnel vSecureLogin vSecurePassword vPrivKey To iSuccess
If (iSuccess = False) Begin
Get ComLastErrorText Of hoTunnel To sTemp1
Showln sTemp1
Procedure_Return
End
Showln "Authenticated."
// After authenticating, call BeginAccepting to start listening for local connections to forward.
Move True To iWaitForThreadExit
Get ComCloseTunnel Of hoTunnel iWaitForThreadExit To iSuccess
If (iSuccess = False) Begin
Get ComLastErrorText Of hoTunnel To sTemp1
Showln sTemp1
Procedure_Return
End
End_Procedure