Add new article "Connecting MySQL database with SSL/TLS to ONLYOFFICE Docs"

Web/Controls/Help/Installation/Docs.ascx

@@ -52,6 +52,7 @@
                     <li><cc:LocalizeContent runat="Server" ControlName="~/Controls/Help/ArticlesCompleteList/TipsTricks/181_connect_dameng.ascx" /></li>
                     <li><a href="<%=VirtualPathUtility.ToAbsolute("~/installation/docs-community-connect-oracle.aspx")%>">Connecting Oracle database to ONLYOFFICE Docs</a></li>
                     <li><a href="<%=VirtualPathUtility.ToAbsolute("~/installation/docs-community-connect-mssql.aspx")%>">Connecting MsSQL database to ONLYOFFICE Docs</a></li>
+                    <li><a href="<%=VirtualPathUtility.ToAbsolute("~/installation/docs-connect-mysql-with-ssl.aspx")%>">Connecting MySQL database with SSL/TLS to ONLYOFFICE Docs</a></li>
                 </ul>
             </li>
             <li><h6>System requirements</h6>
@@ -173,6 +174,7 @@
                     <li><cc:LocalizeContent runat="Server" ControlName="~/Controls/Help/ArticlesCompleteList/TipsTricks/181_connect_dameng.ascx" /></li>
                     <li><a href="<%=VirtualPathUtility.ToAbsolute("~/installation/docs-enterprise-connect-oracle.aspx")%>">Connecting Oracle database to ONLYOFFICE Docs</a></li>
                     <li><a href="<%=VirtualPathUtility.ToAbsolute("~/installation/docs-enterprise-connect-mssql.aspx")%>">Connecting MsSQL database to ONLYOFFICE Docs</a></li>
+                    <li><a href="<%=VirtualPathUtility.ToAbsolute("~/installation/docs-connect-mysql-with-ssl.aspx")%>">Connecting MySQL database with SSL/TLS to ONLYOFFICE Docs</a></li>
                 </ul>
             </li>    
             <li><h6>System requirements</h6>
@@ -285,6 +287,7 @@
                     <li><cc:LocalizeContent runat="Server" ControlName="~/Controls/Help/ArticlesCompleteList/TipsTricks/181_connect_dameng.ascx" /></li>
                     <li><a href="<%=VirtualPathUtility.ToAbsolute("~/installation/docs-developer-connect-oracle.aspx")%>">Connecting Oracle database to ONLYOFFICE Docs</a></li>
                     <li><a href="<%=VirtualPathUtility.ToAbsolute("~/installation/docs-developer-connect-mssql.aspx")%>">Connecting MsSQL database to ONLYOFFICE Docs</a></li>
+                    <li><a href="<%=VirtualPathUtility.ToAbsolute("~/installation/docs-connect-mysql-with-ssl.aspx")%>">Connecting MySQL database with SSL/TLS to ONLYOFFICE Docs</a></li>
                 </ul>
             </li>
             <li><h6>Developing</h6>

Web/Controls/Help/Installation/DocsCommunity.ascx

@@ -50,6 +50,7 @@
                     <li><cc:LocalizeContent runat="Server" ControlName="~/Controls/Help/ArticlesCompleteList/TipsTricks/181_connect_dameng.ascx" /></li>
                     <li><a href="<%=VirtualPathUtility.ToAbsolute("~/installation/docs-community-connect-oracle.aspx")%>">Connecting Oracle database to ONLYOFFICE Docs</a></li>
                     <li><a href="<%=VirtualPathUtility.ToAbsolute("~/installation/docs-community-connect-mssql.aspx")%>">Connecting MsSQL database to ONLYOFFICE Docs</a></li>
+                    <li><a href="<%=VirtualPathUtility.ToAbsolute("~/installation/docs-connect-mysql-with-ssl.aspx")%>">Connecting MySQL database with SSL/TLS to ONLYOFFICE Docs</a></li>
                 </ul>
             </li>
             <li><h6>System requirements</h6>

Web/Controls/Help/Installation/DocsDeveloper.ascx

@@ -43,6 +43,7 @@
                     <li><cc:LocalizeContent runat="Server" ControlName="~/Controls/Help/ArticlesCompleteList/TipsTricks/181_connect_dameng.ascx" /></li>
                     <li><a href="<%=VirtualPathUtility.ToAbsolute("~/installation/docs-developer-connect-oracle.aspx")%>">Connecting Oracle database to ONLYOFFICE Docs</a></li>
                     <li><a href="<%=VirtualPathUtility.ToAbsolute("~/installation/docs-developer-connect-mssql.aspx")%>">Connecting MsSQL database to ONLYOFFICE Docs</a></li>
+                    <li><a href="<%=VirtualPathUtility.ToAbsolute("~/installation/docs-connect-mysql-with-ssl.aspx")%>">Connecting MySQL database with SSL/TLS to ONLYOFFICE Docs</a></li>
                 </ul>
             </li>
             <li><h6>Developing</h6>

Web/Controls/Help/Installation/DocsEnterprise.ascx

@@ -42,6 +42,7 @@
                     <li><cc:LocalizeContent runat="Server" ControlName="~/Controls/Help/ArticlesCompleteList/TipsTricks/181_connect_dameng.ascx" /></li>
                     <li><a href="<%=VirtualPathUtility.ToAbsolute("~/installation/docs-enterprise-connect-oracle.aspx")%>">Connecting Oracle database to ONLYOFFICE Docs</a></li>
                     <li><a href="<%=VirtualPathUtility.ToAbsolute("~/installation/docs-enterprise-connect-mssql.aspx")%>">Connecting MsSQL database to ONLYOFFICE Docs</a></li>
+                    <li><a href="<%=VirtualPathUtility.ToAbsolute("~/installation/docs-connect-mysql-with-ssl.aspx")%>">Connecting MySQL database with SSL/TLS to ONLYOFFICE Docs</a></li>
                 </ul>
             </li>    
             <li><h6>System requirements</h6>

Web/Controls/Help/Server/Document/DocsConnectMySql/DocsConnectMySql.ascx

@@ -0,0 +1,53 @@
+<%@ Control Language="C#" Inherits="BaseContentUserControls"%>
+<%@ Register Namespace="TeamLab.Controls" Assembly="__Code" TagPrefix="cc" %>
+
+<script runat="server">
+    protected override void Init()
+    {
+        PageTitle = PageCaption = "Connecting MySQL database with SSL/TLS to ONLYOFFICE Docs";
+        MetaKeyWords = "mysql, ssl, tls, database, editors";
+        MetaDescription = "Connecting MySQL database with SSL/TLS";            
+    }
+</script>
+
+<div class="main_buscall_container dataBackup">
+<div class="MainHelpCenter">     
+     <h1 class="subHeaderFeaturesCaption TipsCaption">Connecting MySQL database with SSL/TLS to ONLYOFFICE Docs</h1>
+	
+    <p>If you want to use secure SSL/TLS connections with MySQL when connecting to ONLYOFFICE Docs, follow these steps:</p>
+    <ol>   
+        <li>If MySQL is installed with SSL enabled, it provides self-signed certificates in <code>/var/lib/mysql/</code> including the certificate authority <code>ca.pem</code> certificate, server certificates and client certificates: <code>ca-key.pem</code>, <code>ca.pem</code>, <code>client-cert.pem</code>, <code>client-key.pem</code>, <code>private_key.pem</code>, <code>public_key.pem</code>, <code>server-cert.pem</code>, <code>server-key.pem</code>.     
+        <p>To connect via SSL, only <code>ca.pem</code> is required, but for additional protection and establishing trust, it is recommended to use <code>client-cert.pem</code> and <code>client-key.pem</code>. They must be converted to a string, for example, in the following way:</p>
+                <pre><code>awk 'NF {sub(/\r/, ""); printf "%s\\n",$0;}' ca.pem
+awk 'NF {sub(/\r/, ""); printf "%s\\n",$0;}' client-cert.pem
+awk 'NF {sub(/\r/, ""); printf "%s\\n",$0;}' client-key.pem
+</code></pre>
+        </li>
+        <li>
+            Add the certificate to the document server <code>local.json</code> config:
+            <pre><code>{
+  "services": {
+    "CoAuthoring": {
+      "sql": {
+        "type": "mysql",
+        "dbHost": "onlyoffice.local",
+        "dbPort": "3306",
+        "dbName": "onlyoffice",
+        "dbUser": "onlyoffice",
+        "dbPass": "onlyoffice",
+        "mysqlExtraOptions": {
+          "ssl": {
+            "ca": "-----BEGIN CERTIFICATE-----\n...ca.pem...\n-----END CERTIFICATE-----\n\n",
+            "cert": "-----BEGIN CERTIFICATE-----\n...client-cert.pem...-----END CERTIFICATE-----\n\n",
+            "key": "-----BEGIN RSA PRIVATE KEY-----\n...client-key.pem...\n-----END RSAD RSA PRIVATE KEY-----\n\n"
+          }
+        }
+...
+</code></pre>
+        </li>
+        <li>Restart services:
+            <pre><code>systemctl restart ds-converter ds-docservice ds-example ds-metrics</code></pre>
+        </li>
+    </ol>
+</div>
+</div>

Web/installation/docs-connect-mysql-with-ssl.aspx

@@ -0,0 +1,14 @@
+<%@ Page Title="" Language="C#" MasterPageFile="~/Masters/InstallationGuides/InstallationDocsArticles.master" %>
+<%@ Register Namespace="TeamLab.Controls" Assembly="__Code" TagPrefix="cc" %>
+<asp:Content ID="Content4" ContentPlaceHolderID="pagebodyidpage" runat="Server">
+    <body class="common_all_os document_server installation_docs">
+</asp:Content>
+<asp:Content ID="content3" ContentPlaceHolderID="breadstop" runat="server">
+	<cc:LocalizeContent runat="Server" ControlName="~/Controls/Help/VariousControls/TopControls/DocumentServerTop/DocumentServerTop.ascx" />
+</asp:Content>
+<asp:Content ID="Content1" ContentPlaceHolderID="content" runat="Server">
+	<cc:LocalizeContent runat="Server" ControlName="~/Controls/Help/Server/Document/DocsConnectMySql/DocsConnectMySql.ascx" />
+</asp:Content>
+<asp:Content ID="content2" ContentPlaceHolderID="leftmenupage" runat="server">
+    <div class="guidespage document">
+</asp:Content>