URL 清單型原則的篩選格式
本文說明用於Microsoft Edge URL 清單式原則的篩選格式例如 URLBlocklist、 URLAllowList 和 CertificateTransparencyEnforcementDisabledForUrls 原則 。
篩選格式
篩選格式為:
[scheme://][.]host[:port][/path][@query]
篩選格式中的欄位為:
欄位 | 描述 |
---|---|
scheme (選用) | 它可以是 http://、https://、ftp://、edge:// 等。 |
host (必要) | 它必須是有效的主機名,而且您可以使用通配符 (“*”) 。 若要停用子域比對,請在 主機之前包含選擇性點 (.) 。 您可以指定單一IP位址常值主機名,但IP位址常值主機名不支援通配符。 |
port (選用) | 有效值範圍為 1 到 65535。 |
path (選用) | 您可以在路徑中使用任何字串。 |
query (選用) | query 是鍵值或僅鍵權杖,由 & 符號分隔。 使用等號 ("=") 分隔鍵值權杖。 若要指出前置詞相符,您可以在 查詢結尾使用星號 (“*”) 。 |
將篩選格式與 URL 格式進行比較
篩選格式類似於 URL 格式,但有以下差異:
- 如果您在格式中包含 「user:pass」,則會忽略它。 例如 http://user:pass@ftp.contoso.com/pub/example.iso.
- 如果包含片段識別碼 ("#"),則將忽略它和識別碼後面的所有內容。
- 您可以使用通配符 (“*”) 做為 主機 ,而且可以在前面加上點 (.) 。
- 您可以使用正斜線 (“/”) 或點 (.) 作為 主機的後綴。 在這種情況下,將忽略尾碼。
篩選選取準則
為 URL 選取的篩選是處理以下篩選選取規則後所找到的最具體相符項目:
首先選取 host 相符長度最長的篩選。
從選取的篩選中,會捨棄任何配置或埠不相符的篩選。
從其餘篩選中,選取具有最長相符 path 的篩選。
從其餘篩選中,選取具有最長 query 權杖集的篩選。 在此步驟中,如果這兩個篩選具有相同的 路徑 長度和 查詢 令牌數目,允許清單篩選會優先於封鎖清單篩選。
如果沒有剩餘有效的篩選,則從 host 中移除最左側的子網域,並從步驟 1 重新開始選取程序。 特殊星號 ("*") host 是最後搜尋的,它會比對所有主機。
如果有可用篩選,它將封鎖或允許 URL 請求。
注意
如果沒有相符篩選,預設行為是允許 URL 請求。
篩選選取準則範例
在此範例中,搜尋與 “https://sub.contoso.com/docs" 的相符專案時;篩選選取專案將會:
- 搜尋的
sub.contoso.com
篩選條件。 如果找到篩選,搜尋將移到步驟 2。 如果找不到篩選條件,則會再次嘗試使用contoso.com
、com
和 finally “ ” - 從所選篩選中移除 scheme 中沒有 "http" 的任何篩選。
- 從其餘篩選中移除任何確切連接埠號碼不是 "80" 的篩選。
- 從其餘篩選中移除 path 首碼沒有 "/docs" 的任何篩選。
- 從其餘篩選中,選取並套用具有最長 path 首碼的篩選。 如果未找到篩選,則從步驟 1 重新開始選取程序。 將使用下一個子網域重複此程序。
更多篩選資訊
如果篩選在 host 前具有點 (".") 首碼,則僅篩選確切的 host 相符項。 例如:
contoso.com
(沒有點) 符合contoso.com
、www.contoso.com
和sub.www.contoso.com
.www.contoso.com
只) 符合點前置詞的 (www.contoso.com
您可以使用標準或自訂結構描述。 支援的標準 schema 包括:
- about、blob、content、edge、cid、data、file、filesystem、ftp、gopher、http、https、javascript、mailto、ws 和 wss。
任何其他 schema 都被視為自訂 schema,但只允許 schema:* 和 schema://* 模式。 例如:
- “custom:*” 或 “custom://*” 符合 “custom:app”
- "custom:app" 或 "custom://app" 無效
schema 和 host 不區分大小寫。 例如:
http://contoso.com
篩選條件符合HTTP://contoso.com
、http://contoso.COM
和http://contoso.com
path 和 query 區分大小寫。 例如:
http://contoso.com/path?query=A
filter 不符合http://contoso.com/Path?query=A
或http://contoso.com/path?Query=A
。 它確實符合http://contoso.COM/path?query=A
。
內容授權
注意
本頁的某些部分是根據 Chromium.org 創造和分享的作品加以修改,並根據創用 CC 姓名標示 4.0 國際版本授權條款中所述條款加以使用。 原始 Chromium 頁面可在此處找到。
本作品根據創用 CC 姓名標示 4.0 國際版本授權條款獲得授權。