SSH Authentication using X.509 Certificates

See more SSH Examples

Demonstrates authenticating with an SSH/SFTP server using the private key of an X.509 certificate. The certificate and key are loaded from a .pfx, the private key is exported as PEM, and that key is used for public-key authentication. See X.509v3 Certificates for SSH Authentication for more information.

Note: The file paths are relative to the application's current working directory. Supply the paths to your own files.

Background: This is not X.509 certificate authentication in the SSH-protocol sense — the server still performs ordinary public-key authentication. The certificate is simply a convenient container for a key pair your organization already manages through its PKI, so the same credential issued for other purposes can be reused for SSH. What the server needs installed is the corresponding public key, exactly as with any other key. Chilkat can also load such certificates from smart cards and USB tokens rather than a file.

Chilkat C# Downloads

Download Chilkat for C#

bool success = false;

//  This example requires the Chilkat API to have been previously unlocked.
//  See Global Unlock Sample for sample code.

//  Demonstrates authenticating with an SSH/SFTP server using the private key of an X.509
//  certificate.

Chilkat.Ssh ssh = new Chilkat.Ssh();

string hostname = "ssh.example.com";
int port = 22;
success = ssh.Connect(hostname,port);
if (success == false) {
    Debug.WriteLine(ssh.LastErrorText);
    return;
}

//  Load the certificate and its private key from a .pfx file.  The PFX password should come
//  from a secure source rather than being hard-coded.
//  Note: Chilkat can load certificates and private keys from many sources, including smart
//  cards and USB tokens (HSMs).
string pfxPassword = "myPfxPassword";
Chilkat.Cert cert = new Chilkat.Cert();
success = cert.LoadPfxFile("qa_data/pfx/example.pfx",pfxPassword);
if (success == false) {
    Debug.WriteLine(cert.LastErrorText);
    return;
}

//  Get the certificate's private key as PEM, to be used for SSH authentication.  The
//  corresponding public key is installed on the server.
string privKeyPem = cert.GetPrivateKeyPem();
if (cert.LastMethodSuccess == false) {
    Debug.WriteLine(cert.LastErrorText);
    return;
}

Chilkat.SshKey key = new Chilkat.SshKey();
success = key.FromOpenSshPrivateKey(privKeyPem);
if (success == false) {
    Debug.WriteLine(key.LastErrorText);
    return;
}

success = ssh.AuthenticatePk("mySshLogin",key);
if (success == false) {
    Debug.WriteLine(ssh.LastErrorText);
    return;
}

Debug.WriteLine("Public-key authentication successful.");

ssh.Disconnect();