Skip to content

Latest commit

 

History

History
72 lines (57 loc) · 3.29 KB

README.md

File metadata and controls

72 lines (57 loc) · 3.29 KB

nginx-fips-check-module

Build & Test FreeBSD A/UBSan Valgrind CodeQL Lint

Report whether the OpenSSL that nginx is linked against is running in FIPS mode, and refuse to carry on if that ever changes under a running server.

The module has no directives. It runs once when a cycle starts and writes one line:

2026/10/14 09:12:03 [notice] 7421#0: OpenSSL FIPS Mode is not enabled

That line is the point. Whoever has to show that a server runs in FIPS mode gets it from the process itself rather than from the configuration that was supposed to arrange it, and a worker that comes up with a different answer than the master found at startup aborts instead of serving.

What it does not do: enable anything. FIPS mode is a property of the OpenSSL the server links against, set up outside nginx.

Building

ci/build.sh 1.30.5 /tmp/nginx-test            # into the binary
ci/build.sh 1.30.5 /tmp/nginx-test dynamic    # as a loadable object

The module needs libcrypto and takes it from nginx: a static build has to be an nginx configured with SSL, a loadable one resolves the symbol against the running binary. An nginx without SSL has no FIPS mode to report anyway.

Testing

ci/build.sh 1.30.5 /tmp/nginx-test
TEST_NGINX_BINARY=/tmp/nginx-test/sbin/nginx prove -r t/

The suite asks what a module without directives can be asked: that it loads, that it reports the state it found, and that the report belongs to the start of a cycle and not to a request. It asserts the common prefix of the two messages, so a host whose OpenSSL really is in FIPS mode passes as well.

License

Apache License 2.0, the module and the scaffolding around it alike; see LICENSE. The module is Owen Garrett's, and so is the NOTICE file beside it -- that licence asks for it to travel with the work, so it does.