← Back to branch summary

~ubuntu-branches/ubuntu/hardy/openswan/hardy-updates

« back to all changes in this revision

Viewing changes to doc/manpage.d/ipsec_showhostkey.8.html

  • Committer: Bazaar Package Importer
  • Author(s): Rene Mayrhofer
  • Date: 2005-01-27 16:10:11 UTC
  • mfrom: (1.1.1 upstream)
  • Revision ID: james.westby@ubuntu.com-20050127161011-idgybmyz3vwhpfiq
Tags: 2.3.0-2
http://bugs.debian.org/292458
http://bugs.debian.org/291143
Urgency HIGH due to security issue and problems with build-deps in sarge.
* Fix the security issue. Please see
  http://www.idefense.com/application/poi/display?id=190&
      type=vulnerabilities&flashstatus=false
  for more details. Thanks to Martin Schulze for informing me about
  this issue.
  Closes: #292458: Openswan XAUTH/PAM Buffer Overflow Vulnerability
* Added a Build-Dependency to lynx.
  Closes: #291143: openswan: FTBFS: Missing build dependency.

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/manpage.d/ipsec_showhostkey.8.html
1
 
Content-type: text/html
2
 
 
3
 
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
4
 
<HTML><HEAD><TITLE>Man page of IPSEC_SHOWHOSTKEY</TITLE>
5
 
</HEAD><BODY>
6
 
<H1>IPSEC_SHOWHOSTKEY</H1>
7
 
Section: Maintenance Commands (8)<BR>Updated: 5 March 2002<BR><A HREF="#index">Index</A>
8
 
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
9
 
 
10
 
 
11
 
<A NAME="lbAB">&nbsp;</A>
12
 
<H2>NAME</H2>
13
 
 
14
 
ipsec showhostkey - show host's authentication key
15
 
<A NAME="lbAC">&nbsp;</A>
16
 
<H2>SYNOPSIS</H2>
17
 
 
18
 
<B>ipsec</B>
19
 
 
20
 
<B>showhostkey</B>
21
 
 
22
 
[
23
 
<B>--key</B>
24
 
 
25
 
] [
26
 
<B>--left</B>
27
 
 
28
 
] [
29
 
<B>--right</B>
30
 
 
31
 
] [
32
 
<B>--txt</B>
33
 
 
34
 
gateway
35
 
] [
36
 
<B>--dhclient</B>
37
 
 
38
 
] [
39
 
<B>--file</B>
40
 
 
41
 
secretfile
42
 
] [
43
 
<B>--id</B>
44
 
 
45
 
identity
46
 
]
47
 
<A NAME="lbAD">&nbsp;</A>
48
 
<H2>DESCRIPTION</H2>
49
 
 
50
 
<I>Showhostkey</I>
51
 
 
52
 
outputs (on standard output) a public key suitable for this host,
53
 
in the format specified,
54
 
using the host key information stored in
55
 
<I>/etc/ipsec.secrets</I>.
56
 
 
57
 
In general only the super-user can run this command,
58
 
since only he can read
59
 
<I>ipsec.secrets</I>.
60
 
 
61
 
<P>
62
 
 
63
 
The
64
 
<B>--txt</B>
65
 
 
66
 
option causes the output to be in opportunistic-encryption DNS TXT record
67
 
format,
68
 
with the specified
69
 
<I>gateway</I>
70
 
 
71
 
value.
72
 
If information about how the key was generated is available,
73
 
that is provided as a DNS-file comment.
74
 
For example,
75
 
<B>--txt 10.11.12.13</B>
76
 
 
77
 
might give (with the key data trimmed for clarity):
78
 
<P>
79
 
 
80
 
<PRE>
81
 
  ; RSA 2048 bits   xy.example.com   Sat Apr 15 13:53:22 2000
82
 
      IN TXT  &quot;X-IPsec-Server(10)=10.11.12.13 AQOF8tZ2...+buFuFn/&quot;
83
 
</PRE>
84
 
 
85
 
<P>
86
 
 
87
 
No name is supplied in the TXT record
88
 
because there are too many possibilities,
89
 
depending on how it will be used.
90
 
If the text string is longer than 255 bytes,
91
 
it is split up into multiple strings (matching the restrictions of
92
 
the DNS TXT binary format).
93
 
If any split is needed, the first split will be at the start of the key:
94
 
this increases the chances that later hand editing will work.
95
 
<P>
96
 
 
97
 
The
98
 
<B>--left</B>
99
 
 
100
 
and
101
 
<B>--right</B>
102
 
 
103
 
options cause the output to be in
104
 
<I><A HREF="/cgi-bin/man/man2html?5+ipsec.conf">ipsec.conf</A></I>(5)
105
 
 
106
 
format, as a
107
 
<B>leftrsasigkey</B>
108
 
 
109
 
or
110
 
<B>rightrsasigkey</B>
111
 
 
112
 
parameter respectively.
113
 
Again, generation information is included if available.
114
 
For example,
115
 
<B>--left</B>
116
 
 
117
 
might give (with the key data trimmed down for clarity):
118
 
<P>
119
 
 
120
 
<PRE>
121
 
  # RSA 2048 bits   xy.example.com   Sat Apr 15 13:53:22 2000
122
 
  leftrsasigkey=0sAQOF8tZ2...+buFuFn/
123
 
</PRE>
124
 
 
125
 
<P>
126
 
 
127
 
The
128
 
<B>--dhclient</B>
129
 
 
130
 
option cause the output to be suitable for inclusion in
131
 
<I><A HREF="/cgi-bin/man/man2html?5+dhclient.conf">dhclient.conf</A></I>(5)
132
 
 
133
 
as part of configuring WAVEsec.
134
 
See &lt;<A HREF="http://www.wavesec.org">http://www.wavesec.org</A>&gt;.
135
 
<P>
136
 
 
137
 
If
138
 
<B>--key</B>
139
 
 
140
 
is specified,
141
 
the output format is the text form of a DNS KEY record;
142
 
the host name is the one included in the key information
143
 
(or, if that is not available,
144
 
the output of
145
 
<B>hostname&nbsp;--fqdn</B>),
146
 
 
147
 
with a
148
 
<B>.</B>
149
 
 
150
 
appended.
151
 
Again, generation information is included if available.
152
 
For example (with the key data trimmed down for clarity):
153
 
<P>
154
 
 
155
 
<PRE>
156
 
  ; RSA 2048 bits   xy.example.com   Sat Apr 15 13:53:22 2000
157
 
  xy.example.com.   IN   KEY   0x4200 4 1 AQOF8tZ2...+buFuFn/
158
 
</PRE>
159
 
 
160
 
<P>
161
 
 
162
 
Normally, the default key for this host
163
 
(the one with no host identities specified for it) is the one extracted.
164
 
The
165
 
<B>--id</B>
166
 
 
167
 
option overrides this,
168
 
causing extraction of the key labeled with the specified
169
 
<I>identity</I>,
170
 
 
171
 
if any.
172
 
The specified
173
 
<I>identity</I>
174
 
 
175
 
must
176
 
<I>exactly</I>
177
 
 
178
 
match the identity in the file;
179
 
in particular, the comparison is case-sensitive.
180
 
<P>
181
 
 
182
 
The
183
 
<B>--file</B>
184
 
 
185
 
option overrides the default for where the key information should be
186
 
found, and takes it from the specified
187
 
<I>secretfile</I>.
188
 
 
189
 
<A NAME="lbAE">&nbsp;</A>
190
 
<H2>DIAGNOSTICS</H2>
191
 
 
192
 
A complaint about ``no pubkey line found'' indicates that the
193
 
host has a key but it was generated with an old version of FreeS/WAN
194
 
and does not contain the information that
195
 
<I>showhostkey</I>
196
 
 
197
 
needs.
198
 
<A NAME="lbAF">&nbsp;</A>
199
 
<H2>FILES</H2>
200
 
 
201
 
/etc/ipsec.secrets
202
 
<A NAME="lbAG">&nbsp;</A>
203
 
<H2>SEE ALSO</H2>
204
 
 
205
 
<A HREF="/cgi-bin/man/man2html?5+ipsec.secrets">ipsec.secrets</A>(5), <A HREF="/cgi-bin/man/man2html?5+ipsec.conf">ipsec.conf</A>(5), <A HREF="/cgi-bin/man/man2html?8+ipsec_rsasigkey">ipsec_rsasigkey</A>(8)
206
 
<A NAME="lbAH">&nbsp;</A>
207
 
<H2>HISTORY</H2>
208
 
 
209
 
Written for the Linux FreeS/WAN project
210
 
&lt;<A HREF="http://www.freeswan.org">http://www.freeswan.org</A>&gt;
211
 
by Henry Spencer.
212
 
<A NAME="lbAI">&nbsp;</A>
213
 
<H2>BUGS</H2>
214
 
 
215
 
Arguably,
216
 
rather than just reporting the no-IN-KEY-line-found problem,
217
 
<I>showhostkey</I>
218
 
 
219
 
should be smart enough to run the existing key through
220
 
<I>rsasigkey</I>
221
 
 
222
 
with the
223
 
<B>--oldkey</B>
224
 
 
225
 
option, to generate a suitable output line.
226
 
<P>
227
 
 
228
 
The need to specify the gateway address (etc.) for
229
 
<B>--txt</B>
230
 
 
231
 
is annoying, but there is no good way to determine it automatically.
232
 
<P>
233
 
 
234
 
There should be a way to specify the priority value for TXT records;
235
 
currently it is hardwired to
236
 
<B>10</B>.
237
 
 
238
 
<P>
239
 
 
240
 
The
241
 
<B>--id</B>
242
 
 
243
 
option assumes that the
244
 
<I>identity</I>
245
 
 
246
 
appears on the same line as the
247
 
<B>:&nbsp;RSA&nbsp;{</B>
248
 
 
249
 
that begins the key proper.
250
 
<P>
251
 
 
252
 
<HR>
253
 
<A NAME="index">&nbsp;</A><H2>Index</H2>
254
 
<DL>
255
 
<DT><A HREF="#lbAB">NAME</A><DD>
256
 
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
257
 
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
258
 
<DT><A HREF="#lbAE">DIAGNOSTICS</A><DD>
259
 
<DT><A HREF="#lbAF">FILES</A><DD>
260
 
<DT><A HREF="#lbAG">SEE ALSO</A><DD>
261
 
<DT><A HREF="#lbAH">HISTORY</A><DD>
262
 
<DT><A HREF="#lbAI">BUGS</A><DD>
263
 
</DL>
264
 
<HR>
265
 
This document was created by
266
 
<A HREF="/cgi-bin/man/man2html">man2html</A>,
267
 
using the manual pages.<BR>
268
 
Time: 10:29:43 GMT, June 17, 2004
269
 
</BODY>
270
 
</HTML>