Private endpoint et DNS pour Azure SQL : pourquoi ça marche du portail mais pas du job
Private endpoint, service endpoint ou accès public, zone privatelink, redirection DNS hub-and-spoke et on-premises, puis check-list de dépannage : Resolve-DnsName, Test-NetConnection, politique Redirect ou Proxy et plages de ports.
« Ça marche depuis le portail mais pas depuis le job. » Sur Azure SQL, quand un private endpoint est en jeu, c'est presque toujours un problème de DNS, puis de ports, très rarement de SQL lui-même. Voici comment je distingue les options réseau, comment je pose le DNS, et la check-list que je déroule quand une connexion échoue.
Trois façons d'exposer Azure SQL
| Accès public + pare-feu | Service endpoint | Private endpoint | |
|---|---|---|---|
| Portée | Le serveur, par règles IP | Tout le service SQL, au niveau du sous-réseau | Une instance précise (votre serveur) |
| Adresse IP publique utilisée | Oui | Oui (le trafic sort avec l'IP privée du sous-réseau) | Non |
| Accès depuis le on-premises | Via IP publique autorisée | Non | Oui (VPN, ExpressRoute) |
| Peut-on désactiver l'accès public | Sans objet | Non | Oui |
| Changement DNS | Non | Non | Oui |
| Anti-exfiltration intégrée | Non | Non | Oui |
Deux détails de la documentation que je retiens : avec un service endpoint, Azure SQL est régional (réseau virtuel et serveur dans la même région) ; et ajouter un private endpoint ne bloque pas l'accès public. Il faut cocher Deny public network access sur le serveur, sinon vous avez deux chemins ouverts.
Le DNS : la partie qui casse
Le client continue d'utiliser le nom habituel <serveur>.database.windows.net. Azure publie dans le DNS public un CNAME vers <serveur>.privatelink.database.windows.net. Une zone DNS privée privatelink.database.windows.net contient l'enregistrement A vers l'IP privée du private endpoint. Un client ne passe par le chemin privé que si son résolveur interroge cette zone.
- La zone doit être liée à chaque réseau virtuel dont les clients doivent résoudre (ou à un réseau qui sert de point de résolution).
- Une zone par type de service. Ne mélangez pas plusieurs services dans la même zone, et n'associez pas la même zone à deux private endpoints de services différents.
- Les clients doivent utiliser le nom normal. Se connecter par l'IP ou par le nom
privatelinkéchoue, par conception.
flowchart LR
OnPrem["Client on-premises"] --> OPDNS["DNS on-premises"]
OPDNS -- "redirection conditionnelle database.windows.net" --> Inbound["Resolver DNS : endpoint entrant (hub)"]
Inbound --> Zone["Zone privee privatelink.database.windows.net"]
Spoke["Job dans un spoke"] --> AzDNS["DNS Azure 168.63.129.16"]
AzDNS --> Zone
Zone --> PE["Private endpoint : IP privee"]
OnPrem -- "VPN / ExpressRoute" --> PE
Spoke -- "peering" --> PE
PE --> SQL["Passerelle Azure SQL"]
Hub-and-spoke et on-premises
- Réseaux Azure qui utilisent le DNS par défaut : il suffit que la zone privée soit liée à ces réseaux (ou au hub, selon l'architecture).
- Réseaux avec des serveurs DNS personnalisés : ces serveurs doivent renvoyer les requêtes vers
168.63.129.16(le DNS d'Azure), une adresse accessible uniquement depuis l'intérieur d'un réseau virtuel Azure. - DNS on-premises : ne jamais pointer un redirecteur directement sur
168.63.129.16(injoignable depuis chez vous, la résolution retombe silencieusement sur le DNS public). Il faut une redirection conditionnelle vers l'endpoint entrant d'un Azure DNS Private Resolver (ou une VM DNS relais dans un réseau lié à la zone). - Et la redirection porte sur
database.windows.net, pas surprivatelink.database.windows.net. Microsoft l'écrit noir sur blanc. L'idée : le client demande<serveur>.database.windows.net, donc c'est ce nom-là que le DNS local doit envoyer à Azure. Azure suit alors toute la chaîne (le nom normal, puis le CNAMEprivatelink, puis l'enregistrement A de la zone privée) et rend l'IP privée. Les serveurs qui n'ont pas de private endpoint continuent de répondre avec leur IP publique : rien ne casse pour eux.
Check-list quand le job échoue
Je lance tout depuis la machine qui exécute le job, pas depuis mon poste ni le portail. Le portail et le job n'empruntent pas le même chemin réseau, ni le même DNS.
1. Quelle IP revient ?
Resolve-DnsName sql-contoso-prd.database.windows.net -Type A
nslookup sql-contoso-prd.database.windows.net
On attend une IP privée du sous-réseau du private endpoint. IP publique : le résolveur du job ne voit pas la zone privée (lien manquant, DNS personnalisé sans redirecteur, cache). NXDOMAIN ou délai dépassé : problème de redirection ou de pare-feu DNS (UDP/TCP 53).
2. Le port répond-il ?
Test-NetConnection -ComputerName sql-contoso-prd.database.windows.net -Port 1433
Vérifiez RemoteAddress : c'est la preuve que le test est passé par le chemin privé.
3. Le handshake passe, mais la connexion expire : politique de connexion.
- Redirect : après le handshake sur 1433, le client est redirigé vers un autre port. Avec un private endpoint, la documentation demande d'autoriser 1433 à 65535 (entrant vers le réseau du private endpoint, sortant depuis le réseau du client). Pour l'accès public ou service endpoint, la plage de redirection est 11000-11999. Si ces ports sont bloqués, la connexion initiale réussit puis expire.
- Proxy : tout passe par la passerelle sur 1433 seulement. Plus simple pour les pare-feu, latence plus élevée.
- Default : Redirect depuis Azure, Proxy depuis l'extérieur.
- Seuls certains pilotes savent faire du redirect (ODBC, OLE DB, SqlClient, JDBC 9.4+) ; les autres passent en proxy.
4. Routage asymétrique. Si le trafic traverse une NVA, un pare-feu ou une NAT : le retour doit suivre le même chemin. Une UDR ne peut remplacer la route système /32 du private endpoint que par un préfixe égal ou plus précis, et la NVA doit faire du SNAT.
5. Contrôle final côté SQL, une fois connecté :
SELECT client_net_address FROM sys.dm_exec_connections WHERE session_id = @@SPID;
Pièges
- Accès public laissé ouvert « au cas où » : le test depuis le portail réussit et masque le problème du chemin privé.
- Zone privée supprimée ou recréée sans refaire les liens : plus aucune résolution privée.
- Politique de connexion basculée sur Redirect avant d'ouvrir les ports.
- Cache DNS : après correction, videz le cache du client (
Clear-DnsClientCache) et celui du serveur DNS.
Retour d'expérience
Je commence toujours par Resolve-DnsName depuis le bon hôte. Dans la grande majorité des cas, la réponse est déjà la cause. Les ports ne viennent qu'en deuxième, et le changement de politique de connexion en dernier recours, jamais comme premier réflexe.