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 situation | Pratiques recommandées | raison |
|---|---|---|
| Le nom de fichier d'origine de l'utilisateur doit être affiché sur l'interface | Nom d'affichage réservé à l'affichage uniquement | Afficher le nom séparé du chemin du disque pour éviter le croisement de chemin |
| Besoin de sauvegarder les fichiers téléchargés | Le 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 stockage | Prendre le suffixe de la liste autorisée du serveur | Ne copiez pas les extensions données par les utilisateurs |
| Besoin de déterminer le vrai type du fichier | Effectuer la détection et l'analyse de contenu | Les 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ée | A quel niveau faut-il le traiter ? | lacunes |
|---|---|---|
| Contient un séparateur de chemin | Non utilisé comme chemin de stockage | Supprimer simplement la barre oblique ne suffit pas |
| extension PDF | Détection et analyse de contenu | Les extensions peuvent être forgées |
| Le nom d'affichage contient du HTML | Sortie d’interface | Tu ne peux pas le résoudre en changeant le nom du disque |
| Même nom d’affichage | Isolation interne de l’ID | Il ne devrait pas remplacer le téléchargement précédent |
📊 Comparaison des noyaux
| Méthode | Que peut-on résoudre ? | Limites |
|---|---|---|
| Utilisez directement le nom de fichier de l’utilisateur | La mise en œuvre est la plus simple | Un parcours de chemin et une écrasure de noms en double peuvent se produire |
| Ne retirez que le séparateur de chemin | Partie traitée de l’entrée | Supprimer simplement la ligne diagonale ne suffit pas |
| Déterminer le type en fonction de l’extension | Différenciation préliminaire des documents | Les extensions peuvent être falsifiées et doivent être coordonnées avec la détection de contenu |
| Le serveur génère des identifiants internes | Isoler les fichiers dupliqués, avec des chemins contrôlés par le système | Cela 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.
Références : Python pathlib


