Chamilo

Kako funkcioniše

Integracija ONLYOFFICE prati API dokumentovan ovde.

1. Da biste kreirali novi fajl, nastavnik otvara potrebnu fasciklu i klikne na ikonu Kreiraj novi ONLYOFFICE.
2. Korisnik je preusmeren na stranicu za kreiranje fajla gde treba da unese naziv i format fajla (tekstualni dokument, tabela ili prezentacija). Pregledač poziva metodu /plugin/onlyoffice/create.php. Dodaje kopiju praznog fajla u fasciklu kursa.
3. Da biste otvorili postojeći fajl, korisnik bira ikonu Otvori sa ONLYOFFICE.
4. Zahtev se šalje na /plugin/onlyoffice/editor.php?docId="identifikator dokumenta". Server obrađuje zahtev, generiše konfiguraciju za inicijalizaciju editora sa sledećim svojstvima:
   • url - URL koji ONLYOFFICE Docs koristi za preuzimanje dokumenta;
   • callbackUrl - URL koji ONLYOFFICE Docs koristi za informisanje o statusu uređivanja dokumenta;
   • documentServerUrl - URL na koji klijent treba da odgovori ONLYOFFICE Docs (može biti postavljen na stranici administrativnih postavki);
   • key - etag koji upućuje ONLYOFFICE Docs da li da ponovo preuzme dokument ili ne.
5. Server vraća stranicu sa skriptom za otvaranje editora.
6. Pregledač otvara ovu stranicu i učitava editor.
7. Pregledač šalje zahtev ONLYOFFICE Docs i prosleđuje mu konfiguraciju dokumenta.
8. ONLYOFFICE Docs učitava dokument i korisnik počinje sa uređivanjem.
9. ONLYOFFICE Docs šalje POST zahtev na callbackUrl da obavesti Chamilo da korisnik uređuje dokument.
10. Kada svi korisnici završe sa uređivanjem, zatvaraju prozor editora.
11. Nakon 10 sekundi, ONLYOFFICE Docs šalje POST zahtev na callbackUrl da obavesti da je sesija uređivanja završena i šalje link ka novoj verziji dokumenta.
12. Chamilo učitava novu verziju dokumenta i prepisuje fajl.

Omogućavanje JWT za integraciju ONLYOFFICE i Chamilo

Da bi se dokumenti zaštitili od neovlašćenog pristupa, ONLYOFFICE editori koriste JSON Web Token (JWT). Token se dodaje u konfiguraciju kada se inicijalizuje Editor dokumenata 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 podrazumevano omogućen i tajni ključ se automatski generiše. Treba da pronađete svoj tajni ključ u konfiguracionom fajlu ONLYOFFICE Docs, zatim navedite isti tajni ključ u postavkama konektora.

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

1. Otvorite fajl local.json sa bilo kojim dostupnim tekst editorom.
   • 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 treba 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
``````html
3. Automatski generisani tajni ključ je naveden u tri sekcije. Možete zameniti podrazumevanu tajnu vrednost svojim tajnim ključem. Tajni ključ mora biti isti u sve tri sekcije.
   • services.CoAuthoring.secret.inbox.string
   • services.CoAuthoring.secret.outbox.string
   • services.CoAuthoring.secret.session.string
4. Ako izvršite izmene, sačuvajte ih i ponovo pokrenite servise da bi promene u konfiguraciji stupile na snagu.

   supervisorctl restart all

Korak 2: Navedite isti tajni ključ u podešavanjima konektora

U podešavanjima konektora, navedite isti tajni ključ u polju Tajni ključ i sačuvajte podešavanja.

Onemogućavanje ONLYOFFICE konektora za Chamilo

Ako treba da onemogućite ONLYOFFICE konektor:

1. Na stranici Dodaci, pronađite ONLYOFFICE i kliknite na Konfiguriši.
2. Označite Ne u sekciji Omogući.