This project is not yet finished. Public release planned end of 2026.Contact us for details
Poradniki

Bezpieczeństwo i dane

Co jest szyfrowane, co zostaje na Twojej instancji i dokładnie co widzą usługi prowadzone przez Ionide.

Ionide nie przechowuje środków (custody) i nie jest giełdą. Twoje aktywa zostają na koncie giełdy, które podłączasz, a Ionide otrzymuje wyłącznie dostęp API przeznaczony do handlu. Ta strona opisuje, jak przechowywane są Twoje dane dostępowe giełd oraz dokładnie jakie dane opuszczają (lub nie) Twoją własną, samodzielnie hostowaną instancję.

Jak przechowywane są Twoje klucze API giełd

  • Klucze są szyfrowane algorytmem AES-256-GCM przed zapisaniem w lokalnej bazie danych Twojej instancji (wolumen Dockera, /app/data), przy użyciu klucza, który generujesz sam: instalator uruchamia za Ciebie openssl rand -hex 32 i zapisuje go w lokalnym .env jako SECRETS_ENCRYPTION_KEY.
  • Klucz szyfrowania jest niezależny od tokenu bota Discord, więc rotacja jednego nigdy nie unieważnia drugiego.
  • /secrets action:status pokazuje, dla których giełd skonfigurowano dane dostępowe, nigdy ich nie odszyfrowując. Zapisane wartości nigdy nie są wyświetlane z powrotem w Discordzie, nawet właścicielowi bota.
  • Odszyfrowanie zachodzi wyłącznie w pamięci, w momencie gdy bot otwiera lub sprawdza transakcję. Nigdy nie jest częścią żadnego żądania do usługi prowadzonej przez Ionide.

Co nigdy nie opuszcza Twojej instancji

Twój surowy klucz API, sekret i (dla BitgetBitget) passphrase nigdy nie są nigdzie przesyłane po ich wpisaniu przez /secrets action:set: ani do product-api, ani do alpha-engine, ani do logów. Są używane wyłącznie do bezpośredniego uwierzytelniania bota w wybranej giełdzie. Jeśli zgubisz SECRETS_ENCRYPTION_KEY, tych zapisanych danych nie odszyfruje nikt, łącznie z nami. Musisz wtedy ponownie uruchomić /secrets action:set z nowym kluczem.

Co Ionide otrzymuje automatycznie

Przy pierwszym uruchomieniu bot rejestruje wygenerowany identyfikator instalacji, aby Ionide mógł utworzyć tożsamość instancji, jeszcze przed uruchomieniem /setup. Po konfiguracji żądania używają tego identyfikatora instancji i danych dostępowych przypisanych do instancji; klucz licencyjny nie jest dołączany do każdego żądania.

  • Wymagany heartbeat (co 5 minut, gdy bot działa): wersja produktu, środowisko wdrożenia, statystyki opóźnień API na giełdę, zużycie pamięci/czas działania/liczba wątków JVM oraz łączne liczniki wyników wejść/wyjść z transakcji (udane, nieudane, symulowane). Dane są potrzebne do działania licencji i diagnozowania niezawodności instancji samodzielnie hostowanych.
  • Raporty błędów (wysyłane natychmiast, poza głównym wątkiem bota, przy nieoczekiwanych awariach): zredagowana treść wyjątku, stack trace, krótka etykieta miejsca wystąpienia, identyfikator korelacji i identyfikator danego uruchomienia. Dzięki temu problemy mogą zostać wykryte i naprawione bez czekania na ręczne zgłoszenie.

To pełna lista wymaganej telemetrii. Nie opuszczają Twojej instancji: dane dostępowe giełd, adresy portfeli, salda, pozycje, symbole, strony, wartości nominalne, PnL, funding, szczegóły zleceń ani historia transakcji.

Pakiety wsparcia: wysyłane tylko na Twoje żądanie

Pakiet wsparcia jest oddzielny od wymaganej telemetrii. Zostaje wysłany tylko, gdy właściciel bota wyraźnie uruchomi /share-support-bundle z jednorazowym kluczem otrzymanym od wsparcia. Może zawierać:

  • Zredagowany bieżący log bota.
  • Zredagowany dziennik incydentu używany do zbadania awarii. Może zawierać nazwy giełd, symbole, ceny, opłaty oraz kontekst zleceń/wykonania potrzebny do odtworzenia incydentu.
  • Małe metadane runtime: identyfikator instancji, wersję bota, czas działania, dane pamięci/wątków oraz informację, czy rejestrator incydentów był włączony.
  • Notatkę podaną w komendzie.

Znane lokalne sekrety i popularne wzorce danych dostępowych są redagowane przed wysyłką. Znacząco ogranicza to ekspozycję, ale dopasowywanie wzorców w wolnym tekście logów nie gwarantuje wykrycia każdego nieznanego formatu sekretu. Jeśli Ionide nie potrafi odczytać lokalnych sekretów potrzebnych do bezpiecznej redakcji, przerywa cały upload. Pakiety wsparcia są przechowywane maksymalnie 90 dni, a następnie usuwane.

Zakres uprawnień

Ionide zawsze prosi wyłącznie o uprawnienia do handlu na kluczu API Twojej giełdy, nigdy o dostęp do wypłat. Zobacz Dodawanie kluczy API giełd po dokładne kroki dla każdej giełdy i uruchom /secrets action:test po ustawieniu klucza: sprawdza, czy klucz działa, i tam, gdzie API giełdy to udostępnia, potwierdza, że uprawnienia do wypłat są faktycznie wyłączone. Odwołaj klucz z panelu swojej giełdy w dowolnym momencie: bot natychmiast traci dostęp do handlu, ale i tak nigdy nie miał możliwości wyprowadzenia środków.

Gdy host ma stały publiczny wychodzący adres IP, ogranicz klucz przez allowlistę IP giełdy. Bez niej część giełd automatycznie wygasza klucze API. Ionide ostrzega każdego właściciela bota na Discordzie przed konserwatywnie oszacowaną datą wygaśnięcia i oznacza ją w /secrets action:status; wymień klucz przez /secrets action:set. To estymacja, nie data wygaśnięcia raportowana przez giełdę.

Sprawdzenie wychodzącego IP przez instalator

Po udanej instalacji instalator wykonuje jedno opcjonalne żądanie HTTPS wyłącznie przez IPv4 do https://api.ipify.org i wyświetla w terminalu zaobserwowany adres. ipify otrzymuje źródłowy adres IP tego żądania; Ionide nie otrzymuje z tego sprawdzenia żadnych danych. Wynik nigdy nie trafia do .env, bazy danych, logów, telemetrii ani pakietu wsparcia.

To tylko obserwacja z jednego momentu. Nie określa, czy IP jest stałe czy dynamiczne, i nie gwarantuje, że ruch do giełdy używa tej samej trasy. Dodaj wyświetlony adres do allowlisty giełdy tylko gdy wiesz, że Twój wychodzący IP jest stały. Gdy sprawdzenie się nie powiedzie, odpowiedź będzie nieprawidłowa albo host nie ma trasy IPv4, instalacja trwa dalej bez wyświetlenia adresu.

Twoja własna infrastruktura

Ionide działa jako kontener na infrastrukturze, którą kontrolujesz. Bezpieczeństwo hosta Dockera (aktualizacje systemu, dostęp SSH, kto może dotrzeć do Twojego demona Dockera) to Twoja odpowiedzialność, tak jak w przypadku każdej innej samodzielnie hostowanej usługi. Zobacz Self-hosting Ionide, aby dowiedzieć się, co robi instalator i gdzie znajdują się klucz szyfrowania oraz baza danych, żebyś mógł zrobić ich kopię zapasową.

Pytania?

Napisz na Discordzie lub [email protected].