API-nøgle
En API-nøgle er en hemmelig streng, der beviser, at et andet system har lov til at læse dine data. Den fungerer som en adgangskode, men den angives af et program i stedet for en person, og den forbliver gyldig, indtil du tilbagekalder den.
Godt at vide: Gatherino-editoren og kontoen findes på engelsk eller tjekkisk. Formularerne, som respondenterne udfylder, kan vises på 18 sprog, herunder dansk.
Nøglen oprettes under indstillingerne og vises kun én gang. Gem den med det samme i en miljøvariabel eller hos en secret manager på din server. Du kan ikke hente den igen senere, fordi den gemmes i en form, som den oprindelige værdi ikke kan udledes af.
Den hyppigste fejl er at lægge nøglen i sidens JavaScript. Kildekoden i browseren er offentlig, så alle kan kopiere nøglen og hente hvert svar fra alle dine formularer. API-kald bør derfor køres fra en server, der har nøglen, og som kun returnerer det, der er beregnet til at være offentligt.
Hvis en nøgle lækker, skal du ikke undersøge, om nogen har brugt den. Tilbagekald den i stedet, og udsted en ny. Tilbagekaldelsen træder i kraft med det samme, og den gamle nøgle holder op med at virke.
I praksis
- Nøglen hører hjemme i en miljøvariabel på serveren, ikke i et repository og ikke i frontend.
- Brug helst en separat nøgle til hver integration, så du kan tilbagekalde én uden at påvirke de andre.
- Udskift (roter) nøglen, når en person, der kendte den, forlader virksomheden.
FAQ
Hvor opretter jeg en API-nøgle?
Under Indstillinger → API-nøgler. Den vises kun én gang.
Hvordan sendes nøglen?
I en Authorization: Bearer <key>-header eller i en x-api-key-header.
Hvad sker der, når jeg tilbagekalder en nøgle?
Den holder op med at virke med det samme, og integrationer, der bruger den, modtager en 401-fejl.
Relateret
Prøv Gatherino gratis
Gratis plan: 3 formularer og 100 svar om måneden. Intet kreditkort, data hostet i EU.
Kom i gang gratis →