README
¶
chrome-ssh-agent
This is a bare-bones SSH agent extension for Google Chrome. It provides an SSH agent implementation that can be used with the Secure Shell Chrome extension.
Getting Started
Installation from Chrome Web Store
Visit the extension in the Chrome Web Store and install it.
Managing Keys in the SSH Agent
The extension allows you to configure keys which are then stored in Chrome and synced across your devices.
Once configured, key can be loaded into the SSH agent by providing the key's passphrase. Loaded keys are available for use by the Secure Shell extension.
Using Keys in the Secure Shell Extension
The Secure Shell extension must be instructed to use the SSH Agent. This is
done by adding --ssh-agent=eechpbnaifiimgajnomdipfaamobdfha to the
"SSH Relay Server Options" in the properties for a SSH connection.
Current Limitations
Unencrypted Keys Are Not Supported
The extension currently only supports encrypted private keys.
Credits
Portions of the code and approach are heavily based on the MacGyver Chrome extension. In particular, the following:
- Usage of GopherJS, which makes it easy to use Go's existing SSH Agent implementation.
- Code translating between the Chrome SSH Agent protocol and the actual SSH agent protocol (details).
Disclaimer
This is not an officially supported Google product.
Directories
¶
| Path | Synopsis |
|---|---|
|
go
|
|
|
agentport
Package agentport supports serving the SSH Agent protocol to Chrome's Secure Shell Extension.
|
Package agentport supports serving the SSH Agent protocol to Chrome's Secure Shell Extension. |
|
background
command
|
|
|
chrome
Package chrome exposes Go versions of Chrome's extension APIs.
|
Package chrome exposes Go versions of Chrome's extension APIs. |
|
chrome/fakes
Package fakes implements fake implementations of Chrome's extension APIs to ease unit testing.
|
Package fakes implements fake implementations of Chrome's extension APIs to ease unit testing. |
|
dom
Package dom provides APIs for interacting with the DOM.
|
Package dom provides APIs for interacting with the DOM. |
|
dom/testing
Package testing provides utilities for using the DOM in unit tests.
|
Package testing provides utilities for using the DOM in unit tests. |
|
keys
Package keys provides APIs to manage configured keys and load them into an SSH agent.
|
Package keys provides APIs to manage configured keys and load them into an SSH agent. |
|
options
command
|
|
|
optionsui
Package optionsui defines the behavior underlying the user interface for the extension's options.
|
Package optionsui defines the behavior underlying the user interface for the extension's options. |