Spis treści dokumentacji

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:// (klucz api.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.pem

Dodaj do /etc/gadka/gadka.yaml:

federation:
  enabled: true
  signing_key_file: /etc/gadka/federation-key.pem

Uruchom serwer ponownie: sudo systemctl restart gadka.

Krok 2. Wymień adresy organizacji

  1. Otwórz Admin, Federacja.
  2. W polu Adres Twojej organizacji kliknij Kopiuj adres. Adres ma postać firma@gadka.example.com.
  3. Przekaż adres administratorowi drugiej organizacji telefonicznie albo e-mailem i poproś o jego adres.

Krok 3. Dodaj zaufaną organizację

  1. Kliknij Dodaj organizację.
  2. Wpisz Adres organizacji i kliknij Dodaj.
  3. 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.

Co dalej