diff --git a/Web/Controls/Help/Installation/Docs.ascx b/Web/Controls/Help/Installation/Docs.ascx index 41ce94dd9..7af2c6691 100644 --- a/Web/Controls/Help/Installation/Docs.ascx +++ b/Web/Controls/Help/Installation/Docs.ascx @@ -52,6 +52,7 @@
  • ">Connecting Oracle database to ONLYOFFICE Docs
  • ">Connecting MsSQL database to ONLYOFFICE Docs
  • +
  • ">Connecting MySQL database with SSL/TLS to ONLYOFFICE Docs
  • System requirements
    @@ -173,6 +174,7 @@
  • ">Connecting Oracle database to ONLYOFFICE Docs
  • ">Connecting MsSQL database to ONLYOFFICE Docs
  • +
  • ">Connecting MySQL database with SSL/TLS to ONLYOFFICE Docs
  • System requirements
    @@ -285,6 +287,7 @@
  • ">Connecting Oracle database to ONLYOFFICE Docs
  • ">Connecting MsSQL database to ONLYOFFICE Docs
  • +
  • ">Connecting MySQL database with SSL/TLS to ONLYOFFICE Docs
  • Developing
    diff --git a/Web/Controls/Help/Installation/DocsCommunity.ascx b/Web/Controls/Help/Installation/DocsCommunity.ascx index 98b602cd2..21e21c342 100644 --- a/Web/Controls/Help/Installation/DocsCommunity.ascx +++ b/Web/Controls/Help/Installation/DocsCommunity.ascx @@ -50,6 +50,7 @@
  • ">Connecting Oracle database to ONLYOFFICE Docs
  • ">Connecting MsSQL database to ONLYOFFICE Docs
  • +
  • ">Connecting MySQL database with SSL/TLS to ONLYOFFICE Docs
  • System requirements
    diff --git a/Web/Controls/Help/Installation/DocsDeveloper.ascx b/Web/Controls/Help/Installation/DocsDeveloper.ascx index 017f7619d..89ba6101b 100644 --- a/Web/Controls/Help/Installation/DocsDeveloper.ascx +++ b/Web/Controls/Help/Installation/DocsDeveloper.ascx @@ -43,6 +43,7 @@
  • ">Connecting Oracle database to ONLYOFFICE Docs
  • ">Connecting MsSQL database to ONLYOFFICE Docs
  • +
  • ">Connecting MySQL database with SSL/TLS to ONLYOFFICE Docs
  • Developing
    diff --git a/Web/Controls/Help/Installation/DocsEnterprise.ascx b/Web/Controls/Help/Installation/DocsEnterprise.ascx index 66a7bc9d6..f02822714 100644 --- a/Web/Controls/Help/Installation/DocsEnterprise.ascx +++ b/Web/Controls/Help/Installation/DocsEnterprise.ascx @@ -42,6 +42,7 @@
  • ">Connecting Oracle database to ONLYOFFICE Docs
  • ">Connecting MsSQL database to ONLYOFFICE Docs
  • +
  • ">Connecting MySQL database with SSL/TLS to ONLYOFFICE Docs
  • System requirements
    diff --git a/Web/Controls/Help/Server/Document/DocsConnectMySql/DocsConnectMySql.ascx b/Web/Controls/Help/Server/Document/DocsConnectMySql/DocsConnectMySql.ascx new file mode 100644 index 000000000..bcdd63bce --- /dev/null +++ b/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" %> + + + +
    +
    +

    Connecting MySQL database with SSL/TLS to ONLYOFFICE Docs

    + +

    If you want to use secure SSL/TLS connections with MySQL when connecting to ONLYOFFICE Docs, follow these steps:

    +
      +
    1. If MySQL is installed with SSL enabled, it provides self-signed certificates in /var/lib/mysql/ including the certificate authority ca.pem certificate, server certificates and client certificates: ca-key.pem, ca.pem, client-cert.pem, client-key.pem, private_key.pem, public_key.pem, server-cert.pem, server-key.pem. +

      To connect via SSL, only ca.pem is required, but for additional protection and establishing trust, it is recommended to use client-cert.pem and client-key.pem. They must be converted to a string, for example, in the following way:

      +
      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
      +
      +
    2. +
    3. + Add the certificate to the document server local.json config: +
      {
      +  "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"
      +          }
      +        }
      +...
      +
      +
    4. +
    5. Restart services: +
      systemctl restart ds-converter ds-docservice ds-example ds-metrics
      +
    6. +
    +
    +
    \ No newline at end of file diff --git a/Web/installation/docs-connect-mysql-with-ssl.aspx b/Web/installation/docs-connect-mysql-with-ssl.aspx new file mode 100644 index 000000000..9653be46b --- /dev/null +++ b/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" %> + + + + + + + + + + +
    + \ No newline at end of file