Spis treści dokumentacji

Podglądy i bezpieczeństwo linków

Włączysz podglądy linków i ustawisz ochronę przed stronami wyłudzającymi dane.

Gadka ma dwie niezależne funkcje związane z linkami: podglądy (domyślnie wyłączone) i sprawdzanie linków z Listą Ostrzeżeń CERT Polska (domyślnie włączone).

Podglądy linków

Podgląd to tytuł, opis i obraz strony pod wiadomością z linkiem. Strony pobiera wyłącznie serwer. Aplikacje nie łączą się z linkowanymi stronami.

Podglądy trzeba włączyć na dwóch poziomach.

1. Serwer. W /etc/gadka/gadka.yaml:

link_previews:
  enabled: true

Uruchom serwer ponownie: sudo systemctl restart gadka.

2. Workspace. Właściciel lub administrator otwiera Admin, Podglądy linków i wybiera jedną z opcji:

  • Włączone dla wszystkich linków,
  • Tylko wybrane domeny (po jednej w wierszu; obejmuje też subdomeny),
  • Wyłączone.

Dopóki nikt nie zapisze polityki, podglądy w workspace'ie są wyłączone.

KluczDomyślnieZnaczenie
link_previews.enabledfalsenadrzędny przełącznik instalacji
link_previews.proxypusteopcjonalne proxy wychodzące, np. http://proxy.example.com:3128
link_previews.timeout3slimit czasu pobrania
link_previews.max_page_bytes524288limit rozmiaru strony
link_previews.max_image_bytes1048576limit rozmiaru obrazu

Podglądy pojawiają się dla wiadomości wysłanych lub edytowanych po włączeniu, najwyżej dla 3 linków w wiadomości.

Bezpieczeństwo linków

Każdy link kliknięty w wiadomości przechodzi przez serwer i jest sprawdzany z Listą Ostrzeżeń CERT Polska. Domena z listy (i każda jej subdomena) się nie otwiera. Użytkownik widzi komunikat Link zablokowany.

KluczDomyślnieZnaczenie
link_safety.enabledtruefalse wyłącza sprawdzanie
link_safety.sourcehttps://hole.cert.pl/domains/v2/domains.txtadres listy: jedna domena w wierszu
link_safety.interval5mjak często serwer pobiera listę (od 1m do 6h)
link_safety.timeout30slimit czasu pobrania
link_safety.max_bytes16777216limit rozmiaru listy
link_safety.proxypusteopcjonalne proxy wychodzące

Stan listy widzi właściciel i administrator na stronie Podglądy linków, np. Lista Ostrzeżeń CERT Polska: aktualna.

Serwer bez dostępu do internetu

Masz dwie możliwości:

  • ustaw link_safety.source na adres wewnętrznej kopii pliku domains.txt, którą odświeżasz z sieci z dostępem do internetu,
  • albo ustaw link_safety.enabled: false.

Co dalej