Ana içeriğe geç

Linux için ONLYOFFICE Workspace Community'yi HTTPS'e geçirme

Giriş​

Çoğu durumda portala HTTPS protokolüyle erişmek, varsayılan olarak kullanılan HTTP'ye göre çok daha güvenlidir. Ancak portal erişim yöntemini değiştirmek için bazı işlemler yapmak gerekir. ONLYOFFICE Workspace'inizi HTTPS'e nasıl geçireceğinizi öğrenmek için aşağıdaki adımları izleyin.

Güvenlik sertifikası ve özel anahtar oluşturma​

ONLYOFFICE Workspace Community'yi HTTPS'e geçirmeye başlamadan önce bir güvenlik sertifikası ve sertifikanın özel anahtarını oluşturmanız gerekir.

letsencrypt hizmetini kullanarak SSL sertifikasını otomatik olarak oluşturmak için bu makaleye bakın.

Sertifikayı edindikten sonra aşağıdaki adımlara geçin.

ONLYOFFICE Workspace Community'yi betikle HTTPS'e geçirme​

ONLYOFFICE Workspace Community'yi HTTPS'e geçirmenin en hızlı yolu betiği kullanmaktır. Betik şu konumdadır:

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

Oluşturduğunuz sertifikaları /var/www/onlyoffice/Data/certs/ dizinine yerleştirin. Orada iki dosya bulunmalıdır:

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

Ardından betiği çalıştırın:

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

Betik, ONLYOFFICE Workspace Community kurulumunuzu HTTPS'e geçirmek için gereken her şeyi yapar.

ONLYOFFICE Workspace Community'yi elle HTTPS'e geçirme​

Betiğin tüm işlemlerini elle de yapabilirsiniz. Bunun için aşağıdaki adımları izleyin:

  1. NGINX hizmetini durdurun:

    sudo service nginx stop

  2. /etc/nginx/includes/onlyoffice-communityserver-common-ssl.conf.template dosyasını Debian tabanlı sistemlerde /etc/nginx/sites-available/onlyoffice dosyasına, RPM tabanlı sistemlerde ise /etc/nginx/conf.d/onlyoffice.conf dosyasına kopyalayın.

    Debian tabanlı sistemler için şu komutu kullanın:

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

    RPM tabanlı sistemler için şu komutu kullanın:

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

  3. Debian tabanlı sistemlerde /etc/nginx/sites-available/onlyoffice dosyasını, RPM tabanlı sistemlerde /etc/nginx/conf.d/onlyoffice.conf dosyasını düzenleyin. Çift süslü parantez içindeki tüm parametreleri {{...}} gerçekte kullanılan değerlerle değiştirin:

    • {{SSL_CERTIFICATE_PATH}}: elinizdeki SSL sertifikasının yolu;
    • {{SSL_KEY_PATH}}: SSL sertifikasının özel anahtarının yolu;
    • {{SSL_VERIFY_CLIENT}}: istemci sertifikalarının doğrulanıp doğrulanmayacağı (kullanılabilir değerler: on, off, optional ve optional_no_ca);
    • {{CA_CERTIFICATES_PATH}}: önceki parametreyle etkinleştirilirse doğrulanacak istemci sertifikasının yolu;
    • {{ONLYOFFICE_HTTPS_HSTS_MAXAGE}}: ONLYOFFICE Workspace Community NGINX vHost yapılandırmasında HSTS max-age değerini ayarlamak için gelişmiş bir yapılandırma seçeneği; yalnızca SSL kullanıldığında geçerlidir (genellikle varsayılan değeri 31536000 olup yeterince güvenli kabul edilir);
    • {{SSL_DHPARAM_PATH}}: Diffie-Hellman parametresinin yolu;
    • {{ONLYOFFICE_NGINX_KEEPLIVE}}: her çalışan işlemin önbelleğinde korunan, yukarı akış sunucularına açık boşta keep-alive bağlantılarının en fazla sayısı (bu parametre hakkında daha fazla bilgi için NGINX belgelerine bakın);
    • {{DOCKER_ONLYOFFICE_SUBNET}}: Docker iç alt ağ değeri (ONLYOFFICE Workspace Community Docker ile kurulduysa);
    • {{SSL_OCSP_CERTIFICATE_PATH}}: ssl_stapling etkinse istemci sertifikalarını ve OCSP (Online Certificate Status Protocol) yanıtlarını doğrulamak için kullanılan, PEM biçiminde güvenilir CA sertifikaları içeren dosyanın yolu.

    Yapılandırma dosyasında kullanılan SSL parametreleri hakkında daha fazla bilgi için NGINX belgelerine bakın.

  4. /var/www/onlyoffice/Services/MailAggregator/ASC.Mail.Aggregator.CollectionService.exe.config yapılandırma dosyasını açın ve mail.default-api-scheme parametresinin değerini https olarak ayarlayın. Ardından posta toplayıcı hizmetini yeniden başlatın:

    onlyofficeMailAggregator restart

  5. Talk'u TLS protokolüne geçirin.

  6. Tüm değişiklikler yapıldığında NGINX hizmetini yeniden başlatabilirsiniz:

    sudo service nginx start
    not

    Portalın doğru çalışması için 443 numaralı bağlantı noktası açık olmalıdır.