Ana içeriğe geç

ONLYOFFICE Docs için IP filtresi yapılandırma

ONLYOFFICE Docs için IP filtresini yapılandırabilirsiniz.

IP filtresi ayarları, ONLYOFFICE Docs yapılandırma dosyasında saklanır: /etc/onlyoffice/documentserver/default.json. Ayarlar şu şekildedir:

"ipfilter": {
       "rules": [
         {
           "address": "ip_address",
           "allowed": true
         },
         {
           "address": "*",
           "allowed": false
         }
       ],
       "useforrequest": false,
       "errorcode": 403
     }
not

default.json dosyasındaki parametreleri değiştirirseniz, tüm değişiklikler ONLYOFFICE Docs güncellemesinden veya Docker kapsayıcısının yeniden başlatılmasından sonra kaybolur. Değişikliklerinizin güncellemeden sonra da korunması için yapıyı koruyarak /etc/onlyoffice/documentserver/local.json dosyasını düzenleyin.

Bir kural iki bölümden oluşur: ana bilgisayar adı ve true veya false değerini alan allowed kuralının kendisi. Varsayılan olarak tek bir kural vardır: address * allowed true.

Adres şu yollarla belirtilebilir:

  • ipv4 için X.X.X.X biçiminde bir IP adresi.
  • ipv6 için xxxx:xxxx:xxxx:xxxx:xxxx:xxxx:xxxx:xxxx biçiminde bir IP adresi.
  • Bir DNS adı.

* joker karakterini kullanmak da mümkündür. Bu karakter, herhangi bir karakterin herhangi bir sayıda tekrarının yerine geçer.

Bağlantılardaki ana bilgisayar adı önce DNS adresi olarak denetlenir. Hiçbir kuralla eşleşmezse, ad üzerinden IP adresi bulunur ve denetim bir kez daha yapılır.

Önemli

"useforrequest": true denetimi etkinleştirilmişse, address parametresi DNS adı değil, IP adresi olarak belirtilmelidir.

"useforrequest": true/false​

Varsayılan olarak useforrequest parametresi false değerine ayarlıdır. Bu durumda ONLYOFFICE Docs'a parametre olarak gelen metin URL'leri denetlenir:

useforrequest parametresi true olarak ayarlanırsa (önerilmez), aşağıdaki http isteklerinde istemci IP adresi de ayrıca denetlenir:

  • coauthoring/CommandService.ashx
  • ConvertService.ashx
  • converter
  • FileUploader.ashx
  • healthcheck
  • docbuilder
  • info/info.json
  • internal/cluster/inactive
  • hosting/discovery
  • hosting/capabilities
  • lool/convert-to/:format?
  • dummyCallback

Bu isteklerde errorcode parametresinde belirtilen kodla bir hata döndürülür.

Önemli

Yalnızca ONLYOFFICE Docs'un görebildiği depolamanın IP adresi denetlenir (x-forwarded üstbilgileri dikkate alınarak).

Örneğin, ONLYOFFICE Docs ve test örneği aynı makineye kuruluysa, istemci IP adresi iç ağın adresi olur. ONLYOFFICE Docs istemcinin ana bilgisayarını öğrenemez, bu nedenle bu ayarla address alanında DNS adı kullanmak mümkün değildir. Bu ayarı varsayılan değerinde bırakmanız ve denetimleri proxy düzeyinde yapmanız önerilir.