From: dlg <dlg@openbsd.org>
Date: Fri, 23 Feb 2018 03:01:34 +0000 (+0000)
Subject: add a SECURITY CONSIDERATIONS section.
X-Git-Url: http://artulab.com/gitweb/?a=commitdiff_plain;h=e1904260e944429b96ad18c90b543f887f65ed1c;p=openbsd

add a SECURITY CONSIDERATIONS section.

mdoc(7) says that section goes last, which is where i put it. i
kind of want it before EXAMPLES though.
---

diff --git a/share/man/man4/gre.4 b/share/man/man4/gre.4
index 2f622f1635c..23297c3b6e0 100644
--- a/share/man/man4/gre.4
+++ b/share/man/man4/gre.4
@@ -1,4 +1,4 @@
-.\" $OpenBSD: gre.4,v 1.63 2018/02/23 02:52:28 dlg Exp $
+.\" $OpenBSD: gre.4,v 1.64 2018/02/23 03:01:34 dlg Exp $
 .\" $NetBSD: gre.4,v 1.10 1999/12/22 14:55:49 kleink Exp $
 .\"
 .\" Copyright 1998 (c) The NetBSD Foundation, Inc.
@@ -638,3 +638,22 @@ the configuration of child
 interfaces or the bridging of VLAN tagged traffic across the tunnel.
 These non-restrictions allow non-compliant tunnels to be configured
 which may not interoperate with other vendors.
+.Sh SECURITY CONSIDERATIONS
+The GRE protocol in all its flavours does not provide any integrated
+security features.
+GRE should only be deployed on trusted private networks,
+or protected with IPsec to add authentication and encryption for
+confidentiality.
+IPsec is especially recommended when transporting GRE over the
+public internet.
+.Pp
+The Packet Filter
+.Xr pf 4
+can be used to filter tunnel traffic with endpoint policies
+.Xr pf.conf 5 .
+.Pp
+The Time-to-Live (TTL) value of a tunnel can be set to 1 or a low
+value to restrict the traffic to the local network:
+.Bd -literal -offset indent
+# ifconfig gre0 tunnelttl 1
+.Ed