Preskoči na sadržaj
HR

API i webhook za sigurno slanje tajni: tim, vlastita domena i vlastiti SMTP

Kad tvrtka šalje stotine lozinki i dokumenata mjesečno, ručno slanje postaje usko grlo. Kako Kriptano povezati s HR sustavom, helpdeskom i CRM-om preko API-ja, kako webhook javlja da je tajna otvorena te kako rade tim, vlastita domena i vlastiti SMTP.

api webhook vlastita domena smtp
Sadržaj članka
  1. Pregled: što je uključeno u koji paket
  2. API: tajne iz vaših sustava
  3. Webhook: događaji u stvarnom vremenu
  4. Tim i uloge: tko smije što
  5. Vlastita domena: linkovi pod vašim imenom
  6. Vlastiti SMTP i slanje s vaše domene e-pošte
  7. Sigurnost integracije: kontrolna lista
  8. Česta pitanja

Jedan jednokratni link napravite za pola minute. Stotinu mjesečno – za nove zaposlenike, resetirane lozinke, klijente i dobavljače – već je posao koji netko mora raditi ručno. Za tvrtke i razvojne timove Kriptano zato nudi pet gradivnih blokova: API, webhook, tim s ulogama, vlastita domena i vlastiti SMTP. U ovom vodiču objašnjavamo što svaki od njih radi, kako ih povezati s vašim sustavima i kako sve ostaje šifrirano u pregledniku.

Ako tek upoznajete Kriptano, počnite s vodičem Jednokratni link. Tehnička dokumentacija s primjerima nalazi se na stranici API.

Pregled: što je uključeno u koji paket

Sve funkcije koriste isto šifriranje: AES-256-GCM, a ključ je samo u linku iza znaka #. Paketi se razlikuju u opsegu i poslovnim funkcijama:

webhook, API, tim, vlastita domena i vlastiti SMTP po paketima Start, Pro i Pro Plus
Vlastita domena i vlastiti SMTP dio su paketa Pro Plus; API, webhook i tim dostupni su od paketa Pro.

Trenutne cijene i ograničenja uvijek su na stranici Paketi. Ako vam treba samo zahtjev za tajnu i šifrirani privitci, dovoljan je paket Start.

API: tajne iz vaših sustava

API omogućuje da vaš sustav sam napravi jednokratni link – kad HR otvori novi račun, kad helpdesk resetira lozinku ili kad CRM šalje pristupne podatke klijentu. Prijava ide API ključem u zaglavlju Authorization. Ključeve izrađujete u Moj račun, a u bazi se čuvaju samo kao sažeci.

API radi na dva načina:

  • Već šifrirani sadržaj – vaš kod šifrira tajnu istim formatom kao preglednik, a poslužitelj nikad ne vidi čisti tekst. To je preporučeni način za osjetljive integracije.
  • Čisti tekst – API šifrira tajnu istim formatom i ne sprema ključ. Ključ postoji samo u linku koji dobijete u odgovoru, pa ga vaš sustav mora odmah predati primatelju.
POST https://kriptano.com/wp-json/kriptano/v1/api/secrets
Authorization: Bearer <vaš API ključ>
Content-Type: application/json

{ "secret": "Početna lozinka: …", "expires": 86400, "passphrase": "…" }

→ 201 Created – odgovor sadrži jednokratni link s ključem iza #

Ostale opcije – broj otvaranja, oznaku za zapisnik, privitke – opisuje dokumentacija. Tipičan primjer je predaja početne lozinke novom zaposleniku, koju opisujemo u vodiču Pristupni podaci i početna lozinka. Zapisnik aktivnosti dostupan je i preko API-ja, pa ga možete povlačiti u vlastiti sustav za nadzor.

Webhook: događaji u stvarnom vremenu

Webhook je adresa na vašem poslužitelju na koju Kriptano šalje HTTPS POST s JSON-om kad se nešto dogodi – primjerice kad primatelj otvori tajnu. Vaš helpdesk tada može automatski zatvoriti tiket, SIEM zabilježiti događaj, a Slack kanal dobiti obavijest. Webhook nikad ne šalje sadržaj tajne, ključ ni šifrat – samo ID, oznaku i stanje, pa zero-knowledge model ostaje netaknut.

webhook – kako radi od API-ja do primatelja i natrag u helpdesk
Događaj secret.viewed stiže u vaš sustav nekoliko sekundi nakon što primatelj otvori link.
DogađajKada stiže
secret.creatednova tajna je napravljena
secret.viewedprimatelj je otvorio tajnu
secret.burnedtajna je uništena nakon zadnjeg otvaranja ili pogrešnih lozinki
secret.expiredrok je istekao, tajna nije otvorena
secret.deletedpošiljatelj je obrisao tajnu
request.created / request.answeredzahtjev za tajnu je poslan ili odgovoren
team.member_joined / team.member_removedpromjena u timu
Događaji koje webhook može javiti

Kako webhook isporučuje poruke

Kriptano poruku šalje odmah nakon događaja. Ako vaš poslužitelj ne odgovori statusom 2xx, slijede ponovni pokušaji nakon 1, 5, 30, 120 i 720 minuta. Nakon 15 uzastopnih neuspjeha adresa se automatski isključuje, a vi to vidite u Moj račun. Dopuštene su samo HTTPS adrese, bez preusmjeravanja i bez privatnih ili lokalnih IP adresa – zaštita od zloupotrebe za napade na unutarnju mrežu. Broj webhook adresa ovisi o paketu, a gumb „Pošalji probu” šalje probnu poruku ping.

Provjera potpisa

Svaka poruka ima zaglavlje X-Kriptano-Signature s vremenom i potpisom. Vaš poslužitelj izračuna HMAC-SHA256 nad vremenom i sirovim tijelom poruke, koristeći tajnu webhooka (whsec_…) koju ste dobili samo jednom, pri dodavanju adrese:

webhook – provjera HMAC potpisa u 4 koraka
Bez provjere potpisa svatko tko zna vašu adresu može poslati lažni događaj.
# Python – provjera potpisa
import hmac, hashlib, time
t, v1 = (p.split("=", 1)[1] for p in request.headers["X-Kriptano-Signature"].split(","))
ocekivano = hmac.new(TAJNA.encode(), f"{t}.{sirovo_tijelo}".encode(), hashlib.sha256).hexdigest()
if not hmac.compare_digest(ocekivano, v1) or abs(time.time() - int(t)) > 300:
    abort(400)

Za idempotentnu obradu koristite ID događaja iz tijela poruke ili zaglavlje X-Kriptano-Delivery: ponovni pokušaj nosi isti događaj, pa ga ne smijete obraditi dvaput.

Tri primjera iz prakse

  • Helpdesk – agent resetira lozinku, sustav preko API-ja napravi link i doda ga u odgovor korisniku. Kad stigne događaj secret.viewed, tiket se sam zatvara; ako stigne secret.expired, agent dobiva podsjetnik.
  • HR i IT onboarding – novi zaposlenik upisan je u HR sustav, IT skripta otvori račune i pošalje početnu lozinku jednokratnim linkom. Webhook javlja kad je zaposlenik link otvorio, pa IT zna da je predaja uspjela.
  • Agencija i klijenti – CRM za svakog novog klijenta pošalje zahtjev za tajnu za pristupne podatke hostinga. Događaj request.answered pomiče projekt u sljedeću fazu, a lozinka nikad ne prolazi kroz e-poštu.

Tim i uloge: tko smije što

U paketu Pro tim ima do 5 članova, a u paketu Pro Plus do 25. Uloge razdvajaju odgovornosti:

  • Vlasnik upravlja paketom i plaćanjem.
  • Administrator poziva i uklanja članove, uključuje obaveznu prijavu u dva koraka za cijeli tim i upravlja webhook adresama.
  • Član šalje tajne i zahtjeve, a u zapisniku vidi samo svoje događaje.

Timske politike postavljaju ista pravila za sve: obaveznu dodatnu lozinku, najdulji rok i najveći broj otvaranja, zadane vrijednosti obrasca te obaveznu prijavu Googleom ili Microsoftom. Tako i novi član od prvog dana radi po pravilima tvrtke, a revizor u zapisniku vidi da su se pravila primjenjivala.

Vlastita domena: linkovi pod vašim imenom

Primatelji sve češće s pravom sumnjaju u linkove nepoznatih domena. U paketu Pro Plus vlastita domena omogućuje da linkovi izgledaju kao tajne.firma.hr/…, a stranica tajne nosi vaš logo i boje. To pomaže i u edukaciji zaposlenika: „naši linkovi uvijek su na tajne.firma.hr” jednostavno je pravilo protiv lažnih poruka.

Postavljanje traje nekoliko minuta:

  1. U Moj račun → Brend i domena upišite poddomenu, primjerice tajne.firma.hr.
  2. Kod svog DNS pružatelja dodajte CNAME zapis prema domains.kriptano.com i TXT zapis za potvrdu vlasništva.
  3. Kliknite „Provjeri”. Certifikat se izdaje automatski pri prvom posjetu domeni.

Vlastita domena radi samo dok je paket aktivan i dok je vlasništvo potvrđeno, pa nitko ne može usmjeriti tuđu domenu na vaše tajne.

Vlastiti SMTP i slanje s vaše domene e-pošte

U paketima Pro i Pro Plus Kriptano može link sam dostaviti primatelju e-poštom – do pet primatelja po tajni. Ključ pritom jednom prolazi poslužiteljem radi slanja i ne sprema se. Zato uz dostavu e-poštom preporučujemo dodatnu lozinku koju javite drugim kanalom: tada tajnu ne može otvoriti ni poslužitelj ni pružatelj e-pošte.

U paketu Pro Plus poruke mogu ići na dva načina pod vašim imenom:

  • Vlastiti SMTP – Kriptano šalje preko vašeg poslužitelja e-pošte (priključci 25, 465, 587 ili 2525). Lozinka se sprema šifrirano, spajanje je dopušteno samo na javne adrese, a SMTP se uključuje tek nakon uspješne probne poruke.
  • Slanje s vaše domene – dodate domenu, postavite SPF, DKIM i MX zapise koje prikaže Moj račun i kliknete „Provjeri”. Javne domene poput Gmaila ili Outlooka nisu dopuštene.
vlastita domena i vlastiti SMTP – DNS zapisi CNAME, TXT, SPF, DKIM i MX
Svi zapisi s točnim vrijednostima prikazuju se u Moj račun → Brend i domena.

Vlastiti SMTP ima smisla kad vaša politika traži da sva odlazna pošta prolazi kroz vaš poslužitelj, primjerice zbog arhiviranja ili DLP pravila. Ako vam je važno samo da poruka stiže s vaše adrese, jednostavnija je opcija slanje s vaše domene.

Sigurnost integracije: kontrolna lista

  • API ključeve i tajnu webhooka čuvajte u upravitelju tajni, ne u kodu ni u repozitoriju.
  • Ključeve mijenjajte kad netko iz tima ode ili kad postoji sumnja na curenje.
  • Webhook potpis provjeravajte prije bilo kakve obrade.
  • Na webhook odgovarajte brzo, a sporu obradu radite asinkrono.
  • Linkove s ključem ne zapisujte u logove vašeg sustava.
  • Za osjetljive podatke koristite već šifrirani sadržaj i dodatnu lozinku.

Takva integracija je i konkretna mjera iz direktive NIS2: zapisnik, kontrola pristupa i obavijesti u stvarnom vremenu pokazuju da razmjenu povjerljivih podataka nadzirete. Više u vodiču NIS2 i GDPR i na stranici Sigurnost. Za specifikaciju HMAC potpisa pogledajte RFC 2104, a za SPF i DKIM RFC 7208 i RFC 6376.

Česta pitanja

Što je webhook?

Webhook je adresa na vašem poslužitelju na koju Kriptano šalje obavijest kad se nešto dogodi, primjerice kad primatelj otvori tajnu. Poruka sadrži ID i stanje tajne, nikad njezin sadržaj.

Može li Kriptano preko API-ja pročitati moje tajne?

Ako šaljete već šifrirani sadržaj, ne – poslužitelj nikad ne vidi čisti tekst. Ako API-ju predate čisti tekst, on ga šifrira i ne sprema ključ; ključ postoji samo u linku koji dobijete.

Kako postaviti vlastitu domenu?

U paketu Pro Plus upišite poddomenu u Moj račun → Brend i domena, dodajte CNAME prema domains.kriptano.com i TXT zapis za potvrdu te kliknite Provjeri. Certifikat se izdaje automatski.

Kada mi treba vlastiti SMTP?

Kad politika tvrtke traži da sva odlazna e-pošta prolazi kroz vaš poslužitelj. Ako želite samo da poruke stižu s vaše adrese, dovoljno je slanje s vaše domene.

Što ako je moj poslužitelj nedostupan kad webhook šalje događaj?

Kriptano ponavlja slanje nakon 1, 5, 30, 120 i 720 minuta. Nakon 15 uzastopnih neuspjeha adresa se isključuje i to vidite u Moj račun.

Povežite Kriptano sa svojim sustavima

API, webhook i tim dostupni su od paketa Pro, a vlastita domena i SMTP u paketu Pro Plus.

Pogledajte paketeAPI dokumentacija

Ažurirano: 19. 11. 2026.