技能 file-uploads
📦

file-uploads

安全

Gérer les téléchargements de fichiers et le stockage cloud de manière sécurisée

Téléchargez des fichiers en toute sécurité sans bloquer votre application ni exposer de données sensibles. Ce skill fournit des modèles éprouvés pour les URL pré-signées, la validation par magic bytes et l'intégration sécurisée au stockage cloud.

支援: Claude Codex Code(CC)
📊 71 充足
1

下載技能 ZIP

2

在 Claude 中上傳

前往 設定 → 功能 → 技能 → 上傳技能

3

開啟並開始使用

測試它

正在使用「file-uploads」。 Télécharger un fichier vidéo de 500 Mo vers le stockage cloud

預期結果:

  • 1. Le client demande des URL pré-signées pour le téléchargement multipart
  • 2. Le serveur génère 5 URLs de parties de téléchargement (100 Mo chacune)
  • 3. Le client télécharge les parties en parallèle directement vers S3
  • 4. Le client appelle l'API complete multipart upload
  • 5. Fichier disponible à s3://bucket/videos/user123/video.mp4

正在使用「file-uploads」。 Valider le type de fichier image téléchargé

預期結果:

  • Octets d'en-tête du fichier vérifiés : FF D8 FF (signature JPEG détectée)
  • En-tête Content-Type revendiqué : image/jpeg - VALIDE
  • Taille du fichier : 2,3 Mo - dans la limite de 5 Mo
  • Nom de fichier assaini : 'photo.jpg' -> 'uploads/user123/abc123.jpg'
  • Téléchargement autorisé et URL pré-signée retournée

安全審計

安全
v1 • 2/25/2026

This skill is a documentation-only file (SKILL.md) providing guidance on secure file upload handling. Static analysis flagged 'weak cryptographic algorithm' at lines 3 and 26, but both are FALSE POSITIVES. Line 3 contains only a YAML description field, and line 26 is plain documentation text. No actual code execution, network calls, or cryptographic operations exist in this skill.

1
已掃描檔案
27
分析行數
1
發現項
1
審計總數
低風險問題 (1)
SKILL.md:3SKILL.md:26
Static analysis false positive - weak cryptographic algorithm
The static analyzer flagged 'weak cryptographic algorithm' at SKILL.md:3 and SKILL.md:26. Both are false positives. Line 3 contains only a YAML frontmatter description field mentioning presigned URLs. Line 26 contains plain documentation text. No actual cryptographic code exists in this file.
審計者: claude

品質評分

38
架構
100
可維護性
87
內容
32
社群
100
安全
91
規範符合性

你能建構什麼

Fonctionnalité de téléchargement de fichiers pour application web

Construisez une fonctionnalité de téléchargement d'images sécurisée pour un système de profils utilisateurs avec validation automatique et stockage cloud.

Gestion de gros fichiers vidéo

Implémentez des téléchargements multipart pour des fichiers vidéo dépassant 100 Mo sans problèmes de mémoire serveur.

Système de gestion de documents

Créez un pipeline de téléchargement de documents sécurisé avec validation de type et chemins de stockage cloud organisés.

試試這些提示

Configuration de base du téléchargement S3 
Génère du code pour télécharger une image d'avatar utilisateur vers S3 en utilisant une URL pré-signée. Valide que le fichier est une image valide en utilisant les magic bytes avant d'autoriser le téléchargement.
Implémentation du téléchargement multipart 
Crée un gestionnaire de téléchargement multipart pour les fichiers de plus de 100 Mo. Inclus le chunking côté client, le suivi de la progression et l'intégration de l'API multipart S3.
Assainissement sécurisé des noms de fichiers 
Écris une fonction qui assainit les noms de fichiers téléchargés pour prévenir les attaques par traversée de chemin. Supprime les caractères dangereux, normalise l'unicode et génère des clés de stockage uniques.
Migration vers Cloudflare R2 
Convertis le code de téléchargement S3 existant pour fonctionner avec Cloudflare R2. Inclus la génération d'URL pré-signées, la configuration appropriée des endpoints et des conseils d'optimisation des coûts.

最佳實務

  • Validez toujours les types de fichiers en utilisant les magic bytes, ne faites jamais confiance aux extensions de fichier ou aux en-têtes Content-Type fournis par le client
  • Utilisez des URL pré-signées pour permettre aux clients de télécharger directement vers le stockage cloud, évitant ainsi les coûts de bande passante serveur
  • Définissez des limites de taille explicites et appliquez-les à la fois au niveau de l'API gateway et dans vos gestionnaires de téléchargement

避免

  • Stocker les fichiers téléchargés sur le système de fichiers du serveur applicatif au lieu du stockage cloud
  • Utiliser le nom de fichier original comme clé de stockage sans assainissement
  • Relayer les téléchargements de fichiers via votre serveur backend au lieu d'utiliser des URL pré-signées

常見問題

Qu'est-ce qu'une URL pré-signée et pourquoi devrais-je l'utiliser ?
Une URL pré-signée est une URL à durée limitée qui accorde un accès temporaire pour télécharger ou télécharger depuis le stockage cloud. L'utilisation d'URL pré-signées permet aux clients de télécharger directement vers S3 ou R2, réduisant la charge serveur et les coûts de bande passante tout en maintenant la sécurité grâce à des identifiants temporaires.
Comment valider les types de fichiers de manière sécurisée ?
Vérifiez les magic bytes du fichier (signature d'en-tête) au lieu de faire confiance à l'extension du fichier ou à l'en-tête Content-Type. Par exemple, les fichiers JPEG commencent par les octets FF D8 FF. Cela empêche les attaquants de télécharger des fichiers malveillants avec de fausses extensions.
Quelles limites de taille devrais-je définir pour les téléchargements ?
Définissez des limites en fonction de votre cas d'utilisation : images de profil (5 Mo), documents (25 Mo), vidéos (500 Mo+). Appliquez toujours les limites à plusieurs niveaux : API gateway, logique applicative et politiques de bucket de stockage cloud.
Comment prévenir les attaques par traversée de chemin dans les noms de fichiers ?
N'utilisez jamais le nom de fichier original directement. Supprimez tous les composants de chemin, retirez ou remplacez les caractères spéciaux, normalisez l'unicode et envisagez de générer des clés de stockage aléatoires tout en mappant les noms originaux dans votre base de données.
Qu'est-ce que le téléchargement multipart et quand devrais-je l'utiliser ?
Le téléchargement multipart divise les gros fichiers en chunks téléchargés en parallèle. Utilisez-le pour les fichiers de plus de 100 Mo. Les avantages incluent : téléchargements reprisables, vitesse de transfert parallèle et capacité à gérer des fichiers jusqu'à 5 To dans S3.
Puis-je utiliser ce skill avec des fournisseurs de stockage autres que S3 ?
Oui. Les modèles fonctionnent avec tout stockage compatible S3, y compris Cloudflare R2, MinIO, DigitalOcean Spaces et Wasabi. Seuls l'URL de l'endpoint et les identifiants doivent être modifiés.

開發者詳情

作者

sickn33

授權

MIT

儲存庫

https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/file-uploads

引用

main

檔案結構

📄 SKILL.md