Ana içeriğe geç

Windows için ONLYOFFICE Docs Enterprise Edition'ı HTTPS'ye geçirme

Giriş​

Çoğu durumda düzenleyicilere varsayılan olarak kullanılan HTTP yerine HTTPS protokolüyle erişmek çok daha güvenlidir. Ancak düzenleyicilerin erişim yöntemini değiştirmek için bazı işlemler yapmanız gerekir. ONLYOFFICE Docs'u HTTPS protokolüne geçirmek için aşağıdaki adımları izleyin.

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

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

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

not

Tüm komutlar yönetici ayrıcalıklarıyla çalıştırılmalıdır. Komut istemini yönetici olarak başlatmak için masaüstünün sol alt köşesindeki Başlat menüsü düğmesine sağ tıklayın ve Komut İstemi (Yönetici) seçeneğine tıklayın.

  1. ONLYOFFICE DocumentServer Proxy hizmetini durdurun:

    net stop DsProxySvc

  2. %ProgramFiles%\ONLYOFFICE\DocumentServer\nginx\conf\ds-ssl.conf.tmpl dosyasını aşağıdaki komutla %ProgramFiles%\ONLYOFFICE\DocumentServer\nginx\conf\ds.conf dosyasına kopyalayın:

    COPY /Y "%ProgramFiles%\ONLYOFFICE\DocumentServer\nginx\conf\ds-ssl.conf.tmpl" "%ProgramFiles%\ONLYOFFICE\DocumentServer\nginx\conf\ds.conf"

  3. %ProgramFiles%\ONLYOFFICE\DocumentServer\nginx\conf\ds.conf dosyasını düzenleyerek çift küme parantezi içindeki tüm {{...}} parametreleri gerçekte kullandığınız değerlerle değiştirin:

    not

    Ters eğik çizgi karakterlerinin ( \ ) şu yollardan biriyle kaçış karakteriyle yazılması gerektiğini unutmayın: C:\\yourfolder\\certificates\\onlyoffice.key veya C:/yourfolder/certificates/onlyoffice.key. Yolda boşluk varsa yolun tamamını tırnak içine almanız gerekir, örneğin: "C:/yourfolder/my certificates/onlyoffice.key".

    • {{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 (genellikle varsayılan değeri 31536000'dir ve yeterince güvenli kabul edilir);
    • {{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 ONLYOFFICE DocumentServer Proxy hizmetini yeniden başlatabilirsiniz:

    net start DsProxySvc
    not

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

  5. %ProgramFiles%\ONLYOFFICE\DocumentServer\bin\documentserver-update-securelink.bat dosyasını çalıştırın.

ONLYOFFICE Docs v4.3–v5.2 sürümlerini HTTPS'ye geçirme​

ONLYOFFICE Docs v4.3/v5.2 sürümlerini HTTPS'ye geçirmek için yukarıdaki tüm adımları uygulayın. Yalnızca ikinci ve üçüncü adımların farklı olduğuna ve şu şekilde olması gerektiğine dikkat edin:

  1. %ProgramFiles%\ONLYOFFICE\DocumentServer\nginx-1.11.4\conf\onlyoffice-documentserver-ssl.conf.template dosyasını aşağıdaki komutla %ProgramFiles%\ONLYOFFICE\DocumentServer\nginx-1.11.4\conf\onlyoffice-documentserver.conf dosyasına kopyalayın:

    COPY /Y "%ProgramFiles%\ONLYOFFICE\DocumentServer\nginx-1.11.4\conf\onlyoffice-documentserver-ssl.conf.template" "%ProgramFiles%\ONLYOFFICE\DocumentServer\nginx-1.11.4\conf\onlyoffice-documentserver.conf"

  2. %ProgramFiles%\ONLYOFFICE\DocumentServer\nginx-1.11.4\conf\onlyoffice-documentserver.conf dosyasını düzenleyerek çift küme parantezi içindeki tüm {{...}} parametreleri gerçekte kullandığınız değerlerle değiştirin...