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-keyKrok 2. Zarejestruj aplikacje u dostawców
Adres zwrotny dla obu dostawców:
https://gadka.example.com:6543/v1/calendar/oauth/callback| Dostawca | Gdzie | Wymagane uprawnienia |
|---|---|---|
| Google Cloud Console | zakres calendar.events | |
| Microsoft | Entra ID | Calendars.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-keyDostawca 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 gadkaW 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
- Kalendarz i spotkania — instrukcja dla użytkowników
- Polityki workspace'u