crypto/heimdal/kuser/kimpersonate.1

   1 .\" Copyright (c) 2002 - 2007 Kungliga Tekniska Högskolan
   2 .\" (Royal Institute of Technology, Stockholm, Sweden).
   3 .\" All rights reserved.
   4 .\"
   5 .\" Redistribution and use in source and binary forms, with or without
   6 .\" modification, are permitted provided that the following conditions
   7 .\" are met:
   8 .\"
   9 .\" 1. Redistributions of source code must retain the above copyright
  10 .\"    notice, this list of conditions and the following disclaimer.
  11 .\"
  12 .\" 2. Redistributions in binary form must reproduce the above copyright
  13 .\"    notice, this list of conditions and the following disclaimer in the
  14 .\"    documentation and/or other materials provided with the distribution.
  15 .\"
  16 .\" 3. Neither the name of the Institute nor the names of its contributors
  17 .\"    may be used to endorse or promote products derived from this software
  18 .\"    without specific prior written permission.
  19 .\"
  20 .\" THIS SOFTWARE IS PROVIDED BY THE INSTITUTE AND CONTRIBUTORS ``AS IS'' AND
  21 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  22 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  23 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE INSTITUTE OR CONTRIBUTORS BE LIABLE
  24 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  25 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  26 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  27 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  28 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  29 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  30 .\" SUCH DAMAGE.
  31 .\"
  32 .\" $Id: kimpersonate.1 20259 2007-02-17 23:49:54Z lha $
  33 .\"
  34 .Dd September 18, 2006
  35 .Dt KERBEROS 1
  36 .Os Heimdal
  37 .Sh NAME
  38 .Nm kimpersonate
  39 .Nd
  40 impersonate a user when there exist a srvtab, keyfile or KeyFile
  41 .Sh SYNOPSIS
  42 .Nm
  43 .Oo Fl s Ar string \*(Ba Xo
  44 .Fl -server= Ns Ar string Oc
  45 .Xc
  46 .Oo Fl c Ar string \*(Ba Xo
  47 .Fl -client= Ns Ar string Oc
  48 .Xc
  49 .Oo Fl k Ar string \*(Ba Xo
  50 .Fl -keytab= Ns Ar string Oc
  51 .Xc
  52 .Op Fl 5 | Fl -krb5
  53 .Oo Fl e Ar integer \*(Ba Xo
  54 .Fl -expire-time= Ns Ar integer Oc
  55 .Xc
  56 .Oo Fl a Ar string \*(Ba Xo
  57 .Fl -client-address= Ns Ar string Oc
  58 .Xc
  59 .Oo Fl t Ar string \*(Ba Xo
  60 .Fl -enc-type= Ns Ar string Oc
  61 .Xc
  62 .Oo Fl f Ar string \*(Ba Xo
  63 .Fl -ticket-flags= Ns Ar string Oc
  64 .Xc
  65 .Op Fl -verbose
  66 .Op Fl -version
  67 .Op Fl -help
  68 .Sh DESCRIPTION
  69 The
  70 .Nm
  71 program creates a "fake" ticket using the service-key of the service.
  72 The service key can be read from a Kerberos 5 keytab, AFS KeyFile or
  73 (if compiled with support for Kerberos 4) a Kerberos 4 srvtab.
  74 Supported options:
  75 .Bl -tag -width Ds
  76 .It Xo
  77 .Fl s Ar string Ns ,
  78 .Fl -server= Ns Ar string
  79 .Xc
  80 name of server principal
  81 .It Xo
  82 .Fl c Ar string Ns ,
  83 .Fl -client= Ns Ar string
  84 .Xc
  85 name of client principal
  86 .It Xo
  87 .Fl k Ar string Ns ,
  88 .Fl -keytab= Ns Ar string
  89 .Xc
  90 name of keytab file
  91 .It Xo
  92 .Fl 5 Ns ,
  93 .Fl -krb5
  94 .Xc
  95 create a Kerberos 5 ticket
  96 .It Xo
  97 .Fl e Ar integer Ns ,
  98 .Fl -expire-time= Ns Ar integer
  99 .Xc
 100 lifetime of ticket in seconds
 101 .It Xo
 102 .Fl a Ar string Ns ,
 103 .Fl -client-address= Ns Ar string
 104 .Xc
 105 address of client
 106 .It Xo
 107 .Fl t Ar string Ns ,
 108 .Fl -enc-type= Ns Ar string
 109 .Xc
 110 encryption type
 111 .It Xo
 112 .Fl f Ar string Ns ,
 113 .Fl -ticket-flags= Ns Ar string
 114 .Xc
 115 ticket flags for krb5 ticket
 116 .It Xo
 117 .Fl -verbose
 118 .Xc
 119 Verbose output
 120 .It Xo
 121 .Fl -version
 122 .Xc
 123 Print version
 124 .It Xo
 125 .Fl -help
 126 .Xc
 127 .El
 128 .Sh FILES
 129 Uses
 130 .Pa /etc/krb5.keytab,
 131 .Pa /etc/srvtab
 132 and
 133 .Pa /usr/afs/etc/KeyFile
 134 when avalible and the the
 135 .Fl k
 136 is used with appropriate prefix.
 137 .Sh EXAMPLES
 138 .Nm
 139 can be used in
 140 .Nm samba
 141 root preexec option
 142 or for debugging.
 143 .Nm
 144 -s host/hummel.e.kth.se@E.KTH.SE -c lha@E.KTH.SE -5
 145 will create a Kerberos 5 ticket for lha@E.KTH.SE for the host
 146 hummel.e.kth.se if there exists a keytab entry for it in
 147 .Pa /etc/krb5.keytab .
 148 .Sh SEE ALSO
 149 .Xr kinit 1 ,
 150 .Xr klist 1
 151 .Sh AUTHORS
 152 Love Hornquist Astrand <lha@kth.se>