Verifichi il rischio di un’estensione di file
Il controllo del rischio delle estensioni offre a filtri degli allegati, moduli di caricamento e verifiche di sicurezza una classificazione preliminare coerente del suffisso di un file.
Esegui gratis nel browser
Inserendo un’estensione come .exe, docm o vacanze.jpg, Lei riceve l’estensione normalizzata, la categoria, il livello di rischio, l’indicazione dei contenuti attivi e una raccomandazione pratica per il filtraggio. Il controllo è deterministico e funziona senza accesso alla rete. È pensato per orientare le regole di sicurezza, non per ispezionare i contenuti; il risultato va quindi affiancato alla verifica MIME, alla scansione antimalware, all’ispezione degli archivi e alle liste di autorizzazione dell’organizzazione.
Usi l’estensione finale come rapido segnale di selezione
Il filtraggio degli allegati spesso inizia prima che uno scanner apra il file. Controllare il suffisso visibile richiede poche risorse e consente di distinguere subito i comuni eseguibili, gli script avviati da interpreti, i documenti per ufficio che supportano macro e i formati multimediali conosciuti. Lei può inviare un suffisso semplice come docm, un’estensione con il punto come .DOCM oppure un nome completo come rapporto-trimestrale.docm. Il controllo elimina gli spazi esterni, non distingue maiuscole e minuscole, rimuove la query o il frammento di un URL e classifica l’ultimo suffisso. Quest’ultima regola è importante per nomi come fattura.pdf.exe: il risultato segue .exe, non il testo apparentemente innocuo che lo precede. La risposta contiene l’estensione normalizzata con il punto, la categoria della regola, un livello di rischio chiaro, l’eventuale supporto abituale a contenuti attivi, una spiegazione e l’azione di filtraggio consigliata. Il formato si integra bene con gateway di posta, portali di assistenza, regole di workflow e code di revisione umana che richiedono un vocabolario uniforme. Rimane comunque un segnale preliminare, perché un aggressore può rinominare i file e un file legittimo può avere un suffisso errato.
Comprenda le quattro categorie di rischio degli allegati
La categoria executable comprende i formati che possono avviare direttamente codice o partecipare all’installazione di programmi e alla configurazione del sistema. Riceve un rischio critico e la raccomandazione di blocco predefinito. La categoria script include file sorgente o di comandi che possono essere eseguiti da shell, interpreti, ambienti browser o sistemi di automazione; il livello assegnato è alto. document-macro-capable identifica i formati della famiglia Office la cui estensione ammette esplicitamente macro o componenti aggiuntivi attivi, tra cui docm, xlsm e pptm. Anche questi ricevono un livello alto, perché un documento dall’aspetto ordinario può trasportare logica eseguibile. safe media raccoglie comuni estensioni di immagini, audio e video che normalmente non vengono avviate come programmi e riceve un livello basso. La definizione «sicuro» è relativa alla politica sugli allegati, non garantisce che i byte siano innocui: un’immagine malformata può sfruttare un decoder vulnerabile, SVG può includere contenuti complessi e il suffisso può non corrispondere al formato reale. Perciò anche un risultato a basso rischio richiede la verifica del tipo di contenuto e una normale scansione antimalware, non fiducia incondizionata.
Gestisca con prudenza i tipi ignoti e combini più controlli
Un filtro degli allegati non deve considerare un suffisso sconosciuto come prova di sicurezza. Quando l’estensione non viene riconosciuta, il controllo restituisce recognized: false e inserisce il valore nel gruppo di regole executable con rischio critico. È una scelta intenzionalmente prudente: l’amministratore può mettere il file in quarantena, ispezionarlo e aggiungere una regola locale, anziché consentire per errore un formato potenzialmente attivo. In produzione, Lei dovrebbe combinare il risultato con più segnali indipendenti. Confronti il tipo MIME dichiarato con il rilevamento mediante byte magici, estragga gli archivi in uno scanner isolato, rifiuti i contenuti protetti da password quando non possono essere esaminati, esegua la ricerca di malware e valuti se il mittente e il processo aziendale richiedono davvero quel formato. Mantenga una lista di autorizzazione ristretta per i flussi che accettano soltanto immagini o video e non la ampli solo perché un file supera questo controllo. Registri inoltre il suffisso normalizzato e la decisione, così da poter verificare le modifiche alle regole. Il prezzo dell’API è $0.002 per richiesta; nel browser si ottiene lo stesso risultato deterministico senza inviare il nome del file. Le estensioni vuote vengono respinte perché manca un suffisso significativo da classificare.
Casi d'uso
Selezioni gli allegati delle e-mail in arrivo
Invii in quarantena eseguibili, script e documenti con macro prima di un’analisi antimalware più approfondita.
Convalidi i caricamenti nel portale di assistenza
Applichi una regola preliminare coerente ai nomi prima di accettare schermate, video o documenti forniti dai clienti.
Spieghi il blocco di un allegato
Fornisca una categoria, una motivazione e un’azione consigliata stabili da inserire nel verbale di revisione.
Domande frequenti
Un risultato a basso rischio dimostra che il file è sicuro?
No. Descrive soltanto il comportamento normalmente associato all’estensione. Verifichi il tipo reale del file e ne analizzi il contenuto prima di considerarlo affidabile.
Che cosa accade se l’estensione è sconosciuta?
Il risultato imposta recognized su false e assegna in modo prudente la categoria executable e un rischio critico, evitando che un tipo ignoto venga considerato sicuro.
Posso inserire il nome completo di un file?
Sì. Il controllo usa l’ultimo suffisso, quindi fattura.pdf.exe viene classificato in base a .exe. Accetta anche una sola estensione, con o senza il punto iniziale.
Perché i documenti con macro sono separati dagli script?
La loro logica attiva è incorporata in un documento aziendale familiare; per questo le politiche li esaminano o bonificano spesso in modo diverso dagli script autonomi.
Quanto costa una richiesta API?
Ogni richiesta costa $0.002. Il controllo è deterministico e non interroga servizi di rete né modelli di IA.
Per sviluppatori — accesso via API
Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.
Endpoint
Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.
Chiamala dal tuo stack
curl -X POST https://api.kit.forhosting.com/security/file-extension-risk-check \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"extension":".docm"}'const res = await fetch("https://api.kit.forhosting.com/security/file-extension-risk-check", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"extension": ".docm"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/security/file-extension-risk-check",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"extension": ".docm"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/security/file-extension-risk-check", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"extension":".docm"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"extension":".docm"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/security/file-extension-risk-check", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Esempio di richiesta
{
"extension": ".docm"
}Esempio di risposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "security.file_extension_risk_check",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.
Prezzi
Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.
Errori
| HTTP | Codice | Significato |
|---|---|---|
401 | unauthorized | Chiave API mancante o non valida: controlla l'header Authorization. |
402 | insufficient_balance | Credito esaurito: ricarica per continuare a eseguire attività. |
404 | unknown_type | Tipo di attività sconosciuto: controlla il campo type della richiesta. |
429 | rate_limited | Troppe richieste in poco tempo: rallenta e riprova tra qualche secondo. |