Slik bruker Agdir SecretDrop · Del 1
Slik sendte en bonde et API-token til utvikleren sin
En gård opprettet et Agdir API-token og måtte gi det til en frilansutvikler. Slik gjorde de det uten at det ble liggende i e-post.
Del 1 av «Slik bruker Agdir SecretDrop» — en serie om hvor et agtech-selskap og kundene deres faktisk deler hemmeligheter.
Agdir gir gårder et ekte API. Fra Innstillinger → API-tokener i Agdir-dashbordet kan en gårdsadministrator lage et token og bruke det til å hente sine egne markdata, jordprøver og vær inn i hva de måtte ønske — et egendefinert dashbord, en regnskapssynkronisering, en integrasjon fra en underleverandør.
Det var akkurat det én gård ønsket. De hadde leid inn en frilansutvikler for å bygge et lite dashbord som hentet markdataene deres ut av Agdir. Bonden logget inn, åpnet Innstillinger → API-tokener og klikket på opprett. Agdir ga tilbake en nøkkel på 64 tegn — vist én gang.
Nå kommer den kleine delen: hvordan får du den nøkkelen frem til utvikleren din?
Den vanlige måten, og hvorfor det er et problem
Bondens første innskytelse var den åpenbare: lime det inn i en e-post. Eller WhatsApp. Eller den samme tråden der de hadde diskutert prosjektet.
Her er problemet med det:
- Nøkkelen er nå permanent. Et API-token i en e-post ligger i begge innboksene for alltid — og blir sikkerhetskopiert, synkronisert på tvers av enheter og indeksert av søk. Det tokenet kan lese gårdens data så lenge det er gyldig.
- Det sprer seg. E-poster blir videresendt. Chatter blir sett på en lånt eller mistet telefon. Det ene stedet en levende legitimasjon ikke bør være, er et sted som husker alt — og e-post er bygget for å huske alt.
- Disse tokenene betyr noe. Agdir begrenser et selskap til tre aktive tokener og lar dem utløpe. Et token er en ekte nøkkel til ekte data, ikke noe man kaster. Det fortjener å bli håndtert som det.
Hva de gjorde i stedet
Bonden limte tokenet inn i SecretDrop og fikk tilbake en engangslenke. De sendte lenken til utvikleren — e-post var greit, fordi lenken ikke er tokenet.
Utvikleren åpnet den én gang, kopierte nøkkelen inn i miljøvariablene sine, og hemmeligheten selvdestruerte. Hvis noen noen gang blar tilbake gjennom den e-posttråden, finner de en død lenke og ingenting annet.
Tokenet gjorde nøyaktig én reise — fra bondens skjerm til utviklerens konfigurasjon — og etterlot ingen kopi på veien.
Det viktigste
Hvis du lager et API-token i Agdir, behandle overleveringen like nøye som tokenet selv:
- Send tokenet som en les-og-brenn-lenke, ikke som tekst i en e-post eller chat.
- Få utvikleren til å lagre det ordentlig (miljøvariabel eller en hemmelighetsbehandler) — aldri tilbake i et dokument eller en melding.
- Ruller det hvis det noen gang lekker, og slett tokener du ikke lenger bruker fra Innstillinger → API-tokener.
Et token som bare eksisterte i de sekundene det tok å lime det inn i en konfigurasjonsfil, er et token som ingen fremtidig sikkerhetsbrudd kan finne.