Skip to main content

AWS Integration Surface

Openbox docs are strictly limited to what OpenBox itself needs. Your AWS estate (org structure, region strategy, edge protection, observability, DR tiering, compliance program) is your decision — this page enumerates the OpenBox-required interface and links out for the rest.

What this page does NOT cover

  • ❌ AWS Organizations / Control Tower / OU structure / SCPs
  • ❌ Region strategy (single-region vs multi-region vs multi-cloud)
  • ❌ CloudFront + WAF + Shield edge protection
  • ❌ Admin access (Verified Access, Client VPN, SSO federation)
  • ❌ Observability stack (Datadog, Prometheus, New Relic, Loki, etc.)
  • ❌ Multi-region DR tiering (your business SLA drives choice)
  • ❌ SOC 2 / GDPR / HIPAA compliance program
  • ❌ CI/CD pipeline (GitHub Actions vs GitLab CI vs Jenkins)

For AWS best practices on these topics, see AWS Well-Architected.

What OpenBox binds to

Required for any AWS deploy:

ResourcePurposeAlternative if not AWS
EKS cluster (Auto Mode ≥ v1.31, or vanilla K8s ≥ 1.27)Container runtimeSelf-managed K8s (kops, Rancher), AKS, GKE
KMS CMKEnvelope encryption for app dataVault Transit, on-prem HSM
S3 bucketOPA policy bundle storageMinIO (S3-compatible)
IAM (IRSA)Pods → AWS API accessVault + K8s ServiceAccount tokens

Optional but common in prod:

ResourcePurposeIn-cluster fallback
RDS PostgreSQL / AuroraManaged DBBitnami postgresql chart, CloudNativePG
ElastiCache RedisManaged RedisBitnami redis chart
ECRImage registryHarbor, GAR, ACR, ghcr.io
Secrets Manager (via ESO)Credential syncHashiCorp Vault, sealed-secrets, K8s Secrets
ALB (via ALB Ingress Controller)Public load balancerIstio Gateway + NLB, NGINX Ingress
ACMTLS certscert-manager + Let's Encrypt

Non-AWS cloud mappings

Every "required" and "optional" AWS resource has a documented equivalent:

AWSAzureGCPOn-prem
EKSAKSGKERancher / OpenShift / Kubespray
KMSAzure Key VaultCloud KMSVault Transit
S3Blob StorageGCSMinIO
RDS AuroraAzure Database for PostgreSQLCloud SQLCloudNativePG operator
ElastiCacheAzure Cache for RedisMemorystoreBitnami redis chart
ECRACRArtifact RegistryHarbor
Secrets ManagerKey Vault (secrets)Secret ManagerVault
ALBApplication GatewayCloud Load BalancerMetalLB + HAProxy
ACMApp Service Managed CertManaged SSLcert-manager
IAM (IRSA)Entra + Managed IdentityWorkload IdentitySPIRE / OIDC federation

Integration pattern

OpenBox is a Kubernetes application. Its only contract with the underlying cloud is:

  1. A conformant K8s cluster (≥ 1.27) with a StorageClass, an Ingress controller, and metrics-server addon.
  2. An object store for OPA bundles (S3 or S3-compatible).
  3. A KMS-like service the pods can call for envelope encryption (via IRSA on AWS, equivalent workload identity elsewhere).

Everything else — where the cluster sits, how traffic reaches it, how data is backed up, what monitors it — is your architecture, not ours.