Azure WAF-Aligned Architecture

June 26, 2025 ยท View on GitHub

This architecture implements Azure Well-Architected Framework (WAF) principles for enterprise-grade deployments, deployed with the WAF-Aligned deployment option:

WAF-Aligned Architecture Diagram

WAF Pillars Implementation

Security

  • Zero Trust Network: Private VNet with private endpoints for all PaaS services
  • Identity & Access: Managed identities with RBAC and least-privilege access
  • Secure Admin Access: Azure Bastion + Jumpbox for internal administration
  • Secrets Management: Azure Key Vault integration

Operational Excellence

  • Observability: Centralized logging via Log Analytics Workspace
  • Application Monitoring: Application Insights for telemetry and diagnostics
  • Infrastructure as Code: Bicep templates with parameterized configurations

Performance Efficiency

  • Auto-scaling: Container Apps with configurable scaling policies
  • Regional Proximity: Resources deployed in optimal Azure regions

Cost Optimization

  • Right-sizing: Parameterized SKUs and capacity settings
  • Resource Sharing: Shared networking and monitoring infrastructure

Reliability

  • High Availability: Multi-zone deployment options
  • Data Redundancy: Configurable geo-replication for critical data stores
  • Private Connectivity: Eliminates internet dependencies

Core Architecture Components

ComponentPurposeWAF Alignment
Virtual NetworkNetwork isolation boundarySecurity, Reliability
Private EndpointsSecure PaaS connectivity (AI Services, Storage, Cosmos DB, Key Vault)Security
Private DNS ZonesInternal name resolutionSecurity, Reliability
Azure Bastion + JumpboxSecure administrative accessSecurity
Container AppsApplication hosting with VNet integrationPerformance, Reliability
Log Analytics + App InsightsCentralized monitoring and diagnosticsOperational Excellence

Deployment Configuration

  • Configurable Parameters: If user selects to deploy as WAF Aligned, Parameters like Monitoring, Scaling, VPN will get enabled.
  • Network-first Design: All components deployed within private network boundaries
  • Enterprise-ready: Production-grade security and monitoring enabled

Application Information Flow

The application information flow remains the same for both 'sandbox' and 'waf-aligned' configuration.

The solution is composed of several services:

  • The web app front end and the backend app logic are containerized and run from Azure Container service instances.
  • When a request for conversion is created in the web app admin console, the user specifies what files should be converted and the target SQL dialect for conversion.
  • These files are then uploaded to blob storage and initial data about the request is stored in Cosmos DB.
  • The conversion takes place using appropriate LLM models using multiple agents, with each agent having a dedicated purpose in the conversion process. As files are converted, they are placed into blob storage, with metadata collected into Cosmos detailing the conversion process and the current state of the batch.
  • Cosmos also stores the logs from the individual agents so the results can be fully reviewed before any of the converted files are put into production.