GuidesWeb app

Tuto : envoyer des fichiers vers S3 par URL signée

Par l’équipe Banzai LabsMis à jour le 2 min de lecture

Votre serveur1. Demande2. URL signée · 5 min3. Envoi directStockage S3Le fichier ne passe pas par votre serveur
Le serveur signe une adresse temporaire ; le navigateur envoie le fichier directement au stockage.

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.

À lire ensuite

Tous les guides