Skip to content

Commit 1b6f7f0

Browse files
authored
[Gateway] How sandboxing works (#17743)
1 parent dac46d7 commit 1b6f7f0

File tree

1 file changed

+31
-1
lines changed

1 file changed

+31
-1
lines changed

src/content/docs/cloudflare-one/policies/gateway/http-policies/file-sandboxing.mdx

Lines changed: 31 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,37 @@ Only available on Enterprise plans. For more information, contact your account t
1313

1414
In addition to [anti-virus (AV) scanning](/cloudflare-one/policies/gateway/http-policies/antivirus-scanning/), Gateway can quarantine previously unseen files downloaded by your users into a sandbox and scan them for malware.
1515

16-
While the files are quarantined, Gateway will present a scanning page to your users. If a file passes scanning, Gateway will release the file from quarantine and download it to your user's device. If the file contains malware, Gateway will block the request and log the match as a Block decision in your [HTTP logs](/cloudflare-one/insights/logs/gateway-logs/#http-logs).
16+
If AV scanning does not detect malware in a file download, Gateway will quarantine the file in the sandbox. If the file has not been downloaded before, Gateway will monitor any actions taken by the file and compare them to known malware patterns. During this process, Gateway will display an interstitial page in the user's browser. If the sandbox does not detect malicious activity, Gateway will release the file from quarantine and download it to your user's device. If the sandbox detects malicious activity, Gateway will block the download. For any subsequent downloads of the file, Gateway will remember and apply its allow/block decision.
17+
18+
Gateway will log any file sandbox decisions in your [HTTP logs](/cloudflare-one/insights/logs/gateway-logs/#http-logs).
19+
20+
```mermaid
21+
flowchart TD
22+
A(["User starts file download"]) --> B["File sent to AV scanner"]
23+
B --> C["Malicious file detected?"]
24+
C -- Yes --> D["Download blocked"]
25+
C -- No --> G["File sent to sandbox"]
26+
G --> n1["First time file downloaded?"]
27+
K["Malicious activity detected?"] -- Yes --> N["Download blocked"]
28+
K -- No --> n3["Download allowed"]
29+
n2["Interstitial page displayed for user during scan"] --> n4["File activity monitored"]
30+
n1 -- Yes --> n2
31+
n4 --> K
32+
n1 -- No --> K
33+
34+
B@{ shape: subproc}
35+
C@{ shape: hex}
36+
D@{ shape: terminal}
37+
n1@{ shape: hex}
38+
K@{ shape: hex}
39+
N@{ shape: terminal}
40+
n3@{ shape: terminal}
41+
n2@{ shape: display}
42+
n4@{ shape: rect}
43+
style D stroke:#D50000
44+
style N stroke:#D50000
45+
style n3 stroke:#00C853
46+
```
1747

1848
## Get started
1949

0 commit comments

Comments
 (0)