Статьи с тэгом :
Закрыть
История изменений
Закрыть
Попробовать в облаке
Попробовать в облаке
Справочный центр
Интеграция

About the ONLYOFFICE and ownCloud integration

ONLYOFFICE offers an official connector to integrate ONLYOFFICE Docs with ownCloud and edit office documents within the cloud storage. You can download the ONLYOFFICE connector from the ownCloud Marketplace or the ONLYOFFICE GitHub page.

To learn more about the ONLYOFFICE and ownCloud integration connector and how it works in detail, please visit our API documentation page.

Main features

  • Creating, editing, and viewing documents, spreadsheets, and presentations.
  • Sharing files with different permissions — viewing/editing, reviewing, filling forms and commenting with user mentions. It's also possible to restrict downloading (in all editors) and modifying filters (in spreadsheets). Sharing via public links is also available.
  • Co-editing documents in real-time: two co-editing modes (Fast and Strict), Track Changes, comments, and a built-in chat.
  • Co-editing between several federated ownCloud instances connected to one Document Server.
  • JWT support to secure your traffic so that no one, besides the users with proper rights, can have access to your documents.

Supported formats

  • For editing and viewing: DOCX, XLSX, PPTX, CSV, TXT.
  • For viewing only: PDF.
  • For editing via OOXML conversion: ODT, ODS, ODP, and RTF.
  • For converting to Office Open XML formats using the Convert with ONLYOFFICE option: DOC, DOCM, DOT, DOTX, EPUB, HTM, HTML, ODP, ODT, POT, POTM, POTX, PPS, PPSM, PPSX, PPT, PPTM, RTF, XLS, XLSM, XLT, XLTM, XLTX.

What's new in version 7.2.3

Changed

  • Opening the editor in a new tab for ownCloud Web

The full change log is available here.

Connecting ONLYOFFICE Docs to ownCloud

Requirements

  • ONLYOFFICE Docs v6.1 and later.

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

    Starting from version 4.3.0, ONLYOFFICE Docs and ownCloud can be installed either on different computers or on the same machine. In case you select the latter variant, you will need to set up a custom port for ONLYOFFICE Docs, as by default both ONLYOFFICE Docs and ownCloud work on port 80.

    Please refer to the official documentation page to learn more about installing ONLYOFFICE Docs.

    You can also use ONLYOFFICE Docs Cloud (SaaS version).

  • ownCloud v10.0.0 and later
  • ONLYOFFICE connector v7.2.1 and later for ownCloud

Installing the ONLYOFFICE connector for ownCloud

The ownCloud administrator can install the integration app from the in-built application market. To do it, please follow these steps:

  1. Click the upper-left hamburger menu.
  2. Select Market.
  3. Go to the Tools category.
  4. Find ONLYOFFICE in the list of available applications.
  5. Click the Install button.

Alternatively, the administrator can install the application manually:

  1. Get the ownCloud ONLYOFFICE integration app. There are several ways to do that:
    1. Download the latest signed version from the official ownCloud store.
    2. Download the latest signed version from the application release page on GitHub. E.g.:
      wget https://github.com/ONLYOFFICE/onlyoffice-owncloud/archive/refs/tags/vX.X.X.tar.gz

      Where vX.X.X is the necessary connector version.

      Unzip the archive, e.g.:

      tar -xvzf vX.X.X.tar.gz

      Rename the folder to onlyoffice, e.g.

      mv onlyoffice-owncloud-X.X.X onlyoffice
    3. Clone the application source code and compile it yourself:
      git clone https://github.com/ONLYOFFICE/onlyoffice-owncloud.git onlyoffice
      cd onlyoffice
      git submodule update --init --recursive
    ownCloud does not work with unsigned applications showing an alert message, so you will need to use either option a or b to get the application for your production environment.
  2. Move the onlyoffice folder to the ownCloud server apps/ directory (or some other directory used to connect applications):
    cp -r /root/onlyoffice/ /var/www/owncloud/apps/
  3. Go to the apps/ directory:
    cd /var/www/owncloud/apps
  4. Change the owner to update the application right from the ownCloud web interface:
    chown -R www-data:www-data onlyoffice
  5. In ownCloud, go to Settings > Admin > Apps, click Show disabled apps and click Enable for the ONLYOFFICE application.

Configuring the ONLYOFFICE connector for ownCloud

To configure the ONLYOFFICE application settings, please go to Settings > Admin > Additional.

In the Server settings section, specify the following options:

  • ONLYOFFICE Docs address - specify the URL address where the Document Editing Service is installed. This field is obligatory. If you install ONLYOFFICE Docs on a custom port, you must specify the port, e.g.: http://127.0. 0.1:8081/
    ImportantThe address of ONLYOFFICE Docs must be accessible from ownCloud, as well as the address of ownCloud must be accessible from ONLYOFFICE Docs.
  • Disable certificate verification (insecure) - check this box to disable the certificate verification and allow ownCloud to establish connection with ONLYOFFICE Docs if you are using a self-signed certificate for your ONLYOFFICE Docs (otherwise, ownCloud will not validate a self-signed certificate and will not allow for connection to/from ONLYOFFICE Docs). This is an insecure solution, and we strongly recommend that you replace the certificate with the one issued by some CA.
  • Secret key - specify the secret used to sign the data.
    Starting from ONLYOFFICE Docs v7.2, JWT is enabled by default and the secret key is generated automatically. You need to enable it on the ownCloud side as well: find your secret key in the ONLYOFFICE Docs configuration file, then specify the same secret key in the connector settings. For more details, see the Enabling JWT for the ONLYOFFICE and ownCloud integration section of this article.
  • The Advanced server settings section can be used if your network configuration does not allow for requests between the installed ownCloud and ONLYOFFICE Docs using the public addresses. In this case, specify addresses for internal requests in the corresponding fields:
    • In the ONLYOFFICE Docs address for internal requests from the server field, specify the address that is used to access Document Editing Service from ownCloud.
    • In the Server address for internal requests from ONLYOFFICE Docs field, specify the address that is used to access ownCloud from Document Editing Service.
Settings Settings

Click the Save button. After saving the Server settings, the Common settings, Editor customization settings, and Common templates sections will appear.

In the Common settings section, you can specify the following options:

  • Restrict access to the editors to following groups - check this box and select user groups that will not be allowed to use the ONLYOFFICE editors in ownCloud.
  • Use ONLYOFFICE to generate a document preview - check this box for thumbnail generation via ONLYOFFICE. It will take up some disk space.
  • Open file in the same tab - check this box to open a file in the current browser tab. If this option is unchecked, a file will be opened in a new browser tab.
  • Keep metadata for each version once the document is edited function makes it possible to keep metadata and display changes for each document version in the version history. It will take up some disk space. You can use the Clear button to remove the metadata and free up disk space.
  • The default application for opening the format - allows you to check the formats to associate with the ONLYOFFICE editors. The docx, xlsx, and pptx formats are selected by default.
    Opening in ONLYOFFICE editors will be performed only for the formats selected in this section.
  • Open the file for editing - allows administrators to choose the document formats to edit via conversion to OOXML formats. The csv and txt formats are selected by default.
    Due to format restrictions, some data might be lost when saving to the formats from the list (csv, odp, ods, odt, rtf, txt).

    After you enable the corresponding option, documents in the specified formats will be immediately converted and opened in the ONLYOFFICE editor for editing after clicking on them and choosing the Open in ONLYOFFICE menu item. If a format is unchecked, the file will be opened for viewing.

In the Editor customization settings section, you can specify the following options:

  • Keep intermediate versions when editing (forcesave) function allows you to send all changes to the storage directly when clicking the Save button in the ONLYOFFICE editors' interface if you want to prevent data loss. When this option is disabled, your changes are saved to the editors' cache automatically.
  • Select the interface elements of the editors that you want to hide / show (ChatMore compact headerFeedback & SupportHelpMonochrome toolbar header).
  • Review mode for viewing function allows you to set the default document review display mode:
    • Markup - for highlighting the proposed changes,
    • Final - for showing with changes applied,
    • Original - for showing the original document without any changes.
Settings Settings

After making changes to the Common settings and/or Editor customization settings, click the Save button located below to save the changes.

In the Common templates section, you can click the Add icon icon and upload docx, xlsx, or pptx templates for creating new documents.

You can download or delete a template from this list using the corresponding icons.

Settings Settings

After adding templates in the admin settings, users will be able to choose a template when creating a new document using the the Add icon add button in the ownCloud interface or via the File > Create new menu in the ONLYOFFICE editors' interface.

Enabling JWT for the ONLYOFFICE and ownCloud 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.

Starting from ONLYOFFICE Docs v7.2, JWT is enabled by default and the secret key is generated automatically. You need to find your secret key in the ONLYOFFICE Docs configuration file, then specify the same secret key in the connector settings.

Step 1: Find your secret key in the ONLYOFFICE Docs configuration file

  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

      Alternatively, you can use the following command to find the default secret key without opening local.json:

      sudo docker exec <containerID> /var/www/onlyoffice/documentserver/npm/json -f /etc/onlyoffice/documentserver/local.json 'services.CoAuthoring.secret.session.string'

    The local.json file should look like this:

    {
      "services": {
        "CoAuthoring": {
          "token": {
            "enable": {
              "request": {
                "inbox": true,
                "outbox": true
              },
              "browser": true
            }
          },
          "secret": {
            "inbox": {
              "string": "yoursecret"
            },
            "outbox": {
              "string": "yoursecret"
            },
            "session": {
              "string": "yoursecret"
            }
          }
        }
      }
    }
    
  2. The true value is specified in three sections. It means that token validation is enabled.
    • services.CoAuthoring.token.enable.browser
    • services.CoAuthoring.token.enable.request.inbox
    • services.CoAuthoring.token.enable.request.outbox
  3. The automatically generated secret key is specified in three sections. You can replace the default secret value with your own secret key. The secret key must be the same in three sections.
    • services.CoAuthoring.secret.inbox.string
    • services.CoAuthoring.secret.outbox.string
    • services.CoAuthoring.secret.session.string
  4. If you make changes, save them and restart the services for the config changes to take effect.
    supervisorctl restart all

Step2: 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 to the demo ONLYOFFICE Docs

Starting from ONLYOFFICE connector version 3.0.1, you can try the ONLYOFFICE online editors within ownCloud without installing ONLYOFFICE Docs.

To turn the connection on, click the Connect to demo ONLYOFFICE Docs server checkbox and click the Save button.

This is a public test server that will be available during a 30-day period. Don’t share your sensitive data there.

Installing ONLYOFFICE Docs with ownCloud using Docker Compose

Using Docker Compose, you can quickly and easily deploy the preconfigured version of ONLYOFFICE Docs connected to ownCloud with all the required dependencies in the Docker containers.

Installing Docker and Docker Compose

  1. Follow this instruction to download and install Docker to your computer. Docker is a program for automating application development and management in container-enabled environments.
  2. Then follow this instruction to download and install the Docker Compose package manager, which allows you to describe and run multi-container applications.

Installing ONLYOFFICE Docs and ownCloud servers

  1. Download the latest version of the docker-onlyoffice-owncloud repository. To do so, insert the following line into the Command line interface:
    git clone --recursive https://github.com/ONLYOFFICE/docker-onlyoffice-owncloud
  2. Once the repository is downloaded, go to the docker-onlyoffice-owncloud folder:
    cd docker-onlyoffice-owncloud
  3. Update submodules in the repository:
    git submodule update --remote
  4. Launch Docker Compose:
    sudo docker-compose up -d
    You might need to wait a couple of minutes until all the containers are up and running after the command above.

In the browser address bar, enter http://localhost to open the ownCloud setup page and create your admin account. Enter your Login and Password (by default, admin is used for both fields).

Now you can create and edit documents in ownCloud using ONLYOFFICE Docs without configuring any settings.

Server settings are specified during the deployment, but you can adjust Common settings, Editor customization settings, and Common templates. Please refer to the Configuring the ONLYOFFICE connector for ownCloud section to learn more about the available connector settings.

Installing ONLYOFFICE Docs with ownCloud on a virtual machine using UCS

App appliances introduced by Univention are a distribution format that allows installing systems already packed with components such as ONLYOFFICE Docs and ownCloud.

Univention, an open-source corporate infrastructure developer, introduced a handy method of installing systems already equipped with third-party components – virtual app appliances. These are VirtualBox or VMware images that include the app, UCS management system and the UCS runtime environment.

The following virtual images contain Univention Corporate Server, ownCloud and ONLYOFFICE. The apps work out of the box with the additionally created auto-configuration that makes sure that the required ONLYOFFICE add-on in ownCloud is configured correctly. The installation process is far easier than a classic manual method: no manual steps by the administrator are needed.

Download the necessary components

First, you need to install the hypervisor for the virtual machine. Choose between VMware Workstation Player or VirtualBox and follow the documentation for detailed installation instructions.

Then download ONLYOFFICE-ownCloud VM for the hypervisor that you’ve chosen.

UCS step 1

Import the virtual appliance

Now open the hypervisor and import the ONLYOFFICE-ownCloud virtual appliance. This guide describes how to do this in both platforms.

Install the application

Once the image is successfully imported, start the Virtual Machine. Go through the booting process via the installation wizard, following the steps below.

  1. Choose your language and enter the nearest city.
    UCS step 2 UCS step 2

    The wizard will obtain the default system locale, timezone, and keyboard layout.

    UCS step 2-1 UCS step 2-1
  2. Set up your domain and network settings. By default, you obtain an IP address automatically. Alternatively, you can specify your IP address, net mask, and gateway manually. Enter the address of the preferred DNS server.
    UCS step 3 UCS step 3
  3. Select your domain settings. The Manage users and permissions directly on this system option is selected by default. It allows creating a new domain in this system. Alternatively, you can connect to the existing UCS or Microsoft Active Directory domain.
    UCS step 4 UCS step 4
  4. Enter your Company name, admin email address for activating ONLYOFFICE (the license file will be sent to this email address), create and confirm a new password for your administrator account.
    UCS step 5 UCS step 5
  5. Specify the fully qualified domain name for this system and the LDAP base:
    UCS step 6 UCS step 6
  6. Review your settings and make sure everything is filled out correctly. Then click the Configure System button.
    UCS step 7 UCS step 7
  7. Once everything is configured, ONLYOFFICE is ready to start in a newly created UCS platform.
    UCS step 8 UCS step 8

    UCS step 9 UCS step 9
  8. Enter your IP address in the browser address bar and upload your ucs.license file received via email.
  9. To log in to your ONLYOFFICE Docs and ownCloud appliance, click ownCloud in the Applications section and enter the default username and password (owncloud, owncloud).

    To log in to your Univention Management Console, click LOGIN on the top or System and domain settings in the Administration section and enter your admin email address and the password specified during the registration (see step 4).

    UCS step 10 UCS step 10

Start using ONLYOFFICE Docs within ownCloud

To create a document:

  1. Open the needed folder within ownCloud.
  2. Click the Add icon add button.
  3. Choose the needed file type: Document, Spreadsheet, or Presentation.
    Create Create
  4. Type in the document name and press Enter.
  5. Optional. If some templates are added by the administrator, select the necessary template and click Create.
    Template Template

To open a document for editing or viewing:

  1. Open the folder with the needed document.
  2. Click the More icon more button or the document title.
  3. Click the Open in ONLYOFFICE option.
    Open Open

To convert a document to the Office Open XML format:

  1. Open the folder with the needed document.
  2. Click the More icon more button or the document title.
  3. Click the Convert with ONLYOFFICE option.
    Convert Convert
    See the full list of the formats which can be converted into OOXML.

    The ODT, ODS, ODP, and RTF formats are also available for instant conversion. If the corresponding option is enabled in the admin settings, documents in the specified formats will be immediately converted and opened in the ONLYOFFICE editor for editing after clicking on them and choosing the Open in ONLYOFFICE menu item.

Connecting ONLYOFFICE Desktop Editors to ownCloud

ONLYOFFICE allows you to edit the files stored in your ownCloud account and collaborate on them using both online and desktop editors. Thereby, you can use not only online collaboration tools but also the features available in your desktop application only:

  • protecting documents with a password or a digital signature,
  • sending the currently edited file right from the editor using the Send plugin,
  • inserting audio and video via the Presentation Editor.
It's supposed that you already have ownCloud server, ONLYOFFICE Docs and the integration app installed and configured.

Launch ONLYOFFICE Desktop Editors. To connect Desktop Editors to your ownCloud server, perform the following actions:

  1. Switch to the Connect to cloud section on the left side panel.
  2. Click the ownCloud cloud service button. Alternatively, you can use the Connect now link at the bottom.
    Connect to cloud tab Connect to cloud tab
  3. If you pressed the ownCloud service button, the Connect to cloud office window opens with the ownCloud selected. If you used the Connect now link, choose the ownCloud cloud storage from the drop-down list.
    • in the Cloud office URL field, enter your ownCloud server domain name or IP address. When ready, click the Connect now button.
      Connect to cloud office window Connect to cloud office window
    • The ownCloud sign in page will open in a new tab of the Desktop Editors interface.

      • Specify your Username or email and the Password you use to access your ownCloud account,
      • Click the Log in button.
      Connect to cloud office window Connect to cloud office window

The Files section of your ownCloud account will open. Now you can edit your existing files and create new ones, share your documents and collaborate on them with ownCloud users using ONLYOFFICE editors.

To learn more about managing your connected accounts, please refer to this instruction.

Connecting ONLYOFFICE Documents to ownCloud on iOS or Android

You can connect ownCloud to the ONLYOFFICE Documents mobile app to work on your ownCloud documents, spreadsheets, and presentations and edit them collaboratively on-the-go.

It's supposed that you already have ownCloud server, ONLYOFFICE Docs and the integration app installed and configured.

To connect ONLYOFFICE to ownCloud on your mobile device, download and install the latest version of the ONLYOFFICE Documents app for iOS or ONLYOFFICE Documents application for Android and perform the following actions:

  1. Go to the Clouds section.
  2. Choose ownCloud.
  3. Insert the URL address of your ownCloud server in the Connection URL field.
  4. Enter the login and password of your ownCloud account.
  5. Press Next.

To edit documents from your ownCloud using ONLYOFFICE Docs on your mobile device, tap the necessary file name in the file list.

Скачать Лучшие редакторы на вашем сайте Совместно просматривайте и редактируйте
все типы текстовых файлов, таблиц и презентаций
Вас также может заинтересовать:
Закрыть