API ključi in integracije
Izdajte API ključe za integracijo zunanjih aplikacij, ki oddajajo ali berejo prijave kanala.
API key je skrivno poverilnico, ki zunanji aplikaciji (npr. HR sistemu, portalu za stranke ali intranetu podjetja) omogoča samodejno komunikacijo z vašim kanalom za prijavljanje nepravilnosti, brez uporabe spletnega vmesnika.
Čemu služi
Z API key lahko sistem tretje osebe odda nove prijave ali prebere metapodatke in stanje prijav kanala. Namenjen je integracijam med strežniki: nikoli ga ne uporabljajte v javnem brskalniku niti ga ne vgrajujte v spletne strani ali aplikacije na strani odjemalca.
Kako ga ustvariti in preklicati
- Odprite kanal v upravljavski konzoli (/gestore) in pojdite v razdelek »API & Integrations«.
- Ključu dajte prepoznavno ime (npr. »Integracija HR portala«) in izberite potrebna dovoljenja (obsege).
- Ustvarite ključ: prikaže se SAMO enkrat. Takoj ga kopirajte in shranite v upravljalnik skrivnosti.
- Za onemogočitev uporabite »Revoke«: vsaka integracija, ki ga uporablja, takoj preneha delovati. Za rotacijo ključa ustvarite novega, posodobite odjemalca in prekličite starega.
Razpoložljiva dovoljenja (obsegi)
- reports:submit — oddaja novih prijav kanalu.
- reports:read — branje metapodatkov prijav (seznam), nikoli navadne vsebine.
- status:read — branje stanja prijave prek njene potrditvene kode.
Zero-knowledge: API nikoli ne razkrije navadne vsebine prijav. Vrača le metapodatke, stanje in šifrirane podatke (ciphertext); dešifriranje poteka izključno v brskalniku upravljavca z zasebnim ključem.