Package paramiko :: Class Agent
[show private | hide private]
[frames | no frames]

Class Agent


Client interface for using private keys from an SSH agent running on the local machine. If an SSH agent is running, this class can be used to connect to it and retreive PKey objects which can be used when attempting to authenticate to remote SSH servers.

Because the SSH agent protocol uses environment variables and unix-domain sockets, this probably doesn't work on Windows. It does work on most posix platforms though (Linux and MacOS X, for example).
Method Summary
  __init__(self)
Open a session with the local machine's SSH agent, if one is running.
  close(self)
Close the SSH agent connection.
tuple of AgentKey get_keys(self)
Return the list of keys available through the SSH agent, if any.

Method Details

__init__(self)
(Constructor)

Open a session with the local machine's SSH agent, if one is running. If no agent is running, initialization will succeed, but get_keys will return an empty tuple.
Raises:
SSHException - if an SSH agent is found, but speaks an incompatible protocol

close(self)

Close the SSH agent connection.

get_keys(self)

Return the list of keys available through the SSH agent, if any. If no SSH agent was running (or it couldn't be contacted), an empty list will be returned.
Returns:
a list of keys available on the SSH agent
           (type=tuple of AgentKey)

Generated by Epydoc 2.1 on Sun Dec 4 11:16:48 2005 http://epydoc.sf.net