On Demand Scanning & Encrypted Files Guide
Enhance your data security posture with MetaDefender Storage Security's On-Demand scanning and encrypted files capability.
This feature empowers you to take control of sensitive data by enabling immediate scans of encrypted files. Simply provide the necessary passwords through the intuitive user interface or via API integration, and MDSS will analyze the files, ensuring comprehensive protection against hidden threats.
Unlocking Encrypted Files within MetaDefender Storage Security is simple for users who prefer the UI:
- Identify Encrypted Files: In the Reports page, look for files marked with a lock icon, indicating an "Encrypted" verdict. These files are automatically blocked to ensure security.

- Provide Passwords: Click the lock icon to open a window where you can securely enter potential passwords. Need to try multiple passwords? Easily add more with the "plus" symbol. You can also visualize your entered passwords using the "eye" icon.
- Initiate Rescan: Click the rescan icon to begin the decryption process. MDSS will attempt to decrypt the file using each password provided.


Currently, you can rescan one encrypted file at a time. We are actively working to enhance this feature, allowing you to provide passwords for multiple encrypted files simultaneously in future releases.
This outlines the process specifically for those using the MetaDefender Storage Security user interface.
For users who prefer the API integration, MetaDefender Storage Security offers a flexible approach to On-Demand Scanning of encrypted archives:
The dedicated API endpoint allows you to initiate rescans of encrypted files programmatically. This means you can trigger a rescan at any time, regardless of whether you have passwords to provide.
If passwords are available, simply include them in your API request. MDSS will attempt decryption using the provided passwords and return the scan results. This enables seamless integration of encrypted archive scanning into your automated workflows and security processes.
This API-driven approach provides advanced users with the control and flexibility they need to manage encrypted archives effectively within their existing systems. Full API documentation is available to guide your implementation.
Request Body:
{
"fileId": "{string}",
"scanId": "{string}",
"storageProtocolType": "{int32}",
"passwords": ["{array[string]...}"]
}