Metodologia degli strumenti di codice

Il cluster Codeoffre dieci utility, tutte eseguite interamente nel browser e nessuna delle quali invia il proprio payload da qualche parte. Questa pagina documenta cosa fa effettivamente ogni strumento — gli RFC a cui si conformano, le primitive che usano e cosa deliberatamente non fanno.

Base64 (RFC 4648)

Alfabeto standard: A-Z a-z 0-9 + /, imbottito con = a multipli di 4. La variante URL-safe (base64url) sostituisce + con - e / con _, elimina il padding.

Implementazione: il nativo btoa / atob di JavaScript gestisce la codifica, ma supporta solo stringhe Latin-1 (ogni byte è un carattere). Per UTF-8 prima codifichiamo la stringa con TextEncoder, poi eseguiamobtoasull’array di byte risultante. Questo è l’unico modo per codificare in Base64 in modo sicuro testo Unicode arbitrario nel browser senza dipendenze.

Decoder JWT (solo ispezione, nessuna verifica)

I JWT (RFC 7519) sono tre segmenti codificati in base64url separati da punti: header.payload.signature. Il nostro decoder divide, decodifica in base64url header e payload, li analizza come JSON e visualizza il risultato. Non verifichiamo la firma.

La verifica della firma richiede la chiave di firma — tipicamente un segreto HMAC o una chiave pubblica RSA/ECDSA — che deve provenire dall’emittente. Uno strumento solo-browser non può verificare in modo significativo un JWT emesso da terze parti, quindi non fingiamo di farlo. Usa il decoder per l’ispezione; usa lo stack server-side della tua applicazione per la verifica effettiva.

Convertitore di maiuscole/minuscole

Traduce tra camelCase, snake_case, kebab-case, PascalCase, CONSTANT_CASE, Title Case, Sentence case e lower / UPPER. L’algoritmo divide l’input in “parole” usando una regex che abbina le transizioni di maiuscole, trattini, underscore e spazi, poi riassembla nella convenzione target.

Caso limite: numeri negli identificatori. La nostra convenzione è mantenere i confini numero-lettera come confini di parola (quindi parseInt32 si divide in parse, int, 32) ma nondividere i confini lettera-numero all’interno di sequenze dall’aspetto chiaramente di identificatori (quindi md5 rimane una singola parola, non md_5).

Generatore di hash

SHA-1, SHA-256, SHA-384, SHA-512 tramite la Web Crypto API (crypto.subtle.digest), che è un sottile wrapper sull’implementazione nativa del sistema operativo. Deliberatamente non offriamo MD5 — il browser non lo fornisce nativamente (perché è crittograficamente compromesso), e preferiamo non aggiungere uno shim da 2 KB per supportare una funzione di hash che nessuno dovrebbe usare per nulla di rilevante per la sicurezza.

L’output è in esadecimale minuscolo. Tutte le operazioni sono sincrone dal punto di vista dell’utente nonostante la Web Crypto API sia asincrona — la latenza su dispositivi moderni è inferiore al millisecondo per input sotto un megabyte.

Generatore UUID

Due varianti:

• v4 (casuale): crypto.randomUUID() quando disponibile, con fallback a un generatore manuale basato su crypto.getRandomValues. 122 bit di entropia.
• v7 (timestamp + casuale): timestamp Unix ms a 48 bit + 74 bit casuali. Ordinabile per tempo di generazione, il che rende v7 la scelta preferita per le chiavi primarie del database.

Generatore di password

Usa crypto.getRandomValuescon campionamento per rifiuto contro il più grande multiplo della dimensione del charset che rientra in un uint32. Questo elimina il bias del modulo — l’approccio ingenuo random32 % charsetSize è distorto quando charsetSize non divide 2³² equamente, che è ogni charset realistico.

L’entropia viene calcolata come lunghezza × log₂(charset) bit e visualizzata in tempo reale. L’etichetta di forza mappa l’entropia in cinque bande (molto debole / debole / sufficiente / forte / molto forte) con soglie che corrispondono alle linee guida comuni sulla sicurezza (NIST SP 800-63B raccomanda ≥ 80 bit per uso ad alto rischio).

Dettagli dell’algoritmo: le primitive di entropia e casualità

Il generatore di password e UUID sono gli unici strumenti in questo cluster che dipendono dalla casualità crittograficamente forte; la loro correttezza si basa su due primitive del browser.

Selezione di caratteri non distorta (campionamento per rifiuto)

Dato un charset di dimensione K e un draw casuale a 32 bit senza segno r, il naiver % K è distorto verso indici più piccoli a meno cheK divida 2³². Calcoliamo threshold = 2³² − (2³² mod K), estraiamo e rifiutiamo qualsiasi r ≥ threshold. Numero atteso di draw per carattere: < 1,05 per qualsiasiK ≤ 2³²/16. L’output è distribuito uniformemente sul charset.

Contabilità dell’entropia

L’entropia della password è lunghezza × log₂(K) bit. Le nostre bande di forza seguono le linee guida di NIST SP 800-63B:

Layout UUID v7 (RFC 9562)

bits[0..47]   = unix_ms (48 bit)
bits[48..51]  = versione = 0111 (4 bit)
bits[52..61]  = casuale o contatore sub-ms (10 bit)
bits[62..63]  = variante = 10 (2 bit)
bits[64..127] = casuale (64 bit)
totale casuale: 74 bit — resistente alle collisioni in pratica

Fonti e riferimenti

Ogni strumento nel cluster mappa a una specifica primaria: Base64 a RFC 4648, JWT a RFC 7519, hash a FIPS PUB 180-4, UUID a RFC 9562, entropia password a NIST SP 800-63B. La Web Crypto API stessa è una raccomandazione W3C. Vedi il blocco Fonti qui sotto per gli URL canonici.

Presupposti e limitazioni

• Esecuzione solo nel browser.Gli strumenti assumono un browser moderno con Web Crypto. Ambienti vecchi o protetti (alcuni blocchi kiosk, Node server-side senza shim) torneranno a un’implementazione JS e perderanno la forza crittografica.
• Nessuna verifica della firma. La decodifica JWT ispeziona ma non verifica. Non usare questo strumento come parte di una pipeline di autenticazione.
• Nessun MD5. Crittograficamente compromesso per uso autenticato; intenzionalmente omesso anche per il checksum. Usa SHA-256 con un piccolo compromesso sulle prestazioni.
• Nessuno streaming per input grandi.Gli strumenti di hash e Base64 caricano l’intero input in memoria. Gli input >100 MB metteranno in pausa la scheda durante la codifica.
• Nessuna telemetria del payload.Non registriamo, memorizziamo o trasmettiamo nulla incollato in questi strumenti. Il compromesso: non possiamo anche debuggare perché un input specifico viene renderizzato male senza che l’utente lo riproduca.
• I timestamp UUID v7 sono precisi al millisecondo. Generare >1000 UUID nello stesso millisecondo si basa sulla casualità sub-ms a 10 bit per l’unicità dell’ordinamento.
• La forza della password è euristica.La difficoltà reale dell’attacco dipende dai pattern conosciuti dell’attaccante (dizionario, set di password trapelate), non solo dall’entropia.

Cosa non facciamo

• Cifrare o decifrare contenuti. La Web Crypto API lo supporta; non esponiamo un’interfaccia perché l’uso improprio delle API crittografiche è pericoloso.
• Verificare i JWT. Vedi sopra.
• Formattare strutturalmente — preserviamo la formattazione dell’utente dove possibile. Per la formattazione completa usa un formattatore dedicato.
• Registrare i payload. Nulla che l’utente incolla lascia mai il browser.