cClaude.rocks ☕ Le blog

Cas d’utilisation

Parfois, vous voulez exécuter la commande cURL sur un serveur qui gère plusieurs sites web (sur le même port), mais vous ne souhaitez pas vraiment que cURL résolve le nom d’hôte dans l’URL donnée.

Vous savez l’adresse IP du serveur, et cependant la résolution DNS ne vous permet pas d’atteindre le serveur depuis la machine sur laquelle vous souhaitez exécuter cURL.

Typiquement lors de la préparation du lancement d'un site Web ou du débogage de problèmes avec un site déjà en ligne, il peut parfois être utile de contourner les couches CDN et proxy lors de la demande de contenu du site en envoyant ces demandes Web directement à une adresse IP spécifique sans utiliser l'enregistrement DNS public du site.

Cette pratique consistant à « épingler » une requête Web directement sur un serveur peut être accomplie en modifiant votre fichier /etc/hosts, ce qui entraînera le routage des requêtes pour un nom de domaine spécifié (par exemple : « www.example.com ») à partir de votre machine locale à une adresse IP spécifiée (par exemple : 127.0.0.1) jusqu’à ce que les modifications, que vous avez apportées à /etc/hosts, soient annulées.

Cependant, que faire si vous souhaitez épingler une seule requête à une adresse IP, sans modifier les fichiers de configuration de votre système ? Heureusement, ce type d’épinglage de requêtes « ad hoc » est possible via la ligne de commande avec cURL, qui fournit une option de résolution spéciale, formatée comme suit :

--resolve [DOMAIN]:[PORT]:[IP]

Cela acheminera toutes les requêtes Web effectuées lors de l’exécution d’une commande cURL qui correspond à un [DOMAINE] et un [PORT] donné à l’adresse [IP] spécifiée. Les valeurs spécifiées par cette option (qui peuvent être invoquées plusieurs fois dans une seule commande pour acheminer plusieurs combinaisons domaine/port vers diverses adresses IP) s’appliqueront à la demande initiale, ainsi qu’à toutes les redirections que cURL sera amené à suivre.

Les solutions

Bricoler votre fichier hosts

Comme nous l’avons vu plus haut, il est possible de définir le nom de domaine dans le fichier /etc/hosts et de l’associer à l’adresse IP qui vous souhaitez utiliser.

Cependant, cela affectera l’ensemble de la machine et ce n’est pas nécessaire votre souhait.

Fabriquer une fausse entête http avec le bon nom d’hôte

Une manière classique et facile à comprendre est d’envoyer votre requête vers le serveur souhaiter en bricolant l’entête HTTP. Le serveur HTTP pourra alors traiter la réponse pour le nom de serveur souhaiter.

Concrètement si vous exécutez votre site de test HTTP « example.com » sur localhost (127.0.0.1) et souhaitez vérifier qu’il fonctionne :

curl --header "Host: example.com" http://127.0.0.1/

Utiliser cURL ainsi permettra de faire fonctionner le système de cookies au nom du domain « example.com » dans ce cas, mais cela échouera lamentablement si la page redirige vers un autre hôte (dans le cas où le suivi de redirection est activité : --location) car cURL enverra également le faux entête Host: dans toutes les autres demandes.

L’option --header annule intelligemment l’entête Host: intégrée donnée quand un entête personnalisé est fourni afin que seul celui transmis par l’utilisateur soit envoyé dans la demande.

Une meilleure façon de générer une fausse entête

Aujourd’hui le protocole HTTPS devient la norme et simuler l’hôte : l’en-tête ne suffit pas. Un serveur HTTPS doit également obtenir le nom du serveur déjà fourni dans la négociation TLS afin de savoir quel certificat utiliser. Le nom est fourni dans le champ SNI. La commande cURL doit également connaître le nom d’hôte correct pour vérifier le certificat de serveur (les certificats de serveur sont rarement enregistrés pour une adresse IP). cURL extrait le nom à utiliser dans les deux cas à partir de l’URL fournie.

Comme nous ne pouvons pas simplement mettre l’adresse IP dans l’URL pour que cela fonctionne, nous inversons l’approche et donnons à la place l’URL appropriée à cURL mais avec une adresse IP personnalisée à utiliser pour le nom d’hôte que nous avons défini. L’option --resolve de ligne de commande est notre amie :

curl --resolve example.com:443:127.0.0.1 https://example.com/

Sous le capot, cette option remplit le cache DNS de cURL avec une entrée personnalisée pour le port « example.com » 443 avec l’adresse 127.0.0.1, donc lorsque cURL veut se connecter à ce nom d’hôte, il trouve votre adresse spécialement conçue et s’y connecte au lieu de l’adresse IP que le « vrai » nom résoudrait autrement.

Cette méthode fonctionne également parfaitement lorsque vous suivez des redirections, car toute autre utilisation du même nom d’hôte se résoudra toujours à la même adresse IP et la redirection vers un autre nom d’hôte se résoudra alors correctement. Vous pouvez même utiliser cette option plusieurs fois sur la ligne de commande pour ajouter des adresses personnalisées pour plusieurs noms. Vous pouvez également ajouter plusieurs adresses IP pour chaque nom si vous le souhaitez.

Se connecter à un autre hôte par son nom

Comme indiqué ci-dessus, --resolve est génial si vous souhaitez pointer cURL vers une adresse IP connue spécifique. Mais parfois, ce n’est pas exactement ce que vous voulez non plus.

Imaginez que vous ayez un nom d’hôte qui se résout en un certain nombre de noms d’hôtes différents, éventuellement un certain nombre de serveurs frontaux pour le même site / service. Pas complètement inconnu. Imaginez maintenant que vous souhaitez émettre votre commande cURL vers un serveur spécifique parmi les serveurs frontaux. C’est un serveur qui sert « example.com » mais le serveur individuel est appelé « host-47.example.com ».

Vous pouvez résoudre le nom d’hôte dans une première étape avant d’utiliser cURL et utilisez --resolve comme indiqué ci-dessus.

Ou vous pouvez utiliser --connect-to, qui fonctionne à la place sur la base d’un nom d’hôte. En utilisant cela, vous pouvez faire en sorte que cURL remplace une paire spécifique de nom d’hôte + numéro de port par une autre paire d’hôte + numéro de port avant que le nom ne soit résolu !

curl --connect-to example.com:443:host-47.example.com:443 https://example.com/

Des combos fous

La plupart des options de cURL sont contrôlées individuellement, ce qui signifie qu’il y a rarement une logique qui vous empêche de les utiliser dans les combinaisons impressionnantes auxquelles vous pouvez penser.

--resolve, --connect-to et --header peuvent tous être utilisés dans la même ligne de commande !

Connectez-vous à un hôte HTTPS exécuté sur localhost, utilisez le nom correct pour SNI et la vérification de certificat, mais demandez toujours un hôte distinct dans l’en-tête Host:? Bien sûr pas de problème:

curl --resolve example.com:443:127.0.0.1 https://example.com/ --header "Host: diff.example.com"

Tout ce qui précède avec libcurl ?

Lorsque vous avez fini de jouer avec les options cURL comme décrit ci-dessus et que vous souhaitez convertir vos lignes de commande en code libcurl à la place, votre meilleur ami est d’invoqué le paramètre : --libcurl.

Ajoutez simplement --libcurl example.c à votre ligne de commande, et cURL générera le modèle de code C pour vous dans ce nom de fichier donné. Sur la base de ce modèle, l’utilisation correcte de ce code est généralement simple et vous aurez toutes les options à lire de manière pratique.

Références

• curl another host

ᦿ