Ana içeriğe geç

ONLYOFFICE Docs'un Windows kurulumunu 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.

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:

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üzenleyin ve çift küme parantezi içindeki tüm parametreleri {{...}} gerçek değerlerle değiştirin:

    not

    Ters eğik çizgi karakterlerinin ( \ ) şu yollardan biriyle kaçırılması gerektiğini unutmayın: C:\\yourfolder\\certificates\\onlyoffice.key veya C:/yourfolder/certificates/onlyoffice.key. Yolda boşluk varsa, yolu 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 (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şiklikler kaydedildikten sonra ONLYOFFICE DocumentServer Proxy hizmetini yeniden başlatın:

    net start DsProxySvc
    not

    ONLYOFFICE Docs'un 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'yi HTTPS'e geçirme​

not

Bu talimatlar ONLYOFFICE Docs'un eski sürümleri (v4.3–v5.2) için geçerlidir. En son sürüme yükseltmenizi öneririz. Yükseltemiyorsanız, 2. ve 3. adımların aşağıda açıklandığı gibi farklı olduğunu dikkate alarak bu adımları yukarıdaki ana talimatlarla birlikte uygulayın.

  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üzenleyin ve çift küme parantezi içindeki tüm parametreleri {{...}} yukarıdaki 3. adımda açıklandığı gibi gerçek değerlerle değiştirin.