API ključevi
API ključevi omogućuju tehničko povezivanje vanjskih sustava i aplikacija s Voxares platformom. Putem API-ja možete programski upravljati klijentima, terminima, porukama i drugim resursima. Ključevima upravljate u odjeljku Za programere na stranici Integracije.

Popis API ključeva
U odjeljku Za programere vidite tablicu svih kreiranih ključeva s informacijama:
- Ime - opisni naziv ključa (npr. "Integracija s web stranicom" ili "CRM sinkronizacija")
- Vrijednost - prikrivena vrijednost ključa. Korisno ako imate više ključeva i niste sigurni koji je koji.
- Naziv organizacije - ključevi su vezani uz korisnika, ovdje možete vidjeti koji ključ koristite za koju organizaciju. Korisno jedino korisnicima koji su članovi više organizacija unutar Voxares sustava.
- Kreirano - datum kada je ključ stvoren
Kreiranje novog ključa
Unesite naziv
U obrascu Generiraj novi API key dajte ključu opisni naziv koji jasno označava za što se koristi. Ovo pomaže pri kasnijoj organizaciji i reviziji.
Generirajte ključ
Kliknite Generiraj. Ključ se prikazuje na ekranu.
Kopirajte ključ
Kopirajte ga odmah - ključ se prikazuje samo jednom i nakon zatvaranja obavijesti više ga nećete moći vidjeti.
Pohranite ključ na sigurno
Spremite ključ u sigurnu lokaciju - upravitelj lozinki, enkriptirani dokument ili sustav za upravljanje tajnama (secret manager).
Sigurnosne preporuke
Pohrana ključeva
- Nikada ne pohranjujte API ključeve u izvorni kod ili repozitorij
- Koristite varijable okruženja (environment variables) za pristup ključevima u aplikacijama
- Pohranite ključeve u upravitelj lozinki ili sustav za upravljanje tajnama
Rotacija ključeva
- Periodički kreirajte nove ključeve i obrišite stare
- Preporučeni interval rotacije: svaka 3-6 mjeseci
- Pri rotaciji: prvo kreirajte novi ključ, zatim ažurirajte aplikacije, a tek onda obrišite stari
Princip minimalnog pristupa
- Kreirajte zasebne ključeve za svaku integraciju - ne koristite isti ključ za više sustava
- Ako jedna integracija više nije potrebna, obrišite samo njen ključ bez utjecaja na ostale

