Instalacija ONLYOFFICE Docs za Docker na lokalnom serveru

Generisanje samopotpisanih sertifikata

Generisanje samopotpisanih SSL sertifikata uključuje jednostavnu proceduru u 3 koraka

KORAK 1: Kreirajte privatni ključ servera

openssl genrsa -out onlyoffice.key 2048

KORAK 2: Kreirajte zahtev za potpisivanje sertifikata (CSR)

openssl req -new -key onlyoffice.key -out onlyoffice.csr

KORAK 3: Potpišite sertifikat koristeći privatni ključ i CSR

openssl x509 -req -days 365 -in onlyoffice.csr -signkey onlyoffice.key -out onlyoffice.crt

Sada ste generisali SSL sertifikat koji je važeći 365 dana.

Jačanje sigurnosti servera

Ovaj deo vam pruža uputstva kako da ojačate sigurnost vašeg servera.

Da biste to postigli, potrebno je da generišete jače DHE parametre.

openssl dhparam -out dhparam.pem 2048

Instalacija SSL sertifikata

Od četiri generisana fajla, potrebno je instalirati onlyoffice.key, onlyoffice.crt i dhparam.pem fajlove na onlyoffice server. CSR fajl nije potreban, ali se pobrinite da ga bezbedno sačuvate (u slučaju da vam ikada ponovo zatreba).

Podrazumevana putanja na kojoj je onlyoffice aplikacija konfigurisana da traži SSL sertifikate je /var/www/onlyoffice/Data/certs, ali se to može promeniti korišćenjem opcija konfiguracije SSL_KEY_PATH, SSL_CERTIFICATE_PATH i SSL_DHPARAM_PATH.

Putanja /var/www/onlyoffice/Data/ je putanja skladišta podataka, što znači da morate kreirati folder nazvan certs unutar /app/onlyoffice/DocumentServer/data/ i kopirati fajlove u njega, a kao meru sigurnosti ažuriraćete dozvole na fajlu onlyoffice.key da bude čitljiv samo od strane vlasnika.

mkdir -p /app/onlyoffice/DocumentServer/data/certs
cp onlyoffice.key /app/onlyoffice/DocumentServer/
  
data/certs/
cp dhparam.pem /app/onlyoffice/DocumentServer/data/certs/
chmod 400 /app/onlyoffice/DocumentServer/data/certs/onlyoffice.key

I ponovo pokrenite Docker kontejner:

sudo docker restart {{DOCUMENT_SERVER_ID}}

Sada ste samo jedan korak udaljeni od osiguravanja naše aplikacije.

Dostupni parametri konfiguracije

U nastavku je kompletna lista parametara koji se mogu postaviti pomoću promenljivih okruženja.

• ONLYOFFICE_HTTPS_HSTS_ENABLED: Napredna opcija konfiguracije za isključivanje HSTS konfiguracije. Primjenjivo samo kada se koristi SSL. Podrazumevana vrednost je true.
• ONLYOFFICE_HTTPS_HSTS_MAXAGE: Napredna opcija konfiguracije za postavljanje HSTS max-age u onlyoffice NGINX vHost konfiguraciji. Primjenjivo samo kada se koristi SSL. Podrazumevana vrednost je 31536000.
• SSL_CERTIFICATE_PATH: Putanja do SSL sertifikata koji će se koristiti. Podrazumevana vrednost je /var/www/onlyoffice/Data/certs/tls.crt.
• SSL_KEY_PATH: Putanja do privatnog ključa SSL sertifikata. Podrazumevana vrednost je /var/www/onlyoffice/Data/certs/tls.key.
• SSL_DHPARAM_PATH: Putanja do Diffie-Hellman parametra. Podrazumevana vrednost je /var/www/onlyoffice/Data/certs/dhparam.pem.
• SSL_VERIFY_CLIENT: Omogućava verifikaciju klijentskih sertifikata koristeći CA_CERTIFICATES_PATH file. Podrazumevana vrednost je false.
• DB_TYPE: Tip baze podataka. Podržane vrednosti su postgres, mariadb ili mysql. Podrazumevana vrednost je postgres.
• DB_HOST: IP adresa ili ime hosta gde se pokreće server baze podataka.
• DB_PORT: Broj porta servera baze podataka.
• DB_NAME: Ime baze podataka koja će biti kreirana pri pokretanju slike.
• DB_USER: Novo korisničko ime sa superuser dozvolama za nalog baze podataka.
• DB_PWD: Lozinka postavljena za nalog baze podataka.
• AMQP_URI: AMQP URI za povezivanje sa serverom poruka.
• AMQP_TYPE: Tip servera poruka. Podržane vrednosti su rabbitmq ili activemq. Podrazumevana vrednost je rabbitmq.
• REDIS_SERVER_HOST: IP adresa ili ime hosta gde se pokreće Redis server.
• REDIS_SERVER_PORT: Broj porta Redis servera.
• REDIS_SERVER_PASS: Lozinka za Redis server. Lozinka nije postavljena po podrazumevanju.
• NGINX_WORKER_PROCESSES: Definiše broj NGINX radnih procesa.
• NGINX_WORKER_CONNECTIONS: Postavlja maksimalan broj istovremenih konekcija koje može otvoriti NGINX radni proces.
• SECURE_LINK_SECRET: Definiše tajnu za nginx config direktivu secure_link_md5. Podrazumevana vrednost je random string.
• JWT_ENABLED: Specifikuje omogućavanje validacije JSON web tokena od strane ONLYOFFICE Docs. Podrazumevana vrednost je true.
• JWT_SECRET: Definiše tajni ključ za validaciju JSON web tokena u zahtevu ka ONLYOFFICE Docs. Podrazumevana vrednost je nasumična vrednost.
• JWT_HEADER: Definiše HTTP zaglavlje koje će se koristiti za slanje JSON web tokena. Podrazumevana vrednost je Authorization.
• JWT_IN_BODY: Specifikuje omogućavanje validacije tokena u telu zahteva ka ONLYOFFICE Docs. Podrazumevana vrednost je false.
• ALLOW_META_IP_ADDRESS: Definiše da li je dozvoljeno povezivanje meta IP adrese ili ne. Podrazumevana vrednost je false.
• ALLOW_PRIVATE_IP_ADDRESS: Definiše da li je dozvoljeno povezivanje privatne IP adrese ili ne. Podrazumevana vrednost je false.
• WOPI_ENABLED: Specifikuje omogućavanje wopi handlera. Podrazumevana vrednost je false.
• USE_UNAUTHORIZED_STORAGE: Postavite na true ako koristite samopotpisane sertifikate za vaš server za skladištenje, npr. Nextcloud. Podrazumevana vrednost je false.
• GENERATE_FONTS: Kada je true, regeneriše listu fontova i sličice fontova itd. pri svakom pokretanju. Podrazumevana vrednost je true.
• METRICS_ENABLED: Specifikuje omogućavanje StatsD za ONLYOFFICE Docs. Podrazumevana vrednost je false.
• METRICS_HOST: Definiše host za slušanje StatsD. Podrazumevana vrednost je localhost.
• METRICS_PORT: Definiše port za slušanje StatsD. Podrazumevana vrednost je 8125.
• METRICS_PREFIX: Definiše prefiks za StatsD metrike za backend servise. Podrazumevana vrednost je ds..
• LETS_ENCRYPT_DOMAIN: Definiše domen za Let's Encrypt sertifikat.
• LETS_ENCRYPT_MAIL: Definiše email adresu administratora domena za Let's Encrypt sertifikat.