Ana içeriğe geç

ONLYOFFICE Docs'u HTTPS'e geçirme

Giriş​

ONLYOFFICE Docs'a çoğu durumda HTTPS protokolü üzerinden erişmek, varsayılan olarak kullanılan HTTP'ye göre çok daha güvenlidir. Düzenleyicilerin erişim yöntemini değiştirmek için bazı işlemler yapılması gerekir. ONLYOFFICE Docs'u HTTPS protokolüne geçirmek için aşağıdaki adımları izleyin.

certbot kullanarak ONLYOFFICE Docs'u HTTPS'e geçirme​

ONLYOFFICE Docs'u HTTPS'e geçirmenin en kolay yolu, certbot kullanarak Let's Encrypt SSL sertifikalarını otomatik olarak almaktır.

certbot'u kurun. Bu işlem, işletim sistemine (DEB veya RPM tabanlı) göre farklılık gösterir. İşletim sisteminize ait talimatları okumak için ilgili sekmeyi seçin:

Örneğin Ubuntu 20'de bu işlem aşağıdaki komutlarla yapılabilir:

sudo snap install --classic certbot
sudo ln -s /snap/bin/certbot /usr/bin/certbot

certbot makinenize kurulduktan sonra, e-posta adresinizi ve alan adınızı belirterek betiği çalıştırın:

sudo bash /usr/bin/documentserver-letsencrypt.sh email@example.com yourdomain.com

Betik, letsencrypt.org CA tarafından imzalanmış sertifikayı otomatik olarak oluşturup sunucunuza kurar ve değişikliklerin geçerli olması için NGINX hizmetini yeniden başlatır.

Artık ONLYOFFICE Docs'a https://yourdomain.com adresinden erişebilmeniz gerekir.

ONLYOFFICE Docs v5.3 ve sonraki sürümlerini HTTPS'e geçirme​

ONLYOFFICE Docs'u HTTPS protokolüne geçirmeye başlamadan önce bir güvenlik sertifikası ve sertifikanın özel anahtarını oluşturmanız gerekir. Bunları ONLYOFFICE Docs'un kurulu olduğu bilgisayardaki bir klasöre koyun.

Sertifikaya sahip olduktan sonra aşağıdaki adımlarla devam edin:

  1. NGINX hizmetini durdurun:

    sudo service nginx stop

  2. ds-ssl.conf.tmpl dosyasını aşağıdaki komutla ds.conf dosyasına kopyalayın:

    sudo cp -f /etc/onlyoffice/documentserver/nginx/ds-ssl.conf.tmpl /etc/onlyoffice/documentserver/nginx/ds.conf

  3. /etc/onlyoffice/documentserver/nginx/ds.conf dosyasını düzenleyin ve çift küme parantezi içindeki tüm parametreleri {{...}} gerçek değerlerle değiştirin:

    • {{SSL_CERTIFICATE_PATH}} - edindiğiniz 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ğrulanmasının etkin olup olmadığı (kullanılabilir değerler: on, off, optional ve optional_no_ca);
    • {{CA_CERTIFICATES_PATH}} - önceki parametreyle etkinleştirilmişse doğrulanacak istemci sertifikasının yolu;
    • {{ONLYOFFICE_HTTPS_HSTS_MAXAGE}} - ONLYOFFICE Docs NGINX vHost yapılandırmasında HSTS max-age değerini ayarlamak için gelişmiş yapılandırma seçeneği; yalnızca SSL kullanıldığında geçerlidir (varsayılan değer genellikle yeterince güvenli kabul edilen 31536000'dir);
    • {{SSL_DHPARAM_PATH}} - Diffie-Hellman parametresinin yolu;

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

  4. Tüm değişiklikleri yaptıktan sonra 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.

  5. Aşağıdaki betiği çalıştırın:

    sudo bash /usr/bin/documentserver-update-securelink.sh