Jira

Dodavanje konektora sa Atlassian marketplace-a

1. Prijavite se u vašu Jira Software instancu kao administrator.
2. Kliknite na ikonu Administracija u gornjem desnom uglu i izaberite opciju Upravljanje aplikacijama iz menija.
   
3. Otvoriće se sekcija Pronađi nove aplikacije. Kliknite na polje Pretraži Marketplace i pronađite Jira ONLYOFFICE integracionu aplikaciju.
4. Kliknite na dugme Instaliraj da biste preuzeli i instalirali aplikaciju.

Dodavanje konektora kompajliranog iz izvornog koda

Prvo, potrebno je da instalirate sledeće preduslove kako biste mogli da kompajlirate ONLYOFFICE konektor za Jira:

• 1.8.X Oracle Java SE Development Kit 8
• Atlassian Plugin SDK

Da biste kompajlirali ONLYOFFICE konektor za Jira, pratite ove korake:

1. Klonirajte onlyoffice-jira repozitorijum.

   git clone https://github.com/ONLYOFFICE/onlyoffice-jira.git

2. Idite u direktorijum onlyoffice-jira.

   cd onlyoffice-jira

3. Pokrenite sledeću komandu:

   atlas-package

   Sačekajte dok se konektor kompajlira. Nakon toga, konektor se može pronaći u folderu target.

Možete da otpremite kompajlirani konektor na vašu Jira Software Administration > Upravljanje aplikacijama stranicu.

1. Prijavite se u vašu Jira Software instancu kao administrator.
2. Kliknite na ikonu Administracija u gornjem desnom uglu i izaberite opciju Upravljanje aplikacijama iz menija.
3. Izaberite sekciju Upravljanje aplikacijama na levoj strani stranice.
4. Kliknite na link Otpremi aplikaciju.
5. Kliknite na dugme Izaberi fajl, potražite kompajlirani target/onlyoffice-jira-app.jar fajl i kliknite Otpremi. Sačekajte dok se aplikacija instalira.
   

Konfigurisanje ONLYOFFICE konektora za Jira

Kliknite na dugme Konfiguriši ispod instalirane Jira ONLYOFFICE integracione aplikacije na stranici Upravljanje aplikacijama ili pronađite aplikaciju u sekciji OSTALO na stranici Upravljanje aplikacijama.

Document Server

1. U polju Adresa servisa za uređivanje dokumenata, navedite IP adresu ili naziv hosta servera na kojem je instaliran ONLYOFFICE Docs.
   Adresa ONLYOFFICE Docs mora biti dostupna iz Jira, kao i adresa Jira mora biti dostupna iz ONLYOFFICE Docs.
2. Onemogući verifikaciju sertifikata (nesigurno) - označite ovu opciju da biste onemogućili verifikaciju sertifikata i omogućili Jira da uspostavi vezu sa ONLYOFFICE Docs ako koristite samopotpisani sertifikat za vaš ONLYOFFICE Docs (u suprotnom, Jira neće validirati samopotpisani sertifikat i neće dozvoliti vezu sa/iz ONLYOFFICE Docs). Ovo je nesigurno rešenje, i preporučujemo da zamenite sertifikat onim koji je izdao neki CA.
3. Navedite Tajni ključ (ostavite prazno da onemogućite) - tajni ključ za validaciju JSON web 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. Potrebno je da ga omogućite i na strani Jira: pronađite vaš tajni ključ u ONLYOFFICE Docs konfiguracionom fajlu, zatim navedite isti tajni ključ u postavkama konektora. Za više detalja, pogledajte sekciju Omogućavanje JWT za integraciju ONLYOFFICE i Jira u ovom članku.
4. Header za autorizaciju (ostavite prazno da koristite podrazumevani header) - autorizacioni JWT header korišćen u ONLYOFFICE je Authorization. U slučaju da je ovaj header u konfliktu sa vašim podešavanjima, možete ga promeniti u prilagođeni header.
5. Poveži se sa demo ONLYOFFICE Document Server - pokrenite test server.
   VažnoOvo je javni test server koji će biti dostupan tokom 30-dnevnog perioda. Nemojte deliti vaše osetljive podatke tamo.

Napredna podešavanja servera

Odeljak Napredna podešavanja servera može se koristiti ako vaša mrežna konfiguracija ne dozvoljava zahteve između instaliranog Jira Software i ONLYOFFICE Docs koristeći javne adrese. U tom slučaju, navedite adrese za interne zahteve u odgovarajućim poljima:

1. Adresa servera za interne zahteve iz Document Editing Service - adresa Jira Software servera za interne zahteve iz ONLYOFFICE Docs
2. Adresa Document Editing Service za interne zahteve sa servera - adresa ONLYOFFICE Docs za interne zahteve sa Jira Software servera

Opšta podešavanja

1. Formati za uređivanje - označite polje pored formata koji su podržani u vašem Jira okruženju.

   Može doći do gubitka podataka prilikom čuvanja u navedenim formatima zbog ograničenja formata.

2. Interfejs urednika - prilagodite interfejs urednika:
   • Prikaži dugme za meni Chat - sakrij/prikaži ikonu ugrađenog Chata na levoj traci.
   • Prikaži zaglavlje kompaktnije - sakrij/prikaži tekst ikona na gornjoj traci sa alatkama.
   • Prikaži dugme za meni Povratne informacije i podrška - sakrij/prikaži dugme Povratne informacije i podrška na levoj traci.
   • Prikaži dugme za meni Pomoć - sakrij/prikaži dugme Pomoć na levoj traci.
   • Prikaži zaglavlje trake sa alatkama u monohromatskom stilu - prebacite gornju traku sa alatkama na monohromatsku paletu boja.

Bezbednost

1. Omogući dodatke - omogućite/onemogućite podršku za dodatke u urednicima.
2. Pokreni makroe dokumenta - omogućite/onemogućite pokretanje makroa unutar urednika.
3. Omogući zaštitu dokumenta za - izaberite da li želite da omogućite svim korisnicima da omoguće zaštitu lozinkom za dokumente ili samo vlasniku dokumenta.

Kliknite Sačuvaj da biste sačuvali podešavanja.

Kako funkcioniše

Integracija sa ONLYOFFICE prati API dokumentovan ovde.

1. Korisnik odlazi na priloge u Jira i bira akciju Uredi u ONLYOFFICE.
2. Jira šalje zahtev ka OnlyOfficeEditorServlet (URL u formi: /plugins/servlet/onlyoffice/doceditor?attachmentId=$attachment.id).
3. Jira šalje dokument usluzi skladištenja dokumenata ONLYOFFICE i dobija privremeni link.
4. Jira 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 od strane svojstva files.docservice.url.api);
   • key: UUID koji upućuje ONLYOFFICE Docs da li da ponovo preuzme dokument ili ne;
   • title: naslov (ime) dokumenta.
5. Jira uzima ovaj objekat i konstruira stranicu iz freemarker šablona, popunjavajući sve te vrednosti kako bi klijentski pretraživač mogao da učita urednik.
6. Klijentski pretraživač šalje zahtev ka JavaScript biblioteci iz ONLYOFFICE Docs i šalje ONLYOFFICE Docs konfiguraciju DocEditor sa navedenim svojstvima.
7. Zatim ONLYOFFICE Docs preuzima dokument iz skladišta dokumenata 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 Jira da su klijenti završili sa uređivanjem dokumenta i zatvorili ga.
10. Dokument sa svim izmenama se čuva kao novi prilog sa dodatkom na ime fajla.

Omogućavanje JWT za integraciju ONLYOFFICE i Jira

Da bi zaštitili dokumente od neovlašćenog pristupa, ONLYOFFICE urednici koriste JSON Web Token (JWT). Token se dodaje u konfiguraciju prilikom inicijalizacije Document Editor-a 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 verzije v7.2 ONLYOFFICE Docs, JWT je omogućen po defaultu i tajni ključ se automatski generiše. Potrebno je da pronađete vaš tajni ključ u konfiguracionom fajlu ONLYOFFICE Docs, zatim navedite isti tajni ključ u podešavanjima konektora.

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

1. Otvorite local.json fajl 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
3. Automatski generisani tajni ključ je naveden u tri sekcije. Možete zameniti podrazumevanu vrednost tajnog ključa 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
``````html
4. Ako napravite izmene, sačuvajte ih i restartujte usluge kako 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.

Povezivanje sa demo verzijom ONLYOFFICE Docs

Počevši od verzije 2.0.0 ONLYOFFICE konektora, možete isprobati ONLYOFFICE online uređivače unutar Jira bez instaliranja ONLYOFFICE Docs.

Da biste uključili vezu, označite polje Poveži se sa demo serverom ONLYOFFICE Docs i kliknite na dugme Sačuvaj.