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:

meta_actor

The user who performed the action

meta_action

SAVE, DELETE, or FIND operation

meta_class

The original class name

meta_subject

The affected record's ID

Audit records are stored in companion classes with the _AUD suffix by default (e.g., PatientPatient_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