MicrosoftDocs / azure-docs

Open source documentation of Microsoft Azure
https://docs.microsoft.com/azure
Creative Commons Attribution 4.0 International
10.26k stars 21.44k forks source link

Clarify purpose of domain validation DNS records (A and TXT) #115796

Closed jephlu closed 3 months ago

jephlu commented 1 year ago

Hello,

On DNS record for domain validation, can you precise the purpose of the 2 record, the A and the TXT ?

Here they are presented as a requirement : image

Later it CNAME is not required image

My understanding / proposal :

Best practice :

What do you think ?

Jean-Philippe


Document Details

Do not edit this section. It is required for learn.microsoft.com ➟ GitHub issue linking.

RyanHill-MSFT commented 1 year ago

Thanks for the feedback! We are currently investigating and will update you shortly.

RyanHill-MSFT commented 1 year ago

@jephlu I see where the confusion came in @jephlu. You are correct in your first bullet, however, you don't believe you need to delete it if the CNAME is deleted. You will need to delete/update it when certificate renewal takes place. Both the A record and CNAME will route traffic, but it's recommended to use a CNAME as the inbound IP address could change due to infrastructure changes.

Nonetheless, I've assigned this issue to the content author for further review.

jephlu commented 1 year ago

Sorry, I mistaken A / CNAME records. My issue is not totally clear.

Completely agree that CNAME is the best option to route traffic.

A record can be used to route also (but was not the point of my issue at all as my point is about custom domain validation).

I just want to make clear that :

I have a customer that said to me that both are needed together (because it is marked in the doc and the azure portal, it is interpreted as a and) I demonstrated him that the process of custom domain validation works fine with the TXT record only, but he stays confident in the doc.

Last point, for the deletion of the TXT record. It can be done safely when the CNAME record is deleted, because the TXT protects it from being overtaken on another subscription by a rogue app service (in case the original app service was destroyed but not the CNAME)

Thanks!

msangapu-msft commented 3 months ago

We've added this to our backlog to review and update as needed. #please-close