Spis treści dokumentacji

Kalendarze

Włączysz na serwerze integrację z Google Workspace, Microsoft 365 i CalDAV.

Integracja kalendarzy pozwala użytkownikom zobaczyć spotkania w Gadce, dostać przypomnienie i automatycznie ustawić status na czas spotkania. Domyślnie jest wyłączona. Z dostawcami łączy się wyłącznie serwer, nigdy aplikacje użytkowników.

Zanim zaczniesz

  • Dostęp root do serwera.
  • Dla Google i Microsoft: możliwość zarejestrowania aplikacji OAuth u dostawcy.
  • Ruch wychodzący z serwera do hostów dostawcy. Zobacz Zapora i porty.

Krok 1. Wygeneruj klucz szyfrujący

Tokeny i hasła aplikacji są szyfrowane tym kluczem.

openssl rand -base64 32 | tr -d '\n' | sudo tee /etc/gadka/calendar-key > /dev/null
sudo chown root:gadka /etc/gadka/calendar-key
sudo chmod 0640 /etc/gadka/calendar-key

Krok 2. Zarejestruj aplikacje u dostawców

Adres zwrotny dla obu dostawców:

https://gadka.example.com:6543/v1/calendar/oauth/callback
DostawcaGdzieWymagane uprawnienia
GoogleGoogle Cloud Consolezakres calendar.events
MicrosoftEntra IDCalendars.ReadWrite, User.Read, offline_access

Sekret każdej aplikacji zapisz w osobnym pliku w /etc/gadka, z właścicielem root:gadka i trybem 0640. CalDAV nie wymaga rejestracji.

Krok 3. Włącz integrację w konfiguracji

calendar:
  enabled: true
  sync_interval: 5m
  google:    { client_id: "<id klienta>", client_secret_file: /etc/gadka/google-calendar-secret }
  microsoft: { client_id: "<id aplikacji>", client_secret_file: /etc/gadka/ms-calendar-secret, tenant: organizations }
  caldav:    { allowed_hosts: [cloud.example.com, caldav.icloud.com] }
crypto:
  mfa_key_file: /etc/gadka/mfa-key
  calendar_key_file: /etc/gadka/calendar-key

Dostawca jest dostępny tylko wtedy, gdy go skonfigurujesz. Pomiń te, których nie używasz. Wartość sync_interval musi mieścić się między 1m a 1h.

Krok 4. Uruchom ponownie i sprawdź

sudo systemctl restart gadka

W aplikacji otwórz Preferencje, sekcję Kalendarze. Skonfigurowani dostawcy mają przycisk Połącz.

Lista dozwolonych serwerów CalDAV

  • Sama nazwa hosta, np. cloud.example.com, dopuszcza tylko HTTPS na porcie 443.
  • Inny port wymaga pełnego adresu, np. https://dav.example.com:8443.
  • Wpis z http:// dopuszcza połączenie bez szyfrowania. Hasło aplikacji jest wtedy przesyłane otwartym tekstem, więc używaj go wyłącznie w zaufanej sieci wewnętrznej.

Polityka workspace'u

Właściciel lub administrator decyduje w Admin, Integracje kalendarzy, czy tytuły spotkań mogą trafiać do statusu. Zobacz Polityki workspace'u.

Co dalej