Initial import from FreeBSD RELENG_4:
[dragonfly.git] / lib / libskey / skey.1
1 .\"     @(#)skey.1      1.1     10/28/93
2 .\" $FreeBSD: src/lib/libskey/skey.1,v 1.4.2.2 2001/12/21 10:07:09 ru Exp $
3 .\"
4 .Dd October 28, 1993
5 .Dt KEY 1
6 .Os
7 .Sh NAME
8 .Nm S/key
9 .Nd "a procedure to use one time passwords for accessing computer systems"
10 .Sh DESCRIPTION
11 .Nm
12 is a procedure for using one time password to authenticate access to
13 computer systems.
14 It uses 64 bits of information transformed by the
15 MD4 algorithm.
16 The user supplies the 64 bits in the form of 6 English
17 words that are generated by a secure computer.
18 Example use of the
19 .Nm
20 program
21 .Nm key :
22 .Bd -literal -offset indent
23 >key 99 th91334
24 Enter password: <your secret password is entered here>
25 OMEN US HORN OMIT BACK AHOY
26 >
27 .Ed
28 .Pp
29 The programs that are part of the
30 .Nm
31 system are
32 .Nm keyinit , key ,
33 and
34 .Nm keyinfo .
35 .Nm Keyinit
36 is used to get your ID set up,
37 .Nm key
38 is
39 used to get the one time password each time,
40 .Nm keyinfo
41 is used to extract information from the
42 .Nm
43 database.
44 .Pp
45 When you run
46 .Nm keyinit
47 you inform the system of your
48 secret password.
49 Running
50 .Nm key
51 then generates the
52 one-time passwords, and also requires your secret
53 password.
54 If however, you misspell your password
55 while running
56 .Nm key ,
57 you will get a list of passwords
58 that will not work, and no indication about the problem.
59 .Pp
60 Password sequence numbers count backward from 99.
61 If you don't know this, the syntax for
62 .Nm key
63 will be confusing.
64 .Pp
65 You can enter the passwords using small letters, even
66 though the
67 .Nm key
68 program gives them in caps.
69 .Pp
70 .Tn Macintosh
71 and a general purpose
72 .Tn PC
73 use are available.
74 .Pp
75 Under
76 .Fx ,
77 you can control, with
78 .Pa /etc/skey.access ,
79 from which hosts and/or networks the use of
80 .Nm
81 passwords is obligated.
82 .Sh SEE ALSO
83 .Xr key 1 ,
84 .Xr keyinfo 1 ,
85 .Xr keyinit 1 ,
86 .Xr skey.access 5
87 .Sh AUTHORS
88 .An Phil Karn
89 .An Neil M. Haller
90 .An John S. Walden
91 .An Scott Chasin