TLS Configuration for your Reseed Server

By default, reseed-tools will generate self-signed certificates for your reseed service. This is so that it can use TLS by default, and so that it can offer self-signed certificates when operating in .onion mode. It is also possible to configure reseed-tools without TLS certificates, or to configure it to use ACME in order to automtically obtain a certificate from Let’s Encrypt.

I2P does not rely on TLS Certificate Authorities to authenticate reseed servers. Instead, the certificates are effectively “Pinned” in the software, after manual review by the I2P developers and the community. It is acceptable to use self-signed certificates in this fashion because they are not summarily trusted. A self-signed certificate which is not configured in the I2P software will not work when serving a reseed to an I2P router.

Disable TLS

If you do this, it is highly recommended that you use a reverse proxy such as Apache2 or nginx to provide a TLS connection to clients. Alternatively, you could run reseed-tools as an .onion service and rely on Tor for encryption and authentication.

You can disable automatic TLS configuration with the --trustProxy flag like this:

./reseed-tools reseed --signer=you@mail.i2p --netdb=/home/i2p/.i2p/netDb --trustProxy --ip=127.0.0.1

Setup Self-Signed TLS non-interactively

If you don’t want to interactively configure TLS but still want to use self-signed certificates, you can pass the --yes flag, which will use the defaults for all config values.

./reseed-tools reseed --signer=you@mail.i2p --netdb=/home/i2p/.i2p/netDb --yes

Use ACME to acquire TLS certificate

Instead of self-signed certificates, if you want to chain up to a TLS CA, you can. To automate this process using an ACME CA, like Let’s Encrypt, you can use the --acme flag. Be sure to change the --acmeserver option in order to use a production ACME server, as the software defaults to a staging ACME server for testing purposes.

This functionality is new and may have issues. Please file bug reports at (i2pgit)[ https://i2pgit.org/idk/reseed-tools) or github .

./reseed-tools reseed --signer=you@mail.i2p --netdb=/home/i2p/.i2p/netDb --acme --acmeserver="https://acme-v02.api.letsencrypt.org/directory"

Copyright (c) 2014 Matt Drollette

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.