/mandos/trunk

To get this branch, use:
bzr branch http://bzr.recompile.se/loggerhead/mandos/trunk

« back to all changes in this revision

Viewing changes to intro.xml

  • Committer: Teddy Hogeborn
  • Date: 2011-09-18 15:59:05 UTC
  • mfrom: (24.1.179 mandos)
  • Revision ID: teddy@fukt.bsnet.se-20110918155905-ngj2ig0yheralj1s
* DBUS-API: Document new "Expires" and "ExtendedTimeout" properties.
* README: Refer to the installed manual page more simply.
* mandos (Client.extended_timeout, Client.expires): New attributes.
  (Client.extended_timeout_milliseconds): New.
  (Client.__init__, Client.enable, Client.disable): Set new attributes.
  (Client.checked_ok): Take new "timeout" argument.
  (ClientDBus.expires): Transform into a property which sends a D-Bus
                        signal when changed.
  (ClientDBus._datetime_to_dbus): Return empty D-Bus string on None.
                                  All callers changed to use this.

  (ClientDBus.ApprovedByDefault_dbus_property,
  ClientDBus.ApprovalDelay_dbus_property,
  ClientDBus.ApprovalDuration_dbus_property,
  ClientDBus.Host_dbus_property, ClientDBus.Timeout_dbus_property,
  ClientDBus.Interval_dbus_property,
  ClientDBus.Checker_dbus_property): Bug fix: Only send D-Bus signal
                                     if new value is different.
  (ClientDBus.Timeout_dbus_property): Use new "expires" attribute.
  (ClientDBus.Expires_dbus_property,
  ClientDBus.ExtendedTimeout_dbus_property): New D-Bus properties.
  (ClientHandler.handle): Bump time using extended_timeout value.
  (main.client_defaults): Change default values of "timeout" and
                          "interval", added new default value for
                          "extended_timeout".
* mandos-clients.conf.xml (OPTIONS): Changed default values of
                                     "interval" and "timeout".  Add
                                     new "extended_timeout" option.
  (EXAMPLE): Updated default values.
* mandos-ctl: Show new "ExtendedTimeout" D-Bus property and change it
              using new "--extended-timeout" option.
* mandos-ctl.xml (SYNOPSIS, OPTIONS): Document new
                                      "--extended-timeout" option.
* mandos-monitor (MandosClientWidget.update): Use new "Expires" D-Bus
                                              property.
* mandos.xml (DESCRIPTION): Add reference to intro(8mandos) manual
                            page.
  (CHECKING): Refer to the new "extended_timeout" option in
  clients.conf.

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
1
<?xml version="1.0" encoding="UTF-8"?>
2
2
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3
3
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4
 
<!ENTITY TIMESTAMP "2016-03-22">
 
4
<!ENTITY TIMESTAMP "2011-08-08">
5
5
<!ENTITY % common SYSTEM "common.ent">
6
6
%common;
7
7
]>
18
18
        <firstname>Björn</firstname>
19
19
        <surname>Påhlsson</surname>
20
20
        <address>
21
 
          <email>belorn@recompile.se</email>
 
21
          <email>belorn@fukt.bsnet.se</email>
22
22
        </address>
23
23
      </author>
24
24
      <author>
25
25
        <firstname>Teddy</firstname>
26
26
        <surname>Hogeborn</surname>
27
27
        <address>
28
 
          <email>teddy@recompile.se</email>
 
28
          <email>teddy@fukt.bsnet.se</email>
29
29
        </address>
30
30
      </author>
31
31
    </authorgroup>
32
32
    <copyright>
33
33
      <year>2011</year>
34
 
      <year>2012</year>
35
 
      <year>2013</year>
36
 
      <year>2014</year>
37
 
      <year>2015</year>
38
 
      <year>2016</year>
39
34
      <holder>Teddy Hogeborn</holder>
40
35
      <holder>Björn Påhlsson</holder>
41
36
    </copyright>
201
196
      </para>
202
197
    </refsect2>
203
198
    
204
 
    <refsect2 id="sniff">
205
 
      <title>How about sniffing the network traffic and decrypting it
206
 
      later by physically grabbing the Mandos client and using its
207
 
      key?</title>
208
 
      <para>
209
 
        We only use <acronym>PFS</acronym> (Perfect Forward Security)
210
 
        key exchange algorithms in TLS, which protects against this.
211
 
      </para>
212
 
    </refsect2>
213
 
    
214
199
    <refsect2 id="physgrab">
215
200
      <title>Physically grabbing the Mandos server computer?</title>
216
201
      <para>
229
214
      </para>
230
215
    </refsect2>
231
216
    
232
 
    <refsect2 id="fakecheck">
233
 
      <title>Faking checker results?</title>
 
217
    <refsect2 id="fakeping">
 
218
      <title>Faking ping replies?</title>
234
219
      <para>
235
 
        If the Mandos client does not have an SSH server, the default
236
 
        is for the Mandos server to use
 
220
        The default for the server is to use
237
221
        <quote><literal>fping</literal></quote>, the replies to which
238
222
        could be faked to eliminate the timeout.  But this could
239
223
        easily be changed to any shell command, with any security
240
 
        measures you like.  If the Mandos client
241
 
        <emphasis>has</emphasis> an SSH server, the default
242
 
        configuration (as generated by
243
 
        <command>mandos-keygen</command> with the
244
 
        <option>--password</option> option) is for the Mandos server
245
 
        to use an <command>ssh-keyscan</command> command with strict
246
 
        keychecking, which can not be faked.  Alternatively, IPsec
247
 
        could be used for the ping packets, making them secure.
 
224
        measures you like.  It could, for instance, be changed to an
 
225
        SSH command with strict keychecking, which could not be faked.
 
226
        Or IPsec could be used for the ping packets, making them
 
227
        secure.
248
228
      </para>
249
229
    </refsect2>
250
230
  </refsect1>
379
359
    </para>
380
360
  </refsect1>
381
361
  
382
 
  <refsect1 id="bugs">
383
 
    <title>BUGS</title>
384
 
    <xi:include href="bugs.xml"/>
385
 
  </refsect1>
386
 
  
387
362
  <refsect1 id="see_also">
388
363
    <title>SEE ALSO</title>
389
364
    <para>
417
392
    <variablelist>
418
393
      <varlistentry>
419
394
        <term>
420
 
          <ulink url="https://www.recompile.se/mandos">Mandos</ulink>
 
395
          <ulink url="http://www.fukt.bsnet.se/mandos">Mandos</ulink>
421
396
        </term>
422
397
        <listitem>
423
398
          <para>