Avvelenamento del file di regole
La regola sembrava una nota. L'assistente l'ha rispettata.
Cos’è Avvelenamento del file di regole?
Un assistente AI per la programmazione legge un file di regole nel tuo repository e lo rispetta a ogni richiesta. La pull request di un collaboratore esterno ha infilato in quel file una riga – mantieni un vecchio header di bypass dell'autenticazione – ed è stata integrata in pochi secondi senza revisione. Un normale refactoring ha poi seguito la regola e rimesso il bypass in produzione. Risalirai dalla riga alla sua pull request, la rimuoverai, ripeterai il refactoring in modo pulito e metterai il file di regole sotto un proprietario del codice con revisione obbligatoria. La lezione: un file di regole è fiducia eseguibile, quindi rivedilo come il codice.
Cosa imparerai in Avvelenamento del file di regole
- Spiegare perché un file di regole dell'assistente è un'istruzione eseguibile e non documentazione, e quindi una modifica al file cambia ciò che fa l'assistente
- Riconoscere i segnali di una modifica avvelenata: un'integrazione rapida, nessuna revisione, un'etichetta innocua e un autore sconosciuto
- Risalire dal comportamento introdotto dall'assistente al file che glielo ha ordinato, usando la mappa del contesto e il margine della provenienza
- Mettere i file di regole, di prompt e di configurazione dell'assistente sotto un proprietario del codice con revisione obbligatoria, così una sola pull request non rivista non può riscrivere il comportamento
- Verificare una correzione di sicurezza ripetendo la richiesta esatta che era entrata e controllando che ora venga rifiutata
Avvelenamento del file di regole — Fasi della formazione
-
Una riga nel file di regole
Tre settimane prima che ad Alice arrivi il compito di preparare l'audit, Bob lavora come collaboratore esterno sul repository portal-api. Apre una pull request di una sola riga su .assistant/rules.md , il file che l'assistente AI del team legge prima di toccare il codice, e la etichetta come documentazione. Viene integrata in undici secondi. Adesso aspetta: la prossima modifica di routine al middleware di autenticazione leggerà quella riga e riporterà il bypass in produzione.
-
Riordina il middleware prima dell'audit
Il tuo responsabile di Ingegneria ti ha aperto un'issue in Jotvane, il tracker del team: il middleware di autenticazione è finito diviso in tre piccole funzioni, e l'audit di sicurezza della prossima settimana lo vuole in una sola. Accorpalo.
-
Apri il progetto
L'editor carica il middleware di autenticazione, le route di amministrazione che ci stanno dietro, il file CODEOWNERS del repository e un file di regole dell'assistente che il progetto tiene in .assistant/ . Il middleware è fatto delle tre funzioni di cui ti ha parlato il tuo responsabile.
-
Chiedi il refactoring
Apri l'assistente e chiedigli di accorpare il middleware in un'unica funzione, proprio come l'ha descritto il tuo responsabile.
-
Una sola funzione, e una riga che non avevi chiesto
Claude legge il file di regole, il middleware e le route di amministrazione, poi propone un'unica funzione authenticate() . Si legge bene, e in mezzo c'è un controllo dell'header che nessuno ha chiesto. La risposta è breve e sicura di sé.
-
Accetta il refactoring
Il diff sembra un accorpamento pulito e la risposta è sicura, quindi lo accetti. Le righe nuove compaiono in viola e non riviste: le ha scritte Claude e tu non le hai ancora lette. La riga del bypass è lì dentro, una delle quattro scritte da Claude.
-
Invia l'header, ottieni i dati
Bob fa la chiamata per cui ha inserito la riga. Non ha un account in Dunmerrow né un token di sessione, solo l'header. Punta l'API Tester sull'endpoint dei clienti della console di amministrazione e invia una GET con il solo x-internal-bypass: 1 .
-
Una sessione che non è mai esistita
La responsabile della sicurezza ha aperto un avviso sotto forma di issue. La console di amministrazione ha risposto a una richiesta arrivata da un indirizzo che nessuno riconosce, e la richiesta portava un header al posto di un login.
-
La riga nel file di regole
Il refactoring ha toccato solo il middleware, e il tuo responsabile aveva chiesto di non cambiare il comportamento. Quindi l'istruzione di aggiungere il bypass viene da qualcosa che l'assistente ha letto. Trova il file di regole nella mappa del contesto e leggi la riga 7.
-
Come è entrata quella riga
Quella riga non l'hai scritta tu. Apri la modifica indicata dalla responsabile della sicurezza e guarda come è arrivata nel file di regole.
Copertura dei framework di sicurezza
OWASP Top 10
- A08:2025 Software or Data Integrity Failures
CWE
- CWE-1427 Improper Neutralization of Input Used for LLM Prompting
CIS Controls
- CIS 16 Application Software Security
NIST CSF
- PR.AT-02 Individuals in specialized roles are provided with awareness and training so that they possess the knowledge and skills to perform relevant tasks with cybersecurity risks in mind
- PR.PS Platform Security
NICE Framework
- DD-WRL-003 Secure Software Development