From 0c73c819196e1ac88fce40b28f66b37f8c8bf2fd Mon Sep 17 00:00:00 2001 From: Nitish Tiwari Date: Tue, 28 Nov 2017 15:15:50 +0530 Subject: [PATCH] Cleanup TLS setup document (#5231) Fixes #4959 --- docs/tls/README.md | 75 ++++++++++++++++++++++++++++++---------------- 1 file changed, 49 insertions(+), 26 deletions(-) diff --git a/docs/tls/README.md b/docs/tls/README.md index 086e2eec7..368a391e0 100644 --- a/docs/tls/README.md +++ b/docs/tls/README.md @@ -1,30 +1,29 @@ # How to secure access to Minio server with TLS [![Slack](https://slack.minio.io/slack?type=svg)](https://slack.minio.io) -In this document, we will configure Minio servers with TLS certificates for both Linux and Windows. +This document explains how to configure Minio server with TLS certificates on Linux and Windows platforms. ## 1. Prerequisites -* Download Minio server from [here](https://docs.minio.io/docs/minio-quickstart-guide) +Download Minio server from [here](https://docs.minio.io/docs/minio-quickstart-guide) -## 2. Configure with existing certificates +## 2. Existing certificates -Assuming that you are already having private and public certificates, you will need to copy them under `certs` in your Minio config directory using the names `private.key` and `public.crt` for key and public certificates respectively. +If you have already acquired private keys and public certificates, copy them under `certs` directory in your Minio config directory. By default config directory is `${HOME}/.minio/` or `%%USERPROFILE%%\.minio\` (based on your operating system). Note that the file should be named as `private.key` and `public.crt` for key and certificate respectively. -If the certificate is signed by a certificate authority, `public.crt` should be the concatenation of the server's certificate, any intermediates, and the CA's root certificate. +If the certificate is signed by a certificate authority (CA), `public.crt` should be the concatenation of the server's certificate, any intermediates, and the CA's root certificate. -## 3. Generate certificates +If you're looking to generate CA certificate for Minio using Let's Encrypt, follow the docs [here](https://docs.minio.io/docs/generate-let-s-encypt-certificate-using-concert-for-minio). -### Linux +## 3. Generate self-signed certificates -Minio supports only key/certificate in PEM format on Linux. +Before generating your self-signed certificate, note that -#### With Let's Encrypt +- Minio supports only key/certificate in PEM format on Linux. +- Minio supports only key/certificate in PEM format on Windows. We don't support PFX certificates currently. -Please explore [here](https://docs.minio.io/docs/generate-let-s-encypt-certificate-using-concert-for-minio) +### Using generate_cert.go -#### With generate_cert.go (self-signed certificate) - -You need to download [generate_cert.go](https://golang.org/src/crypto/tls/generate_cert.go?m=text) which is a simple go tool for generating self-signed certificates but works for the most of cases. +Download [generate_cert.go](https://golang.org/src/crypto/tls/generate_cert.go?m=text). This is a simple go tool to generate self-signed certificates. `generate_cert.go` already provides SAN certificates with DNS and IP entries: @@ -32,7 +31,7 @@ You need to download [generate_cert.go](https://golang.org/src/crypto/tls/genera go run generate_cert.go -ca --host "10.10.0.3" ``` -#### With OpenSSL: +### Using OpenSSL Generate the private key: @@ -46,11 +45,38 @@ Generate the self-signed certificate: openssl req -new -x509 -days 3650 -key private.key -out public.crt -subj "/C=US/ST=state/L=location/O=organization/CN=domain" ``` -### Windows +### Using OpenSSL (with IP address) -Minio only supports key/certificate in PEM format on Windows. Currently we do not yet support PFX certificates. +Create a file called `openssl.conf` and add the below text in the file. Note that you'll need to change the `IP.1` field to point to correct IP address. -#### Install GnuTLS +```sh +[req] +distinguished_name = req_distinguished_name +x509_extensions = v3_req +prompt = no + +[req_distinguished_name] +C = US +ST = VA +L = Somewhere +O = MyOrg +OU = MyOU +CN = MyServerName + +[v3_req] +subjectAltName = @alt_names + +[alt_names] +IP.1 = 127.0.0.1 +``` + +Then run + +```sh +openssl req -x509 -nodes -days 730 -newkey rsa:2048 -keyout private.key -out public.crt -config openssl.conf +``` + +### Using GnuTLS (for Windows) Download and decompress the Windows version of GnuTLS from [here](http://www.gnutls.org/download.html) @@ -62,17 +88,13 @@ setx path "%path%;C:\Users\MyUser\Downloads\gnutls-3.4.9-w64\bin" You may need to restart your powershell console for this to take affect. -#### Generate private.key - -Run the following command to create `private.key` +- Run the following command to create `private.key` ``` -certtool.exe --generate-privkey --outfile private.key +certtool.exe --generate-privkey --outfile private.key ``` -#### Generate public.crt - -Create a file `cert.cnf` with all the necessary information to generate a certificate. +- Create a file `cert.cnf` with all the necessary information to generate a certificate. ``` # X.509 Certificate options @@ -117,7 +139,7 @@ encryption_key Generate public certificate ``` -certtool.exe --generate-self-signed --load-privkey private.key --template cert.cnf --outfile public.crt +certtool.exe --generate-self-signed --load-privkey private.key --template cert.cnf --outfile public.crt ``` ## 4. Install third-party CAs @@ -125,5 +147,6 @@ certtool.exe --generate-self-signed --load-privkey private.key --template cert.c Minio can be configured to connect to other servers, whether Minio nodes or servers like NATs, Redis. If these servers use certificates that are not registered in one of the known certificates authorities, you can make Minio server trust these CAs by dropping these certificates under Minio config path (`~/.minio/certs/CAs/` on Linux or `C:\Users\\.minio\certs\CAs` on Windows). # Explore Further -* [Minio Quickstart Guide](https://docs.minio.io/docs/minio-quickstart-guide) * [Minio Client Complete Guide](https://docs.minio.io/docs/minio-client-complete-guide) +* [Generate Let's Encrypt Certificate](https://docs.minio.io/docs/generate-let-s-encypt-certificate-using-concert-for-minio) +* [Setup Nginx Proxy with Minio Server](https://docs.minio.io/docs/setup-nginx-proxy-with-minio)