اسمح للمتصفح بالرفع إلى المخزن

وقع رابط رفع على خادمك، لكي يرسل المتصفح الملفات إلى المخزن مباشرة دون أن يرى السر.

كل الصفحات

كيف يعمل

لا يحصل المتصفح على مفاتيح المخزن أبدا. يطلب من خادمك رابطا، فيوقعه خادمك بمفاتيح المخزن، ثم يرسل المتصفح الملف إلى هذا الرابط.

ارفع ملفا

  1. على خادمك، وقع رابطا للملف.

    مع مخزن مربوط، تملك الخدمة أصلا S3_PUBLIC_ENDPOINT وS3_REGION والمفاتيح:

    js
    import { PutObjectCommand, S3Client } from "@aws-sdk/client-s3";
    import { getSignedUrl } from "@aws-sdk/s3-request-presigner";
    
    const signer = new S3Client({
      region: process.env.S3_REGION,
      bucketEndpoint: true,
      requestChecksumCalculation: "WHEN_REQUIRED",
      credentials: {
        accessKeyId: process.env.S3_ACCESS_KEY_ID,
        secretAccessKey: process.env.S3_SECRET_ACCESS_KEY,
      },
    });
    
    export async function signUpload(type) {
      const key = `uploads/${crypto.randomUUID()}`;
      const url = await getSignedUrl(
        signer,
        new PutObjectCommand({
          Bucket: process.env.S3_PUBLIC_ENDPOINT,
          Key: key,
          ContentType: type,
        }),
        { expiresIn: 900 },
      );
      return { key, url };
    }

    وقعه على S3_PUBLIC_ENDPOINT: العنوان داخل المشروع لا يستجيب إلا من داخل شبكة المشروع، فلا يستطيع المتصفح استخدام رابط موقع عليه. ومع تشغيل bucketEndpoint، يأخذ Bucket هذا العنوان بدلا من اسم المخزن.

    اضبط requestChecksumCalculation على WHEN_REQUIRED: فالـ SDK يوقع checksum في كل طلب من تلقاء نفسه، وهذا يفسد الرفع الموقع.

  2. في الصفحة، اطلب رابطا من خادمك وارفع الملف عليه:
    js
    const { url } = await fetch("/upload-link", {
      method: "POST",
      headers: { "Content-Type": "application/json" },
      body: JSON.stringify({ type: file.type }),
    }).then((response) => response.json());
    
    await fetch(url, {
      method: "PUT",
      body: file,
      headers: { "Content-Type": file.type },
    });

    /upload-link مثال على route في خادمك يستدعي signUpload.

يبقى السر على خادمك. يعمل الرابط للمدة التي وقعته لها، وهي هنا 15 دقيقة.

حدد المصادر

يقبل المخزن طلبات المتصفح من أي موقع حتى تكتب المصادر المسموحة له. القائمة الفارغة تعني كل المصادر: فالتوقيع هو الذي يحكم الكتابة، لا القائمة.

لكي تكتبها، افتح المخزن، واضغط ⌘K واختر تعديل المصادر المسموحة. اكتب مصدرا واحدا في كل سطر، الـ scheme والـ host فقط، مثل https://example.com. تتسع القائمة لـ 50 مصدرا كحد أقصى. بعد ذلك يرفض المخزن طلبات المتصفح من أي مصدر آخر. لا يملأ غيم القائمة أبدا من عناوين مشروعك: فالمخزن لا يتبع أي مشروع.