Distingui utente, attività e account addebitato
L’utente del prodotto, l’attività interna e l’account del dominio addebitato sono tre identità distinte. Il backend collega le prime due e ne verifica i permessi. Il browser riceve il risultato consentito. Con la chiave condivisa, invece, chi la possiede potrebbe avviare recuperi a pagamento fuori dai limiti previsti nella schermata.
Non pubblicare la chiave nel codice del browser, nei repository, nei file scaricabili o nei registri. Puoi caricarla tramite una variabile d’ambiente del server o un gestore di segreti. Questo separa configurazione e codice, ma da solo non impedisce che uno strumento diagnostico o un’eccezione ne riveli il valore. Controlla anche intestazioni, risposte di errore e copie della configurazione che escono dalla tua infrastruttura.
Costruisci una richiesta consentita
Fissa l’host dell’archivio e il percorso di ricerca ammesso per la prima attività. Costruisci q=onboarding, subreddit=SaaS e limit=3 con valori convalidati, poi aggiungi la chiave al momento della richiesta in uscita. Non inviare questo segreto a un URL arbitrario del visitatore. L’autorizzazione deve essere già stata verificata.
Per capire il costo dell’attività di onboarding, al registro locale servono identificatore del lavoro, filtri e numero del tentativo, non l’intestazione che contiene il segreto. Il client HTTP può inviare X-API-Key: <key> o Authorization: Bearer <key> caricando la chiave da una configurazione protetta del server. Escludila dal codice per il browser, dai repository pubblici, dai messaggi di errore e dai registri. Il cookie Secure HttpOnly riguarda la sessione dell’account; gli identificatori di utente e fattura conservati dal pannello non sono chiavi di recupero. Quando colleghi il conteggio dei costi, controlla anche questi passaggi: separarli non garantisce da solo l’assenza di esposizioni indesiderate.
Registra il tentativo prima di ripetere
Assegna un identificatore interno e un piccolo limite di tentativi. Registra percorso, filtri, numero del tentativo ed esito senza intestazioni di autenticazione. Una regola di esempio consente tre tentativi totali, comprese pagine aggiuntive e ripetizioni. È una regola del prodotto: l’archivio non offre quella quota per utente né il tuo registro delle attività.
Considera una sequenza ambigua: il primo successo vuoto costa un credito; la seconda risposta va persa e potrebbe averne consumato un altro; una ripetizione riuscita costa ancora. Non classificare la risposta persa come errore certamente gratuito. Gli errori del servizio a monte restituiscono la prenotazione, mentre un errore locale di elaborazione o scrittura non annulla un successo addebitato.
Salva la risposta prima di interpretarla
Salva la risposta prima di adattarla alla schermata. I record sono piatti; possono mancare campi e parent_id o link_id possono riferirsi a dati non ricevuti. Raggrupparli non prova che una conversazione sia completa. Le date usano YYYY-MM-DD in UTC, con il giorno to incluso. q cerca in title e text con AND all’interno del campo corrispondente; min_score filtra e _doc non rappresenta un ordinamento per data o rilevanza.
Sostituisci la chiave senza presumere sovrapposizioni
Prepara la sostituzione fermando l’accettazione di nuove attività. Dopo l’accesso e la conferma della password, rigenerare invalida immediatamente la vecchia chiave. Aggiorna i processi che effettuano richieste prima di riavviarli. Non contare su un periodo di sovrapposizione. Limita anche l’accesso al nuovo valore durante la consegna ed escludilo dalla diagnostica.
Un limite locale controlla solo le richieste che attraversano il tuo backend. Non blocca l’uso diretto di una chiave divulgata. Durante un’indagine confronta i tentativi registrati con il contesto dell’account, senza interpretare un picco di volume come prova di fuga. La sostituzione non recupera crediti spesi. Conserva anche la password: non esistono reimpostazione né invio della chiave per email.
Verifica il percorso con una piccola attività
Concludi eseguendo una piccola attività e valutandone l’esito reale. Per 400 verifica i parametri, per 401 la chiave, per 402 il saldo e per 429 la frequenza. Si arriva a 100 record per richiesta e 100 pagine per query, senza copertura completa garantita. /v1/status descrive staticamente l’ambito del servizio, non lo stato dell’archivio. Anche un campione salvato e una decisione motivata di fermarsi possono chiudere l’attività.
