Ana içeriğe geç

Windows için ONLYOFFICE Docs Developer Edition'ı HTTPS'e geçirme

Giriş​

Çoğu durumda düzenleyicilere HTTPS protokolü üzerinden erişmek, varsayılan olarak kullanılan HTTP'ye göre çok daha güvenlidir. Ancak düzenleyicilerin erişim yöntemini değiştirmek için bazı işlemlerin yapılması gerekir. ONLYOFFICE Docs'u HTTPS protokolüne nasıl geçireceğinizi öğrenmek için aşağıdaki adımları izleyin.

ONLYOFFICE Docs v5.3 ve sonraki sürümlerini HTTPS'e 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. Aşağıdaki komutu kullanarak %ProgramFiles%\ONLYOFFICE\DocumentServer\nginx\conf\ds-ssl.conf.tmpl dosyasını %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üzenleyin ve çift küme parantezi içindeki tüm {{...}} parametreleri gerçekte kullanılacak değerlerle değiştirin:

    not

    Ters eğik çizgi karakterlerinin ( \ ) şu yöntemlerden biriyle kaçırı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}} - bir ö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 kullanılan gelişmiş 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;

    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 ve v5.2'yi HTTPS'e geçirme​

ONLYOFFICE Docs v4.3/v5.2'yi HTTPS'e 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. Aşağıdaki komutu kullanarak %ProgramFiles%\ONLYOFFICE\DocumentServer\nginx-1.11.4\conf\onlyoffice-documentserver-ssl.conf.template dosyasını %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üzenleyin ve çift küme parantezi içindeki tüm {{...}} parametreleri gerçekte kullanılacak değerlerle değiştirin...