<div dir="ltr">Sure! I'll do a PR in the next days.<div><br></div><div>Cheers,</div><div>Maarten</div><div class="gmail_extra"><br></div><div class="gmail_extra"><br><div class="gmail_quote">On Sat, Jun 18, 2016 at 12:57 PM, Aaron Zauner <span dir="ltr"><<a href="mailto:azet@azet.org" target="_blank">azet@azet.org</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><span class=""><br>
> On 18 Jun 2016, at 11:16, Maarten Van Horenbeeck <<a href="mailto:maarten.vhb@gmail.com">maarten.vhb@gmail.com</a>> wrote:<br>
><br>
> Hi everyone,<br>
><br>
> I'd like to contribute some text around the use of CAA records, as this is a helpful technology to improve an organization's use of X.509 PKI. Before I do a pull request, I though I'd share my proposed text on the list for discussion. Let me know if you have any edits or change requests, or if you feel this is out of scope of the document.<br>
><br>
> Thanks!<br>
> Maarten<br>
><br>
><br>
> Proposed contribution:<br>
<br>
</span>Excellent contribution.<br>
<span class=""><br>
<br>
><br>
><br>
> Certificate Authority Authorization Records (CAA)<br>
><br>
><br>
> RFC 6844 describes Certification Authorization Records, a mechanism for domain name owners to signal which Certificate Authorities are authorized to issue certificates for their domain.<br>
><br>
><br>
> When a CAA record is defined for a particular domain, it specifies that the domain owner requests Certificate Authorities to validate any request against the CAA record. If the certificate issuer is not listed in the CAA record, it should not issue the certificate.<br>
><br>
><br>
> The RFC also permits Certificate Evaluators to test an issued certificate against the CAA record, but should exercise caution, as the CAA record may change during the lifetime of a certificate, without affecting its validity.<br>
><br>
><br>
> CAA also supports an iodef property type which can be requested by a Certificate Authority to report certificate issue requests which are inconsistent with the issuer’s Certificate Policy.<br>
><br>
><br>
> Configuration<br>
><br>
><br>
> BIND supports CAA records as of version 9.9.6.<br>
><br>
><br>
> A CAA record can be configured by adding it to the zone file:<br>
><br>
><br>
> $ORIGIN <a href="http://example.com" rel="noreferrer" target="_blank">example.com</a><br>
><br>
>        CAA 0 issue "<a href="http://ca1.org" rel="noreferrer" target="_blank">ca1.org</a>"<br>
>        CAA 0 iodef “mailto:<a href="mailto:security@example.com">security@example.com</a>”<br>
><br>
><br>
> If your organization uses multiple CA’s, you can configure multiple records:<br>
><br>
><br>
>       CAA 0 issue "<a href="http://ca1.org" rel="noreferrer" target="_blank">ca1.org</a>"<br>
><br>
>       CAA 0 issue "<a href="http://ca2.org" rel="noreferrer" target="_blank">ca2.org</a>"<br>
><br>
><br>
> “<a href="http://ca1.org" rel="noreferrer" target="_blank">ca1.org</a>” and “<a href="http://ca2.org" rel="noreferrer" target="_blank">ca2.org</a>” are unique identifiers for the CA you plan on using. These strings can be obtained from your Certificate Authority, and typically are its top level domain. An example is “letsencryptorg” for the Let’s Encrypt CA operated by the Internet Security Research Group.<br>
><br>
><br>
> Knot-DNS supports CAA records as of version 2.2.0.<br>
><br>
><br>
><br>
> Validation<br>
><br>
><br>
><br>
> Once a CAA record is deployed, it can be validated using the following dig query:<br>
><br>
><br>
> user@system:~$ dig CAA <a href="http://google.com" rel="noreferrer" target="_blank">google.com</a><br>
><br>
><br>
> ; <<>> DiG 9.10.3-P4-Debian <<>> CAA <a href="http://google.com" rel="noreferrer" target="_blank">google.com</a><br>
><br>
><br>
> ;; ANSWER SECTION:<br>
><br>
> <a href="http://google.com" rel="noreferrer" target="_blank">google.com</a>.          3600 IN   CAA  0 issue "<a href="http://symantec.com" rel="noreferrer" target="_blank">symantec.com</a>"<br>
><br>
><br>
><br>
><br>
> On older versions of Dig, which do not support CAA records, you can query the record type manually:<br>
><br>
><br>
> dig +short -t TYPE257 <a href="http://google.com" rel="noreferrer" target="_blank">google.com</a><br>
<br>
</span>Would you be willing to open a Pull Request on GitHub for that? If not we'll find someone to typeset this for you.<br>
<span class="HOEnZb"><font color="#888888"><br>
Aaron<br>
<br>
</font></span></blockquote></div><br></div></div>