GuidesWeb app
Tuto : envoyer des fichiers vers S3 par URL signée
1. Signer (serveur)
import { S3Client, PutObjectCommand } from '@aws-sdk/client-s3';
import { getSignedUrl } from '@aws-sdk/s3-request-presigner';
import { randomUUID } from 'node:crypto';
const s3 = new S3Client({ region: process.env.S3_REGION, endpoint: process.env.S3_ENDPOINT });
export async function signer(type: string, taille: number) {
if (!['image/jpeg', 'image/png', 'application/pdf'].includes(type)) throw new Error('type refusé');
if (taille > 10 * 1024 * 1024) throw new Error('trop lourd');
const cle = `envois/${randomUUID()}`;
const url = await getSignedUrl(s3, new PutObjectCommand({ Bucket: process.env.S3_BUCKET, Key: cle, ContentType: type }), { expiresIn: 300 });
return { url, cle };
}
2. Envoyer (navigateur)
const { url, cle } = await (await fetch('/api/signer', { method: 'POST', body: JSON.stringify({ type: f.type, taille: f.size }) })).json();
await fetch(url, { method: 'PUT', body: f, headers: { 'Content-Type': f.type } });
await fetch('/api/fichiers', { method: 'POST', body: JSON.stringify({ cle }) }); // enregistrer
3. Les réglages qui comptent
- CORS du bucketAutoriser PUT depuis votre domaine seulement.
- Bucket privéLa lecture passe aussi par des URL signées.
- Clé choisie par le serveurJamais le nom de fichier de l’utilisateur.
- Expiration courteQuelques minutes suffisent.
Le cadre : créer une web app.
Questions fréquentes
- Pourquoi ne pas envoyer le fichier à mon serveur ?
- Un fichier lourd occupe le serveur, sa mémoire et sa bande passante. Avec l’URL signée, le stockage reçoit le fichier directement.
- L’utilisateur peut-il envoyer n’importe quoi ?
- Le serveur décide du nom, du type et de la taille autorisés avant de signer. Après l’envoi, on vérifie le fichier réel avant de l’utiliser.
- Ça marche hors d’Amazon ?
- Oui, avec tous les stockages compatibles S3 : il suffit de changer l’adresse du point d’accès dans le client.