X-Git-Url: http://www.git.cypherpunks.ru/?a=blobdiff_plain;f=gocheese.texi;h=8b89b166a9183a0411f63a1d884dc522180772c2;hb=2b83ac5db8551f70614672b2d326272b35d064d3;hp=f89df36221c40070d6bc5e360c3af7fc28042170;hpb=b144ad5b2dd5d62dd14909afd6696b3137bdf0db;p=gocheese.git diff --git a/gocheese.texi b/gocheese.texi index f89df36..8b89b16 100644 --- a/gocheese.texi +++ b/gocheese.texi @@ -25,18 +25,19 @@ but nearly all the code was rewritten. It has huge differences: @item proxying and caching of missing packages @item atomic packages store on filesystem @item SHA256-checksummed packages (both uploaded and proxied one) -@item no TLS support +@item graceful HTTP-server shutdown @item no YAML configuration, just command-line arguments -@item no package overwriting ability +@item no package overwriting ability (as PyPI does) @end itemize GoCheese is free software, licenced under -@url{https://www.gnu.org/licenses/gpl-3.0.html, GNU GPLv3} conditions: +@url{https://www.gnu.org/licenses/gpl-3.0.html, GNU GPLv3}: see the file COPYING for copying conditions. @menu * Usage:: * Password authentication: Passwords. +* TLS support: TLS. * Storage format: Storage. @end menu @@ -124,6 +125,28 @@ $ kill -HUP `pidof gocheese` Before refreshing it's recommended to check @option{-passwd} file with @option{-passwd-check} option to prevent daemon failure. +@node TLS +@unnumbered TLS support + +You can enable TLS support by specifying PEM-encoded X.509 certificate +and private key files. Go's TLS implementation supports TLS 1.3, HTTP/2 +negotiation, Keep-Alives, modern ciphersuites and ECC. + +For example generate some self-signed certificate using GnuTLS toolset: + +@verbatim +$ certtool --generate-privkey --ecc --outfile prv.pem +$ cert_template=`mktemp` +$ echo cn=gocheese.host > $cert_template +$ certtool \ + --generate-self-signed \ + --load-privkey=prv.pem \ + --template $cert_template \ + --outfile=cert.pem +$ rm $cert_template +$ gocheese -tls-cert cert.pem -tls-key prv.pem [...] +@end verbatim + @node Storage @unnumbered Storage format