mirror of
git://anongit.mindrot.org/openssh.git
synced 2024-12-24 19:02:06 +00:00
caf6dd6d21
- deraadt@cvs.openbsd.org 2000/08/24 15:46:59 [scp.c] off_t in sink, to fix files > 2GB, i think, test is still running ;-) - deraadt@cvs.openbsd.org 2000/08/25 10:10:06 [session.c] Wall - markus@cvs.openbsd.org 2000/08/26 04:33:43 [compat.c] ssh.com-2.3.0 - markus@cvs.openbsd.org 2000/08/27 12:18:05 [compat.c] compatibility with future ssh.com versions - deraadt@cvs.openbsd.org 2000/08/27 21:50:55 [auth-krb4.c session.c ssh-add.c sshconnect.c uidswap.c] print uid/gid as unsigned - markus@cvs.openbsd.org 2000/08/28 13:51:00 [ssh.c] enable -n and -f for ssh2 - markus@cvs.openbsd.org 2000/08/28 14:19:53 [ssh.c] allow combination of -N and -f - markus@cvs.openbsd.org 2000/08/28 14:20:56 [util.c] util.c - markus@cvs.openbsd.org 2000/08/28 14:22:02 [util.c] undo - markus@cvs.openbsd.org 2000/08/28 14:23:38 [util.c] don't complain if setting NONBLOCK fails with ENODEV
171 lines
4.6 KiB
Groff
171 lines
4.6 KiB
Groff
.\" $OpenBSD: ssh-agent.1,v 1.15 2000/08/25 16:16:15 deraadt Exp $
|
|
.\"
|
|
.\" -*- nroff -*-
|
|
.\"
|
|
.\" ssh-agent.1
|
|
.\"
|
|
.\" Author: Tatu Ylonen <ylo@cs.hut.fi>
|
|
.\"
|
|
.\" Copyright (c) 1995 Tatu Ylonen <ylo@cs.hut.fi>, Espoo, Finland
|
|
.\" All rights reserved
|
|
.\"
|
|
.\" Created: Sat Apr 23 20:10:43 1995 ylo
|
|
.\"
|
|
.Dd September 25, 1999
|
|
.Dt SSH-AGENT 1
|
|
.Os
|
|
.Sh NAME
|
|
.Nm ssh-agent
|
|
.Nd authentication agent
|
|
.Sh SYNOPSIS
|
|
.Nm ssh-agent
|
|
.Op Fl c Li | Fl s
|
|
.Op Fl k
|
|
.Oo
|
|
.Ar command
|
|
.Op Ar args ...
|
|
.Oc
|
|
.Sh DESCRIPTION
|
|
.Nm
|
|
is a program to hold private keys used for public key authentication
|
|
(RSA, DSA).
|
|
The idea is that
|
|
.Nm
|
|
is started in the beginning of an X-session or a login session, and
|
|
all other windows or programs are started as clients to the ssh-agent
|
|
program.
|
|
Through use of environment variables the agent can be located
|
|
and automatically used for authentication when logging in to other
|
|
machines using
|
|
.Xr ssh 1 .
|
|
.Pp
|
|
The options are as follows:
|
|
.Bl -tag -width Ds
|
|
.It Fl c
|
|
Generate C-shell commands on
|
|
.Dv stdout .
|
|
This is the default if
|
|
.Ev SHELL
|
|
looks like it's a csh style of shell.
|
|
.It Fl s
|
|
Generate Bourne shell commands on
|
|
.Dv stdout .
|
|
This is the default if
|
|
.Ev SHELL
|
|
does not look like it's a csh style of shell.
|
|
.It Fl k
|
|
Kill the current agent (given by the
|
|
.Ev SSH_AGENT_PID
|
|
environment variable).
|
|
.El
|
|
.Pp
|
|
If a commandline is given, this is executed as a subprocess of the agent.
|
|
When the command dies, so does the agent.
|
|
.Pp
|
|
The agent initially does not have any private keys.
|
|
Keys are added using
|
|
.Xr ssh-add 1 .
|
|
When executed without arguments,
|
|
.Xr ssh-add 1
|
|
adds the
|
|
.Pa $HOME/.ssh/identity
|
|
file.
|
|
If the identity has a passphrase,
|
|
.Xr ssh-add 1
|
|
asks for the passphrase (using a small X11 application if running
|
|
under X11, or from the terminal if running without X).
|
|
It then sends the identity to the agent.
|
|
Several identities can be stored in the
|
|
agent; the agent can automatically use any of these identities.
|
|
.Ic ssh-add -l
|
|
displays the identities currently held by the agent.
|
|
.Pp
|
|
The idea is that the agent is run in the user's local PC, laptop, or
|
|
terminal.
|
|
Authentication data need not be stored on any other
|
|
machine, and authentication passphrases never go over the network.
|
|
However, the connection to the agent is forwarded over SSH
|
|
remote logins, and the user can thus use the privileges given by the
|
|
identities anywhere in the network in a secure way.
|
|
.Pp
|
|
There are two main ways to get an agent setup:
|
|
Either you let the agent
|
|
start a new subcommand into which some environment variables are exported, or
|
|
you let the agent print the needed shell commands (either
|
|
.Xr sh 1
|
|
or
|
|
.Xr csh 1
|
|
syntax can be generated) which can be evalled in the calling shell.
|
|
Later
|
|
.Xr ssh 1
|
|
look at these variables and use them to establish a connection to the agent.
|
|
.Pp
|
|
A unix-domain socket is created
|
|
.Pq Pa /tmp/ssh-XXXXXXXX/agent.<pid> ,
|
|
and the name of this socket is stored in the
|
|
.Ev SSH_AUTH_SOCK
|
|
environment
|
|
variable.
|
|
The socket is made accessible only to the current user.
|
|
This method is easily abused by root or another instance of the same
|
|
user.
|
|
.Pp
|
|
The
|
|
.Ev SSH_AGENT_PID
|
|
environment variable holds the agent's PID.
|
|
.Pp
|
|
The agent exits automatically when the command given on the command
|
|
line terminates.
|
|
.Sh FILES
|
|
.Bl -tag -width Ds
|
|
.It Pa $HOME/.ssh/identity
|
|
Contains the RSA authentication identity of the user.
|
|
This file should not be readable by anyone but the user.
|
|
It is possible to
|
|
specify a passphrase when generating the key; that passphrase will be
|
|
used to encrypt the private part of this file.
|
|
This file is not used by
|
|
.Nm
|
|
but is normally added to the agent using
|
|
.Xr ssh-add 1
|
|
at login time.
|
|
.It Pa $HOME/.ssh/id_dsa
|
|
Contains the DSA authentication identity of the user.
|
|
.Pq Pa /tmp/ssh-XXXXXXXX/agent.<pid> ,
|
|
Unix-domain sockets used to contain the connection to the
|
|
authentication agent.
|
|
These sockets should only be readable by the owner.
|
|
The sockets should get automatically removed when the agent exits.
|
|
.El
|
|
.Sh AUTHOR
|
|
Tatu Ylonen <ylo@cs.hut.fi>
|
|
.Pp
|
|
OpenSSH
|
|
is a derivative of the original (free) ssh 1.2.12 release, but with bugs
|
|
removed and newer features re-added.
|
|
Rapidly after the 1.2.12 release,
|
|
newer versions bore successively more restrictive licenses.
|
|
This version of OpenSSH
|
|
.Bl -bullet
|
|
.It
|
|
has all components of a restrictive nature (i.e., patents)
|
|
directly removed from the source code; any licensed or patented components
|
|
are chosen from
|
|
external libraries.
|
|
.It
|
|
has been updated to support ssh protocol 1.5.
|
|
.It
|
|
contains added support for
|
|
.Xr kerberos 8
|
|
authentication and ticket passing.
|
|
.It
|
|
supports one-time password authentication with
|
|
.Xr skey 1 .
|
|
.El
|
|
.Pp
|
|
.Sh SEE ALSO
|
|
.Xr ssh 1 ,
|
|
.Xr ssh-add 1 ,
|
|
.Xr ssh-keygen 1 ,
|
|
.Xr sshd 8 ,
|