On-Demand Scans
Flyingduck's On-Demand Scans allow you to manually trigger security scans on a repository at any time — provided a runner is configured and active.
This is especially helpful when:
- Your repository hasn’t had recent commits (hence, no automated scans),
- You want to validate the current code against the latest known vulnerabilities, or
- You’re performing routine security assessments on important branches.
Note: On-demand scans always run against the latest commit of the specified branch.
🚀 Why Use On-Demand Scans?
- Ensure continued security coverage even for idle branches.
- Manually validate the latest commit for vulnerabilities.
- Gain confidence before releases or major merges.
✅ Prerequisites
- A Flyingduck Runner must be configured and running.
- The repository should already be integrated into Flyingduck.
How to Perform an On-Demand Scan
Step 1: Open the Repository Dashboard
You can navigate to the desired repository using one of the following methods:
-
From the Repositories List:
Click on theRepositories
tab in the sidebar. This will take you to the list of all repositories you've integrated with Flyingduck. Locate and select the repository you want to scan. -
Using the Search Bar:
Use thesearch bar
at the top navigation bar to search for your repository by name. From the search results, click on theOverview
link of the desired repository.
Step 2: Trigger a Scan
In the top-right corner of the repository page, click on the Actions
button and select Scan Code
from the dropdown menu. A modal form will appear where you can configure your scan options.
Step 3: Choose Scan Type
Select between the following scan types using the radio buttons
:
- Smart Scan: Requires only the
branch name
. Automatically scans all modules (SBOM, SCA, Secrets, SAST). - Custom Scan: Requires the
branch name
. Lets you select one or more modules to scan. For instance, selectingSBOM
also includesSCA
, but skips Secrets and SAST.
Step 4: Submit the Scan
After selecting the scan type and entering the required details, click Submit
. The runner will pick up the job and begin scanning.
Notes
- On-demand scans are performed on the latest commit in the branch.
- They can be triggered at any time, regardless of commit activity.
- It's best practice to periodically run scans for critical branches even if no new commits have been made.
Keep your runner active to ensure immediate scanning whenever you trigger an on-demand scan.