Unicode C
Unicode C
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 Unicode C Downloads
#include <C_CkSshTunnelW.h>
#include <C_CkSshKeyW.h>
#include <C_CkSecureStringW.h>
void ChilkatSample(void)
{
BOOL success;
HCkSshTunnelW tunnel;
int sshPort;
const wchar_t *password;
HCkSshKeyW privKey;
const wchar_t *keyText;
HCkSecureStringW secureLogin;
HCkSecureStringW securePassword;
BOOL waitForThreadExit;
success = FALSE;
// 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.
tunnel = CkSshTunnelW_Create();
// The tunnel forwards accepted local connections to this destination through the SSH server.
CkSshTunnelW_putDestHostname(tunnel,L"db.internal.example.com");
CkSshTunnelW_putDestPort(tunnel,5432);
// Connect to the SSH server. This performs the TCP/proxy connection and SSH handshake, but
// does not authenticate yet.
sshPort = 22;
success = CkSshTunnelW_Connect(tunnel,L"ssh.example.com",sshPort);
if (success == FALSE) {
wprintf(L"%s\n",CkSshTunnelW_lastErrorText(tunnel));
CkSshTunnelW_Dispose(tunnel);
return;
}
// 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.
password = L"mySshPassword";
// Load the SSH private key. LoadText reads the file's text, which is then imported.
privKey = CkSshKeyW_Create();
keyText = CkSshKeyW_loadText(privKey,L"qa_data/id_rsa");
if (CkSshKeyW_getLastMethodSuccess(privKey) == FALSE) {
wprintf(L"%s\n",CkSshKeyW_lastErrorText(privKey));
CkSshTunnelW_Dispose(tunnel);
CkSshKeyW_Dispose(privKey);
return;
}
success = CkSshKeyW_FromOpenSshPrivateKey(privKey,keyText);
if (success == FALSE) {
wprintf(L"%s\n",CkSshKeyW_lastErrorText(privKey));
CkSshTunnelW_Dispose(tunnel);
CkSshKeyW_Dispose(privKey);
return;
}
// Place the login and password into SecureString objects.
secureLogin = CkSecureStringW_Create();
CkSecureStringW_Append(secureLogin,L"mySshLogin");
securePassword = CkSecureStringW_Create();
CkSecureStringW_Append(securePassword,password);
success = CkSshTunnelW_AuthenticateSecPwPk(tunnel,secureLogin,securePassword,privKey);
if (success == FALSE) {
wprintf(L"%s\n",CkSshTunnelW_lastErrorText(tunnel));
CkSshTunnelW_Dispose(tunnel);
CkSshKeyW_Dispose(privKey);
CkSecureStringW_Dispose(secureLogin);
CkSecureStringW_Dispose(securePassword);
return;
}
wprintf(L"Authenticated.\n");
// After authenticating, call BeginAccepting to start listening for local connections to forward.
waitForThreadExit = TRUE;
success = CkSshTunnelW_CloseTunnel(tunnel,waitForThreadExit);
if (success == FALSE) {
wprintf(L"%s\n",CkSshTunnelW_lastErrorText(tunnel));
CkSshTunnelW_Dispose(tunnel);
CkSshKeyW_Dispose(privKey);
CkSecureStringW_Dispose(secureLogin);
CkSecureStringW_Dispose(securePassword);
return;
}
CkSshTunnelW_Dispose(tunnel);
CkSshKeyW_Dispose(privKey);
CkSecureStringW_Dispose(secureLogin);
CkSecureStringW_Dispose(securePassword);
}