Dropbox Integration
Scan and enforce policies on Dropbox file content and sharing.
Overview
The Dropbox integration connects Aguardic to your Dropbox account via OAuth. Aguardic monitors file activity, evaluating document content, metadata, and sharing status against your policies. Violations trigger enforcement actions like quarantining files to a designated folder.
Setup
1
Connect via OAuth
Go to Integrations > Add Integration > Dropbox in the Aguardic dashboard and click Connect. You'll be redirected to Dropbox to authorize Aguardic to access your files and folders.
2
Configure monitored paths
After connecting, configure which folders Aguardic should monitor. You can watch specific folders or your entire Dropbox.
3
Bind policies
Go to Policy Bindings and map your policies to the Dropbox integration. Policies are evaluated against file activity within your monitored paths.
4
Configure enforcement
Choose how Aguardic enforces policy results on Dropbox:
BLOCKMoves the file to the "Aguardic Quarantine" folder, removing it from its original location
WARNLogs the violation in Aguardic and flags the file for review
MONITOR_ONLYNo visible action in Dropbox, violations logged in Aguardic only
How It Works
1
File activity detected
A file is created, modified, or shared in a monitored folder
2
Webhook received
Dropbox sends a webhook notification to Aguardic
3
Fetch file data
Aguardic fetches the file content, metadata, and sharing status
4
Policy evaluation
The governance engine evaluates against bound policies
5
Enforce policies
Enforcement actions are taken based on the policy mode
Aguardic automatically creates the "Aguardic Quarantine" folder in your Dropbox when the first BLOCK enforcement is triggered.
What Gets Evaluated
File contentText extracted from documents, spreadsheets, and other supported file types
File metadataName, type, size, creation date, last modified date
Sharing statusWhether the file is shared, with whom, and link permissions
File pathFull folder path of the file
Example Policies
PII in Documents
Detect personally identifiable information in file content:
- Field:
content - Operator:
MATCHES - Value:
(\b\d{3}-\d{2}-\d{4}\b|\b\d{16}\b)(SSN or credit card patterns) - Severity: CRITICAL
Unauthorized Sharing
Flag files that are shared via public link:
- Field:
sharing - Operator:
EQUALS - Value:
public - Severity: HIGH
Restricted File Types
Block upload of restricted file types:
- Field:
filename - Operator:
MATCHES - Value:
\.(exe|zip|tar\.gz|7z)$ - Severity: MEDIUM
Next Steps
- Google Drive Integration — Similar setup for Google Drive
- OneDrive Integration — Similar setup for OneDrive
- Your First Policy — Deep dive into policy creation