From c85d6d8089a590675bb90115426cea0fe401a30e Mon Sep 17 00:00:00 2001 From: Nikolai Emil Damm Date: Fri, 13 Nov 2026 17:01:32 +0100 Subject: [PATCH 1/2] feat(email): publish the SES MAIL FROM records through external-dns Company Email relays through Amazon SES with the custom MAIL FROM domain bounce.devantler.tech. Publish its MX and SPF records DNS-only from one platform-applied DNSEndpoint in the aws namespace, extend the explicit DNS-record allow-list with exactly that endpoint list, name and namespace, and let external-dns manage MX and TXT records. The mailbox domain's own SPF and DMARC records stay with their current owner. The identity's three DKIM CNAMEs join this DNSEndpoint once their tokens are readable. Part of devantler-tech/platform#5481. Co-Authored-By: Claude Opus 5.5 --- .../restrict-explicit-dns-records.yaml | 32 ++++++++- .../hetzner/apps/aws/dns-endpoint.yaml | 31 ++++++++ .../hetzner/apps/aws/kustomization.yaml | 1 + .../external-dns/helm-release.yaml | 11 +++ .../approved-surface.txt | 2 +- .../kyverno-test.yaml | 15 ++++ .../resources.yaml | 72 +++++++++++++++++++ .../kyverno-test.yaml | 16 +++++ .../resources.yaml | 34 +++++++++ .../kyverno-test.yaml | 15 ++++ 10 files changed, 225 insertions(+), 4 deletions(-) create mode 100644 k8s/providers/hetzner/apps/aws/dns-endpoint.yaml create mode 100644 tests/restrict-explicit-dns-records-ses-drift/kyverno-test.yaml create mode 100644 tests/restrict-explicit-dns-records-ses-drift/resources.yaml diff --git a/k8s/bases/infrastructure/cluster-policies/best-practices/restrict-explicit-dns-records.yaml b/k8s/bases/infrastructure/cluster-policies/best-practices/restrict-explicit-dns-records.yaml index ced1b4e030..403018c8b0 100644 --- a/k8s/bases/infrastructure/cluster-policies/best-practices/restrict-explicit-dns-records.yaml +++ b/k8s/bases/infrastructure/cluster-policies/best-practices/restrict-explicit-dns-records.yaml @@ -16,7 +16,8 @@ metadata: policies.kyverno.io/minversion: 1.17.0 policies.kyverno.io/description: >- Limits explicit ExternalDNS records to the owning product's namespace and - the approved DNS-only documentation CNAME. Tenant labels do not grant DNS + the approved DNS-only records: the documentation CNAME and company + Email's Amazon SES records. Tenant labels do not grant DNS ownership. New records require a reviewed allow-list change. spec: validationActions: @@ -47,13 +48,38 @@ spec: "providerSpecific": dyn([{"name": "cloudflare/proxied", "value": "false"}]) } ] + # Company Email's Amazon SES records (platform#5481), DNS-only and owned by + # one platform-applied DNSEndpoint in the aws namespace: the MAIL FROM + # domain's MX and SPF records. The mailbox domain's own SPF and DMARC + # records are not managed here. + - name: companyMailEndpoints + expression: >- + [ + { + "dnsName": dyn("bounce.devantler.tech"), + "recordType": dyn("MX"), + "recordTTL": dyn(300), + "targets": dyn(["10 feedback-smtp.eu-central-1.amazonses.com"]), + "providerSpecific": dyn([{"name": "cloudflare/proxied", "value": "false"}]) + }, + { + "dnsName": dyn("bounce.devantler.tech"), + "recordType": dyn("TXT"), + "recordTTL": dyn(300), + "targets": dyn(["v=spf1 include:amazonses.com ~all"]), + "providerSpecific": dyn([{"name": "cloudflare/proxied", "value": "false"}]) + } + ] validations: # CEL equality compares the complete endpoint list, field by field and # without wildcard matching: extra targets, endpoints, routing fields or # provider settings cannot slip through, and a missing list never matches. - expression: >- - object.metadata.namespace == 'data-product-controller' && - object.?spec.?endpoints.orValue([]) == variables.approvedEndpoints + (object.metadata.namespace == 'data-product-controller' && + object.?spec.?endpoints.orValue([]) == variables.approvedEndpoints) || + (object.metadata.namespace == 'aws' && + object.metadata.name == 'company-mail-ses' && + object.?spec.?endpoints.orValue([]) == variables.companyMailEndpoints) message: >- Explicit DNS records require platform ownership and an approved endpoint, target, record type and DNS-only provider configuration. diff --git a/k8s/providers/hetzner/apps/aws/dns-endpoint.yaml b/k8s/providers/hetzner/apps/aws/dns-endpoint.yaml new file mode 100644 index 0000000000..47956466e7 --- /dev/null +++ b/k8s/providers/hetzner/apps/aws/dns-endpoint.yaml @@ -0,0 +1,31 @@ +# Company Email's Amazon SES DNS records (platform#5481), published DNS-only by +# the platform's external-dns. These are new names, so each has one owner: the +# MAIL FROM domain's MX and SPF records, so that SPF aligns with the mailbox +# domain for DMARC. The mailbox domain's own SPF and DMARC records are not +# managed here. restrict-explicit-dns-records admits exactly this endpoint list +# in this namespace and under this name. +apiVersion: externaldns.k8s.io/v1alpha1 +kind: DNSEndpoint +metadata: + name: company-mail-ses + namespace: aws + labels: + app.kubernetes.io/managed-by: ksail +spec: + endpoints: + - dnsName: bounce.devantler.tech + recordTTL: 300 + recordType: MX + targets: + - 10 feedback-smtp.eu-central-1.amazonses.com + providerSpecific: + - name: cloudflare/proxied + value: "false" + - dnsName: bounce.devantler.tech + recordTTL: 300 + recordType: TXT + targets: + - v=spf1 include:amazonses.com ~all + providerSpecific: + - name: cloudflare/proxied + value: "false" diff --git a/k8s/providers/hetzner/apps/aws/kustomization.yaml b/k8s/providers/hetzner/apps/aws/kustomization.yaml index 86324f13ba..49931fea0d 100644 --- a/k8s/providers/hetzner/apps/aws/kustomization.yaml +++ b/k8s/providers/hetzner/apps/aws/kustomization.yaml @@ -12,6 +12,7 @@ resources: - policy-eks-ci-smoke-boundary.yaml - role-eks-ci.yaml - role-ses-account-setup.yaml + - dns-endpoint.yaml - external-secret.yaml - oci-repository.yaml - flux-kustomization.yaml diff --git a/k8s/providers/hetzner/infrastructure/external-dns/helm-release.yaml b/k8s/providers/hetzner/infrastructure/external-dns/helm-release.yaml index c335f602d3..f8f8e0199e 100644 --- a/k8s/providers/hetzner/infrastructure/external-dns/helm-release.yaml +++ b/k8s/providers/hetzner/infrastructure/external-dns/helm-release.yaml @@ -22,6 +22,17 @@ spec: sources: - gateway-httproute - crd + # The chart default manages only A, AAAA and CNAME. Company Email's SES + # DNSEndpoint also declares MX and TXT records (platform#5481). The TXT + # registry still owns only records carrying this instance's marker, so + # existing MX, SPF and DMARC records that external-dns did not create stay + # untouched. + managedRecordTypes: + - A + - AAAA + - CNAME + - MX + - TXT policy: sync # TXT-registry ownership is what makes this single writer safe to reschedule: # every managed record gets a paired "_externaldns." TXT carrying this diff --git a/scripts/validate-eks-ci-role-policy/approved-surface.txt b/scripts/validate-eks-ci-role-policy/approved-surface.txt index 56b7f55f3c..c049256f56 100644 --- a/scripts/validate-eks-ci-role-policy/approved-surface.txt +++ b/scripts/validate-eks-ci-role-policy/approved-surface.txt @@ -58,7 +58,7 @@ helm.toolkit.fluxcd.io/v2|HelmRelease|crossplane-system|crossplane fb717f7c9adb2 helm.toolkit.fluxcd.io/v2|HelmRelease|dex|dex e2cbe6e6b5ace19ebded8d0e75f508277dd450c079ed51062d13649e148904b9 -helm.toolkit.fluxcd.io/v2|HelmRelease|external-dns|external-dns 31c51b3b18a4d7dfbbe2fec098d6aad40f292dd29c6e91f0422217969ce24e45 +helm.toolkit.fluxcd.io/v2|HelmRelease|external-dns|external-dns 107eaf8ad3d74abff5c6b1c6d7ca1b49ac75829fe425672f81cdc1e799457511 helm.toolkit.fluxcd.io/v2|HelmRelease|external-secrets|external-secrets 8f35691cdbe76b4011798a5adba69e8fc77415acf56aa0187e460015d8608087 diff --git a/tests/restrict-explicit-dns-records-create/kyverno-test.yaml b/tests/restrict-explicit-dns-records-create/kyverno-test.yaml index a4de23d105..46d926ecf6 100644 --- a/tests/restrict-explicit-dns-records-create/kyverno-test.yaml +++ b/tests/restrict-explicit-dns-records-create/kyverno-test.yaml @@ -99,3 +99,18 @@ results: - wedding-app/forged-label kind: DNSEndpoint result: fail + - policy: restrict-explicit-dns-records + resources: + - aws/company-mail-ses + kind: DNSEndpoint + result: pass + - policy: restrict-explicit-dns-records + resources: + - aws/other-mail-records + kind: DNSEndpoint + result: fail + - policy: restrict-explicit-dns-records + resources: + - data-product-controller/company-mail-ses + kind: DNSEndpoint + result: fail diff --git a/tests/restrict-explicit-dns-records-create/resources.yaml b/tests/restrict-explicit-dns-records-create/resources.yaml index 25a01ef242..2bfd177510 100644 --- a/tests/restrict-explicit-dns-records-create/resources.yaml +++ b/tests/restrict-explicit-dns-records-create/resources.yaml @@ -280,3 +280,75 @@ spec: providerSpecific: - name: cloudflare/proxied value: "false" +--- +apiVersion: externaldns.k8s.io/v1alpha1 +kind: DNSEndpoint +metadata: + name: company-mail-ses + namespace: aws +spec: + endpoints: + - dnsName: bounce.devantler.tech + recordTTL: 300 + recordType: MX + targets: + - 10 feedback-smtp.eu-central-1.amazonses.com + providerSpecific: + - name: cloudflare/proxied + value: "false" + - dnsName: bounce.devantler.tech + recordTTL: 300 + recordType: TXT + targets: + - v=spf1 include:amazonses.com ~all + providerSpecific: + - name: cloudflare/proxied + value: "false" +--- +apiVersion: externaldns.k8s.io/v1alpha1 +kind: DNSEndpoint +metadata: + name: other-mail-records + namespace: aws +spec: + endpoints: + - dnsName: bounce.devantler.tech + recordTTL: 300 + recordType: MX + targets: + - 10 feedback-smtp.eu-central-1.amazonses.com + providerSpecific: + - name: cloudflare/proxied + value: "false" + - dnsName: bounce.devantler.tech + recordTTL: 300 + recordType: TXT + targets: + - v=spf1 include:amazonses.com ~all + providerSpecific: + - name: cloudflare/proxied + value: "false" +--- +apiVersion: externaldns.k8s.io/v1alpha1 +kind: DNSEndpoint +metadata: + name: company-mail-ses + namespace: data-product-controller +spec: + endpoints: + - dnsName: bounce.devantler.tech + recordTTL: 300 + recordType: MX + targets: + - 10 feedback-smtp.eu-central-1.amazonses.com + providerSpecific: + - name: cloudflare/proxied + value: "false" + - dnsName: bounce.devantler.tech + recordTTL: 300 + recordType: TXT + targets: + - v=spf1 include:amazonses.com ~all + providerSpecific: + - name: cloudflare/proxied + value: "false" diff --git a/tests/restrict-explicit-dns-records-ses-drift/kyverno-test.yaml b/tests/restrict-explicit-dns-records-ses-drift/kyverno-test.yaml new file mode 100644 index 0000000000..4bd975b3c5 --- /dev/null +++ b/tests/restrict-explicit-dns-records-ses-drift/kyverno-test.yaml @@ -0,0 +1,16 @@ +--- +apiVersion: cli.kyverno.io/v1alpha1 +kind: Test +metadata: + name: restrict-explicit-dns-records-ses-drift +policies: + - ../../k8s/bases/infrastructure/cluster-policies/best-practices/restrict-explicit-dns-records.yaml +resources: + - resources.yaml +variables: ../restrict-explicit-dns-records-create/values.yaml +results: + - policy: restrict-explicit-dns-records + resources: + - aws/company-mail-ses + kind: DNSEndpoint + result: fail diff --git a/tests/restrict-explicit-dns-records-ses-drift/resources.yaml b/tests/restrict-explicit-dns-records-ses-drift/resources.yaml new file mode 100644 index 0000000000..48bde20195 --- /dev/null +++ b/tests/restrict-explicit-dns-records-ses-drift/resources.yaml @@ -0,0 +1,34 @@ +--- +# The approved name and namespace with drifted content: one record is proxied +# and an extra endpoint is appended. Equality over the complete list refuses it. +apiVersion: externaldns.k8s.io/v1alpha1 +kind: DNSEndpoint +metadata: + name: company-mail-ses + namespace: aws +spec: + endpoints: + - dnsName: bounce.devantler.tech + recordTTL: 300 + recordType: MX + targets: + - 10 feedback-smtp.eu-central-1.amazonses.com + providerSpecific: + - name: cloudflare/proxied + value: "true" + - dnsName: bounce.devantler.tech + recordTTL: 300 + recordType: TXT + targets: + - v=spf1 include:amazonses.com ~all + providerSpecific: + - name: cloudflare/proxied + value: "false" + - dnsName: mail.devantler.tech + recordTTL: 300 + recordType: A + targets: + - 192.0.2.1 + providerSpecific: + - name: cloudflare/proxied + value: "false" diff --git a/tests/restrict-explicit-dns-records-update/kyverno-test.yaml b/tests/restrict-explicit-dns-records-update/kyverno-test.yaml index 28f7cfbc43..588770b92f 100644 --- a/tests/restrict-explicit-dns-records-update/kyverno-test.yaml +++ b/tests/restrict-explicit-dns-records-update/kyverno-test.yaml @@ -99,3 +99,18 @@ results: - wedding-app/forged-label kind: DNSEndpoint result: fail + - policy: restrict-explicit-dns-records + resources: + - aws/company-mail-ses + kind: DNSEndpoint + result: pass + - policy: restrict-explicit-dns-records + resources: + - aws/other-mail-records + kind: DNSEndpoint + result: fail + - policy: restrict-explicit-dns-records + resources: + - data-product-controller/company-mail-ses + kind: DNSEndpoint + result: fail From 54089e4e7ca41898af2ac8a940fe6f6709d9febf Mon Sep 17 00:00:00 2001 From: Nikolai Emil Damm Date: Fri, 13 Nov 2026 21:19:23 +0100 Subject: [PATCH 2/2] feat(email): publish the SES identity's DKIM records The company mail domain's SES identity exists, and its three Easy DKIM tokens are now readable. Add the matching DNS-only CNAMEs to the SES DNSEndpoint and to the explicit DNS-record allow-list, so SES can verify the domain. The committed DNSEndpoint passes the policy as written. Part of devantler-tech/platform#5481. Co-Authored-By: Claude Opus 5.5 --- .../restrict-explicit-dns-records.yaml | 25 ++++++- .../hetzner/apps/aws/dns-endpoint.yaml | 31 +++++++- .../resources.yaml | 72 +++++++++++++++++++ 3 files changed, 123 insertions(+), 5 deletions(-) diff --git a/k8s/bases/infrastructure/cluster-policies/best-practices/restrict-explicit-dns-records.yaml b/k8s/bases/infrastructure/cluster-policies/best-practices/restrict-explicit-dns-records.yaml index 403018c8b0..783d359e35 100644 --- a/k8s/bases/infrastructure/cluster-policies/best-practices/restrict-explicit-dns-records.yaml +++ b/k8s/bases/infrastructure/cluster-policies/best-practices/restrict-explicit-dns-records.yaml @@ -50,8 +50,8 @@ spec: ] # Company Email's Amazon SES records (platform#5481), DNS-only and owned by # one platform-applied DNSEndpoint in the aws namespace: the MAIL FROM - # domain's MX and SPF records. The mailbox domain's own SPF and DMARC - # records are not managed here. + # domain's MX and SPF records and the identity's three Easy DKIM CNAMEs. + # The mailbox domain's own SPF and DMARC records are not managed here. - name: companyMailEndpoints expression: >- [ @@ -68,6 +68,27 @@ spec: "recordTTL": dyn(300), "targets": dyn(["v=spf1 include:amazonses.com ~all"]), "providerSpecific": dyn([{"name": "cloudflare/proxied", "value": "false"}]) + }, + { + "dnsName": dyn("svxhyimgvhbtlrpbuivbx6ievcg5iwiw._domainkey.devantler.tech"), + "recordType": dyn("CNAME"), + "recordTTL": dyn(300), + "targets": dyn(["svxhyimgvhbtlrpbuivbx6ievcg5iwiw.dkim.amazonses.com"]), + "providerSpecific": dyn([{"name": "cloudflare/proxied", "value": "false"}]) + }, + { + "dnsName": dyn("frps4kqaz6dyvptmesuiwlaendicjq5v._domainkey.devantler.tech"), + "recordType": dyn("CNAME"), + "recordTTL": dyn(300), + "targets": dyn(["frps4kqaz6dyvptmesuiwlaendicjq5v.dkim.amazonses.com"]), + "providerSpecific": dyn([{"name": "cloudflare/proxied", "value": "false"}]) + }, + { + "dnsName": dyn("caa46ibjaox7qooavcfri6ha3xbxxjld._domainkey.devantler.tech"), + "recordType": dyn("CNAME"), + "recordTTL": dyn(300), + "targets": dyn(["caa46ibjaox7qooavcfri6ha3xbxxjld.dkim.amazonses.com"]), + "providerSpecific": dyn([{"name": "cloudflare/proxied", "value": "false"}]) } ] validations: diff --git a/k8s/providers/hetzner/apps/aws/dns-endpoint.yaml b/k8s/providers/hetzner/apps/aws/dns-endpoint.yaml index 47956466e7..5e2c201362 100644 --- a/k8s/providers/hetzner/apps/aws/dns-endpoint.yaml +++ b/k8s/providers/hetzner/apps/aws/dns-endpoint.yaml @@ -1,9 +1,10 @@ # Company Email's Amazon SES DNS records (platform#5481), published DNS-only by # the platform's external-dns. These are new names, so each has one owner: the # MAIL FROM domain's MX and SPF records, so that SPF aligns with the mailbox -# domain for DMARC. The mailbox domain's own SPF and DMARC records are not -# managed here. restrict-explicit-dns-records admits exactly this endpoint list -# in this namespace and under this name. +# domain for DMARC, and the identity's three Easy DKIM CNAMEs, whose tokens +# come from the EmailIdentity's status. The mailbox domain's own SPF and DMARC +# records are not managed here. restrict-explicit-dns-records admits exactly +# this endpoint list in this namespace and under this name. apiVersion: externaldns.k8s.io/v1alpha1 kind: DNSEndpoint metadata: @@ -29,3 +30,27 @@ spec: providerSpecific: - name: cloudflare/proxied value: "false" + - dnsName: svxhyimgvhbtlrpbuivbx6ievcg5iwiw._domainkey.devantler.tech + recordTTL: 300 + recordType: CNAME + targets: + - svxhyimgvhbtlrpbuivbx6ievcg5iwiw.dkim.amazonses.com + providerSpecific: + - name: cloudflare/proxied + value: "false" + - dnsName: frps4kqaz6dyvptmesuiwlaendicjq5v._domainkey.devantler.tech + recordTTL: 300 + recordType: CNAME + targets: + - frps4kqaz6dyvptmesuiwlaendicjq5v.dkim.amazonses.com + providerSpecific: + - name: cloudflare/proxied + value: "false" + - dnsName: caa46ibjaox7qooavcfri6ha3xbxxjld._domainkey.devantler.tech + recordTTL: 300 + recordType: CNAME + targets: + - caa46ibjaox7qooavcfri6ha3xbxxjld.dkim.amazonses.com + providerSpecific: + - name: cloudflare/proxied + value: "false" diff --git a/tests/restrict-explicit-dns-records-create/resources.yaml b/tests/restrict-explicit-dns-records-create/resources.yaml index 2bfd177510..12dfe9673b 100644 --- a/tests/restrict-explicit-dns-records-create/resources.yaml +++ b/tests/restrict-explicit-dns-records-create/resources.yaml @@ -304,6 +304,30 @@ spec: providerSpecific: - name: cloudflare/proxied value: "false" + - dnsName: svxhyimgvhbtlrpbuivbx6ievcg5iwiw._domainkey.devantler.tech + recordTTL: 300 + recordType: CNAME + targets: + - svxhyimgvhbtlrpbuivbx6ievcg5iwiw.dkim.amazonses.com + providerSpecific: + - name: cloudflare/proxied + value: "false" + - dnsName: frps4kqaz6dyvptmesuiwlaendicjq5v._domainkey.devantler.tech + recordTTL: 300 + recordType: CNAME + targets: + - frps4kqaz6dyvptmesuiwlaendicjq5v.dkim.amazonses.com + providerSpecific: + - name: cloudflare/proxied + value: "false" + - dnsName: caa46ibjaox7qooavcfri6ha3xbxxjld._domainkey.devantler.tech + recordTTL: 300 + recordType: CNAME + targets: + - caa46ibjaox7qooavcfri6ha3xbxxjld.dkim.amazonses.com + providerSpecific: + - name: cloudflare/proxied + value: "false" --- apiVersion: externaldns.k8s.io/v1alpha1 kind: DNSEndpoint @@ -328,6 +352,30 @@ spec: providerSpecific: - name: cloudflare/proxied value: "false" + - dnsName: svxhyimgvhbtlrpbuivbx6ievcg5iwiw._domainkey.devantler.tech + recordTTL: 300 + recordType: CNAME + targets: + - svxhyimgvhbtlrpbuivbx6ievcg5iwiw.dkim.amazonses.com + providerSpecific: + - name: cloudflare/proxied + value: "false" + - dnsName: frps4kqaz6dyvptmesuiwlaendicjq5v._domainkey.devantler.tech + recordTTL: 300 + recordType: CNAME + targets: + - frps4kqaz6dyvptmesuiwlaendicjq5v.dkim.amazonses.com + providerSpecific: + - name: cloudflare/proxied + value: "false" + - dnsName: caa46ibjaox7qooavcfri6ha3xbxxjld._domainkey.devantler.tech + recordTTL: 300 + recordType: CNAME + targets: + - caa46ibjaox7qooavcfri6ha3xbxxjld.dkim.amazonses.com + providerSpecific: + - name: cloudflare/proxied + value: "false" --- apiVersion: externaldns.k8s.io/v1alpha1 kind: DNSEndpoint @@ -352,3 +400,27 @@ spec: providerSpecific: - name: cloudflare/proxied value: "false" + - dnsName: svxhyimgvhbtlrpbuivbx6ievcg5iwiw._domainkey.devantler.tech + recordTTL: 300 + recordType: CNAME + targets: + - svxhyimgvhbtlrpbuivbx6ievcg5iwiw.dkim.amazonses.com + providerSpecific: + - name: cloudflare/proxied + value: "false" + - dnsName: frps4kqaz6dyvptmesuiwlaendicjq5v._domainkey.devantler.tech + recordTTL: 300 + recordType: CNAME + targets: + - frps4kqaz6dyvptmesuiwlaendicjq5v.dkim.amazonses.com + providerSpecific: + - name: cloudflare/proxied + value: "false" + - dnsName: caa46ibjaox7qooavcfri6ha3xbxxjld._domainkey.devantler.tech + recordTTL: 300 + recordType: CNAME + targets: + - caa46ibjaox7qooavcfri6ha3xbxxjld.dkim.amazonses.com + providerSpecific: + - name: cloudflare/proxied + value: "false"