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