SMB - Pull Files
Use this type of job to automatically pull files from a file share on a remote host using the SMB protocol.
Configuration
Source SMB Username
The username used to authenticate via the SMB protocol on the selected host.
Source SMB Password
The password used to authenticate via the SMB protocol on the selected host.
In case of editing or duplicating a previously saved job, the password needs to be re-entered.
Select Source SMB
Select the SMB integration to use. Files will be pulled from the selected file share. See: SMB Integration.
Provide Source Path(s)
Provide paths to recursively collect and pull files from the selected host using SMB. Any number of paths can be configured.
The folder structure under the configured source paths will be preserved at the destination.
Pull Files as a Member of the Selected Group
Select the Active Directory group you want to upload files to. Different groups may have different security settings. This field is available if your account is from AD and you belong to multiple groups, or if the "Allow Users to Upload Files Without Specifying Group Membership" option is disabled.
For further information, see Custom MetaDefender Core Workflow Rule for Groups and Active Directory Supervisors Setup.
Destination at MFT
The destination path in MetaDefender Managed File Transfer where the files will be pulled. If the path does not exist, it will be created automatically.
Transfer Method
Decide what to do with the original files on the remote file share:
- Copy Files: Files successfully pulled will remain intact on the remote file share.
- Move Files: Files successfully pulled will be removed from the remote file share.
- Sync Files: Keeps a local destination folder identical to a remote source folder.
If multiple source paths point to the same file, the file will only be deleted from the remote host if it is successfully pulled from all listed source paths.
For example, if move is enabled and there is a file located at \data\logs\log.txt and source paths \data and \data\logs are configured with the destination /pull, it will only be removed from the remote file share if pulling is successful for both \pull\logs\log.txt and \pull\log.txt.
Duplicate File Transfer Rule
Decide what to do if a file with the same absolute path already exists in MetaDefender Managed File Transfer.
- Skip duplicates: The file on the remote share is not pulled into MFT.
- Transfer duplicates with unique names: The existing local file is kept. The new file from the remote share is pulled and saved locally with a unique name.
- Overwrite existing files: Pull the file from the remote host and replace the locally existing one.
The Overwrite existing files option does not perform any pre-check on the local or remote file; it simply overwrites the local file with the remote one, even if they contain the same data. This means if a file does not change on the remote host, the same file will be pulled repeatedly.
The Overwrite existing files option will not work for files that have been sanitized by MetaDefender Core and had their filenames changed.
For example, if a file file.pdf is sanitized and renamed to file_sanitized_by_OPSWAT_MetaDefender.pdf by a Core rule, the overwrite function in MFT will not recognize it as the same file, and a new file will be created instead of overwriting the old one.
To ensure files are overwritten as expected, you can configure the sanitization rules in MetaDefender Core. This will maintain the original filename after sanitization, allowing MFT's overwrite function to work correctly.
Sync Behavior for Deleted Files
Decide on the course of action if the selected transfer method is Sync Files.
- Delete from destination: If a file or folder is deleted from the source, it will also be deleted from the destination on the next job run. This ensures the destination remains an exact mirror of the source.
- Retain on destination: If a file or folder is deleted from the source, it will not be deleted from the destination. This option is useful when you want to use Sync to transfer new and updated files but need to prevent any data from being automatically removed from the destination.
Workflow Override
If enabled, select which MetaDefender Core™ Workflow Rule should analyze the files being pulled.
If Workflow Override is not enabled, the analysis will use the same MetaDefender Core Workflow Rule as for a manually uploaded file.
Example
I want to pull files from my remote Windows file share into MetaDefender Managed File Transfer™. I only want to pull files that are in my folder named teodor, and I want this to be done every Monday at 10 AM. My username is teodor and my password is pass%123!.
My Windows file share can be reached via the FQDN planet.jupiter.io, where the SMB (version 2.0+) file share named moonshare is available and accessible on port 445. I want my files to remain on my Windows file share and just copy them to /pulled/win on MetaDefender Managed File Transfer. If a file already exists there, I want to overwrite it. For these files, I want my MetaDefender Core integration to analyze them with the Workflow Rule called "Pulled From Windows."
