Ana içeriğe geç

ONLYOFFICE Docs için JWT yapılandırma

Belgeleri yetkisiz erişimden korumak için ONLYOFFICE düzenleyicileri JSON Web Token (JWT) kullanır. Token, Belge Düzenleyici başlatılırken yapılandırmaya ve dahili ONLYOFFICE Docs hizmetleri arasındaki komut alışverişi sırasında eklenir. Gizli anahtar, JSON web token'ı imzalamak ve ONLYOFFICE Docs'a yapılan istekte token'ı doğrulamak için kullanılır.

not

ONLYOFFICE Docs v.7.2'den itibaren JWT varsayılan olarak etkindir ve gizli anahtar otomatik olarak oluşturulur. Parametreleri istediğiniz zaman ihtiyacınıza uygun olanlarla değiştirebilirsiniz. Önceki bir sürümden yükseltirken elle yapılandırılmış gizli anahtarlar korunur.

Belgelerinizi korumak için ONLYOFFICE Docs yapılandırma dosyasında kendi gizli anahtarınızı belirtin, ardından aynı gizli anahtarı bağlayıcı ayarlarında da belirtin. 7.2'den önceki bir sürüm kullanıyorsanız ayrıca token doğrulamasını etkinleştirmeniz gerekir.

Linux/Windows için: ONLYOFFICE Docs'u yapılandırma​

  1. local.json dosyasını herhangi bir metin düzenleyiciyle açın.

    • Linux için — /etc/onlyoffice/documentserver/local.json
    • Windows için — %ProgramFiles%\ONLYOFFICE\DocumentServer\config\local.json

  2. 7.2'den önceki bir sürüm kullanıyorsanız, üç bölümde false değerini true olarak değiştirerek token doğrulamasını etkinleştirin:

    • services.CoAuthoring.token.enable.browser
    • services.CoAuthoring.token.enable.request.inbox
    • services.CoAuthoring.token.enable.request.outbox

  3. Üç bölümde gizli değeri kendi metin dizinizle değiştirerek kendi gizli anahtarınızı belirtin. Gizli anahtar üç bölümde de aynı olmalıdır.

    • services.CoAuthoring.secret.inbox.string
    • services.CoAuthoring.secret.outbox.string
    • services.CoAuthoring.secret.session.string
    {
      "services": {
        "CoAuthoring": {
          "token": {
            "enable": {
              "request": {
                "inbox": true,
                "outbox": true
              },
              "browser": true
            }
          },
          "secret": {
            "inbox": {
              "string": "<your_secret_key>"
            },
            "outbox": {
              "string": "<your_secret_key>"
            },
            "session": {
              "string": "<your_secret_key>"
            }
          }
        }
      }
    }

  4. Değişikliklerinizi kaydedin.

  5. Yapılandırma değişikliklerinin geçerli olması için hizmetleri yeniden başlatın:

    Linux:

    systemctl restart ds-converter ds-docservice ds-metrics

    Windows:

    Get-Service | Where-Object { $_.DisplayName -like "*ONLYOFFICE*" } | Restart-Service -Force

Docker için: Ortam değişkenlerini kullanma​

Docker dağıtımlarında local.json dosyasını doğrudan düzenlemek yerine docker run komutunda ortam değişkenlerini kullanın.

Uyarı

/etc/onlyoffice/documentserver/local.json dosyasında otomatik olarak oluşturulan gizli anahtarı değiştirirseniz veya JWT'yi elle devre dışı bırakırsanız, sunucu yeniden başlatılırken JWT yeniden etkinleştirilir ve gizli anahtar yeniden oluşturulur. Docker dağıtımlarında JWT'yi yapılandırmak için her zaman ortam değişkenlerini kullanın.

Yeni ortam değişkenlerini uygulamak için kapsayıcıyı yeniden oluşturmanız gerekir. Mevcut kapsayıcıyı durdurup kaldırın, ardından güncellenmiş parametrelerle yenisini çalıştırın:

sudo docker stop documentserver
sudo docker rm documentserver
sudo docker run -i -t -d -p 80:80 \
  -e JWT_ENABLED=true \
  -e JWT_SECRET=<your_secret_key> \
  onlyoffice/documentserver

JWT'yi devre dışı bırakmak için bunun yerine -e JWT_ENABLED=false kullanın.