Connecting ONLYOFFICE Docs to SuiteCRM
+ + +Installing the ONLYOFFICE integration module for SuiteCRM
+To install the ONLYOFFICE application:
+-
+
- Get the latest compiled package files of the ONLYOFFICE integration plugin from the GitHub page. +
-
+ Launch SuiteCRM and switch to Admin -> Admin Tools -> Module Loader.
+ ++
" /> +
+ - Upload the ONLYOFFICE plugin archive. +
- Install the uploaded module by pressing the Install button. +
- Switch to Admin -> Admin Tools -> Repair. +
-
+ Run Quick Repair and Rebuild.
+ ++
+
Configuring JWT for the ONLYOFFICE and SuiteCRM integration
+JWT or JSON Web Token is a string sent from client to server within the HTTP request to validate the authenticity of the client. JWT is saved on the client-side only so the transmission between parties is protected and digitally signed.
+The token is generated using the JWT (JSON Web Tokens) standard. The tokens are signed by the server's key, so the client is able to verify that the token is legitimate.
+ONLYOFFICE Docs validates the token. The data from the payload is considered valid and is used instead of the corresponding data from the main parameters. If the token is invalid, the command is not executed. To learn more, please read the API Security guide.
+In SuiteCRM, JWT is enabled by default starting from version 7.2.
+Follow these steps to configure it manually if needed:
+-
+
-
+ Go to Admin -> ONLYOFFICE -> ONLYOFFICE Settings.
+ ++
+
- Enter the values in the following fields:
+
-
+
- Document Editing Service Address: Specify the URL address where ONLYOFFICE Docs is installed (e.g.,
https://documentserver).
+ - Secret key (leave blank to disable): The secret key is generated automatically to restrict the access to ONLYOFFICE Docs. If you want to specify your own secret key in this field, also specify the same secret key in the ONLYOFFICE Docs config file to enable the validation. +
- Authorization header (leave blank to use default header): Standard JWT header used in ONLYOFFICE is Authorization. In case this header is in conflict with your setup, you can change the header to the custom one. +
++
+ - Document Editing Service Address: Specify the URL address where ONLYOFFICE Docs is installed (e.g.,
Start using ONLYOFFICE Docs within SuiteCRM
+To edit and collaborate on office files:
+-
+
- Go to the Documents module. +
- Open the Detail View page by clicking on the file name. +
- On the Detail View page, click on Open in ONLYOFFICE in the drop-down ACTIONS menu - the file will open in a new tab. +