Preskočiť na obsah
Dakoty — PomocníkDakoty — PomocníkDakoty — Pomocník

Ako zabezpečiť integrácie

Vyžaduje oprávnenieSpravovať - Integrácie

Čo dosiahnete: integrácie, o ktoré sa nemusíte báť

Section titled “Čo dosiahnete: integrácie, o ktoré sa nemusíte báť”

Kľúč od bytu tiež nedávate každému a s kľúčmi od Dakoty je to rovnaké. Po prečítaní viete, čo dať aplikácii za práva, čo robiť, keď kľúč unikne, a ako si príjemca overí, že správa prišla od Dakoty. Trvá to asi 5 minút.

Kto môže spravovať kľúče a webhooky

Section titled “Kto môže spravovať kľúče a webhooky”

Kľúče a webhooky spravuje vlastník organizácie alebo používateľ, ktorého rola má oprávnenie Spravovať - Integrácie. Kľúč má vždy len vlastné oprávnenia, nie vaše.

Zásady pre API kľúče

Section titled “Zásady pre API kľúče”
  • Najmenej práv. Dajte kľúču len oblasti, ktoré scenár potrebuje. Voľba Len čítanie je bezpečná pre reporty.
  • Jeden kľúč pre jednu aplikáciu. Zrušenie jedného nepoloží ostatné.
  • Platnosť. Pole Platnosť je predvolene 1 rok. Kľúč bez obmedzenia radšej nepoužívajte.
  • Kľúč patrí do hlavičky Authorization: Bearer dk_live_…, nie do adresy a nie do e-mailu či chatu.
  • Kontrola. V zozname API kľúče vás štítok Nepoužitý 90+ dní upozorní na kľúč, ktorý môžete zrušiť.

Ako zrušiť uniknutý API kľúč – krok za krokom

Section titled “Ako zrušiť uniknutý API kľúč – krok za krokom”
  1. Otvorte Nastavenia organizácie → Integrácie → API kľúče.
  2. Pri kľúči kliknite na tri bodky a vyberte Zrušiť kľúč.
  3. Potvrďte tlačidlom Zrušiť kľúč.
  4. Vytvorte nový kľúč tlačidlom Nový API kľúč a vložte ho do Make, Zapieru alebo n8n.
  5. Pri Naposledy použitý skontrolujte, kedy a z akej aplikácie sa kľúč používal.

Zrušený kľúč prestane fungovať okamžite. Webhooky, ktoré si cez neho zapli Make alebo Zapier, sa zmažú a aplikácia ich vytvorí znova s novým kľúčom.

Ako overiť podpis webhooku

Section titled “Ako overiť podpis webhooku”

Každá správa z Dakoty nesie hlavičky webhook-id, webhook-timestamp a webhook-signature podľa štandardu Standard Webhooks. Príjemca podpis prepočíta tajným kľúčom webhooku (whsec_…) a porovná. Podpisuje sa reťazec webhook-id.webhook-timestamp.telo algoritmom HMAC-SHA256; v hlavičke webhook-signature je podpis v tvare v1,… a pri výmene kľúča s prekrytím ich je viac (stačí, aby sedel jeden).

Pri overovaní dodržte tieto zásady:

  • Podpis počítajte z nespracovaného (raw) tela správy tak, ako prišlo, pred parsovaním JSON. Po opätovnom zápise JSON sa podpis nezhodne.
  • Odmietnite správy so starým webhook-timestamp (odporúčame odchýlku najviac 5 minút od vášho času), inak by niekto mohol zachytenú správu poslať znova (replay). Pomáha aj webhook-id: už spracované ID ignorujte.
  • Podpisy porovnávajte funkciou s konštantným časom (napr. crypto.timingSafeEqual, hash_equals, hmac.compare_digest), nie obyčajným ==.
  • Najjednoduchšie je použiť oficiálnu knižnicu standardwebhooks, ktorá robí všetky tieto kroky za vás.

Ukážky pre Node, PHP a Python nájdete v detaile webhooku v záložke Podpis v časti Ako overiť podpis. Starší webhook (štítok Starší formát) používa pôvodný podpis X-Dakoty-Signature. Pozor: adresa „catch hook“ v Make alebo Zapieri podpis overiť nevie, preto ju držte v tajnosti. Prejsť na nový formát môžete tlačidlom Prejsť na nový formát; telo správy sa tým zmení, takže príjemcu treba upraviť.

Ako zobraziť a vymeniť tajný kľúč webhooku

Section titled “Ako zobraziť a vymeniť tajný kľúč webhooku”
  1. Otvorte webhook cez tri bodky a Detail a doručenia.
  2. Prepnite na záložku Podpis.
  3. Kliknite na Zobraziť, zadajte Vaše heslo a kliknite na Zobraziť kľúč. Každé zobrazenie sa zaznamená.
  4. Na výmenu kliknite na Vymeniť kľúč a vyberte Hneď alebo Starý platí ešte 24 hodín.
  5. Potvrďte tlačidlom Vymeniť kľúč, nový kľúč skopírujte a kliknite na Mám ho uložený.

Pri voľbe Hneď starý kľúč prestane platiť okamžite. Pri 24-hodinovom prekrytí podpisujeme oboma kľúčmi, aby ste stihli prepnúť príjemcu; starší formát to nepodporuje.

Limity a ochrana

Section titled “Limity a ochrana”

Predvolene smie kľúč poslať 120 požiadaviek za minútu a organizácia spolu 600 (pre jednotlivé organizácie sa môžu líšiť). Predvolený počet kľúčov je 20 a webhookov 25. Pri prekročení dostanete chybu 429 s hlavičkou Retry-After. Zobrazenie tajného kľúča webhooku je obmedzené na 5 volaní za 15 minút na používateľa (počíta sa každé zobrazenie, nielen chybné heslo). Webhooky smerujú len na verejné adresy https://.

Časté problémy so zabezpečením

Section titled “Časté problémy so zabezpečením”

Zabudol som tajný kľúč webhooku. Zobrazte ho v záložke Podpis, alebo ho vymeňte.

Zobrazenie kľúča hlási chybné heslo. Zadajte heslo svojho účtu v Dakoty. Zobrazenie kľúča je obmedzené na 5 pokusov za 15 minút, potom musíte počkať.

Starý kľúč v Make prestal fungovať. Zrejme bol zrušený alebo vypršal. Vytvorte nový.

Nenašli ste svoj problém? Opýtajte sa Milana: vpravo hore kliknite na svoje meno a vyberte Podpora a pomoc. Milan je náš AI asistent a o Dakoty vie veľa; keď si nebude istý, odovzdá vás kolegom z podpory.

Súvisiace návody k bezpečnosti

Section titled “Súvisiace návody k bezpečnosti”