API i webhook za sigurno slanje tajni: tim, vlastita domena i vlastiti SMTP
Kada firma šalje stotine lozinki i dokumenata mjesečno, ručno slanje postaje usko grlo. Kako Kriptano povezati s HR sistemom, helpdeskom i CRM-om preko API-ja, kako webhook javlja da je tajna otvorena te kako rade tim, vlastita domena i vlastiti SMTP.
Sadržaj članka
Jedan jednokratni link napravite za pola minute. Stotinu mjesečno – za nove uposlenike, resetovane lozinke, klijente i dobavljače – već je posao koji neko mora raditi ručno. Za firme 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 šta svaki od njih radi, kako ih povezati s vašim sistemima 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: šta 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 po obimu i poslovnim funkcijama:

Aktuelne cijene u KM i ograničenja uvijek su na stranici Paketi. Ako vam treba samo zahtjev za tajnu i kriptirani prilozi, dovoljan je paket Start.
API: tajne iz vaših sistema
API omogućava da vaš sistem sam napravi jednokratni link – kada HR otvori novi račun, kada helpdesk resetuje lozinku ili kada CRM šalje pristupne podatke klijentu. Prijava ide API ključem u zaglavlju Authorization. Ključeve pravite u Moj račun, a u bazi se čuvaju samo kao heš vrijednosti.
API radi na dva načina:
- Već šifrirani sadržaj – vaš kod šifrira tajnu istim formatom kao preglednik, a server nikad ne vidi čisti tekst. To je preporučeni način za osjetljive integracije.
- Čisti tekst – API šifrira tajnu istim formatom i ne čuva ključ. Ključ postoji samo u linku koji dobijete u odgovoru, pa ga vaš sistem mora odmah predati primaocu.
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, priloge – opisuje dokumentacija. Tipičan primjer je predaja početne lozinke novom uposleniku, 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 sistem za nadzor.
Webhook: događaji u stvarnom vremenu
Webhook je adresa na vašem serveru na koju Kriptano šalje HTTPS POST s JSON-om kada se nešto desi – na primjer kada primalac otvori tajnu. Vaš helpdesk tada može automatski zatvoriti tiket, SIEM zabilježiti događaj, a Slack kanal dobiti obavještenje. Webhook nikad ne šalje sadržaj tajne, ključ ni šifrat – samo ID, oznaku i stanje, pa zero-knowledge model ostaje netaknut.

| Događaj | Kada stiže |
|---|---|
| secret.created | nova tajna je napravljena |
| secret.viewed | primalac je otvorio tajnu |
| secret.burned | tajna je uništena nakon posljednjeg otvaranja ili pogrešnih lozinki |
| secret.expired | rok je istekao, tajna nije otvorena |
| secret.deleted | pošiljalac je obrisao tajnu |
| request.created / request.answered | zahtjev za tajnu je poslan ili odgovoren |
| team.member_joined / team.member_removed | promjena u timu |
Kako webhook isporučuje poruke
Kriptano poruku šalje odmah nakon događaja. Ako vaš server 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. Dozvoljene su samo HTTPS adrese, bez preusmjeravanja i bez privatnih ili lokalnih IP adresa – zaštita od zloupotrebe za napade na unutrašnju mrežu. Broj webhook adresa zavisi od paketa, a dugme „Pošalji probu” šalje probnu poruku ping.
Provjera potpisa
Svaka poruka ima zaglavlje X-Kriptano-Signature s vremenom i potpisom. Vaš server izračuna HMAC-SHA256 nad vremenom i sirovim tijelom poruke, koristeći tajnu webhooka (whsec_…) koju ste dobili samo jednom, pri dodavanju adrese:

# 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 resetuje lozinku, sistem preko API-ja napravi link i doda ga u odgovor korisniku. Kada stigne događaj secret.viewed, tiket se sam zatvara; ako stigne secret.expired, agent dobija podsjetnik.
- HR i IT onboarding – novi uposlenik upisan je u HR sistem, IT skripta otvori račune i pošalje početnu lozinku jednokratnim linkom. Webhook javlja kada je uposlenik otvorio link, 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 pomjera projekat u sljedeću fazu, a lozinka nikad ne prolazi kroz e-mail.
Tim i uloge: ko smije šta
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, najduži rok i najveći broj otvaranja, zadane vrijednosti obrasca te obaveznu prijavu Google ili Microsoft računom. Tako i novi član od prvog dana radi po pravilima firme, a revizor u zapisniku vidi da su se pravila primjenjivala.
Vlastita domena: linkovi pod vašim imenom
Primaoci sve češće s pravom sumnjaju u linkove nepoznatih domena. U paketu Pro Plus vlastita domena omogućava da linkovi izgledaju kao tajne.firma.ba/…, a stranica tajne nosi vaš logo i boje. To pomaže i u edukaciji uposlenika: „naši linkovi su uvijek na tajne.firma.ba” jednostavno je pravilo protiv lažnih poruka.
Postavljanje traje nekoliko minuta:
- U Moj račun → Brend i domena upišite poddomenu, na primjer tajne.firma.ba.
- Kod svog DNS provajdera dodajte CNAME zapis prema
domains.kriptano.comi TXT zapis za potvrdu vlasništva. - Kliknite „Provjeri”. Certifikat se izdaje automatski pri prvoj posjeti domeni.
Vlastita domena radi samo dok je paket aktivan i dok je vlasništvo potvrđeno, pa niko ne može usmjeriti tuđu domenu na vaše tajne.
Vlastiti SMTP i slanje s vaše domene
U paketima Pro i Pro Plus Kriptano može link sam dostaviti primaocu e-mailom – do pet primalaca po tajni. Ključ pritom jednom prolazi kroz server radi slanja i ne čuva se. Zato uz dostavu e-mailom preporučujemo dodatnu lozinku koju javite drugim kanalom: tada tajnu ne može otvoriti ni server ni provajder e-maila.
U paketu Pro Plus poruke mogu ići na dva načina pod vašim imenom:
- Vlastiti SMTP – Kriptano šalje preko vašeg mail servera (portovi 25, 465, 587 ili 2525). Lozinka se čuva šifrirano, povezivanje je dozvoljeno 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 dozvoljene.

Vlastiti SMTP ima smisla kada vaša politika traži da sva odlazna pošta prolazi kroz vaš server, na primjer zbog arhiviranja ili DLP pravila. Ako vam je važno samo da poruka stiže s vaše adrese, jednostavnija opcija je slanje s vaše domene.
Sigurnost integracije: kontrolna lista
- API ključeve i tajnu webhooka čuvajte u menadžeru tajni, ne u kodu ni u repozitoriju.
- Ključeve mijenjajte kada neko iz tima ode ili kada postoji sumnja na curenje.
- Webhook potpis provjeravajte prije bilo kakve obrade.
- Na webhook odgovarajte brzo, a sporu obradu radite asinhrono.
- Linkove s ključem ne upisujte u logove vašeg sistema.
- Za osjetljive podatke koristite već šifrirani sadržaj i dodatnu lozinku.
Takva integracija je i konkretna mjera koju traže partneri iz EU prema direktivi NIS2: zapisnik, kontrola pristupa i obavještenja u stvarnom vremenu pokazuju da nadzirete razmjenu povjerljivih podataka. Više u vodiču NIS2 i GDPR u BiH i na stranici Sigurnost. Za specifikaciju HMAC potpisa pogledajte RFC 2104, a za SPF i DKIM RFC 7208 i RFC 6376.
Česta pitanja
Šta je webhook?
Webhook je adresa na vašem serveru na koju Kriptano šalje obavještenje kada se nešto desi, na primjer kada primalac otvori tajnu. Poruka sadrži ID i stanje tajne, nikad njen sadržaj.
Može li Kriptano preko API-ja pročitati moje tajne?
Ako šaljete već šifrirani sadržaj, ne – server nikad ne vidi čisti tekst. Ako API-ju predate čisti tekst, on ga šifrira i ne čuva 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?
Kada politika firme traži da sva odlazna pošta prolazi kroz vaš server. Ako želite samo da poruke stižu s vaše adrese, dovoljno je slanje s vaše domene.
Šta ako je moj server nedostupan kada 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 sistemima
API, webhook i tim dostupni su od paketa Pro, a vlastita domena i SMTP u paketu Pro Plus.