メインコンテンツまでスキップ

ONLYOFFICE Workspace CommunityをHTTPSプロトコルに切り替える

はじめに​

ほとんどの場合、HTTPSプロトコルを使用してポータルにアクセスする方が、デフォルトで使用されているHTTPよりもはるかに安全です。ただし、ポータルのアクセス方法を変更するには、特定の操作を行う必要があります。以下の手順に従って、ONLYOFFICE Workspace をHTTPSに切り替える方法をご確認ください。

セキュリティ証明書と秘密鍵の作成​

ONLYOFFICE Workspace Community をHTTPSに切り替える前に、セキュリティ証明書と証明書の秘密鍵を作成する必要があります。

letsencryptサービスを使用してSSL証明書を自動的に生成するには、この記事を参照してください。

証明書を取得したら、以下の手順に進みます。

スクリプトを使用してONLYOFFICE Workspace CommunityをHTTPSに切り替える​

ONLYOFFICE Workspace Community をHTTPSに切り替える最も速い方法は、スクリプトを使用することです。スクリプトは次の場所にあります。

/var/www/onlyoffice/Tools/default-onlyoffice-ssl.sh

作成した証明書を /var/www/onlyoffice/Data/certs/ ディレクトリに配置します。そこには次の2つのファイルが必要です。

  • /var/www/onlyoffice/Data/certs/onlyoffice.crt
  • /var/www/onlyoffice/Data/certs/onlyoffice.key

次に、スクリプトを実行します。

sudo bash /var/www/onlyoffice/Tools/default-onlyoffice-ssl.sh

ONLYOFFICE Workspace Community のインストールをHTTPSに切り替えるために必要なすべての処理が実行されます。

ONLYOFFICE Workspace Communityを手動でHTTPSに切り替える​

スクリプトのすべての操作を手動で実行できます。そのためには、以下の手順に従います。

  1. NGINXサービスを停止します。

    sudo service nginx stop

  2. /etc/nginx/includes/onlyoffice-communityserver-common-ssl.conf.template ファイルを、Debianベースのシステムでは /etc/nginx/sites-available/onlyoffice ファイルに、RPMベースのシステムでは /etc/nginx/conf.d/onlyoffice.conf にコピーします。

    Debian ベースのシステムでは、次のコマンドを使用します。

    sudo cp -f /etc/nginx/includes/onlyoffice-communityserver-common-ssl.conf.template /etc/nginx/sites-available/onlyoffice

    RPM ベースのシステムでは、次のコマンドを使用します。

    sudo cp -f /etc/nginx/includes/onlyoffice-communityserver-common-ssl.conf.template /etc/nginx/conf.d/onlyoffice.conf

  3. Debianベースのシステムでは /etc/nginx/sites-available/onlyoffice ファイルを、RPMベースのシステムでは /etc/nginx/conf.d/onlyoffice.conf ファイルを編集します。二重中括弧 {{...}} で囲まれたすべてのパラメータを、実際に使用する値に変更します。

    • {{SSL_CERTIFICATE_PATH}}：お持ちのSSL証明書へのパス。
    • {{SSL_KEY_PATH}}：SSL証明書の秘密鍵へのパス。
    • {{SSL_VERIFY_CLIENT}}：クライアント証明書の検証を有効にするかどうか（使用可能な値は on、off、optional、optional_no_ca）。
    • {{CA_CERTIFICATES_PATH}}：クライアント証明書へのパス。前のパラメータで有効にした場合に検証されます。
    • {{ONLYOFFICE_HTTPS_HSTS_MAXAGE}}：ONLYOFFICE Workspace Community のNGINX vHost構成でHSTSのmax-ageを設定するための高度な構成オプション。SSLを使用している場合にのみ適用されます（通常、デフォルトは 31536000 で、十分に安全と見なされています）。
    • {{SSL_DHPARAM_PATH}}：Diffie-Hellmanパラメータへのパス。
    • {{ONLYOFFICE_NGINX_KEEPLIVE}}：各ワーカープロセスのキャッシュに保持される、アップストリームサーバーへのアイドル状態のkeep-alive接続の最大数（このパラメータの詳細については、NGINXドキュメントを参照してください）。
    • {{DOCKER_ONLYOFFICE_SUBNET}}：Dockerの内部サブネットの値（ONLYOFFICE Workspace Community をDockerでインストールしている場合）。
    • {{SSL_OCSP_CERTIFICATE_PATH}}：ssl_stapling が有効な場合に、クライアント証明書とOCSP（Online Certificate Status Protocol）応答を検証するために使用される、PEM形式の信頼できるCA証明書を含むファイルへのパス。

    構成ファイルで使用されるSSLパラメータの詳細については、NGINXドキュメントを参照してください。

  4. /var/www/onlyoffice/Services/MailAggregator/ASC.Mail.Aggregator.CollectionService.exe.config 構成ファイルを開き、mail.default-api-scheme パラメータの値を https に設定します。その後、メールアグリゲーターサービスを再起動します。

    onlyofficeMailAggregator restart

  5. Talk をTLSプロトコルに切り替えます。

  6. すべての変更が完了したら、NGINXサービスを再度起動できます。

    sudo service nginx start
    注記

    ポータルを正しく動作させるには、ポート443を開く必要があります。