linshare-editor-onlyoffice

A backend application acts as a middleware between OnlyOffice document server and LinShare

Initial setup steps

Install dependencies

npm install

Save public key to Linshare

LINSHARE_USER=root@localhost.localdomain LINSHARE_PASS=adminlinshare LINSHARE_HOST=http://localhost:30000 bash ./config/config_key.sh

LINSHARE_USER and LINSHARE_PASS are Linshare administrator's username and password.

Configurations

Setup neccessary configurations in ./config/default.json to make the app works properly:

• webserver.baseUrl: base url of this backend app for communication with document server
• linshare.baseUrl: base url to LinShare api.
• db.connectionString: connection string to a MongoDB sever.

In order to utilize environment values for custom configuration, you can add your own environment values that will be used for certain configuration in config/custom-environment-variables.json. This configuration will override the other configuration files to use the environment values instead.

Development

Create a customized config file for development

cp ./config/default.json ./config/development.json

Start server

npm start

Run in development mode

npm run dev

Run your unit tests

npm run test

Configurations

Enable authorization by JWT token between OnlyOffice document server and Editor application

OnlyOffice document server can enforce JWT authorization for requests coming from frontend client. Requests from frontend client therefore have to contain a signed payload that are retrieved from linshare-editor-onlyoffice server.

This authorization process requires configuration from both OnlyOffice document server and linshare-editor-onlyoffice server.

• From document server side, change the server configuration of services.CoAuthoring.token.enable.browser to true and define the JWT secret key in services.CoAuthoring.secret.inbox.string.
• From linshare-editor-onlyoffice side, use the following configuration, note that both services must share a same secret

{
  "documentServer": {
      "signature": {
        "browser": {
          "enable": true,
          "algorithm": "HS256",
          "secret": "secret",
          "expiresIn": "5m"
        }
      }
    }
  }
}

Enable authorization by JWT token for requests coming from OnlyOffice document server.

From document server side, change the server configuration of services.CoAuthoring.token.enable.request.outbox to true and define the JWT secret key in services.CoAuthoring.secret.outbox.string.

From linshare-editor-onlyoffice side, use the following configuration, note that both services must share a same secret

{
  "documentServer": {
      "signature": {
        "request": {
          "incoming": {
            "enable": "true",
            "algorithm": "HS256",
            "secret": "secret",
            "authorizationHeader": "authorization",
            "authorizationHeaderPrefix": "Bearer "
          }
        }
      }
    }
  }
}