Preskoči na sadržaj
BS

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.

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

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:

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.

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.

webhook – kako radi od vašeg sistema preko API-ja do primaoca i nazad
Događaj secret.viewed stiže u vaš sistem nekoliko sekundi nakon što primalac otvori link.
DogađajKada stiže
secret.creatednova tajna je napravljena
secret.viewedprimalac je otvorio tajnu
secret.burnedtajna je uništena nakon posljednjeg otvaranja ili pogrešnih lozinki
secret.expiredrok je istekao, tajna nije otvorena
secret.deletedpošiljalac 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š 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:

webhook – provjera HMAC potpisa u 4 koraka
Bez provjere potpisa svako ko 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 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:

  1. U Moj račun → Brend i domena upišite poddomenu, na primjer tajne.firma.ba.
  2. Kod svog DNS provajdera dodajte CNAME zapis prema domains.kriptano.com i TXT zapis za potvrdu vlasništva.
  3. 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.
vlastita domena i vlastiti SMTP – DNS zapisi CNAME, TXT, SPF, DKIM i MX
Svi zapisi s tačnim vrijednostima prikazuju se u Moj račun → Brend i domena.

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.

Pogledajte paketeAPI dokumentacija

Ažurirano: 19. 11. 2026.