HardeningWrapper

Differences between revisions 1 and 2
Revision 1 as of 2008-01-24 12:23:02
Size: 2201
Editor: yttrium
Comment: initial outline about hardening wrapper details
Revision 2 as of 2008-03-03 22:59:13
Size: 2690
Editor: c-76-105-157-155
Comment: how to add hardening-wrapper to sbuild runs
Deletions are marked like this. Additions are marked like this.
Line 41: Line 41:

To catch libc runtime abort errors, they must be forced to STDERR by setting the environment variable {{{LIBC_FATAL_STDERR_=1}}}. (The trailing underscore is not a typo.)

== Enabling ==

=== sbuild ===

 * Set the environment variable "DEB_BUILD_HARDENING=1"
 * Add {{{-a "PKG: & hardening-wrapper"}}} to the command line, where '''PKG''' is the package you're building

e.g.:
 {{{DEB_BUILD_HARDENING=1 sbuild -q -A -d hardy -b -a "hello: & hardening-wrapper" hello*.dsc}}}

While the DistCompilerFlags spec (and ensuing [https://wiki.ubuntu.com/DistCompilerFlags Debian discussion]) matures, we need a way to test security hardening compiler options (in the hopes of implementing it distro-wide for Hardy+1). The [http://wiki.debian.org/Hardening hardening-wrapper] package installs wrappers for ld and gcc/g++ (4.1, 4.2, 4.3 -- 3.x is not included since it seems that it won't be in the archive for Hardy+1, though these can be added if someone needs it). These options enable several features that make the resulting binaries more resistant to memory corruption vulnerability exploitation (making targets in the binary harder to find, reducing the number of targets, catching overflows before they happen, and warning about unsafe *printf usage during compile).

To perform package builds with the options enabled, a developer needs to do two things:

  • install hardening-wrapper (surprise!)
  • set the environment variable DEB_BUILD_HARDENING=1

The hardening features can be individually disabled if there are complications during a build. The most likely build failures will be related to DEB_BUILD_HARDENING_PIE which has the largest impact on the built objects. Some more complex packages (e.g. openoffice.org) are known not to work with this wrapper's implementation of the PIE compiler options. When build failures are found that are specific to enabling the hardening features, please open a bug against the failed package with this information and:

  • attach the build log when built with DEB_BUILD_HARDENING_DEBUG=1 enabled
  • tag the bug as "hardening-ftbfs"
  • discuss any tested work-arounds (does it compile with certain options disabled?)

When performing compiles, also please keep an eye out for this kind of warning:

foo.c: In function 'bar':
foo.c:16: warning: format not a string literal and no format arguments

This indicates a (possibly) unsafe use of a *printf function (i.e. printf(strvar) when printf("%s",str) should be used), and should be investigated to make sure the package is not vulnerable to a format string attack. Please open bugs for these as well, and tag them "format-security".

To catch libc runtime abort errors, they must be forced to STDERR by setting the environment variable LIBC_FATAL_STDERR_=1. (The trailing underscore is not a typo.)

Enabling

sbuild

  • Set the environment variable "DEB_BUILD_HARDENING=1"
  • Add -a "PKG: & hardening-wrapper" to the command line, where PKG is the package you're building

e.g.:

  • DEB_BUILD_HARDENING=1 sbuild -q -A -d hardy -b -a "hello: & hardening-wrapper" hello*.dsc

Security/HardeningWrapper (last edited 2008-09-02 23:56:11 by sites)