usr.bin/keyinit/keyinit.1

   1 .\"     @(#)keyinit.1   1.0 (Bellcore) 7/20/93
   2 .\"
   3 .Dd July 20, 1993
   4 .Dt KEYINIT 1
   5 .Os
   6 .Sh NAME
   7 .Nm keyinit
   8 .Nd change password or add user to S/Key authentication system
   9 .Sh SYNOPSIS
  10 .Nm
  11 .Op Fl s
  12 .Op Ar userID
  13 .Sh DESCRIPTION
  14 .Nm Keyinit
  15 initializes the system so you can use S/Key one-time passwords to
  16 login.  The program will ask you to enter a secret pass phrase; enter a
  17 phrase of several words in response. After the S/Key database has been
  18 updated you can login using either your regular UNIX password or using
  19 S/Key one-time passwords.
  20 .Pp
  21 When logging in from another machine you can avoid typing a real
  22 password over the network, by typing your S/Key pass phrase to the
  23 .Nm key
  24 command on the local machine:  the program will respond with
  25 the one-time password that you should use to log into the remote
  26 machine.  This is most conveniently done with cut-and-paste operations
  27 using a mouse.  Alternatively, you can pre-compute one-time passwords
  28 using the
  29 .Nm key
  30 command and carry them with you on a piece of paper.
  31 .Pp
  32 .Nm Keyinit
  33 requires you to type your secret password, so it should
  34 be used only on a secure terminal. For example, on the console of a
  35 workstation. If you are using
  36 .Nm
  37 while logged in over an
  38 untrusted network, follow the instructions given below with the
  39 .Fl s
  40 option.
  41 .Sh OPTIONS
  42 .Bl -tag -width indent
  43 .It Fl s
  44 Set secure mode where the user is expected to have used a secure
  45 machine to generate the first one time password.  Without the
  46 .Fl s
  47 the
  48 system will assume you are direct connected over secure communications
  49 and prompt you for your secret password.
  50 The
  51 .Fl s
  52 option also allows one to set the seed and count for complete
  53 control of the parameters.  You can use
  54 .Nm
  55 .Fl s
  56 in combination with
  57 the
  58 .Nm key
  59 command to set the seed and count if you do not like the defaults.
  60 To do this run
  61 .Nm
  62 in one window and put in your count and seed
  63 then run
  64 .Nm key
  65 in another window to generate the correct 6 English words
  66 for that count and seed. You can then
  67 "cut" and "paste" them or copy them into the
  68 .Nm
  69 window.
  70 .It Ar userID
  71 The ID for the user to be changed/added
  72 .El
  73 .Sh FILES
  74 .Pa /etc/skeykeys
  75 data base of information for S/Key system.
  76 .Sh SEE ALSO
  77 .Xr key 1 ,
  78 .Xr keyinfo 1 ,
  79 .Xr skey 1 ,
  80 .Xr su 1
  81 .Sh AUTHORS
  82 Command by
  83 .An Phil Karn ,
  84 .An Neil M. Haller ,
  85 .An John S. Walden