Formato di filtro per criteri basati su elenchi di URL

Questo articolo descrive il formato di filtro usato per i criteri basati sull'elenco di URL di Microsoft Edge, ad esempio URLBlocklist, URLAllowList e CertificateTransparencyEnforcementDisabledForUrls .

Formato di filtro

Il formato di filtro è:

    [scheme://][.]host[:port][/path][@query]

I campi nel formato di filtro sono:

Campo	Descrizione
schema (facoltativo)	Può essere http://, https://, ftp://, edge:// e così via.
host (obbligatorio)	Deve essere un nome host valido ed è possibile usare un carattere jolly (""). Per disabilitare la corrispondenza del sottodominio, includere un punto facoltativo (.) prima dell'host*. È possibile specificare un singolo nome host letterale indirizzo IP, ma il carattere jolly non è supportato per un nome host letterale indirizzo IP.
porta (facoltativo)	I valori validi sono compresi tra 1 e 65535.
percorso (facoltativo)	Puoi usare qualsiasi stringa nel percorso.
query (facoltativo)	La query è costituita da token chiave-valore o solo chiave separati da un simbolo ("&"). Separa i token chiave-valore con un simbolo di uguale ("="). Per indicare una corrispondenza di prefisso, è possibile usare un asterisco ("") alla fine della query*.

Il formato del filtro è simile al formato dell'URL, ad eccezione delle differenze seguenti:

Se si include "user:pass" nel formato , viene ignorato. Per esempio http://user:pass@ftp.contoso.com/pub/example.iso.
Se includi un identificatore di frammento ("#"), quest'ultimo e tutti gli elementi che seguono gli identificatori vengono ignorati.
È possibile usare un carattere jolly ("*") come host ed è possibile anteporrlo a un punto (.).
È possibile usare una barra ("/") o un punto (.) come suffisso per l'host. In questo caso, il suffisso viene ignorato.

Il filtro selezionato per un URL è la corrispondenza più specifica trovata dopo l'elaborazione delle regole di selezione del filtro seguenti:

I filtri con la corrispondenza host più lunga sono selezionati per primi.
Dai filtri selezionati, qualsiasi filtro con uno schema o una porta che non corrisponde viene eliminato.
Nei filtri rimanenti viene selezionato il filtro con il percorso corrispondente più lungo.
Nei filtri rimanenti viene selezionato il filtro con il set di token di query più lungo. In questo passaggio, il filtro allowlist ha la precedenza sul filtro blocklist se entrambi i filtri hanno la stessa lunghezza del percorso e il numero di token di query .
Se non è presente alcun filtro valido, il sottodominio più a sinistra viene rimosso dall'host e il processo di selezione viene riavviato dal passaggio 1. L'host con asterisco speciale ("*") è l'ultimo cercato e corrisponde a tutti gli host.
Se un filtro è disponibile, tale filtro blocca o consente la richiesta dell'URL.

Nota

Il comportamento predefinito consiste nel consentire la richiesta URL se non viene trovato alcun filtro.

In questo esempio, quando si cerca una corrispondenza con "https://sub.contoso.com/docs" la selezione del filtro:

Cercare un filtro per sub.contoso.com. Se viene trovato un filtro, la ricerca passa al passaggio 2. Se non viene trovato un filtro, viene eseguito un nuovo tentativo con contoso.com, come infine " ".
Nei filtri selezionati, quelli per cui non è presente "http" nello schema vengono rimossi.
Nei filtri rimanenti quelli con un numero di porta esatto diverso da "80" vengono rimossi.
Nei filtri rimanenti, quelli per cui non è presente "/docs" come prefisso del percorso vengono rimossi.
Nei filtri rimanenti viene selezionato e applicato il filtro con il prefisso del percorso più lungo. Se non viene trovato alcun filtro, il processo di selezione riparte dal passaggio 1. Il processo viene ripetuto con il sottodominio successivo.

Se un filtro ha un punto (".") come prefisso dell'host, vengono filtrate solo le corrispondenze esatte dell'host. Ad esempio:

contoso.com (nessun punto) corrisponde contoso.coma , www.contoso.come sub.www.contoso.com
.www.contoso.com (con un prefisso punto) corrisponde solo a www.contoso.com

È possibile utilizzare una versione standard o personalizzata dello schema. Gli schemi standard supportati includono:

about, blob, content, edge, cid, data, file, filesystem, ftp, gopher, http, https, javascript, mailto, ws, and wss.

Qualsiasi altro schema viene considerato come schema personalizzato, ma sono consentiti solo i modelli schema:* e schema://*. Ad esempio:

schema e host non rispettano la distinzione tra maiuscolo e minuscole. Ad esempio:

http://contoso.com filter corrisponde HTTP://contoso.coma , http://contoso.COMe http://contoso.com

percorso e query rispettano la distinzione tra maiuscole e minuscole. Ad esempio:

http://contoso.com/path?query=A il filtro non corrisponde http://contoso.com/Path?query=A o http://contoso.com/path?Query=A. Corrisponde a http://contoso.COM/path?query=A.

Nota

Parti di questa pagina sono modifiche basate sul lavoro creato e condiviso da Chromium.org e usate in base ai termini descritti nella licenza Creative Commons Attribution 4.0 International. La pagina originale di Chromium è disponibile qui.