Narzędzie wiersza poleceń
autosignly to małe CLI do pracy nad integracją na własnej maszynie. Jego główne zadanie:
przekazywanie webhooków na localhost bez wystawiania laptopa do internetu i bez stawiania
tunelu.
- npm: autosignly
- Kod i README: tools/cli
npm install -g autosignly
Wersje: wspierana linia to 1.0.*. Najnowsze wydanie każdej paczki znajdziesz wśród
tagów w repozytorium.
Wymaga Node 20 lub nowszego.
Logowanie
autosignly login
Narzędzie poprosi o klucz i sekret API. Sekret jest wczytywany bez wyświetlania i nie trafia do
historii powłoki. Dane logowania są zapisywane per adres API w
~/.config/autosignly/credentials.json, więc logowanie produkcyjne i sandboxowe mogą istnieć
obok siebie. Narzędzie pokazuje, do jakiego środowiska prowadzi klucz, i wyraźnie ostrzega, gdy
jest to produkcja; firmę wypisuje listen, zanim zacznie przekazywać zdarzenia.
Przekazywanie zdarzeń
autosignly listen --forward-to http://localhost:8000/webhooks/autosignly
Każde zdarzenie trafia pod ten adres jako POST z oryginalnymi nagłówkami X-Webhook-Signature
i X-Webhook-Timestamp, a treść przychodzi bajt w bajt taka, jaka została podpisana — więc
weryfikacja podpisu napisana pod produkcję działa lokalnie bez zmian.
Każde doręczenie jest raportowane na bieżąco:
ok DOCUMENT_SIGNED -> 200 (48 ms)
Flaga --skip-verify pomija nagłówki z podpisem, dopóki Twój handler nie ma jeszcze klucza.
Wylogowanie
autosignly logout
Usuwa zapisane dane logowania dla bieżącego adresu API.