Confluence

Kako funkcioniše

Integracija sa ONLYOFFICE prati API dokumentovan ovde.

1. Korisnik odlazi na Confluence priloge i bira akciju Uredi u ONLYOFFICE.
2. Confluence šalje zahtev ka OnlyOfficeEditorServlet (URL u formi: /plugins/servlet/onlyoffice/doceditor?attachmentId=$attachment.id).
3. Confluence šalje dokument na ONLYOFFICE Document storage service i dobija privremeni link.
4. Confluence priprema JSON objekat sa sledećim svojstvima:
   • url - privremeni link koji ONLYOFFICE Docs koristi za preuzimanje dokumenta;
   • callbackUrl - URL koji ONLYOFFICE Docs koristi da obavesti o statusu uređivanja dokumenta;
   • docserviceApiUrl - URL na koji klijent treba da odgovori ONLYOFFICE Docs (obezbeđen svojstvom files.docservice.url.api);
   • key - UUID koji upućuje ONLYOFFICE Docs da li da ponovo preuzme dokument ili ne;
   • title - naslov dokumenta (ime).
5. Confluence koristi ovaj objekat da generiše stranicu iz freemarker šablona, popunjavajući je datim vrednostima kako bi omogućio klijentskom pretraživaču da učita uređivač.
6. Klijentski pretraživač šalje zahtev JavaScript biblioteci iz ONLYOFFICE Docs i šalje ONLYOFFICE Docs konfiguraciju DocEditor-a sa gore navedenim svojstvima.
7. Zatim ONLYOFFICE Docs preuzima dokument iz Confluence i korisnik počinje sa uređivanjem.
8. Kada svi korisnici i klijentski pretraživači završe sa uređivanjem, zatvaraju prozor za uređivanje.
9. Nakon 10 sekundi neaktivnosti, ONLYOFFICE Docs šalje POST na callbackUrl obaveštavajući Confluence da su klijenti završili sa uređivanjem dokumenta i zatvorili ga.
10. Confluence preuzima novu verziju dokumenta, zamenjujući staru.

Omogućavanje JWT za integraciju ONLYOFFICE i Confluence

Da bi zaštitili dokumente od neovlašćenog pristupa, ONLYOFFICE uređivači koriste JSON Web Token (JWT). Token se dodaje u konfiguraciju kada se pokreće Document Editor i tokom razmene komandi između unutrašnjih ONLYOFFICE Docs servisa. Tajni ključ se koristi za potpisivanje JSON web tokena i validaciju tokena prilikom zahteva ka ONLYOFFICE Docs.

Počevši od ONLYOFFICE Docs v7.2, JWT je omogućeno po defaultu i tajni ključ se generiše automatski. Potrebno je pronaći vaš tajni ključ u ONLYOFFICE Docs konfiguracionom fajlu, zatim navesti isti tajni ključ u postavkama konektora.

Korak 1: Pronađite vaš tajni ključ u ONLYOFFICE Docs konfiguracionom fajlu

1. Otvorite fajl local.json sa bilo kojim dostupnim tekstualnim uređivačem.
   • Za Linux - /etc/onlyoffice/documentserver/local.json
   • Za Windows - %ProgramFiles%\ONLYOFFICE\DocumentServer\config\local.json
   • Za Docker – uđite u ONLYOFFICE Docs kontejner koristeći komandu docker exec -it <containerID> bash i otvorite /etc/onlyoffice/documentserver/local.json

     Alternativno, možete koristiti sledeću komandu da pronađete podrazumevani tajni ključ bez otvaranja local.json:

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

   Fajl local.json bi trebalo da izgleda ovako:

   {
                                           "services": {
                                               "CoAuthoring": {
                                               "token": {
                                               "enable": {
                                               "request": {
                                               "inbox": true,
                                               "outbox": true
                                               },
                                               "browser": true
                                               }
                                               },
                                               "secret": {
                                               "inbox": {
                                               "string": "yoursecret"
                                               },
                                               "outbox": {
                                               "string": "yoursecret"
                                               },
                                               "session": {
                                               "string": "yoursecret"
                                               }
                                               }
                                               }
                                               }
                                               }

2. Vrednost true je navedena u tri sekcije. To znači da je validacija tokena omogućena.
   • services.CoAuthoring.token.enable.browser
   • services.CoAuthoring.token.enable.request.inbox
   • services.CoAuthoring.token.enable.request.outbox
3. Automatski generisani tajni ključ je naveden u tri sekcije. Možete zameniti podrazumevanu vrednost tajnog ključa sa vašim sopstvenim tajnim ključem. Tajni ključ mora biti isti u tri sekcije.
   • services.CoAuthoring.secret.inbox.string
   • services.CoAuthoring.secret.outbox.string
   • services.CoAuthoring.secret.session.string
4. Ako napravite izmene, sačuvajte ih i restartujte servise kako bi promene u konfiguraciji stupile na snagu.

   supervisorctl restart all

Korak 2: Navedite isti tajni ključ u postavkama konektora

U postavkama konektora, navedite isti tajni ključ u polju Tajni ključ i sačuvajte postavke.

Povezivanje na demo ONLYOFFICE Docs

Ako želite da testirate ONLYOFFICE online uređivače unutar Confluence bez instaliranja ONLYOFFICE Docs:

1. Idite na administraciju Confluence > Upravljanje aplikacijama > ONLYOFFICE Connector za Confluence > Konfiguriši.
2. Označite kućicu Poveži se sa demo ONLYOFFICE Document Server.
3. Kliknite na dugme Sačuvaj.