XRAY: How to tune the interval of Xray checking if the artifact is scanned when you have enabled block unscanned artifacts in Xray Policy

Introduction 

When utilizing Xray policies, it is possible to configure Xray to block the download of unscanned artifacts. For instance, if you attempt to pull a new package from upstream while the Block Unscanned Artifact setting is enabled, the download will be delayed until the package has been scanned.

Please find the screenshot below:

 
By default, Artifactory makes a POST request to Xray every 20 seconds to check the scan status. Below is a code snippet for your reference:

2025-07-04T14:11:12.810Z|23b02cfd2e3d1228|127.0.0.1|jfrt@01jz9wdkrd138911ya0wps1eaq|POST|/api/v1/artifactBlockedStatus|200|78|280|13.463000|XrayJavaClient/1.0.8
2025-07-04T14:11:12.823Z|23b02cfd2e3d1228|127.0.0.1|jfrt@01jz9wdkrd138911ya0wps1eaq|POST|/api/v1/artifactBlockedStatus|200|78|280|8.209000|XrayJavaClient/1.0.8
2025-07-04T14:11:32.839Z|23b02cfd2e3d1228|127.0.0.1|jfrt@01jz9wdkrd138911ya0wps1eaq|POST|/api/v1/artifactBlockedStatus|200|78|280|11.248000|XrayJavaClient/1.0.8
2025-07-04T14:11:52.853Z|23b02cfd2e3d1228|127.0.0.1|jfrt@01jz9wdkrd138911ya0wps1eaq|POST|/api/v1/artifactBlockedStatus|200|78|280|8.843000|XrayJavaClient/1.0.8
2025-07-04T14:12:12.866Z|23b02cfd2e3d1228|127.0.0.1|jfrt@01jz9wdkrd138911ya0wps1eaq|POST|/api/v1/artifactBlockedStatus|200|55|280|8.323000|XrayJavaClient/1.0.8

You can customize the recheck interval for unscanned artifacts by adding the following line to your Artifactory’s artifactory.system.properties file:

artifactory.xray.block.unscanned.recheck.intervalSecs=n

Note: “n” should be less than “20” seconds.

Please note that after setting this property, a system restart is necessary for the changes to take effect.

Additionally, I would like to caution you that reducing the check interval to n<20 seconds will result in more frequent POST requests between Artifactory and Xray, which may increase network usage. We kindly encourage you to monitor the system's performance following this adjustment.

Please find the documentations for your reference:

https://jfrog.com/help/r/jfrog-installation-setup-documentation/artifactory-system-properties

https://jfrog.com/help/r/artifactory-how-to-modify-artifactory-system-properties-in-artifactory-and-artifactory-ha-chart