Uitleg CAA

Wat is CAA?

Je hoster regelt het certificaat voor je website. Met CAA geef je aan welke uitgever daarvoor toestemming krijgt. Begin bij die dienst en neem de juiste instelling over.

Bij een beveiligde verbinding met example.com controleert de browser of de server bij die domeinnaam hoort. Je hoster regelt daarvoor een certificaat: een digitaal bewijs voor de domeinnaam. Via een DNS-instelling kun je bepalen welke certificaatuitgever zulke certificaten mag uitgeven. Die instelling heet CAA.

Controleer CAA op je eigen domein

Wat gebeurt er bij example.com?

Stel dat je hoster het certificaat voor example.com aanvraagt en automatisch vernieuwt. Voordat de uitgever een nieuw certificaat afgeeft, controleert hij welke toestemming je in DNS hebt gezet. Staat alleen zijn uitgeversnaam in die instelling, dan krijgt een andere uitgever daarmee geen toestemming.

Je hoeft de uitgever meestal niet zelf te kiezen: begin bij de dienst die het certificaat voor je website regelt. Vraag welke CAA-waarde die nodig heeft. Een verkeerde waarde kan de volgende uitgifte of vernieuwing blokkeren. Het certificaat dat je al hebt wordt door deze instelling niet ingetrokken.

De instelling overnemen van je certificaatdienst

Vraag de exacte recordnaam en waarde aan je hoster. In een DNS-paneel met losse velden vul je voor dit voorbeeld meestal in:

  • Naam of Host: example.com, vaak aangegeven met @ of een leeg veld.
  • Type: CAA.
  • Flags of Vlaggen: 0, tenzij de gedocumenteerde instructie iets anders vraagt.
  • Tag: issue, de toestemming voor gewone certificaten.
  • Waarde: de uitgeversnaam uit de instructie van je certificaatdienst.

Gebruik altijd de bedoelde DNS-naam. CAA kan ook voor een andere naam of een subdomein worden ingesteld. De uitgeversnaam is niet noodzakelijk dezelfde als de bedrijfsnaam die je in een certificaat ziet. Plak niet een volledige recordregel in alleen het waardeveld. Volg de providerinstructie voor aanhalingstekens of voor panelen met één volledig gegevensveld.

Een volledige recordregel lezen

Een volledige recordregel ziet er zo uit: example.com. CAA 0 issue "ca1.example.net". Dit fictieve voorbeeld staat de uitgever met CAA-naam ca1.example.net toe om gewone certificaten voor example.com uit te geven. De waarde is een identificatie van de uitgever, geen adres waar bezoekers van je website heen gaan. Neem deze fictieve waarde niet over. Gebruik de echte waarde van je certificaatdienst.

Certificaatuitgevers worden in documentatie ook CA’s genoemd. Gebruik je meerdere certificaatdiensten, bijvoorbeeld naast je hoster ook een CDN, inventariseer dan hun uitgevers. Je kunt een tweede issue-record toevoegen voor de tweede benodigde uitgever. Beide toestemmingen tellen dan mee. Neem ook automatische vernieuwing en reserve-uitgevers in die inventarisatie op.

Instellen en controleren

  • Inventariseer alle diensten die certificaten aanvragen, ook voor automatische vernieuwing.
  • Neem hun gedocumenteerde CAA-namen en eventuele noodzakelijke parameters over.
  • Controleer na publicatie elke naam die op de certificaataanvraag komt, bijvoorbeeld example.com én www.example.com. Houd rekening met oude DNS-caches.
  • Kijk of de geraadpleegde DNS-diensten dezelfde instellingen geven en op welke naam die records gevonden zijn. Die naam heet in technische details de owner.
  • Laat de certificaatdienst tijdig controleren of een aanvraag of vernieuwing met deze instellingen slaagt. Wacht hiermee niet tot het bestaande certificaat bijna verloopt.

Wat een scanuitkomst betekent

DNS Radar vergelijkt de CAA-antwoorden van publieke DNS-diensten. Zij kunnen opgeslagen antwoorden gebruiken. De scan bevraagt de nameservers niet rechtstreeks en voert niet de volledige controle van een certificaatuitgever uit. Een AD-signaal is de melding van de DNS-dienst dat DNSSEC-validatie is geslaagd. DNS Radar valideert de handtekeningen niet zelf.

Een gunstige uitkomst laat dus zien wat de gemeten DNS-antwoorden publiceren, niet dat een certificaat zal worden uitgegeven. De CA moet nog de aanvraag, identiteit en eventuele parameters beoordelen. De e-mailuitkomst is een denkbeeldige RFC 9495-vraag voor een adres op het gescande domein. Er is geen echte S/MIME-aanvraag onderzocht. Bij iodef controleert de scan de schrijfwijze en de vorm van het meldadres, niet of het bereikbaar is of meldingen ontvangt.

Welke records gelden voor een aanvraag?

De CA begint de CAA-opvraag bij de aangevraagde naam. De opvraag volgt ook DNS-aliassen, zoals CNAME. Levert een opvraag geen CAA op, dan zoekt de CA volgens de standaard verder bij de bovenliggende naam, tot en met het TLD. De eerste gevonden groep CAA-records op dezelfde naam heet de relevante recordset, of RRset. Een eigen groep op een subdomein vervangt de groep van de bovenliggende naam. De regels worden niet samengevoegd.

Dat maakt een apex/www-verschil belangrijk. Stel: example.com staat alleen uitgever ca1.example.net toe. www.example.com verwijst met een CNAME naar een CDN-doel waar CAA voor ca2.example.org wordt gevonden. De toestemming voor example.com is dan niet vanzelf toestemming voor www.example.com. Controleer de werkelijk gekozen CAA-records voor beide namen. Eén certificaat met meerdere domeinnamen moet bij al die namen passen.

Bestaat geen relevante recordset, dan beperkt CAA de uitgifte niet. Bestaan er wel beperkingen voor de aanvraag, dan moet de uitgever er normaal aan voldoen. Ook de aanvraagvalidatie en eventuele gedocumenteerde uitzonderingen in het certificaatbeleid van de uitgever (CP/CPS) tellen mee.

De tags: gewone, wildcard- en e-mailcertificaten

  • issue: welke uitgevers gewone certificaten mogen uitgeven. Zonder issuewild geldt dit ook voor wildcards.
  • issuewild: welke uitgevers wildcardcertificaten mogen uitgeven, bijvoorbeeld voor *.example.com. Als deze tag aanwezig is, vervangt hij voor wildcards de issue-regels.
  • issuemail: welke uitgevers certificaten voor e-mailadressen mogen uitgeven, zoals S/MIME. Dit beleid staat los van issue en issuewild.
  • iodef: een adres waar een uitgever meldingen naartoe kan sturen. Alleen publicatie bewijst niet dat er meldingen worden verzonden of aankomen.

Voeg issuewild alleen toe als het wildcardbeleid moet afwijken. Gebruik issuemail alleen als je een apart e-mailcertificaatbeleid nodig hebt.

Een paar veelvoorkomende combinaties, zonder aanvullende voorwaarden:

  • Alleen iodef: er is een meldadres, maar geen beperking op uitgevers van gewone of wildcardcertificaten.
  • Alleen issuewild: wildcards zijn beperkt. Gewone certificaten zijn daarmee niet beperkt.
  • Alleen 0 issue ";": geen uitgever toegestaan voor gewone certificaten, en ook niet voor wildcards zolang issuewild ontbreekt.
  • 0 issue ";" naast 0 issue "ca1.example.net": ca1.example.net is wel toegestaan. Een lege issuer is geen veto boven een andere toestemming.

Let op overerving: als een subdomein alleen een iodef-record krijgt, is dat een eigen recordset die de CAA van de bovenliggende naam vervangt. Een daar ingestelde uitgeverbeperking geldt dan niet automatisch meer op dat subdomein.

Extra voorwaarden en de critical-vlag

Gewone CAA-instellingen hebben meestal vlag 0. Vlag 128 maakt een tag critical: een uitgever moet die tag begrijpen om een certificaat te mogen uitgeven. Dat geldt ook voor een officieel geregistreerde tag. Gebruik die vlag alleen als alle uitgevers die je nodig hebt de tag aantoonbaar ondersteunen.

Voor extra beperking tot een account of controlemethode beschrijft RFC 8657 de parameters accounturi en validationmethods bij issue en issuewild. Ze werken alleen zoals bedoeld bij een CA die ze ondersteunt en herkent. Een syntactisch geldige waarde bewijst die ondersteuning niet. Neem zulke waarden exact uit de CA-documentatie over. Parameters op issuemail zijn CA-specifiek.

Primaire bronnen

Veelgestelde vragen

Trekt CAA bestaande certificaten in?

Nee. CAA wordt beoordeeld bij nieuwe uitgifte en vernieuwing. Bestaande certificaten blijven geldig tot ze verlopen of via een ander mechanisme worden ingetrokken.

Wat als ik meerdere CA's gebruik?

Voeg voor iedere benodigde uitgever een eigen issue-record toe. Neem ook de uitgevers voor hosting, CDN en automatische vernieuwing mee. Controleer bij apart wildcard- of e-mailbeleid of de overeenkomstige tags de juiste uitgevers noemen. De toestemmingen binnen zo’n tag tellen bij elkaar op.

Hoe werken gewone, wildcard- en e-mailregels samen?

issue stuurt gewone certificaten en is de wildcardfallback wanneer issuewild ontbreekt. issuemail is onafhankelijk en valt nooit terug op een van beide TLS-tags.

Garandeert een groene scan dat een CA uitgeeft?

Nee. De uitkomst beschrijft de gemeten DNS-publicatie. De uitgever beoordeelt zelf de aanvraag en ondersteuning voor eventuele extra voorwaarden. Controleer daarom ook de certificaatvernieuwing bij je hoster of certificaatdienst.

Controleer CAA op je eigen domein →