Learning center

Customer-resident data processing

What it means for every row-level operation to run inside your own network, and how a hosted service can still coordinate the work.

Tutorial

Customer-resident processing means that every operation touching a row of your data — reading it, profiling it, subsetting, masking, generating, validating and provisioning it — happens inside your own security boundary: your VPC, VNet, cluster or data centre.

The hosted service still has a job. It holds the people and policy side of test data management: who may request what, which policies are approved, what is scheduled, what happened and when. The trick is splitting the product so that the hosted part never needs your rows.

Control plane and customer-resident data planeTwo zones. The top zone is DataNivra Cloud: public website and console, control-plane API, a metadata and audit store, and the policy registry. The bottom zone is your environment: the DataNivra agent, the TDM engine, your source systems accessed read-only, and your test environments. The agent opens outbound-only HTTPS connections to the cloud and sends only control metadata, aggregate metrics, evidence references and secret references. Raw rows and secret values never cross the boundary.DataNivra CloudWebsite & consoleControl-plane APIMetadata & auditstorePolicy registry &approvalsYour environmentDataNivra agentTDM engineSource systems(read-only)DEV / QA / SIT / UAT/ PERF targetsOutbound-only HTTPS, started by the agentMetadata, aggregates, evidence references only. No rawrows, no secrets.
Control plane and customer-resident data plane. Two zones. The top zone is DataNivra Cloud: public website and console, control-plane API, a metadata and audit store, and the policy registry. The bottom zone is your environment: the DataNivra agent, the TDM engine, your source systems accessed read-only, and your test environments. The agent opens outbound-only HTTPS connections to the cloud and sends only control metadata, aggregate metrics, evidence references and secret references. Raw rows and secret values never cross the boundary.
Text description
  1. DataNivra Cloud: Website & console → Control-plane API → Metadata & audit store → Policy registry & approvals

    Connection: Outbound-only HTTPS, started by the agent — Metadata, aggregates, evidence references only. No raw rows, no secrets.

  2. Your environment: DataNivra agent → TDM engine → Source systems (read-only) → DEV / QA / SIT / UAT / PERF targets

Why it matters

Most organisations are comfortable using software-as-a-service for coordination, but not for sending regulated production data to a vendor. Traditional options force a choice: install and operate everything yourself, or ship data to someone else's cloud. Both are costly — one in operational effort, the other in risk, review cycles and contractual complexity. A split architecture removes the dilemma. Security teams can review a small, well-defined boundary instead of a whole vendor platform, and data owners keep physical control of the data they are accountable for.

Outbound lease modelThe control plane queues a declarative command and grants a time-bound lease when the agent asks for work. The agent validates the command and the policy checksum, executes locally and reports metadata. The control plane never opens a connection into your network.DataNivra CloudQueue declarativecommandGrant time-bound leaseRecord status & auditYour environmentAgent polls for workVerify command &policy checksumExecute locallyReport metadataAgent-initiated HTTPS only; no inbound ports
Outbound lease model. The control plane queues a declarative command and grants a time-bound lease when the agent asks for work. The agent validates the command and the policy checksum, executes locally and reports metadata. The control plane never opens a connection into your network.
Text description
  1. DataNivra Cloud: Queue declarative command → Grant time-bound lease → Record status & audit

    Connection: Agent-initiated HTTPS only; no inbound ports

  2. Your environment: Agent polls for work → Verify command & policy checksum → Execute locally → Report metadata

Example

A synthetic walk-through of one dataset request:

  1. A tester asks for a QA dataset of 500 synthetic-scenario members in the control plane.
  2. The control plane records the request and queues a declarative command: which subset definition, which approved masking policy version, which target environment.
  3. The Agent in the customer network, which only ever connects outbound, polls for work and receives a time-bound Lease.
  4. The agent verifies the policy checksum, reads the source read-only, builds, masks and certifies the dataset, and provisions it to QA.
  5. It reports back job state, row counts, durations and a checksum of the certification report — nothing else.

At no point does the control plane open a connection into the customer network or receive a row.

How DataNivra approaches it

DataNivra is built as two planes. The data plane — agent, engine and industry packs — is deployed in your environment. The control plane is hosted and stores metadata only. The control-plane code base cannot even import the engine or connectors; an automated architecture test enforces that, so the hosted service is structurally unable to process rows.

Connectivity is outbound-only HTTPS from the agent. Credentials are configured as secret references resolved locally. If the control plane is unreachable, the agent finishes or aborts safely and never publishes uncertified output. Read the architecture overview and the agent protocol for the full picture.

Questions a security review should ask

  • Which component touches rows, and where does it run? Only the agent and engine, inside your network.
  • What network access does the agent need? Outbound HTTPS to the control plane; no inbound ports, no VPN, no vendor access to your databases.
  • What exactly leaves? Identifiers, counts, ratios, gate outcomes, checksums and secret references. Small counts in discovery reports are raised to a floor so they cannot reveal tiny tables. Rows, samples, credentials and keys never leave.
  • How is that enforced? Classified message contracts, an egress guard in the agent that checks every outbound message, and the same checks again at the control plane's ingress.
  • What happens if the hosted service is unavailable? The agent keeps its local state, queues value-free reports and resumes when the control plane returns; it never falls back to sending more data.
  • Can we verify it ourselves? Yes: plant synthetic canary values, run a job, and search everything the control plane shows for them; inspect traffic through your own proxy.

The trust page describes these verification procedures, and the documentation covers deployment. See which sources the agent can read on the integrations page, browse the guides, use the free tools, or start free with the synthetic sandbox before installing anything.

Key takeaways

  • Row-level work lives where the data lives.
  • The hosted service coordinates with metadata and never dials in.
  • The boundary is enforced in code, not just in documentation.