odgs-collibra-bridge 0.3.0

Bridge: Collibra Business Glossary → ODGS Runtime Enforcement Schemas

ODGS Collibra Bridge

Transform your Collibra Business Glossary into active ODGS runtime enforcement schemas.

Collibra documents your data. ODGS enforces it.

---

What It Does

The ODGS Collibra Bridge connects to your Collibra Data Intelligence Platform and transforms passive business glossary assets (terms, metrics, data quality rules) into ODGS-compliant JSON schemas that the Universal Interceptor (ODGS Core Engine) can enforce at runtime.

Collibra REST API                 ODGS
┌──────────────┐     Bridge      ┌──────────────┐
│ Business     │ ──────────────→ │ JSON Schema  │
│ Glossary     │   reads terms,  │ + Interceptor│
│ + Data Dict. │   outputs ODGS  │ = Enforcement│
└──────────────┘                 └──────────────┘

Install

pip install odgs-collibra-bridge

---

🏢 Enterprise & Public Sector: EU AI Act Compliance

This open-source package connects your physical data infrastructure to the ODGS validation engine. However, if you are operating a High-Risk AI System and require strict liability indemnification under the EU AI Act (Articles 10 & 12), you need cryptographic provenance.

Metric Provenance offers the commercial Enterprise Infrastructure for ODGS:

• Certified Sovereign Packs: Pre-compiled, cryptographically signed Ed25519 rule bundles for DORA, EU AI Act, and Basel.
• The S-Cert Sovereign Registry: An air-gapped Enterprise Certificate Authority that mints immutable, JWS-sealed audit logs.

👉 Discover the Sovereign CA Enterprise Node & Packs

Quick Start

Python API

from odgs_collibra import CollibraBridge

bridge = CollibraBridge(
    base_url="https://your-org.collibra.com",
    api_token="your-api-token",
    organization="acme_corp",
)

# Sync Finance community → ODGS metric schemas
bridge.sync(
    community="Finance",
    output_dir="./schemas/custom/",
    output_type="metrics",
)

# Sync DQ rules → ODGS enforcement rules
bridge.sync(
    community="Data Quality",
    output_dir="./schemas/custom/",
    output_type="rules",
    severity="HARD_STOP",
)

CLI

# Sync using API token
odgs-collibra sync \
    --url https://your-org.collibra.com \
    --token YOUR_API_TOKEN \
    --org acme_corp \
    --community "Finance" \
    --output ./schemas/custom/ \
    --type metrics

# Or use environment variable
export COLLIBRA_API_TOKEN=your-token
odgs-collibra sync \
    --url https://your-org.collibra.com \
    --org acme_corp \
    --community "Finance"

Output

The bridge generates ODGS-compliant JSON schemas:

{
  "$schema": "https://metricprovenance.com/schemas/odgs/v4",
  "metadata": {
    "source": "collibra",
    "organization": "acme_corp",
    "bridge": "odgs-collibra-bridge",
    "asset_count": 42
  },
  "items": [
    {
      "metric_urn": "urn:odgs:custom:acme_corp:net_revenue",
      "name": "Net Revenue",
      "logic": { "formula": "gross_revenue - returns" },
      "content_hash": "a1b2c3..."
    }
  ]
}

These schemas can be loaded directly by the ODGS Interceptor for runtime enforcement.

🆕 v4.1.0: Bi-Directional Write-Backs

The ODGS Collibra bridge now supports Bi-Directional Sync (Plane 4). It can parse your secure sovereign_audit.log offline and push compliance results back directly into the respective Collibra Asset's activity stream/comments.

This creates a seamless feedback loop for Governance Officers without compromising the Air-Gapped nature of the core ODGS protocol.

odgs-collibra write-back \
    --log-path ./sovereign_audit.log \
    --url https://your-org.collibra.com \
    --token YOUR_API_TOKEN

Authentication

The bridge supports two authentication methods:

Method	Flag	Environment Variable
API Token (recommended)	--token	COLLIBRA_API_TOKEN
Basic Auth	--username + --password	—

URN Namespace

All generated schemas use the urn:odgs:custom:<org>:* namespace, ensuring clean separation from Sovereign URNs (urn:odgs:sov:*) and other organizations.

Requirements

• Python ≥ 3.9
• odgs ≥ 4.0.0 (core protocol)
• Collibra Data Intelligence Platform (any version with REST API v2)

Related

• ODGS Protocol — The core enforcement engine
• ODGS Databricks Bridge — Unity Catalog integration (planned)
• ODGS Snowflake Bridge — Snowflake integration (planned)

---

License

Apache 2.0 — Metric Provenance | The Hague, NL 🇳🇱