]> git.proxmox.com Git - pmg-docs.git/commitdiff
pmg-ssl-certificate.adoc: move ssl cerificate docu to extra file
authorDietmar Maurer <dietmar@proxmox.com>
Fri, 12 Jan 2018 09:21:04 +0000 (10:21 +0100)
committerDietmar Maurer <dietmar@proxmox.com>
Fri, 12 Jan 2018 09:21:04 +0000 (10:21 +0100)
pmg-admin-guide.adoc
pmg-ssl-certificate.adoc [new file with mode: 0644]

index 3ae28a2a466c2fb3ee1d5903b7bd2e116e0fc3b9..1c0bb510a934f25fdad0cf51198b689e0ffe2b88 100644 (file)
@@ -93,61 +93,7 @@ include::pmg-bibliography.adoc[]
 :leveloffset: 0
 
 [appendix]
-SSL certificate
----------------
-
-Access to the administration web interface is always done via
-`https`. The default certificate is never valid for your browser and
-you get always warnings.
-
-If you want to get rid of these warnings, you have to generate a valid
-certificate for your server.
-
-Login to your Proxmox via ssh or use the console:
-
-----
-openssl req -newkey rsa:2048 -nodes -keyout key.pem -out req.pem
-----
-
-Follow the instructions on the screen, see this example:
-
-----
-Country Name (2 letter code) [AU]: AT
-State or Province Name (full name) [Some-State]:Vienna
-Locality Name (eg, city) []:Vienna
-Organization Name (eg, company) [Internet Widgits Pty Ltd]: Proxmox GmbH
-Organizational Unit Name (eg, section) []:Proxmox Mail Gateway
-Common Name (eg, YOUR name) []: yourproxmox.yourdomain.com
-Email Address []:support@yourdomain.com
-
-Please enter the following 'extra' attributes to be sent with your certificate request
-A challenge password []: not necessary
-An optional company name []: not necessary
-----
-
-After you finished this certificate request you have to send the file
-`req.pem` to your Certification Authority (CA). The CA will issue the
-certificate (BASE64 encoded) based on your request – save this file as
-`cert.pem` to your Proxmox.
-
-To activate the new certificate, do the following on your Proxmox:
-
-----
-cat key.pem cert.pem >/etc/pmg/pmg-api.pem
-----
-
-The restart the API servers
-
-----
-systemctl restart pmgproxy
-----
-
-Test your new certificate by using your browser.
-
-NOTE: To transfer files from and to your Proxmox, you can use secure
-copy: If you desktop is Linux, you can use the `scp` command line
-tool. If your desktop PC is windows, please use a scp client like
-WinSCP (see http://winscp.net/).
+include::pmg-ssl-certificate.adoc[]
 
 
 [appendix]
diff --git a/pmg-ssl-certificate.adoc b/pmg-ssl-certificate.adoc
new file mode 100644 (file)
index 0000000..bddba6c
--- /dev/null
@@ -0,0 +1,55 @@
+SSL certificate
+---------------
+
+Access to the administration web interface is always done via
+`https`. The default certificate is never valid for your browser and
+you get always warnings.
+
+If you want to get rid of these warnings, you have to generate a valid
+certificate for your server.
+
+Login to your Proxmox via ssh or use the console:
+
+----
+openssl req -newkey rsa:2048 -nodes -keyout key.pem -out req.pem
+----
+
+Follow the instructions on the screen, see this example:
+
+----
+Country Name (2 letter code) [AU]: AT
+State or Province Name (full name) [Some-State]:Vienna
+Locality Name (eg, city) []:Vienna
+Organization Name (eg, company) [Internet Widgits Pty Ltd]: Proxmox GmbH
+Organizational Unit Name (eg, section) []:Proxmox Mail Gateway
+Common Name (eg, YOUR name) []: yourproxmox.yourdomain.com
+Email Address []:support@yourdomain.com
+
+Please enter the following 'extra' attributes to be sent with your certificate request
+A challenge password []: not necessary
+An optional company name []: not necessary
+----
+
+After you finished this certificate request you have to send the file
+`req.pem` to your Certification Authority (CA). The CA will issue the
+certificate (BASE64 encoded) based on your request – save this file as
+`cert.pem` to your Proxmox.
+
+To activate the new certificate, do the following on your Proxmox:
+
+----
+cat key.pem cert.pem >/etc/pmg/pmg-api.pem
+----
+
+The restart the API servers
+
+----
+systemctl restart pmgproxy
+----
+
+Test your new certificate by using your browser.
+
+NOTE: To transfer files from and to your Proxmox, you can use secure
+copy: If you desktop is Linux, you can use the `scp` command line
+tool. If your desktop PC is windows, please use a scp client like
+WinSCP (see http://winscp.net/).