Kuidas põllumees saatis API tokeni oma arendajale

Osa 1 sarjast "Kuidas Agdir kasutab SecretDropi" — sari sellest, kus agtechi ettevõte ja selle kliendid tegelikult saladusi jagavad.

Agdir annab farmidele tõelise API. Seadistused → API tokenid jaotisest Agdiri juhtpaneelil saab farmi administraator luua tokeni ja kasutada seda oma põlluandmete, mullaproovide ning ilmateabe tõmbamiseks — kohandatud armatuurlauda, raamatupidamise sünkimist või töövõtja integratsiooni jaoks.

Täpselt seda tahtis üks farm. Nad olid palganud vabakutselise arendaja, kes ehitas väikese armatuurlaua, mis tõmbas nende põlluandmeid Agdirist. Põllumees logis sisse, avas Seadistused → API tokenid ja klõpsas loo. Agdir andis tagasi 64-märgilise võtme — näidatuna üks kord.

Nüüd tuli keeruline osa: kuidas see võti arendajani toimetada?

Tavaline viis ja miks see on probleem

Põllumehe esimene instinkt oli ilmne: kleepida see e-kirja. Või WhatsAppi. Või samasse lõime, kus projekti üle arutati.

Siin on probleem sellega:

• Võti on nüüd püsiv. API token e-kirjas istub mõlemas postkastis igavesti — ja seda varundatakse, sünkitakse üle seadmete ning indekseeritakse otsingu poolt. See token võib lugeda farmi andmeid nii kaua, kuni see kehtib.
• See levib. E-kirju edastatakse. Vestlusi nähakse laenatud või kaotatud telefonil. Ainus koht, kus elav mandaat ei peaks olema, on koht, mis mäletab kõike — ja e-post on loodud kõike mäletama.
• Need tokenid on olulised. Agdir piirab ettevõtet kolme aktiivse tokeniga ja aegub neid. Token on päris võti päris andmetele, mitte ühekordne asi. Seda tuleb kohelda vastavalt.

Mida nad hoopis tegid

Põllumees kleevis tokeni SecretDropi ja sai tagasi ühekordse lingi. Ta saatis lingi arendajale — e-post oli sobiv, sest link ei ole token.

Arendaja avas selle üks kord, kopeeris võtme oma keskkonna muutujatesse ja saladus hävitas ennast. Kui keegi kunagi seda e-posti lõime tagasi kerida, leiab ta lihtsalt surnud lingi ja mitte midagi muud.

Token tegi täpselt ühe teekonna — põllumehe ekraanilt arendaja konfiguratsioonifaili — ja ei jätnud teel maha ühtegi koopiat.

Järeldus

Kui lood Agdiris API tokeni, kohtle üleandmist sama hoolikalt kui tokenit ennast:

• Saada token põleta-pärast-lugemist lingina, mitte tekstina e-kirjas ega vestluses.
• Lase arendajal see korralikult salvestada (keskkonna muutuja või saladuste haldur) — mitte dokumendis ega sõnumis.
• Vaheta see välja, kui see kunagi lekkib, ja kustuta tokenid, mida enam ei kasuta, jaotisest Seadistused → API tokenid.

Token, mis eksisteeris ainult need sekundid, mis kulus selle konfiguratsioonifaili kleepimiseks, on token, mida tulevased andmelekked ei leia.

---

Järgmine sarjas: Kuidas Agdiri meeskond edastab hankijate mandaate.
Kas pead saatma võtme või salasõna üks kord ja laskma sel kaduda? Proovi SecretDropi — kontot pole vaja.