Gotify - proste i skuteczne

1. Wstęp

Na początek warto wyjaśnić ogólne pojęcia funkcjonujące w Gotify .

1. Klient - to urządzenie lub aplikacja, która może zarządzać klientami, wiadomościami i aplikacjami. Z drugiej strony klient nie może wysyłać wiadomości.

2. Aplikacja - to urządzenie lub aplikacja, które mogą tylko wysyłać wiadomości.

3. Użytkownik - może tylko zarządzać (zobaczyć, edytować, usunąć) klienta oraz aplikację (włącznie z wiadomościami wysłanymi przez aplikację)

4. Wiadomość - posiada następujące atrybuty: content (zawartość), title (tytuł), creation date (datę utworzenia), application id (id aplikacji) oraz priority (priorytet).

Schemat działania - źródło: gotify.net

2. Gotify - jak to działa ?

2.1. Instalacja

Można gotify zainstalować jako kontener za pomocą Dockera lub jako tzw “binarke” - należy wówczas pobrać i uruchomić odpowiedni dla platformy plik binarny. Ponieważ Gotify został napisany w Go, system do działania korzysta tylko z jednego wykonywalnego pliku binarnego. Ma to swoje wady i zalety …

Na urządzenia z Androidem aplikacja gotify jest dostępna w sklepie Google Play. Działa jako klient (w obecnej wersji w ograniczonym zakresie).

2.2 Konfiguracja

System szuka plików konfiguracyjnych w:

• ./config.yml
• /etc/gotify/config.yml

Obsługuje również zmienne środowiskowe. Szczegóły: “Gotify config”

2.3 Pierwsze logowanie

Po uruchomieniu serwera gotify można zalogować się do panelu zarządzania. Po pierwszym uruchomieniu jest tworzone konto admin z hasłem: admin (jesli nie zostało to zmienione w parametrach konfiguracyjnych). Po zalogowaniu się jest wskazane, aby utworzyć konto z prawami administracyjnymi, natomiast konto admin usunąć.

W przypadku, gdyby jednak konto admin zostało, zalecamy oczywiście zmianę hasła!

2.4 Wysłanie wiadomości jako PUSH - test usługi

Jak wcześniej wspomniano, do wysyłania wiadomości do gotify konieczna jest aplikacja. Tylko użytkownik, który stworzył wpis dla aplikacji w panelu zarządzania gotify może zobaczyć komunikaty wysyłane przez tę aplikację. Aplikację identyfikuje unikalny token, który służy do uwierzytelnienia aplikacji.

Jeśli aplikacja została już założona i jest przypisany do niej token, wówczas można użyć narzędzi typu curl, HHTPie lub każdego innego klienta http/https.

Przykład użycia:

$ curl “https://push.example.de/message?token=APP-TOKEN" -F “title=my title” -F “message=my message” -F “priority=5”

$ http -f POST “https://push.example.de/message?token=APP-TOKEN" title=“my title” message=“my message” priority=“5”

gdzie APP-TOKEN to unikalny token aplikacji.

Można również wykorzystać gotify/cli, w takim przypadku url i token są przechowywane w pliku konfiguracyjnym.

3. Podsumowanie

Gotify to przydatne narzędzie, łatwe w instalacji i utrzymaniu. Można je instalować we własnej infrastrukturze lub w chmurze. Dobra dokumentacja i prostota wykorzystania (łatwe użycie we własnych skryptach) sprawiają, iż w łatwy sposób można otrzymywać ważne i krytyczne powiadomienia na swoje urządzenie mobilne.

Zachęcamy do odwiedzenia strony projektu gotify.net , aby zapoznać się ze wszystkimi możliwościami systemu.