Missing files during OpenSSH import.
[dragonfly.git] / crypto / openssh-3.8.1p1 / README.smartcard
blobfdf83ecab4c044918bcce6c7a155af5bfec7f660
1 How to use smartcards with OpenSSH?
3 OpenSSH contains experimental support for authentication using
4 Cyberflex smartcards and TODOS card readers, in addition to the cards
5 with PKCS#15 structure supported by OpenSC. To enable this you
6 need to:
8 Using libsectok:
10 (1) enable sectok support in OpenSSH:
12         $ ./configure --with-sectok
14 (2) If you have used a previous version of ssh with your card, you
15     must remove the old applet and keys.
17         $ sectok
18         sectok> login -d
19         sectok> junload Ssh.bin
20         sectok> delete 0012
21         sectok> delete sh
22         sectok> quit
24 (3) load the Java Cardlet to the Cyberflex card and set card passphrase:
26         $ sectok
27         sectok> login -d
28         sectok> jload /usr/libdata/ssh/Ssh.bin
29         sectok> setpass
30         Enter new AUT0 passphrase:
31         Re-enter passphrase:
32         sectok> quit
34         Do not forget the passphrase.  There is no way to
35         recover if you do.
37         IMPORTANT WARNING: If you attempt to login with the
38         wrong passphrase three times in a row, you will
39         destroy your card.
41 (4) load a RSA key to the card:
43         $ ssh-keygen -f /path/to/rsakey -U 1
44         (where 1 is the reader number, you can also try 0)
46         In spite of the name, this does not generate a key.
47         It just loads an already existing key on to the card.
49 (5) Optional: If you don't want to use a card passphrase, change the
50     acl on the private key file:
52         $ sectok
53         sectok> login -d
54         sectok> acl 0012 world: w
55          world: w
56          AUT0: w inval
57         sectok> quit
59         If you do this, anyone who has access to your card
60         can assume your identity.  This is not recommended.
63 Using OpenSC:
65 (1) install OpenSC:
67         Sources and instructions are available from
68         http://www.opensc.org/
70 (2) enable OpenSC support in OpenSSH:
72         $ ./configure --with-opensc[=/path/to/opensc] [options]
74 (3) load a RSA key to the card:
76         Not supported yet.
79 Common operations:
81 (1) tell the ssh client to use the card reader:
83         $ ssh -I 1 otherhost
85 (2) or tell the agent (don't forget to restart) to use the smartcard:
87         $ ssh-add -s 1
90 -markus,
91 Tue Jul 17 23:54:51 CEST 2001
93 $OpenBSD: README.smartcard,v 1.9 2003/11/21 11:57:02 djm Exp $