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:
- BLOCK — Moves the file to the "Aguardic Quarantine" folder, removing it from its original location
- WARN — Logs the violation in Aguardic and flags the file for review
- MONITOR_ONLY — No visible action in Dropbox, violations logged in Aguardic only
How It Works
- A file is created, modified, or shared in a monitored folder
- Dropbox sends a webhook notification to Aguardic
- Aguardic fetches the file content, metadata, and sharing status
- The governance engine evaluates against bound 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 content — Text extracted from documents, spreadsheets, and other supported file types
- File metadata — Name, type, size, creation date, last modified date
- Sharing status — Whether the file is shared, with whom, and link permissions
- File path — Full 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