See the Technical Documentation for step-by-step configuration, payload formats, and deployment instructions.
Overview
Netra is a multi-provider DNS management platform that brings change control, approval workflows, and full audit logging to your DNS infrastructure — regardless of where your zones are hosted.
Organizations use Netra to eliminate unreviewed DNS changes, consolidate management across providers, and maintain compliance with internal change management policies.
The Problem
Most organizations manage DNS across multiple providers — Windows DNS for internal infrastructure, Route 53 or Cloud DNS for public-facing services, sometimes Azure DNS for Microsoft workloads. Each provider has its own console, its own access model, and no built-in change approval process.
The result: DNS changes happen without review, without audit trails, and without anyone knowing until something breaks.
How Netra Solves It
- Unified interface — Manage all providers from one UI. End users pick a domain and submit — they don't need to know which provider hosts it.
- Approval workflows — Every change goes through a configurable review process before touching production DNS.
- Complete audit trail — Every action is logged, exportable, and forwardable to your SIEM.
- Drift detection — Continuous monitoring alerts you when live DNS diverges from approved state.
- Enterprise identity — LDAP/Active Directory, Okta, Microsoft Entra ID, or any OIDC provider with role-based access control.
Who It's For
| Role | Value |
|---|---|
| Platform / Infrastructure Teams | Single pane of glass for all DNS operations with built-in guardrails |
| Security & Compliance | Immutable audit log, two-person rule enforcement, SIEM integration |
| Network Engineers | Multi-provider management without switching consoles or remembering credentials |
| DevOps / SRE | CI/CD integration, Terraform provider, API tokens for automation |
Architecture
Netra deploys as a containerized application within your network. It connects outbound to your DNS providers — no inbound access required, no data leaves your environment.
Key Principles
- Zero data egress — All data stays within your infrastructure. No telemetry, no cloud dependencies.
- Embedded data store — No external database to provision, patch, or back up separately. (PostgreSQL supported for enterprise deployments that prefer a managed database.)
- Stateless-friendly — Single persistent volume for data. Container can be replaced, scaled, or migrated without coordination.
- Provider-agnostic — Communicates with each DNS provider via its native API. No agents or plugins required on your DNS servers.
Network Requirements
| Direction | Target | Purpose |
|---|---|---|
| Outbound | Windows DNS servers (port 5985/5986) | Record management via WinRM |
| Outbound | AWS API endpoints (HTTPS) | Route 53 operations |
| Outbound | GCP API endpoints (HTTPS) | Cloud DNS operations |
| Outbound | Azure API endpoints (HTTPS) | Azure DNS operations |
| Outbound | Cloudflare API (HTTPS) | Cloudflare DNS operations |
| Outbound | Domain controllers (LDAP/LDAPS) | LDAP/AD authentication |
| Outbound | Identity provider (HTTPS) | OIDC/SSO authentication |
| Inbound | Users (HTTPS, port configurable) | Web UI and API access |
High Availability
Netra supports deployment behind a load balancer with shared persistent storage. Health endpoints are built in for readiness and liveness probes.
DNS Providers
Connect any number of providers and assign domains to each. Netra routes changes to the correct provider automatically.
Supported Providers
| Provider | Authentication | Capabilities |
|---|---|---|
| Windows DNS (Server 2016–2025) | Service account credentials (encrypted at rest) | All record types, multi-DC failover, zone transfers |
| AWS Route 53 | IAM access keys or instance roles | Hosted zones, alias records, health checks |
| Google Cloud DNS | Service account JSON key | Managed zones, DNSSEC, change batching |
| Azure DNS | App registration (client credentials) | Public and private zones, record sets |
| Cloudflare | Scoped API token (DNS:Edit) | Managed zones, automatic TTL, record CRUD, pagination |
Provider-Agnostic Workflow
End users never interact with provider credentials or consoles. They select a domain from a dropdown, fill in the record details, and submit. Netra handles routing, authentication, and execution against the correct provider.
Multi-Provider Domains
Each domain is assigned to exactly one provider. Organizations with hundreds of domains across multiple providers manage them all from the same interface with consistent approval policies.
Change Control
Netra's approval system ensures no DNS change reaches production without appropriate review.
Workflow
- Submit — Any authorized user creates a DNS change request
- Pre-flight check — Netra queries live DNS to warn of conflicts before submission
- Review — An approver or admin reviews and approves/rejects
- Apply — Approved changes are executed against the DNS provider
- Verify — Drift detection confirms the change took effect
Two-Person Rule
By default, the submitter cannot approve their own request. A second authorized user must review and approve before any change is applied to production DNS.
Emergency Bypass
Admins and approvers can bypass the two-person rule when necessary — for example, during an incident where the only available responder is also the submitter. Bypass requires explicit confirmation and is prominently flagged in the audit log with full context, ensuring accountability without blocking critical operations.
Scheduled Changes
Approve changes during business hours and schedule them to apply at a specific time — during a deploy window, a maintenance period, or any future date. The change executes automatically with full audit context. No one needs to be awake at 2am to click "apply."
Maintenance Windows
Optionally define time windows when changes are permitted. Approved requests submitted outside the window are queued and applied automatically when the window opens — preventing accidental production changes during business-critical hours.
Request Templates
Administrators create reusable templates for common DNS changes. Users select from a dropdown — reducing errors and standardizing submissions.
Rollback
Any applied change can be rolled back with one click. Rollbacks create an inverse change request that goes through the normal approval workflow, maintaining the audit trail.
Identity & Access
Enterprise identity integration with granular role-based access control. Netra supports multiple authentication methods — from built-in local accounts to enterprise directory services and cloud identity providers.
Authentication Methods
| Method | Protocol | Role Mapping |
|---|---|---|
| Local Accounts | Built-in | Assigned directly per user |
| LDAP / Active Directory | LDAP(S) | AD security groups → Netra roles |
| Okta | OAuth 2.0 / OIDC | AD group names → Netra roles |
| Microsoft Entra ID | OIDC | Group Object IDs → Netra roles |
| Generic OIDC | OIDC | Configurable claim mapping |
Compatible with Keycloak, Auth0, PingFederate, Authentik, and any standards-compliant OIDC provider.
LDAP / Active Directory
Native LDAP integration for organizations that authenticate against Active Directory or other LDAP-compliant directories. Ideal for environments managing Windows DNS where AD is already the identity source of truth.
- Bind and search — Authenticates users via LDAP bind with configurable base DN and search filter
- Group-based roles — Map AD security groups directly to Netra's Admin, Approver, and User roles
- LDAPS support — Encrypted connections over port 636 with certificate validation
- No IdP subscription required — Works directly against your existing domain controllers
Role Model
| Role | Submit | Approve | Settings | Audit |
|---|---|---|---|---|
| Admin | ✓ | ✓ | ✓ | ✓ |
| Approver | ✓ | ✓ | — | — |
| User | ✓ | — | — | — |
Session Security
- Maximum 5 concurrent sessions per user
- Configurable session TTL (1–72 hours)
- Sessions persist across application restarts
- Active session visibility and remote revocation
- Full login/logout/failure history with IP addresses
Notifications
Real-time notifications keep stakeholders informed and enable one-click approvals without opening the UI.
Channels
| Channel | Format | Action Buttons |
|---|---|---|
| Slack | Block Kit message with context | Approve / Reject |
| Microsoft Teams | Adaptive card | Approve / Reject |
| Discord | Embedded message | Approve / Reject (links) |
| PagerDuty | Events API v2 alert | Severity-mapped (Critical/Warning/Info) |
| Opsgenie | Alert API v2 | Priority-mapped (P1–P5) |
| Email (SMTP) | HTML with full request details | Approve / Reject |
| Custom Webhook | Structured JSON POST | Action URLs in payload |
One-Click Actions
Approve or reject requests directly from notification messages. Actions are authenticated via cryptographically signed tokens — no session required.
Reliability
- Automatic retry with exponential backoff (30s → 2min → 10min, max 3 attempts)
- Per-channel delivery log with status, response time, and error details
- Webhook payload includes structured data for downstream automation (ServiceNow, Ansible, CMDB)
Drift Detection
Continuous monitoring compares live DNS against approved state, alerting when records diverge from what was authorized.
How It Works
- On a configurable interval, Netra queries live DNS for all managed records
- Compares live values against the last approved and applied state
- Differences are flagged as drift alerts on the dashboard
- Notifications are sent via configured channels
Use Cases
- Detecting unauthorized out-of-band changes made directly in provider consoles
- Identifying propagation failures where approved changes didn't take effect
- Compliance evidence that DNS state matches approved records
Acknowledgment
Drift alerts can be acknowledged individually or in bulk — useful during initial onboarding or planned migrations. Acknowledgments are logged in the audit trail.
Zone Management
Full visibility into your DNS estate with import, export, and continuous synchronization.
Zone Browser
Search, filter, and browse all records across any managed domain. Click any record to view its full change history.
Import Options
- Provider sync — Pull all existing records from a connected provider
- BIND zone file — Upload standard BIND-format zone files
- Auto-sync — Zones re-synchronize automatically on a configurable interval
- Bulk sync — One-click import across all configured domains
Export
- CSV export for reporting and analysis
- BIND zone file export for backup or migration
Bulk Operations
Submit multiple DNS changes via CSV upload. Each row becomes a separate request flowing through the standard approval workflow.
Automation & CI/CD
Integrate DNS management into your existing automation pipelines.
API Tokens
Create named, revocable API tokens for programmatic access. All token usage is recorded in the audit log with the token name for traceability.
CI/CD Integration
- GitHub Actions — Submit DNS changes via HMAC-SHA256 signed webhook as part of deployment workflows
- GitLab CI/CD — Token-verified webhook integration with pipeline metadata
- Bitbucket Pipelines — Token-verified webhook integration for Atlassian environments
- Azure DevOps — Token or Basic auth webhook integration with build metadata
- Pipeline requests are tagged with source system in the audit log
- Configurable auto-approve for trusted pipeline sources (requires explicit CONFIRM acknowledgment)
Terraform Provider
Manage DNS records as infrastructure-as-code. The Netra Terraform provider applies changes directly via the appropriate DNS provider, integrating with your existing IaC review process.
Webhook Payloads
Outbound notifications include structured data objects suitable for downstream automation — ServiceNow ticket creation, Ansible playbook triggers, CMDB synchronization.
Status API
Read-only JSON endpoints for monitoring dashboards — pending request count, drift alert status, and provider health summary.
Compliance & Audit
Immutable audit logging with enterprise-grade retention and forwarding capabilities.
What's Captured
- Every request submission, approval, rejection, and application
- All login attempts (success and failure) with IP addresses and user agents
- Configuration and settings changes
- Provider credential modifications
- Session lifecycle events
- API token creation, usage, and revocation
- Drift detection results and acknowledgments
- Bypass approvals (prominently flagged)
SIEM Integration
Forward audit events in real-time to your security platform:
- Syslog (UDP and TCP)
- HTTP collectors (Splunk HEC, Elastic, custom endpoints)
- Structured JSON format compatible with any log aggregator
Retention & Export
- Configurable retention periods
- CSV export filtered by date range, user, or action type
- Admin-controlled purge with confirmation safeguard
Compliance Alignment
Netra's change control and audit capabilities support compliance with frameworks that require documented change management processes, separation of duties, and audit trails — including SOC 2, ISO 27001, and internal ITIL/ITSM policies.
Deployment Options
Netra deploys within your environment — on-premises, private cloud, or managed cloud infrastructure. No data leaves your network.
Supported Platforms
| Platform | Notes |
|---|---|
| Kubernetes | Helm chart available. PersistentVolumeClaim for data. Any ingress controller. |
| AWS ECS / Fargate | EFS for persistence. ALB target group with health check endpoint. |
| Azure Container Apps | Azure Files for persistence. Built-in ingress. |
| Google Cloud Run | Cloud Storage FUSE or Filestore for persistence. |
| Docker (on-premises) | Direct deployment on any Linux host. Minimal resource requirements. |
Resource Requirements
| Resource | Minimum | Recommended |
|---|---|---|
| Memory | 256 MB | 512 MB |
| CPU | 0.25 vCPU | 0.5 vCPU |
| Storage | 1 GB | 5 GB (scales with audit log retention) |
Database Options
Netra ships with an embedded SQLite database — zero configuration, no external dependencies. For organizations that prefer a managed database or need to integrate with existing infrastructure, Netra also supports PostgreSQL as an optional backend.
| Option | Best For | Configuration |
|---|---|---|
| SQLite (default) | Most deployments. Simple, fast, no moving parts. | Zero-config — works out of the box. |
| PostgreSQL | Teams with existing Postgres infrastructure, HA requirements, or centralized backup policies. | Settings UI or environment variables (DB_ENGINE, DB_HOST, etc.) for IaC/Kubernetes. |
Switching between engines is non-destructive — Netra includes a built-in migration tool that transfers all data bidirectionally. Connection pooling, SSL, and encrypted credential storage are supported for PostgreSQL deployments.
For SQLite deployments, scheduled backups run automatically on a configurable interval with retention policies and support for network-mounted storage (NFS/SMB). A one-click database download is also available in Settings → Database for ad-hoc backups. PostgreSQL deployments use standard pg_dump tooling managed by your DBA team.
Health Monitoring
Three built-in health endpoints support different orchestration needs: /api/health for general status, /api/health/live for liveness probes (event loop responsive), and /api/health/ready for readiness probes (verifies DB connectivity). Compatible with Kubernetes, Docker healthchecks, ALB target groups, and any monitoring system. Every response includes an X-Request-Id header for log correlation.
Onboarding
Our team provides deployment guidance tailored to your infrastructure. Contact us to schedule a deployment planning session.
Security Model
Netra is designed to be safe by default — approval is enforced from first boot with no configuration required.
Data Protection
- All provider credentials encrypted at rest using AES-256-GCM
- Session tokens cryptographically signed
- No data transmitted to external services — zero telemetry
- All provider communication over encrypted channels (TLS/HTTPS)
Access Control
- Three-tier RBAC (Admin, Approver, User)
- SSO with group-based role mapping (LDAP/AD, OIDC)
- API tokens with named identity for automation
- Session limits and configurable TTL
- Remote session revocation
Change Safety
- Two-person rule enforced by default
- Pre-flight conflict detection before submission
- Confirmation safeguard for overwriting existing records
- Maintenance windows to restrict change timing
- Rollback capability with full audit trail
Operational Security
- Hardened container image with minimal attack surface
- No inbound network access required (outbound-only to providers)
- Structured logging compatible with security monitoring
- Real-time audit event forwarding to SIEM
Next Steps
For detailed configuration guides, API reference, CI/CD pipeline setup, Terraform provider documentation, and troubleshooting, see the Technical Documentation.