Skip to content

Enabling RFC2136 for ExternalDNS

RFC2136 is configured through the embedded ExternalDNS subchart (extdns), not through top-level rfc2136.* chart values. Set extdns.provider.name: rfc2136 and pass provider flags under extdns.extraArgs (and secrets via extdns.env when needed). See the chart values reference for extdns.* and the upstream external-dns RFC2136 tutorial.

  • One authentication method should be enabled via extdns.extraArgs:
  • Insecure
    • This method doesn't use any authentication and anonymous updates to the DNS records can be executed
  • TSIG
    • This method uses TSIG authentication that relies on a token provided for the DNS records update.
  • GSS-TSIG

    • This method uses GSS-TSIG authentication, which is a variation of the TSIG method, but uses Kerberos for the generation of tokens for authentication and authorization
    • Method used by Active Directory Windows DNS
  • GSS-TSIG (extdns.extraArgs)

  • rfc2136-kerberos-username
    • this key should have the value of an Active Directory user account that has permissions for DNS updates
  • rfc2136-kerberos-password
    • password of the user account that will be used. Be aware that this isn't encrypted and so far ExternalDNS doesn't support adding a Secret reference for this value, so it will be stored in clear text
  • rfc2136-kerberos-realm
    • domain that will be used for authentication of the user

Sample for GSS-TSIG authentication

extdns:
  enabled: true
  fullnameOverride: "k8gb-external-dns"
  provider:
    name: rfc2136
  txtPrefix: "k8gb-<geotag>-"
  txtOwnerId: "k8gb-<loadBalancedZone>-<geotag>"
  domainFilters:
    - "<parentZone>"
  dnsPolicy: ClusterFirst
  env:
  - name: EXTERNAL_DNS_RFC2136_TSIG_SECRET
    valueFrom:
      secretKeyRef:
        name: rfc2136
        key: secret
  extraArgs:
    rfc2136-host: yourAcDc.k8gb.local
    rfc2136-port: 53
    rfc2136-gss-tsig:
    rfc2136-kerberos-username: someServiceAccount
    rfc2136-kerberos-password: insecurePlainTextPassword
    rfc2136-kerberos-realm: yourKerberosRealm.domain