Creștere Startup5 minute citire

Cheile API pentru clienții unui SaaS B2B: permisiuni, rotație și răspuns la expunere

Cum organizezi cheile API oferite clienților B2B: acces limitat, stocare, expirare, rotație fără întrerupere și pașii de urmat dacă o cheie ajunge într-un loc public.

Echipa Pentru Fondatori

Echipa Pentru Fondatori

Platforma fondatorilor din România

Birou cu laptop care afișează o grilă abstractă de permisiuni, caiet închis și două obiecte în formă de cheie; imagine ilustrativă

O cheie API oferită unui client B2B trebuie să aibă un scop, permisiuni limitate și un proprietar clar. Dacă aceeași cheie este folosită de sistemul de facturare, de un export de date și de o aplicație de test, revocarea ei după o expunere poate opri toate cele trei fluxuri. Separarea cheilor de la început face incidentul mai ușor de limitat.

Birou cu laptop care afișează o grilă abstractă de permisiuni, caiet închis și două obiecte în formă de cheie; imagine ilustrativă

Imagine editorială generată cu OpenAI; scenă ilustrativă.

Definește ce reprezintă cheia

Într-un SaaS B2B, cheia poate identifica o integrare automată a clientului: un serviciu trimite cereri către API fără ca un angajat să se conecteze manual la fiecare operațiune. Stabilește explicit dacă această cheie autentifică aplicația, ce organizație reprezintă și ce operațiuni sunt permise. Nu o transforma în substitut pentru autentificarea persoanelor care folosesc interfața. OWASP, în ghidul său pentru autentificarea API, distinge cheile pentru clienții API de autentificarea utilizatorilor.

Un nume precum „integrare ERP producție” este mai util decât „cheia 2”. În consola clientului, arată cine a creat cheia, data ultimei utilizări, mediul și lista de permisiuni. Evită afișarea repetată a valorii secrete: administratorul trebuie să poată vedea identificatorul și să poată revoca accesul, fără ca fiecare vizită în consolă să dezvăluie credentialul. Pentru cine poate crea sau revoca chei, aplică aceeași disciplină a rolurilor descrisă în ghidul despre invitații și acces.

Permisiuni pe operațiuni, nu acces general

O integrare care citește starea facturilor nu are motiv să poată modifica abonamente. Pentru fiecare cheie, separă citirea de scriere și limitează accesul la resursele necesare. Modelul este concret în documentația Stripe despre tipurile de chei: cheia publicabilă poate apărea în client, în timp ce cheia secretă și cea restricționată nu trebuie expuse. Stripe recomandă cheile restricționate pentru utilizări noi, tocmai pentru că drepturile lor pot fi controlate.

Nu copia însă mecanic modelul unui procesator de plăți. Dacă produsul tău are proiecte, spații de lucru sau filiale, verifică și limita organizațională: o cheie pentru proiectul A nu trebuie să poată citi obiectele proiectului B prin simpla schimbare a unui identificator din URL. OWASP clasifică lipsa verificării drepturilor asupra obiectelor ca risc distinct. Verificarea trebuie făcută la fiecare cerere, pe server, nu doar prin ascunderea unor butoane în interfață.

O listă de permisiuni merită redactată în limbajul clientului: „citește facturi”, „creează comenzi”, „exportă contacte”. Dacă o operațiune nouă intră în API, decide dacă cheia existentă o primește automat. Pentru operațiunile sensibile, acordarea explicită reduce surpriza creată de un drept nou atașat tuturor cheilor vechi.

Stocare și medii separate

Cheia secretă aparține serviciului care face cererile. Nu o pune în codul unui site, într-o aplicație mobilă, într-un repository, în exemplele din documentație sau într-un tichet de suport. Ghidul Stripe pentru protejarea cheilor recomandă un sistem de administrare a secretelor sau, dacă platforma nu oferă unul, variabile de mediu. Stripe cere și separarea cheilor de test de cele de producție. Aplică același principiu în produsul propriu: un test care șterge date nu trebuie să poată atinge contul de producție.

Documentația de integrare ar trebui să folosească valori fictive clar marcate. Nu publica o captură cu valoarea reală, chiar dacă accesul la document este restrâns. În jurnalele aplicației, păstrează identificatorul cheii și rezultatul cererii, nu secretul întreg. OWASP explică ciclul de viață al secretelor, inclusiv accesul controlat, rotația, revocarea și auditul. Pentru produsul tău, stabilește cine răspunde de fiecare etapă înainte ca primul client să ceară o integrare.

Rotație fără să oprești integrarea

O rotație utilizabilă permite emiterea unei chei noi cât timp cea veche încă funcționează, urmată de mutarea clientului pe noua valoare și revocarea celei vechi. Afișează ultima utilizare pentru ambele chei, astfel încât administratorul să poată vedea dacă mai există cereri pe credentialul retras. Nu promite o tranziție fără întrerupere dacă produsul acceptă o singură cheie activă; în acest caz, explică fereastra de schimbare și riscul operațional.

Testează rotația cu o integrare de probă, inclusiv o cerere aflată în curs și o operațiune programată. Dacă API-ul răspunde cu 401 după revocare, documentația trebuie să arate cum se distinge o cheie invalidă de o lipsă de permisiune. Aceste erori trebuie să fie clare pentru administrator, fără să dezvăluie date despre alte conturi. Un jurnal de audit poate lega emiterea, schimbarea drepturilor și revocarea de persoana care le-a aprobat.

Dacă cheia a fost expusă

O cheie ajunsă într-un repository, într-un jurnal accesibil sau într-un mesaj trimis greșit se tratează ca expusă, chiar dacă nu există dovada folosirii ei. Stripe recomandă rotația imediată și verificarea jurnalelor de cereri. Pentru un furnizor SaaS B2B, răspunsul practic este să emiți o cheie nouă, să coordonezi mutarea integrării, să revoci cheia veche și să examinezi cererile făcute cu ea: intervalul, adresele de origine, resursele accesate și operațiunile de scriere.

Nu confunda revocarea cu remedierea completă. Dacă secretul a fost publicat într-un commit, scoaterea lui din ultimul fișier nu garantează dispariția din istoric sau din copii. Dacă jurnalele arată acces neautorizat la date, investighează separat efectele și obligațiile de notificare aplicabile situației concrete. Runbook-ul pentru primele 60 de minute ale unui incident oferă cadrul pentru responsabilități și cronologie. Închide cazul numai după ce integrarea funcționează cu cheia nouă și ai verificat ce s-a întâmplat cu cea veche.

Transparență AI: acest conținut poate fi redactat sau structurat cu ajutorul unor instrumente AI și este verificat editorial înainte de publicare. Imaginile generate sau modificate cu AI sunt folosite cu rol ilustrativ.

SaaS B2BAPIchei APIsecuritateintegrare

Întrebări frecvente

Câte chei API ar trebui să primească o firmă clientă?

Câte una pentru fiecare integrare sau mediu care trebuie administrat separat, cu permisiunile necesare acelui scop; o singură cheie comună îngreunează revocarea și identificarea utilizării.

Ce faci dacă o cheie API a apărut într-un repository sau într-un jurnal?

O tratezi ca expusă: emiți o cheie nouă, muți integrarea pe ea, revoci cheia veche și verifici jurnalele de cereri pentru folosire neautorizată.

Ți-a fost util acest articol? Distribuie-l:

Aplică ce ai citit — alătură-te platformei

Validează-ți ideea, construiește echipa și găsește finanțare pe Pentru Fondatori.

Creează cont gratuit