Zum Hauptinhalt springen

JWT für ONLYOFFICE Docs konfigurieren

Um Dokumente vor unbefugtem Zugriff zu schützen, verwenden ONLYOFFICE-Editoren das JSON Web Token (JWT). Das Token wird bei der Initialisierung des Dokumenteneditors und beim Befehlsaustausch zwischen internen ONLYOFFICE Docs-Diensten in der Konfiguration hinzugefügt. Der geheime Schlüssel wird verwendet, um das JSON Web Token zu signieren und es bei der Anfrage an ONLYOFFICE Docs zu validieren.

hinweis

Ab ONLYOFFICE Docs v.7.2 ist JWT standardmäßig aktiviert und der geheime Schlüssel wird automatisch generiert. Sie können die Parameter jederzeit nach Bedarf ändern. Beim Upgrade von einer früheren Version bleiben manuell konfigurierte geheime Schlüssel erhalten.

Um Ihre Dokumente zu schützen, geben Sie Ihren eigenen geheimen Schlüssel in der ONLYOFFICE Docs-Konfigurationsdatei an. Geben Sie dann denselben geheimen Schlüssel in den Konnektor-Einstellungen an. Wenn Sie eine Version vor 7.2 verwenden, müssen Sie außerdem die Token-Validierung aktivieren.

Für Linux/Windows: ONLYOFFICE Docs konfigurieren​

  1. Öffnen Sie die Datei local.json mit einem beliebigen verfügbaren Texteditor.

    • Für Linux — /etc/onlyoffice/documentserver/local.json
    • Für Windows — %ProgramFiles%\ONLYOFFICE\DocumentServer\config\local.json

  2. Wenn Sie eine Version vor 7.2 verwenden, aktivieren Sie die Token-Validierung, indem Sie in drei Abschnitten den Wert false in true ändern:

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

  3. Geben Sie Ihren eigenen geheimen Schlüssel an, indem Sie den geheimen Wert in drei Abschnitten durch Ihre eigene Textzeichenfolge ersetzen. Der geheime Schlüssel muss in allen drei Abschnitten identisch sein.

    • 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. Speichern Sie Ihre Änderungen.

  5. Starten Sie die Dienste neu, damit die Konfigurationsänderungen wirksam werden:

    Linux:

    systemctl restart ds-converter ds-docservice ds-metrics

    Windows:

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

Für Docker: Umgebungsvariablen verwenden​

Verwenden Sie bei Docker-Bereitstellungen Umgebungsvariablen im Befehl docker run, anstatt local.json direkt zu bearbeiten.

Warnung

Wenn Sie den automatisch generierten geheimen Schlüssel ändern oder JWT manuell in /etc/onlyoffice/documentserver/local.json deaktivieren, wird JWT wieder aktiviert und der geheime Schlüssel wird beim Neustart des Servers neu generiert. Verwenden Sie in Docker-Bereitstellungen immer Umgebungsvariablen, um JWT zu konfigurieren.

Um neue Umgebungsvariablen anzuwenden, müssen Sie den Container neu erstellen. Stoppen und entfernen Sie den vorhandenen Container und führen Sie dann einen neuen mit den aktualisierten Parametern aus:

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

Um JWT zu deaktivieren, verwenden Sie stattdessen -e JWT_ENABLED=false.