Le nom du fichier téléchargé par le client ne peut pas être directement utilisé comme chemin de stockage : pour empêcher la traversée du chemin et la couverture des noms en double

Le fichier téléchargé s'appelle `../../report.pdf`, ce qui ne signifie pas que le serveur doit le sauvegarder sous ce nom. Le nom du fichier vient de l'utilisateur et appartient aux données d'entrée ; le chemin du disque appartient à la limite des autorisations système. Confondre les deux peut facilement entraîner des problèmes tels que la traversée de chemin, la couverture de noms en double et des comportements différents entre Windows et Linux.

Ce n’est pas parce que le fichier téléchargé s’appelle ../../report.pdf que le serveur doit le sauvegarder sous ce nom. Les développeurs qui écrivent des fonctions de téléchargement côté serveur, ainsi que les équipes qui doivent gérer les fichiers utilisateur et se soucier de la traversée des chemins et de la couverture des noms en double, rencontreront ce problème. Après avoir lu cet article, vous serez en mesure de faire la distinction entre les noms d'affichage et les noms de stockage, de savoir quelles vérifications doivent être effectuées à chaque couche et de revoir votre propre implémentation en fonction des éléments d'acceptation.

Le nom du fichier vient de l'utilisateur et appartient aux données d'entrée ; le chemin du disque appartient à la limite des autorisations système. Confondre les deux peut facilement entraîner des problèmes tels que la traversée de chemin, la couverture de noms en double et des comportements différents entre Windows et Linux.

Cet article utilise des échantillons synthétiques pour démontrer la méthode de traitement. Le code a été vérifié par échantillons dans un environnement isolé et ne constitue pas une garantie de tous les fichiers réels ou des performances du produit. Avant de traiter des documents importants, veuillez conserver les originaux et les examiner en fonction des limites et des éléments d'acceptation du texte.

Le nom du fichier téléchargé peut-il être directement utilisé comme chemin de stockage ? Conclusion en une phrase

Il ne peut pas être utilisé directement. Le nom d'affichage est utilisé pour l'affichage de l'interface et le chemin de stockage est généré par le serveur en fonction de l'ID interne.

votre situationPratiques recommandéesraison
Le nom de fichier d'origine de l'utilisateur doit être affiché sur l'interfaceNom d'affichage réservé à l'affichage uniquementAfficher le nom séparé du chemin du disque pour éviter le croisement de chemin
Besoin de sauvegarder les fichiers téléchargésLe serveur génère un identifiant interne et fusionne le chemin de stockageÉvitez d'écraser avec des noms en double et ne soyez pas affecté par les entrées de l'utilisateur.
L'extension de fichier doit participer au stockagePrendre le suffixe de la liste autorisée du serveurNe copiez pas les extensions données par les utilisateurs
Besoin de déterminer le vrai type du fichierEffectuer la détection et l'analyse de contenuLes extensions peuvent être truquées

Le nom d'affichage et le nom de stockage sont séparés

Le nom d'origine est conservé pour l'affichage de l'interface, mais l'identification interne est générée par le serveur. Le suffixe de stockage doit également provenir de la liste autorisée côté serveur, plutôt que de copier l'extension donnée par l'utilisateur.

L'exemple suivant construit uniquement un chemin et ne crée pas de répertoire ou de fichier.

Constructeur de chemin minimum

from pathlib import Path
import re

def storage_path(root, internal_id, extension):
    if not re.fullmatch(r"[a-f0-9]{32}", internal_id):
        raise ValueError("invalid internal id")
    if extension not in {".pdf", ".docx", ".udoc"}:
        raise ValueError("unsupported extension")
    base = Path(root).resolve()
    candidate = (base / (internal_id + extension)).resolve()
    if candidate.parent != base:
        raise ValueError("outside storage root")
    return candidate

root = Path.cwd() / "synthetic-uploads"
identifier = "a" * 32
p = storage_path(root, identifier, ".pdf")
assert p.parent == root.resolve()
assert p.name == identifier + ".pdf"
for bad in ["../../report", "A" * 32, "a" * 31, "a" * 32 + "/x"]:
    try:
        storage_path(root, bad, ".pdf")
    except ValueError:
        pass
    else:
        raise AssertionError(bad)

Cet exemple suppose que l'ID interne a été généré par le serveur. Il ne s'agit pas d'une implémentation de fichier d'écriture sécurisée pour les environnements d'attaque de disque arbitraire :

  • Une course peut encore se produire entre le contrôle et l'ouverture effective.
  • Les autorisations du répertoire parent et les politiques de liens symboliques doivent être contrôlées séparément.
  • Un identifiant unique ne signifie pas non plus que la politique « pas de dérogation » peut être ignorée.

La désinfection du nom de fichier n'est pas une authentification de fichier

Le nettoyage des noms de fichiers ne peut résoudre qu’une partie du problème, et différents phénomènes doivent être traités à différents niveaux :

phénomène d'entréeA quel niveau faut-il le traiter ?lacunes
Contient un séparateur de cheminNon utilisé comme chemin de stockageSupprimer simplement la barre oblique ne suffit pas
extension PDFDétection et analyse de contenuLes extensions peuvent être forgées
Le nom d'affichage contient du HTMLSortie d’interfaceTu ne peux pas le résoudre en changeant le nom du disque
Même nom d’affichageIsolation interne de l’IDIl ne devrait pas remplacer le téléchargement précédent

📊 Comparaison des noyaux

MéthodeQue peut-on résoudre ?Limites
Utilisez directement le nom de fichier de l’utilisateurLa mise en œuvre est la plus simpleUn parcours de chemin et une écrasure de noms en double peuvent se produire
Ne retirez que le séparateur de cheminPartie traitée de l’entréeSupprimer simplement la ligne diagonale ne suffit pas
Déterminer le type en fonction de l’extensionDifférenciation préliminaire des documentsLes extensions peuvent être falsifiées et doivent être coordonnées avec la détection de contenu
Le serveur génère des identifiants internesIsoler les fichiers dupliqués, avec des chemins contrôlés par le systèmeCela nécessite toujours une coopération avec la politique « Pas de dérogation » et le contrôle des permissions par annuaire

Le stockage d’objets a les mêmes limites

R2 ou d’autres objets stockent toute la sémantique sans parcourir traditionnellement les répertoires, mais les clés d’objet affectent toujours l’isolement, le remplacement et l’exposition des URLs.

  • Ne pas épeler directement la chaîne fournie par le locataire en un préfixe partagé.
  • Le téléchargeur ne peut pas déduire l’autorisation uniquement sur la base des noms clés.

Les documents doivent avoir une identité avant d’entrer en traduction

En accédant au flux de travail OmniDoc (entrée produit), les utilisateurs peuvent continuer à voir des noms de fichiers familiers, en interne en utilisant des identifiants de tâches et de fichiers indépendants.

Des identités claires des documents apportent ces avantages :

  • En cas d’échec et de réessaie, cela peut correspondre avec précision à la tâche initiale.
  • Le téléchargement de la traduction et la relecture ultérieure garantissent que le fichier correct est correspondant.
  • Réduit le risque de confondre le dossier de quelqu’un d’autre avec le même nom que le résultat actuel.

🎯 Quelle méthode te convient ?

Si vous devez afficher le nom du fichier

Le nom d’affichage original de l’utilisateur est conservé, mais uniquement pour l’interface, pas le chemin du disque.

Si vous devez sauvegarder et télécharger des fichiers

Le serveur génère l’ID interne, prend l’extension de la liste des permis et contrôle la couverture et les permissions d’annuaire selon les politiques réelles.

Si vous utilisez le stockage d’objets

N’écrivez pas directement les chaînes de locataires avec le préfixe « share », et prenez des décisions d’autorisation séparées lors du téléchargement.

❓ Foire aux questions (FAQ)

1. Si vous supprimez les lignes diagonales, le nom du fichier devient-il sûr ?

Pas assez. Supprimer uniquement les barres oblique ne traite qu’une partie de l’entrée ; la construction de chemin, le remplacement et la détermination du type de fichier doivent toujours être gérés séparément.

2. Si l’extension du fichier est PDF, peut-elle être confirmée comme PDF ?

Non. Des extensions peuvent être falsifiées, nécessitant la détection de contenu et l’analyse syntatique.

3. Que dois-je faire si le nom d’affichage contient du HTML ?

L’échappement lors de la sortie de l’interface ne peut pas être résolu en changeant le nom du fichier sur le disque.

4. Après avoir utilisé un identifiant unique, dois-je quand même désactiver la réécriture ?

Oui. Un identifiant unique ne signifie pas que vous pouvez ignorer la politique « Pas de dérogation ».

📝 Résumé

Le nom du fichier d’envoi doit être géré séparément du chemin de stockage : le nom d’affichage est utilisé pour l’affichage, et le chemin de stockage est généré par le serveur en fonction de l’ID interne. Les trajets, couvertures, types et autorisations doivent être vérifiés séparément.

Faites l’expérience dès maintenant : téléchargez votre document pour commencer à traduire, tout en conservant la mise en forme originale

Références : Python pathlib

Mis à jour le 2026-11-15