Guide pratiche

Errori di registro senza esporre i dati sensibili

I registri dovrebbero aiutare a spiegare e risolvere una situazione. La registrazione di ogni dettaglio della richiesta crea volume e può copiare informazioni che non dovrebbero lasciare il suo flusso di lavoro originale.

vedere il metodo

Illustrazione — Errori di registro senza esporre i dati sensibili
Illustrazione generata dall’IA

Inizia con le domande a cui i registri dovrebbero rispondere

Elenca le domande operative: un modulo non funziona, è un processo interrotto, è stato testato un backup? Definire l'evento, il componente, il tempo e un identificatore di correlazione appropriato. Evita i messaggi che raccolgono il testo senza aiutare a identificare un'azione.

Preparare esempi sintetici di successo, rifiuto e fallimento. Un rifiuto previsto dovrebbe essere distinguibile da un'interruzione. I nomi e i livelli degli eventi dovrebbero aiutare il proprietario a decidere se indagare o monitorare una tendenza.

Collegate gli eventi di un’interazione tramite un identificatore diagnostico controllato, senza copiare un token di sessione. Esempio fittizio: form.saved e mail.failed riportano entrambi DEMO-REQ-21. Il primo descrive il salvataggio, il secondo un errore d’invio; nessuno deve cancellare il significato dell’altro. Distinguete anche l’ora dell’evento da quella di raccolta quando l’elaborazione è differita.

I valori dei visitatori restano dati non attendibili nei log. Codificate ritorni a capo CR, avanzamenti di riga LF e separatori secondo il formato scelto, affinché un campo non fabbrichi un’altra voce. JSON strutturato non rimuove automaticamente i segreti: servono ancora campi consentiti, codifica e limiti di dimensione. Esaminate l’output reale con marcatori fittizi, mai con password vere.

Scorri la tabella orizzontalmente per leggere tutte le colonne. Con la tastiera, porta il focus sulla tabella e usa i tasti freccia.

Esempio fittizio: collegare gli eventi senza confondere gli esiti
Segnale conservatoInterpretazione limitataControllo da eseguire
form.saved con DEMO-REQ-21La fase di salvataggio è riuscita.Verificare il risultato salvato senza dedurre la consegna dell’email.
mail.failed con DEMO-REQ-21Una fase d’invio della stessa interazione è fallita.Avviare il seguito appropriato senza considerare la richiesta persa per impostazione predefinita.
Ora dell’evento e ora di raccoltaDescrivono due momenti che possono differire.Conservare fuso e origine; non ordinare solo in base all’arrivo delle righe.
Valore esterno con CR o LFResta un campo, non un nuovo evento.Verificare codifica, dimensione e assenza di segreti nell’output reale.

ridurre al minimo le informazioni registrate

OWASP discute i dati che dovrebbero essere esclusi dai log, comprese le password, i token di accesso e le informazioni sensibili. Rivedi i messaggi prodotti dal tuo codice, nonché plugin, proxy e servizi di monitoraggio.

Utilizzare un elenco di campi consentito invece di copiare un'intera richiesta. Un identificatore diagnostico può essere sufficiente in cui un messaggio di richiesta completo sarebbe eccessivo. Test con marcatori sintetici, quindi cerca gli output per quei marker per rilevare la raccolta indesiderata.

Gestisci accesso, conservazione e volume

Documenta chi può leggere i registri e perché. Conferma che non vengono serviti da un indirizzo pubblico o resi accessibili tramite strumenti di condivisione. Un'esportazione diagnostica richiede la stessa revisione di accesso dell'archiviazione primaria.

Scegli la conservazione in base al bisogno effettivo e al contesto applicabile piuttosto che copiare la durata di un altro servizio. Disporre la rotazione, i limiti di volume e l'eliminazione. Un errore ripetuto non deve riempire un disco tramite registrazione illimitata.

Testare il percorso da segnale ad azione

attivare un guasto controllato in un ambiente di test. Controllare il registro, la consegna degli avvisi, il destinatario e la procedura di risposta. Un avviso inviato a una posta in arrivo che nessuno controlla non forma un processo operativo.

raggruppare le ripetizioni e seguire i segnali che supportano le decisioni. Dopo un incidente, rivedi cosa mancava e cosa era inutilmente esposto. Un risultato utile collega un evento con dati minimi, un proprietario e un'azione.

Documentazione primaria: owasp : registrazione cheat sheet.

Limitare la trasmissione di percorsi e parametri ai siti collegati.

Caso fittizio: un collegamento esterno parte da una URL con un identificatore inventato. Osservate Referer su una destinazione di prova secondo la politica scelta. Rimuovete anche dati sensibili dalle URL: limitare la provenienza non elimina cronologia o registri precedenti.

  • Viene trasmessa solo la provenienza prevista, senza identificatori personali reali.
  • MDN Referrer-Policy

    Riferimento alla politica che limita le informazioni di provenienza nelle richieste in uscita.

Documenti di riferimento

Contenuto aggiornato

Riferimenti documentati per questo argomento

Riferimenti documentati per questo argomento
RiferimentoValore o sintassiAmbito
RFC 3339 · Date-time
2026-10-22T09:00:00+02:00Lo scarto esplicito collega l’ora locale a UTC; questo esempio non è un appuntamento.

Le date indicano la consultazione delle fonti. Questi riferimenti non costituiscono un audit del sito né una dichiarazione globale di conformità.

Matrice di convalida funzionale per adattarsi al progetto

Questi controlli proposti utilizzano casi fittizi. Decidi quale comportamento è previsto con il team, annota il risultato e assegna discrepanze irrisolte prima della pubblicazione.

Scorri la tabella orizzontalmente per leggere tutte le colonne. Con la tastiera, porta il focus sulla tabella e usa i tasti freccia.

Casi di test, risultati attesi e prove utili
Casorisultato attesoProva da mantenere
Errore funzionale notoL'evento spiega l'esito e identifica la richiesta sintetica.Identificatore di evento, tempo e correlazione tra le fasi di elaborazione rilevanti.
Marcatore sensibile sinteticoIl marker è assente dai campi che dovrebbero escluderlo.Cerca in ogni destinazione del registro di prova, comprese le copie inoltrate e archiviate.
Testo contenente una nuova rigaIl campo non può produrre un evento extra apparentemente valido.valore ricevuto e il modulo effettivamente registrato nella destinazione.
Registri non disponibiliIl comportamento dell'applicazione è compreso e può essere rilevata l'osservabilità persa.Risultato dell'applicazione e osservazioni effettuate durante la raccolta dei registri interrotte.

Domande frequenti

Il testo della richiesta deve essere registrato per la diagnosi?

non automaticamente. Identificare i campi diagnostici minimi e testare prima con i dati sintetici. Un'indagine completa potrebbe non essere necessaria per l'analisi di uno stato tecnico.

Uno strumento di monitoraggio sostituisce un proprietario?

No. Raccoglie o invia un segnale, ma qualcuno deve comunque esaminarlo utilizzando una procedura concordata. Testare l'intera catena con un incidente controllato e verificare il risultato atteso.