x
[heimdal.git] / kuser / kimpersonate.1
blob0e5949b96862757786166e289654cd9e4cafc681
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$
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
105 address of client
106 .It Xo
107 .Fl t Ar string Ns ,
108 .Fl -enc-type= Ns Ar string
110 encryption type
111 .It Xo
112 .Fl f Ar string Ns ,
113 .Fl -ticket-flags= Ns Ar string
115 ticket flags for krb5 ticket
116 .It Xo
117 .Fl -verbose
119 Verbose output
120 .It Xo
121 .Fl -version
123 Print version
124 .It Xo
125 .Fl -help
128 .Sh FILES
129 Uses
130 .Pa /etc/krb5.keytab,
131 .Pa /etc/srvtab
133 .Pa /usr/afs/etc/KeyFile
134 when avalible and the the
135 .Fl k
136 is used with appropriate prefix.
137 .Sh EXAMPLES
139 can be used in
140 .Nm samba
141 root preexec option
142 or for debugging.
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>