Skip to content

Latest commit

 

History

History
88 lines (69 loc) · 2.79 KB

README.md

File metadata and controls

88 lines (69 loc) · 2.79 KB

Credits:

Go Pageant client

This repository contains a library for Go that provides a native PuTTY Pageant SSH agent implementation compatible with the golang.org/x/crypto/ssh/agent package.

This package, works with Windows and Unix/Linux platforms. See below for alternatives on Unix/Linux platforms.

Usage

import (
	"golang.org/x/crypto/ssh"
	"golang.org/x/crypto/ssh/agent"
	"github.com/kbolino/pageant"
)

func main() {
	agentConn, err := pageant.NewConn()
	if err != nil {
		// failed to connect to Pageant
	}
	defer agentConn.Close()
	sshAgent := agent.NewClient(agentConn)

	config := ssh.ClientConfig{
		Auth:            []ssh.AuthMethod{ssh.PublicKeysCallback(sshAgent.Signers)},
		HostKeyCallback: ssh.InsecureIgnoreHostKey(),
		User:            "somebody",
	}
	sshConn, err := ssh.Dial("tcp", "someserver:22", &config)
	if err != nil {
		// failed to connect to SSH
	}
	defer sshConn.Close()
	// now connected to SSH with public key auth from Pageant
	// ...
}

Unix/Linux Alternatives

The ssh-agent command implements the same SSH agent protocol as Pageant, but over a Unix domain socket instead of shared memory. The path to this socket is exposed through the environment variable SSH_AUTH_SOCK.

	agentConn, err := pageant.NewConn()
	// works like
	agentConn, err := net.Dial("unix", os.Getenv("SSH_AUTH_SOCK"))

OpenSSH for Windows Alternatives

The ssh-add, ssh commands of OpenSSH for Windows implements the same SSH agent protocol as Unix/Linux, but over a Named Pipe instead of Unix domain socket. The ssh-agent daemon of OpenSSH for Windows used Named Pipe \\.\pipe\openssh-ssh-agent
The sshd daemon of OpenSSH for Windows used Unix domain socket like /tmp/somepath
for some versions of Windows it works: look sc query afunix.

	agentConn, err := pageant.NewConn()
	// works like
	agentConn, err := winio.DialPipe(`\\.\pipe\openssh-ssh-agent`, nil)

Testing

The standard tests require Pageant to be running and to have at least 1 key loaded. To test connecting to an SSH server, set the sshtest build flag and see the comments in pageant_ssh_test.go for how to set up the test.