Federacja z inną organizacją
Połączysz swoją Gadkę z Gadką innej firmy, żeby rozmawiać bez zakładania kont gościnnych.
Federacja pozwala pisać do osób z innej organizacji, która ma własną Gadkę, i zapraszać je do wspólnych kanałów. Zaufanie muszą potwierdzić administratorzy obu stron.
Zanim zaczniesz
- Klucz licencji Standard lub Enterprise.
- Publiczny adres serwera zaczynający się od
https://(kluczapi.public_url). - Serwery obu organizacji muszą się wzajemnie widzieć w sieci.
- Kontakt do administratora drugiej organizacji inną drogą niż Gadka.
Krok 1. Włącz federację na serwerze
Wygeneruj klucz, którym serwer podpisuje żądania do innych serwerów:
sudo openssl genpkey -algorithm ed25519 -out /etc/gadka/federation-key.pem
sudo chown root:gadka /etc/gadka/federation-key.pem
sudo chmod 0640 /etc/gadka/federation-key.pemDodaj do /etc/gadka/gadka.yaml:
federation:
enabled: true
signing_key_file: /etc/gadka/federation-key.pemUruchom serwer ponownie: sudo systemctl restart gadka.
Krok 2. Wymień adresy organizacji
- Otwórz Admin, Federacja.
- W polu Adres Twojej organizacji kliknij Kopiuj adres. Adres ma postać
firma@gadka.example.com. - Przekaż adres administratorowi drugiej organizacji telefonicznie albo e-mailem i poproś o jego adres.
Krok 3. Dodaj zaufaną organizację
- Kliknij Dodaj organizację.
- Wpisz Adres organizacji i kliknij Dodaj.
- Relacja ma stan Czeka na ich akceptację, dopóki druga strona nie doda Twojego adresu. Potem stan zmienia się na Aktywna.
Krok 4. Ustaw, na co pozwalasz
W szczegółach relacji, w części Na co pozwalasz, zaznacz: Wiadomości bezpośrednie, Wspólne kanały, Pliki, Widoczność obecności. Każda strona ustawia to osobno. Obecność jest widoczna tylko wtedy, gdy zezwalają na nią obie strony.
Co widzi druga organizacja
- Treść kanałów, do których jej osoby zostały zaproszone i zaproszenie przyjęły, oraz rozmów bezpośrednich.
- Wspólny kanał i jego pliki są przechowywane u organizacji, która go utworzyła.
- Osobę z innej organizacji znajduje się tylko po pełnym adresie e-mail. Listy osób drugiej strony nie da się przeglądać.
Odwołanie zaufania i blokady
- Odwołaj zaufanie działa natychmiast: osoby z tej organizacji tracą dostęp do wspólnych kanałów, a rozmowy bezpośrednie z nimi stają się tylko do odczytu.
- Zablokuj przy konkretnej osobie odcina tylko ją, bez kończenia relacji.
- Odśwież klucze kliknij tylko wtedy, gdy administrator drugiej strony potwierdził inną drogą, że wymienił klucz swojego serwera.
Sieć
Adresy /federation/v1/ i /.well-known/gadka-federation na Twoim serwerze muszą być osiągalne dla serwerów zaufanych organizacji. Serwer łączy się tylko z adresami publicznymi. Relację z serwerem w sieci prywatnej oznacza się opcją Serwer w sieci prywatnej (on-prem), która wymaga ustawienia federation.allow_private_networks: true.