MATIH Platform is in active MVP development. Documentation reflects current implementation status.
10. Data Catalog & Governance
Governance
Compliance Reporting

Compliance

The Data Catalog governance framework supports regulatory compliance through dedicated compliance policies, enforcement actions, and audit capabilities. Compliance policies ensure data handling practices meet requirements from regulations such as GDPR, HIPAA, SOC 2, and PCI DSS.


Compliance Policy Types

Policy TypeRegulationFocus Area
COMPLIANCEGeneralRegulatory compliance rules
RETENTIONGDPR, HIPAAData lifecycle and deletion
MASKINGPCI DSS, GDPRData protection through masking
AUDITSOC 2, HIPAAAccess logging and monitoring
ENCRYPTIONPCI DSSData encryption requirements

Retention Policies

Retention policies manage data lifecycle and ensure data is archived or deleted according to regulatory requirements.

Rule TypeDescription
MAX_AGEData must not exceed a maximum age
ARCHIVE_AFTERData must be archived after a specified period
DELETE_AFTERData must be deleted after a specified period

Example Retention Policy

{
  "name": "GDPR Data Retention",
  "policyType": "RETENTION",
  "scopeType": "CLASSIFICATION",
  "scopeEntities": ["PII"],
  "enforcementMode": "HARD_ENFORCE",
  "rules": [
    {
      "name": "Max PII Age",
      "ruleType": "MAX_AGE",
      "parameters": {
        "maxAgeMinutes": 525960,
        "description": "PII data must be deleted after 365 days"
      },
      "enabled": true,
      "order": 1
    },
    {
      "name": "Archive After 180 Days",
      "ruleType": "ARCHIVE_AFTER",
      "parameters": {
        "archiveAfterMinutes": 259200,
        "archiveDestination": "cold-storage"
      },
      "enabled": true,
      "order": 2
    }
  ],
  "enforcementActions": [
    {
      "actionType": "WORKFLOW",
      "parameters": {
        "workflowName": "data-deletion-review"
      },
      "order": 1
    }
  ]
}

Usage Restriction Policies

Usage restriction policies control how data can be exported, downloaded, or queried.

Rule TypeDescription
QUERY_LIMITMaximum number of rows a query can return
EXPORT_RESTRICTIONAllowed export formats for the data
DOWNLOAD_RESTRICTIONControls on data download operations

Example Usage Policy

{
  "name": "PCI Export Restrictions",
  "policyType": "USAGE",
  "scopeType": "CLASSIFICATION",
  "scopeEntities": ["PCI"],
  "enforcementMode": "HARD_ENFORCE",
  "rules": [
    {
      "name": "Row Limit",
      "ruleType": "QUERY_LIMIT",
      "parameters": {
        "maxRows": 1000
      },
      "enabled": true,
      "order": 1
    },
    {
      "name": "Export Format Restriction",
      "ruleType": "EXPORT_RESTRICTION",
      "parameters": {
        "allowedFormats": ["csv"]
      },
      "enabled": true,
      "order": 2
    }
  ]
}

Policy Lifecycle for Compliance

Compliance policies follow an approval workflow to ensure proper review before activation.

StatusDescription
DRAFTPolicy is being authored
PENDING_APPROVALSubmitted for approval by a governance admin
ACTIVEApproved and actively enforced
SUSPENDEDTemporarily disabled for review
DEPRECATEDBeing phased out in favor of a replacement
ARCHIVEDNo longer in use, retained for historical record

Approval Workflow

StepActionRequired Role
1Create policyDATA_STEWARD or GOVERNANCE_ADMIN
2Submit for approvalDATA_STEWARD or GOVERNANCE_ADMIN
3Approve or rejectGOVERNANCE_ADMIN
4ActivateGOVERNANCE_ADMIN
5Suspend (if needed)GOVERNANCE_ADMIN

Governance Statistics

The governance API provides statistics for compliance reporting.

StatisticDescription
Total policiesCount of all governance policies for the tenant
Active policiesCount of currently enforced policies
Recent violationsCount of violations in the reporting period
Violation by typeBreakdown of violations by policy type
Compliance scorePercentage of policies passing without violations

Compliance Reporting

Compliance reports are generated from the governance statistics and violation data. The /v1/governance/policies/statistics endpoint provides aggregate data for building compliance dashboards and audit reports.

Report AreaData Source
Access controlABAC policy evaluations and violations
Data classificationClassification policy compliance
Data retentionRetention policy violation tracking
Audit trailAudit policy log entries
Masking coverageMasking policy application reports