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