Parse Auditor
Automated data versioning and audit tracking for Parse Server applications
Built by Blackburn Labs to add HIPAA compliance capabilities to Parse Server projects.
What is Parse Auditor?
Parse Auditor is a module that brings automated data versioning and tracking capabilities to Parse applications, inspired by Hibernate's Envers project. It's particularly useful for regulated industries requiring compliance with standards like HIPAA, SOC 2, and GDPR.
When we needed to add comprehensive audit logging to our Parse Server projects for HIPAA compliance, we created Parse Auditor as an open-source solution. It automatically tracks all changes to your data, creating a complete audit trail without requiring manual logging code throughout your application.
Key Features
Automatic Version Tracking
Automatically creates audit records for all creates, updates, and deletes on designated Parse classes.
HIPAA Compliance Ready
Track who accessed what data and when - essential for healthcare and other regulated industries.
Easy Integration
Simple setup with minimal configuration required. Just add to your Parse Cloud Code and specify which classes to audit.
Dual Tracking Modes
Track both write operations (creates, updates, deletes) and read operations with separate audit classes.
Installation
Add Parse Auditor to your Parse Server project's Cloud Code dependencies:
// cloud/package.json
{
"dependencies": {
"parse-auditor": "*"
}
}Basic Setup
Add to your Cloud Code main file (e.g., cloud/main.js):
const ParseAuditor = require('parse-auditor');
// Track write operations on specific classes
ParseAuditor.audit(['Patient', 'MedicalRecord', 'Prescription']);
// Optional: Track read operations separately
ParseAuditor.audit(['Patient'], {
readOnly: true,
className: 'Patient_READ_AUD'
});Audit Record Structure
Each audit entry automatically includes these metadata fields:
The user who performed the action
SAVE, DELETE, or FIND operation
The original class name
The affected record's ID
Audit records are stored in companion classes with the _AUD suffix by default (e.g., Patient → Patient_AUD).
Perfect For
Healthcare Applications
Meet HIPAA audit trail requirements for patient data access and modifications.
Financial Services
Track all changes to financial records for compliance and fraud prevention.
Enterprise Applications
Maintain complete audit logs for security, debugging, and compliance reporting.
Need Help with HIPAA Compliance?
Our team has extensive experience building healthcare applications and implementing comprehensive compliance solutions. Let's discuss how we can help your project.
Parse Auditor is open source and available under the MIT license.
View on GitHub • View on NPM