Artículos con :
Cerrar
Changelog
Cerrar
Pruébelo en la nube
Centro de ayuda
integración

Overview

To edit your documents within SharePoint collaborative platform, you can connect ONLYOFFICE Docs with the document library either via an official ONLYOFFICE connector or using WOPI.

Main features

  • Editing text documents, spreadsheets, and presentations using the Edit in ONLYOFFICE option within the context menu of the file and the ribbon (when using an official connector) or clicking the file (when using WOPI).
  • Co-authoring documents in real-time: use two co-editing modes (Fast and Strict with the official connector, Fast only over WOPI), the Track Changes feature, comments, and a built-in chat.
WOPI Warning: Access tokens expire after a certain period of time. Set the access_token_ttl property to 10 hours for the Fast co-editing mode. The Strict co-editing mode might negatively affect the access token parameter.

Supported formats

For the official connector:

  • For viewing and editing: DOCX, XLSX, PPTX, PPSX.
  • For viewing only: PDF, DJVU, TXT, CSV, ODT, ODS, ODP, DOC, XLS, PPT, PPS, EPUB, RTF, HTML, HTM, MHT, XPS.

For WOPI:

  • For viewing and editing: DOCX, XLSX, PPTX, DOCM, XLSM, PPTM, ODT, ODS, ODP, TXT, CSV.
  • For viewing only: PDF, DJVU, XPS.

What's new in version 3.0.0

Added

  • JWT support
  • Document Server v6.0 and earlier is no longer supported

The full change log is available here.

Connecting ONLYOFFICE Docs to SharePoint

Requirements

  • ONLYOFFICE Document Server v7.1 or later
    You need to enable WOPI following this instruction.

    You need an instance of ONLYOFFICE Docs that is resolvable and connectable both from SharePoint and any end clients. It must be able to POST to SharePoint directly.

    Please refer to the official documentation page to learn more about installing ONLYOFFICE Docs.
  • SharePoint 2019
  • ONLYOFFICE Connector 3.0.0 for SharePoint

Installing and configuring ONLYOFFICE and SharePoint

The ONLYOFFICE SharePoint integration solution is an official ONLYOFFICE connector available on GitHub page under the GNU AGPL v.3 licence.

To learn more about how it works and how to compile the ONLYOFFICE SharePoint integration solution, please visit our API documentation.
  1. Click Start, point to All Programs, point to Administrative Tools, then click Services, and make sure that SharePoint Administration service is started.
  2. Click Start, click SharePoint Management Shell, go to the directory with the .wsp file.
  3. Run the Install.ps1 script:
    PS> .\Install.ps1
  4. Enter your SharePoint site address:
    https://<yoursharepointsite>
    Instead of steps 3 and 4 you can type the following command:
    Add-SPSolution -LiteralPath<solutionpath>/onlyoffice.wsp

    On the SharePoint Central Administration home page, click System Settings > Farm Management > Manage farm solutions. On the Solution Management page, click onlyoffice.wsp, then click Deploy Solution.

  5. On the SharePoint Central Administration home page, under Application Management, click Manage web applications.
  6. Make sure you select your site and click the Authentication Providers icon.
  7. In the Authentication Providers pop-up window click Default zone.
  8. Under Edit Authentication, check Enable anonymous access and click Save.
  9. Going back to Web Application Management click on the Anonymous Policy icon.
  10. Under Anonymous Access Restrictions select your Zone and set the Permissions to None – No policy and click Save.
  11. In SharePoint open the /_layouts/15/Onlyoffice/Settings.aspx page with administrative settings. Enter the following address:
    https://<documentserver>/
    Where the documentserver is the name of the server with the ONLYOFFICE Docs installed. The address must be accessible for the user browser and from the SharePoint server. The SharePoint server address must also be accessible from ONLYOFFICE Docs for correct work.
If you have subsites set up with SharePoint, you will need to additionally configure ONLYOFFICE Docs connection with each of them in order for it to work properly. Go to each subsite settings and enter the Docs address to the proper field.

Enabling JWT for the ONLYOFFICE and SharePoint integration

To protect documents from unauthorized access, ONLYOFFICE editors use the JSON Web Token (JWT). The token is added in the configuration when the Document Editor is initialized and during the exchange of commands between inner ONLYOFFICE Docs services. The secret key is used to sign the JSON web token and validate the token upon the request to ONLYOFFICE Docs.

To protect your documents, you need to enable the token validation and specify your own secret key in the ONLYOFFICE Docs configuration file, then specify the same secret key in the connector settings.

Step 1: Configure ONLYOFFICE Docs

  1. Open the local.json file with any available text editor.
    • For Linux - /etc/onlyoffice/documentserver/local.json
    • For Windows - %ProgramFiles%\ONLYOFFICE\DocumentServer\config\local.json
    • For Docker - enter the ONLYOFFICE Docs container using the docker exec -it <containerID> bash command and open /etc/onlyoffice/documentserver/local.json
  2. Enable token validation by changing the false value to true in three sections:
    • services.CoAuthoring.token.enable.browser
    • services.CoAuthoring.token.enable.request.inbox
    • services.CoAuthoring.token.enable.request.outbox
  3. Specify your own secret key by replacing the secret value with your own text string in three sections. The secret key must be the same.
    • 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": "yoursecret"
            },
            "outbox": {
              "string": "yoursecret"
            },
            "session": {
              "string": "yoursecret"
            }
          }
        }
      }
    }
    
  4. Save your changes.
  5. Restart the services for the config changes to take effect.
    supervisorctl restart all

Step 2: Specify the same secret key in the connector settings

In the connector settings, specify the same secret in the Secret key field and save the settings.

Connecting ONLYOFFICE Docs using WOPI

You can also connect ONLYOFFICE Docs with SharePoint over WOPI, a REST-based protocol that issues HTTP requests to a set of REST-endpoints when a client establishes a connection to the server with your data.

Please note that connecting ONLYOFFICE Docs over WOPI lacks in some features due to the WOPI architecture:
  • The editors do not support the Version History feature.
  • No support for the Mail Merge feature.
  • The editors do not support inserting an image from your storage.
  • No support for comparing documents from your storage.
  • No support for the following formats: DOC, XLS, PPT.

To connect ONLYOFFICE to SharePoint over WOPI,

  1. Make sure you meet the requirements.
  2. Open your SharePoint server. Run the SharePoint Management Shell console and set the needed WOPI zone with the following command:
    Set-SPWOPIZone -Zone "external-http"
    The documentserver uses the external-http parameter by default.
  3. Run the following command to check whether there are WOPI bindings to other document types on the current farm:
    Get-SPWOPIBinding
    Delete these bindings, if any, by running the following command:
    Remove-SPWOPIBinding -All:$true
  4. Create new bindings for default actions as per file types. Run the following command to create bindings for all file types at once:
    New-SPWOPIBinding -ServerName ip_or_domain.com:port
    Run the following command to create bindings for particular file types only:
    New-SPWOPIBinding -ServerName ip_or_domain.com:port -Extension DOCX
    If SSL is not used, add -AllowHTTP at the end of the command.
Download Best editors on your website Let your site users view, edit and collaborate
on all types of text, spreadsheet and presentation files
También le podría gustar:
Cerrar