ONLYOFFICE¶

In dit artikel

• ONLYOFFICE. Belangrijkste functies
• Implementatiefuncties
• Aan de slag na het implementeren van ONLYOFFICE
• Toegang tot webinterface
• JWT-geheimconfiguratie
• Voorbeelden inschakelen voor testen
• Een server met ONLYOFFICE bestellen via de API

In dit artikel: - ONLYOFFICE. Belangrijkste functies - Implementatiefuncties - Aan de slag na het implementeren van OnlyOffice - Toegang tot webinterface - JWT-geheimconfiguratie - Voorbeelden inschakelen voor testen - Een server met ONLYOFFICE bestellen via de API

ONLYOFFICE. Belangrijkste functies¶

• Realtime documentbewerking: Volledig uitgeruste editors voor DOCX, XLSX, PPTX met mogelijkheden voor collaboratief bewerken;
• Compatibiliteit met Microsoft Office-indelingen: Volledige ondersteuning voor MS Office-indelingen, inclusief complexe opmaak;
• Collaboratieve bewerking: Gelijktijdige documentbewerking door meerdere gebruikers met wijzigingsregistratie;
• Ingebouwde opmerkingen en chat: Tools voor het bespreken van documenten direct binnen de editorinterface;
• Versiebeheer: Registratie van de wijzigingsgeschiedenis met de mogelijkheid om terug te keren naar eerdere versies;
• Plugins en integraties: Uitbreiden van functionaliteit via plugins en integratie met populaire opslagsystemen;
• Beveiliging: Ondersteuning voor JWT-tokens om de API te beschermen en gegevensversleuteling tijdens transmissie;
• API voor ontwikkelaars: REST API voor integratie met aangepaste applicaties;
• Mobiele ondersteuning: Adaptieve interface voor tablets en smartphones.

Implementatiefuncties¶

Aan de slag na het implementeren van ONLYOFFICE¶

Na betaling van de bestelling wordt er een melding over de serverklaarheid naar het e-mailadres gestuurd dat tijdens de registratie is opgegeven. Hierin staat het VPS-IP-adres, evenals de inloggegevens en het wachtwoord voor verbinding. Klanten van ons bedrijf beheren apparatuur via het serverbeheerpaneel en de API — Invapi.

Autorisatiegegevens zijn te vinden op het tabblad Information >> Tags van het serverbeheerpaneel of in de verzonden e-mail:

• Link voor toegang tot het ONLYOFFICE-webinterfacepaneel: in de webpanel-tag;
• Inloggegevens en Wachtwoord voor het beheren van de server: verzonden via e-mail bij levering van de server.

Toegang tot webinterface¶

Controleren van ONLYOFFICE-functionaliteit¶

1. Open een webbrowser en ga naar de link uit de webpanel-tag;

2. U zou de ONLYOFFICE-welkomstpagina moeten zien:

   

3. Gebruik de ingebouwde voorbeelden om de editorfunctionaliteit te controleren (zie sectie "Voorbeelden inschakelen voor testen").

Controleren van servicestatus¶

Voer het volgende commando uit op de server om de status van containers te controleren:

docker ps

CONTAINER ID   IMAGE                          STATUS        PORTS                    NAMES
527cd331a316   jonasal/nginx-certbot:latest   Up 19 hours                           nginx-nginx-1
e32700b1ac75   onlyoffice/documentserver      Up 19 hours   0.0.0.0:8080->80/tcp    onlyoffice-docs

JWT-geheimconfiguratie¶

Huidig JWT-geheim weergeven¶

Het JWT-geheim wordt gebruikt voor het beschermen van de Document Server API. Om de huidige waarde te bekijken:

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

Structuur van JWT-tokens¶

ONLYOFFICE gebruikt drie soorten JWT-geheimen voor verschillende doeleinden:

• secret.inbox.string - voor inkomende verzoeken van externe systemen naar ONLYOFFICE;
• secret.outbox.string - voor uitgaande verzoeken van ONLYOFFICE naar externe systemen;
• secret.session.string - voor interne sessies en interacties tussen componenten.

JWT-geheimen wijzigen¶

Volg deze stappen om JWT-geheimen te wijzigen:

1. Maak een back-up van de configuratie:

   docker exec onlyoffice-docs cp /etc/onlyoffice/documentserver/local.json /etc/onlyoffice/documentserver/local.json.backup
   

2. Log in op de OnlyOffice-container:

   docker exec -it onlyoffice-docs /bin/bash
   

3. Bewerk het configuratiebestand:

   nano /etc/onlyoffice/documentserver/local.json
   

4. Zoek de sectie services.CoAuthoring.secret en wijzig de waarden:

   "secret": {
     "inbox": {
       "string": "your_unique_secret_for_incoming_requests"
     },
     "outbox": {
       "string": "your_unique_secret_for_outgoing_requests"
     },
     "session": {
       "string": "your_unique_secret_for_sessions"
     }
   }
   

5. Sla het bestand op en verlaat de editor (Ctrl+X, dan Y, dan Enter);
6. Herstart de container om de wijzigingen toe te passen:

   docker restart onlyoffice-docs
   

7. Controleer of de service correct is gestart:

   docker logs onlyoffice-docs --tail 100
   

Voorbeelden inschakelen voor testen¶

ONLYOFFICE bevat ingebouwde voorbeelden voor het testen van documenteditors. Standaard zijn deze uitgeschakeld.

Voorbeelden activeren¶

Voer de volgende commando's uit om testvoorbeelden in te schakelen:

Start voorbeeldservice:

sudo docker exec e32700b1ac75 sudo supervisorctl start ds:example

sudo docker exec e32700b1ac75 sudo sed 's,autostart=false,autostart=true,' -i /etc/supervisor/conf.d/ds-example.conf

1. Open in een browser: https://your-domain/welcome/;
2. U ziet een pagina met editorvoorbeelden;
3. Klik op een willekeurig documenttype om te testen:
   • Document - voor het maken van tekstdocumenten;
   • Spreadsheet - voor het maken van spreadsheets;
   • Presentation - voor het maken van presentaties;
   • PDF form - voor het werken met PDF-formulieren.

Een server met ONLYOFFICE bestellen via de API¶