usr.bin/keyinit/keyinit.1

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