Ressources · 72

Imports par URL : prévenir les requêtes serveur non autorisées

Prévenir les attaques SSRF dans les téléchargements, aperçus et connecteurs utilisant une adresse fournie par un utilisateur.

· 10 min

Allée sécurisée de serveurs et de réseaux, sans personnel Illustration éditoriale générée par IA

Ce que ce guide permet

  • Inventorier les sorties
  • Réduire les destinations
  • Limiter au niveau réseau
  • Tester les refus
  • Préférer une destination reconstruite

Contrôle express

  • Quelles destinations le composant peut-il atteindre ?
  • Une redirection est-elle contrôlée avant connexion ?
  • Les refus sont-ils vérifiés sur des cibles factices ?

Méthode pas à pas

  1. 01

    Inventorier les sorties

    Recensez import d’images, récupération de documents, aperçus de liens et connecteurs. Notez les protocoles, bibliothèques, destinations légitimes et réseaux accessibles depuis chaque composant. L’interface publique ne décrit pas les accès du serveur.

    Livrable : carte des sorties.

  2. 02

    Réduire les destinations

    Si les services sont connus, utilisez une liste d’autorisation stricte. Validez schéma, nom, port et adresses résolues avec des outils adaptés. Contrôlez chaque redirection ou désactivez-la. Une expression régulière sur le texte de l’URL ne suffit pas.

    Livrable : politique de destination.

  3. 03

    Limiter au niveau réseau

    Complétez la validation applicative par des restrictions de sortie et l’isolation du composant de récupération. Limitez temps, taille et nombre de redirections. Vérifiez les protections des services internes et de métadonnées sans utiliser de secrets dans les essais.

    Livrable : règles de sortie et limites.

  4. 04

    Tester les refus

    Dans un laboratoire autorisé, utilisez des destinations factices représentant réseau privé, boucle locale, redirection et changement de résolution. Vérifiez le refus avant connexion et l’absence d’information sensible dans l’erreur. Conservez les résultats à chaque évolution du connecteur.

    Livrable : tests négatifs et preuves de refus.

  5. 05

    Préférer une destination reconstruite

    Pour un connecteur à destinations connues, demandez un identifiant de service ou un hôte autorisé et construisez la requête avec schéma, port et chemin fixés par l’application. Ne recopiez pas librement les autres composants d’une URL utilisateur. Refusez une interprétation divergente entre le composant de validation et celui qui effectue la requête.

    Livrable : contrat d’entrée et règle de construction de la destination.

Examiner la destination effective, pas seulement le lien affiché

Cas défensifs fictifs à reproduire uniquement dans un environnement de test maîtrisé. Aucun accès à un service tiers ou à des métadonnées réelles n’est nécessaire.

SituationDécision de protectionPreuve à conserver
Un connecteur n’utilise que des services connusSélectionner une destination définie par l’application au lieu d’accepter une URL arbitraire.Contrat d’entrée, hôtes permis et requête reconstruite avec paramètres maîtrisés.
Une cible de test autorisée répond par redirectionDésactiver le suivi automatique ; si le besoin impose une redirection, appliquer la politique avant chaque nouvelle connexion.Journal de la destination initiale et refus d’une cible factice non autorisée.
Un nom de test possède plusieurs adressesExaminer les réponses IPv4 et IPv6 selon la politique et traiter les changements de résolution.Résolutions observées et décision liée à la destination effectivement utilisée.
Le validateur et le client HTTP interprètent différemment une entréeRefuser l’entrée et revoir le contrat entre composants ; ne pas valider avec une expression régulière puis déléguer une URL ambiguë.Cas de régression sans charge sensible et concordance des composants.

Cas de recette à reproduire

Exemple fictif : ces données ne décrivent aucun client ni résultat réel.

Voir les données du cas
{
    "initial_host": "public.example",
    "redirect_host": "internal.example",
    "resolved_ip": "127.0.0.1",
    "network": "isolated-test"
}

Décision attendue

La redirection aboutit à une adresse de boucle locale. Bloquer ce trajet dans le test isolé. La vérification du nom initial ne couvre pas la destination après redirection. Dans l’environnement isolé, garder le suivi automatique désactivé et vérifier qu’aucune connexion n’atteint la boucle locale. Le résultat attendu est un refus traçable, sans collecte d’un contenu interne pour prouver le blocage.

Procédure de vérification

  1. Listez destinations et réseaux autorisés pour l’import.
  2. Testez une redirection vers loopback dans un environnement isolé.
  3. Conservez la destination résolue et la preuve du blocage.

OWASP — Server Side Request Forgery Prevention

Fiche de travail à réutiliser

À compléter avec vos observations autorisées. Ces champs constituent une trame de travail, pas des résultats observés.

ChampInformation à consigner
FonctionEntrée URL, composant et destinations légitimes
PolitiqueSchémas, hôtes, ports, résolution et redirections
EssaiDestination factice, refus attendu et observé
AcceptationDestination effective autorisée, refus avant accès et absence de donnée interne retournée

Exemple d’application

Situation illustrative

Exemple fictif : un outil d’aperçu accepte une URL publique de test qui redirige vers un service privé factice.

Décision et preuve attendue

La politique refuse cette nouvelle destination. L’équipe vérifie le journal de refus, les limites de transfert et l’absence de contenu privé renvoyé.

Distinguer les mécanismes

MécanismeUtilitéPoint de vigilance
Destinations connuesLimiter à des services explicitement autorisésVérifier résolution et redirections
URL externes ouvertesAccepter une fonctionnalité plus largeExige une isolation et des contrôles supplémentaires

Indicateurs de pilotage

IndicateurCe qu’il mesurePremière action
Sorties documentéesFonctions reliées à une politiqueTraiter les connecteurs sans propriétaire
Refus vérifiésCas interdits bloqués avant connexionCorriger les chemins non contrôlés

Erreurs fréquentes

  • Valider uniquement le nom affiché dans l’URL
  • Laisser le composant accéder à tous les réseaux internes

Questions fréquentes

HTTPS suffit-il ?

Non. Le protocole ne prouve pas qu’une destination est autorisée ni qu’elle reste la même après résolution ou redirection.

Le filtre doit-il être uniquement dans le navigateur ?

Non. Le service effectuant la requête doit appliquer sa politique, complétée par le réseau.

Peut-on tester sur un système tiers ?

Utilisez un environnement maîtrisé et une autorisation explicite. Cette méthode ne demande aucun test intrusif sur des tiers.

Une liste d’hôtes autorisés dispense-t-elle des contrôles réseau ?

Non. Elle réduit le périmètre applicatif mais doit être reliée à la résolution, au client de requête et aux règles de sortie du composant. Documentez aussi temps, volume et journalisation ; aucune couche isolée ne couvre tous les chemins.

SSRF : URL et connexions

SSRF : lire une URL avant de contrôler la connexion

Une SSRF (Server-Side Request Forgery) apparaît lorsqu’une application est amenée à émettre une requête serveur vers une destination qu’elle ne devait pas atteindre. Un import de rapport, un aperçu de lien ou un outil d’agent IA peut disposer d’un accès réseau que son utilisateur ne possède pas. Le contrôle porte sur la destination réellement jointe, pas seulement sur le texte affiché.

Atelier fictif, calculé hors ligne : les 12 chaînes ci-dessous passent uniquement dans le parseur URL WHATWG du runtime Node de maintenance. Aucune résolution DNS et aucune connexion ne sont effectuées. Les domaines .example sont pédagogiques ; 2001:db8::10 appartient au préfixe IPv6 documentaire de RFC 3849. Ces résultats ne constituent pas un validateur SSRF de production.

Le contrat local de l’exercice

Le connecteur fictif n’accepte qu’une URL absolue HTTPS, sans identifiants, dont le hostname est exactement reports.partner.example, le port effectif 443 et le chemin normalisé commence par /reports/. La comparaison suit le résultat du parseur. Ce contrat refuse le point terminal et n’infère aucune équivalence DNS. Il ne couvre ni les paramètres de requête, ni leur interprétation par le service distant, ni les autorisations métier.

Pour un service connu, privilégier un identifiant de rapport et reconstruire l’URL côté serveur à partir d’une origine et d’un chemin maîtrisés. L’exercice explique les pièges d’une URL fournie ; il ne recommande pas d’exposer une URL arbitraire. Un accès à tout le Web demande une architecture de sortie distincte et ne se sécurise pas en recopiant cette petite liste autorisée.

Quatre contrôles, quatre éléments de preuve
Quatre contrôles, quatre éléments de preuve Quatre contrôles séparés : contrat et parseur, résolution et connexion, chaque redirection, puis bornes de la réponse. Le succès du premier ne valide pas les suivants. 1 · Contrat et parseur Origine, port, chemin et identifiants 2 · Résolution et connexion Adresse validée réellement utilisée 3 · Chaque redirection Nouvelle cible, même politique 4 · Réponse et ressources Délais, taille et type attendus Une URL analysable ne vaut pas autorisation réseau.
  1. 1 · Contrat et parseur — Origine, port, chemin et identifiants
  2. 2 · Résolution et connexion — Adresse validée réellement utilisée
  3. 3 · Chaque redirection — Nouvelle cible, même politique
  4. 4 · Réponse et ressources — Délais, taille et type attendus

12 URL fictives : résultat observé et limite

Chaque détail expose la chaîne initiale, les champs calculés et la décision du seul contrat local. « Poursuivre vers la résolution » signifie que les contrôles réseau restent à faire. Un hôte conforme au contrat n’est ni résolu ni déclaré sûr.

U01 · Nom attendu, réseau encore inconnu

Chaîne initiale
https://reports.partner.example/reports/daily.json

URL sérialisée
https://reports.partner.example/reports/daily.json
Schéma
https:
Nom d’hôte
reports.partner.example
Port effectif
443
Identifiant utilisateur
Absent
Mot de passe présent
Non
Chemin normalisé
/reports/daily.json

Poursuivre vers la résolution — réseau non vérifié

Le texte respecte le contrat, mais aucune adresse n’est connue. Un contrôle DNS, une connexion imposée vers l’adresse validée et une politique réseau restent nécessaires.

U02 · Majuscules et port HTTPS explicite

Chaîne initiale
https://REPORTS.PARTNER.EXAMPLE:443/reports/daily.json

URL sérialisée
https://reports.partner.example/reports/daily.json
Schéma
https:
Nom d’hôte
reports.partner.example
Port effectif
443
Identifiant utilisateur
Absent
Mot de passe présent
Non
Chemin normalisé
/reports/daily.json

Poursuivre vers la résolution — réseau non vérifié

Le parseur met le nom d’hôte en minuscules et supprime le port HTTPS par défaut de sa sérialisation. Le port effectif reste 443 ; comparer le résultat analysé évite de confondre présentation et destination.

U03 · Le nom rassurant est avant @

Chaîne initiale
https://reports.partner.example@untrusted.example/reports/daily.json

URL sérialisée
https://reports.partner.example@untrusted.example/reports/daily.json
Schéma
https:
Nom d’hôte
untrusted.example
Port effectif
443
Identifiant utilisateur
reports.partner.example
Mot de passe présent
Non
Chemin normalisé
/reports/daily.json

Refuser selon le contrat local

Motifs du contrat:

  • Nom d’hôte différent de la liste exacte
  • Identifiants intégrés interdits

Le parseur place reports.partner.example dans username. Le véritable hostname est untrusted.example : chercher une sous-chaîne autorisée dans l’URL entière ne contrôle pas la destination.

U04 · Un suffixe supplémentaire change l’hôte

Chaîne initiale
https://reports.partner.example.untrusted.example/reports/daily.json

URL sérialisée
https://reports.partner.example.untrusted.example/reports/daily.json
Schéma
https:
Nom d’hôte
reports.partner.example.untrusted.example
Port effectif
443
Identifiant utilisateur
Absent
Mot de passe présent
Non
Chemin normalisé
/reports/daily.json

Refuser selon le contrat local

Motifs du contrat:

  • Nom d’hôte différent de la liste exacte

Le hostname se termine ici par untrusted.example. Une comparaison exacte échoue, même si le nom attendu apparaît au début. Le contrat n’utilise ni recherche de sous-chaîne ni expression permissive.

U05 · Même hôte, autre port

Chaîne initiale
https://reports.partner.example:8443/reports/daily.json

URL sérialisée
https://reports.partner.example:8443/reports/daily.json
Schéma
https:
Nom d’hôte
reports.partner.example
Port effectif
8443
Identifiant utilisateur
Absent
Mot de passe présent
Non
Chemin normalisé
/reports/daily.json

Refuser selon le contrat local

Motifs du contrat:

  • Port effectif différent de 443

Le port effectif est 8443. Autoriser un nom d’hôte ne doit pas ouvrir tous les services disponibles sur ses autres ports.

U06 · HTTP ne satisfait pas HTTPS

Chaîne initiale
http://reports.partner.example/reports/daily.json

URL sérialisée
http://reports.partner.example/reports/daily.json
Schéma
http:
Nom d’hôte
reports.partner.example
Port effectif
80
Identifiant utilisateur
Absent
Mot de passe présent
Non
Chemin normalisé
/reports/daily.json

Refuser selon le contrat local

Motifs du contrat:

  • Schéma différent de HTTPS
  • Port effectif différent de 443

Le schéma HTTP et son port par défaut 80 divergent du contrat HTTPS/443. Réécrire silencieusement la chaîne masquerait la demande initiale ; la décision doit rester explicite.

U07 · Le segment .. change le chemin

Chaîne initiale
https://reports.partner.example/reports/../admin/status

URL sérialisée
https://reports.partner.example/admin/status
Schéma
https:
Nom d’hôte
reports.partner.example
Port effectif
443
Identifiant utilisateur
Absent
Mot de passe présent
Non
Chemin normalisé
/admin/status

Refuser selon le contrat local

Motifs du contrat:

  • Chemin hors du préfixe /reports/

Le parseur résout /reports/../admin/status en /admin/status. Tester le préfixe sur la chaîne brute aurait pris une décision différente. Même après normalisation, l’interprétation du chemin côté service doit être maîtrisée.

U08 · Un caractère d’hôte encodé est normalisé

Chaîne initiale
https://%72eports.partner.example/reports/daily.json

URL sérialisée
https://reports.partner.example/reports/daily.json
Schéma
https:
Nom d’hôte
reports.partner.example
Port effectif
443
Identifiant utilisateur
Absent
Mot de passe présent
Non
Chemin normalisé
/reports/daily.json

Poursuivre vers la résolution — réseau non vérifié

Le %72 initial devient r dans le hostname calculé pour cette URL spéciale HTTPS. La chaîne rejoint le même résultat que U01 ; cela n’apporte aucune preuve sur DNS, TLS ou l’autorisation métier.

U09 · Point terminal : contrat exact

Chaîne initiale
https://reports.partner.example./reports/daily.json

URL sérialisée
https://reports.partner.example./reports/daily.json
Schéma
https:
Nom d’hôte
reports.partner.example.
Port effectif
443
Identifiant utilisateur
Absent
Mot de passe présent
Non
Chemin normalisé
/reports/daily.json

Refuser selon le contrat local

Motifs du contrat:

  • Nom d’hôte différent de la liste exacte

Le hostname conserve son point final dans ce résultat WHATWG. Le profil pédagogique exige une égalité exacte et le refuse. Une politique de production doit documenter sa propre normalisation et l’utiliser de bout en bout.

U10 · Référence relative sans URL de base

Chaîne initiale
//reports.partner.example/reports/daily.json

URL absolue non analysable sans base

Refuser : échec du parseur

Sans base fournie, new URL rejette cette référence commençant par //. Ajouter une base ailleurs dans la chaîne pourrait changer le résultat : validateur et client doivent employer le même modèle d’analyse.

U11 · Hôte attendu avec identifiant intégré

Chaîne initiale
https://training@reports.partner.example/reports/daily.json

URL sérialisée
https://training@reports.partner.example/reports/daily.json
Schéma
https:
Nom d’hôte
reports.partner.example
Port effectif
443
Identifiant utilisateur
training
Mot de passe présent
Non
Chemin normalisé
/reports/daily.json

Refuser selon le contrat local

Motifs du contrat:

  • Identifiants intégrés interdits

Le nom d’hôte attendu ne suffit pas : username contient training. Le profil interdit tout identifiant intégré. Cette valeur est fictive et ne représente pas un compte ni un secret.

U12 · Adresse IPv6 documentaire

Chaîne initiale
https://[2001:db8::10]/reports/daily.json

URL sérialisée
https://[2001:db8::10]/reports/daily.json
Schéma
https:
Nom d’hôte
[2001:db8::10]
Port effectif
443
Identifiant utilisateur
Absent
Mot de passe présent
Non
Chemin normalisé
/reports/daily.json

Refuser selon le contrat local

Motifs du contrat:

  • Nom d’hôte différent de la liste exacte

Le parseur accepte la syntaxe IPv6 entre crochets, mais le contrat n’autorise aucun littéral IP. Ce préfixe est réservé à la documentation ; il ne doit pas être décrit comme une destination Internet opérationnelle.

Du nom contrôlé à la destination réellement jointe

Du nom contrôlé à la destination réellement jointe
Situation fictivePreuve manquante ou changementDécision attendue
N01 · Résolution répétéeL’application valide une première réponse ; le client résout de nouveau et obtient une adresse interne.Bloquer cette seconde résolution non contrôlée. Connecter uniquement une adresse validée selon la politique de destination.
N02 · Réponse 302Location désigne un autre hôte, port ou chemin.Désactiver le suivi automatique. Si le produit autorise des redirections contrôlées, analyser et vérifier chaque nouvelle cible avant sa connexion.
N03 · Proxy de sortieLe proxy résout le nom et choisit la destination ; l’application ignore ses règles.Ne pas conclure à une destination vérifiée. Documenter le contrôle et la preuve au composant qui établit réellement la connexion.
N04 · Repli après échecUne nouvelle adresse A/AAAA, un retry ou un fallback est tenté.Appliquer la même politique à chaque adresse et à chaque tentative ; aucun chemin de repli ne doit contourner le contrôle.
N05 · Réponse trop longueLa destination autorisée renvoie un flux volumineux ou un contenu inattendu.Imposer des délais et une limite de taille dans le client, vérifier le type attendu et traiter le contenu séparément. Aucun seuil universel n’est inventé ici.

Lier la connexion à l’adresse validée ne signifie pas désactiver TLS : conserver le nom d’hôte original pour HTTP Host, SNI et la vérification du certificat. Le composant qui ouvre la connexion doit imposer cette liaison ; une observation DNS enregistrée plus tôt ne la démontre pas. Les règles réseau complètent le contrôle applicatif, notamment contre les destinations locales, privées, de bouclage et de lien local, en IPv4 comme en IPv6.

Métadonnées cloud : un contrôle séparé

Dans EC2, l’option « jeton requis » impose IMDSv2 ; « jeton facultatif » permet IMDSv1 ou IMDSv2. L’activation du point d’accès IPv6 est une option explicite. Ces paramètres se vérifient sur les instances concernées : le simple nom IMDSv2 dans une documentation ne prouve pas leur configuration. Protéger les métadonnées ne remplace ni l’isolement des sorties ni le contrôle des autres services internes.

Six pièces à conserver pour une recette SSRF

  • Le besoin métier et la liste des services, ports et opérations réellement nécessaires.
  • La version du parseur et du client HTTP, avec les résultats attendus des cas négatifs.
  • La politique d’adresses IPv4/IPv6 et l’endroit où elle est imposée avant connexion.
  • La trace qui relie la destination validée à la connexion, y compris proxy, retries et repli.
  • La décision sur les redirections et les bornes de réponse, testées dans un environnement autorisé.
  • Les journaux minimisés : décision, cible utile et corrélation, sans recopier mots de passe, jetons ou paramètres sensibles.

Les 12 cas, les quatre contrôles et les six pièces sont une méthode éditoriale locale, pas une certification OWASP. Le parseur fournit des champs ; les sources décrivent les risques et les contrôles. Les libellés « refus » et « poursuivre » ne préjugent pas du comportement de votre pile HTTP.

Sources primaires et périmètre

Sources relues le

Fichiers : quarantaine et retrait

Un contenu récupéré reste à contrôler avant diffusion

Téléverser un document ou le récupérer par URL ne décide pas de sa mise à disposition. L’original et les dérivés doivent conserver leur version, leurs contrôles et leur état d’accès jusqu’à chaque lecture.

  • Isoler les fichiers reçus avant les traitements et la diffusion.
  • Refuser un retour de traitement visant une ancienne version ou décision.
  • Vérifier les droits et le retrait sur les aperçus comme sur l’original.

Voir les trois parcours et les retours tardifs →

Sources relues le · OWASP · File Upload Cheat Sheet · OWASP · Authorization Cheat Sheet · WHATWG · HTML input accept · PostgreSQL 18 · Transaction isolation

Références officielles

Date de consultation des références : . La méthode et la fiche de travail proposent des contrôles à adapter à votre contexte ; elles ne constituent pas une certification.