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
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
- 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.
- 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.
- 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.
- 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.
- 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.
| Situation | Décision de protection | Preuve à conserver |
|---|---|---|
| Un connecteur n’utilise que des services connus | Sé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 redirection | Dé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 adresses | Examiner 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ée | Refuser 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
- Listez destinations et réseaux autorisés pour l’import.
- Testez une redirection vers loopback dans un environnement isolé.
- Conservez la destination résolue et la preuve du blocage.
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.
| Champ | Information à consigner |
|---|---|
| Fonction | Entrée URL, composant et destinations légitimes |
| Politique | Schémas, hôtes, ports, résolution et redirections |
| Essai | Destination factice, refus attendu et observé |
| Acceptation | Destination 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écanisme | Utilité | Point de vigilance |
|---|---|---|
| Destinations connues | Limiter à des services explicitement autorisés | Vérifier résolution et redirections |
| URL externes ouvertes | Accepter une fonctionnalité plus large | Exige une isolation et des contrôles supplémentaires |
Indicateurs de pilotage
| Indicateur | Ce qu’il mesure | Première action |
|---|---|---|
| Sorties documentées | Fonctions reliées à une politique | Traiter les connecteurs sans propriétaire |
| Refus vérifiés | Cas interdits bloqués avant connexion | Corriger 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.
- 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
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 initialehttps://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 initialehttps://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 initialehttps://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 initialehttps://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 initialehttps://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 initialehttp://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 initialehttps://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 initialehttps://%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 initialehttps://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 initialehttps://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 initialehttps://[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
| Situation fictive | Preuve manquante ou changement | Décision attendue |
|---|---|---|
| N01 · Résolution répétée | L’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 302 | Location 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 sortie | Le 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 échec | Une 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 longue | La 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
- OWASP · SSRF Prevention Cheat Sheet · Living documentation · checked 2026-10-22
Case 1: application/network layers · DNS rebinding · validated connection · retries/fallbacks · redirects - WHATWG · URL Living Standard · Updated 2026-10-19 · checked 2026-10-22
§2 Security considerations · §3 Hosts · §4 URLs · basic URL parser - AWS EC2 · Instance metadata options · Living documentation · checked 2026-10-22
Metadata access · IPv6 endpoint · IMDSv2 token requirements - IETF · RFC 3849 · Informational · July 2004
§2 Documentation IPv6 address prefix: 2001:DB8::/32
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.
