Dokumentacja konfiguracji Amazon S3

Funkcja Amazon S3 dla Easy Digital Downloads (EDD) pozwala hostować pliki do pobrania na Twoim koncie Amazon S3. Jest to bezpieczniejsze i bardziej niezawodne niż przechowywanie plików bezpośrednio na własnym koncie hostingowym.

Ten przewodnik przeprowadzi Cię przez proces tworzenia użytkownika IAM w AWS, łączenia Twojego konta Amazon S3 z EDD i korzystania z Amazon S3 po skonfigurowaniu wszystkiego.

Uwaga: Amazon S3 to funkcja Pro, która wymaga co najmniej przepustki Extended.

---

Włączanie Amazon S3

Aby zainstalować funkcję Amazon S3 w swoim sklepie EDD, przejdź do Pobrane » Rozszerzenia, wyszukaj Amazon S3 i kliknij Zainstaluj.

Zobacz Jak zainstalować rozszerzenie? więcej informacji na temat instalacji i aktywacji funkcji.

Gdy funkcja będzie aktywna, ustawienia Amazon S3 znajdziesz w Pobrane » Ustawienia » Rozszerzenia » Amazon S3. Po wykonaniu poniższych kroków wprowadzisz tam swoje dane uwierzytelniające AWS.

Tworzenie konta IAM

Aby połączyć Easy Digital Downloads z Twoim kontem Amazon S3, musisz utworzyć użytkownika IAM w AWS i przypisać mu politykę uprawnień.

Gdy to zrobisz, wygenerujesz klucz dostępu i klucz tajny dla tego użytkownika, a następnie wprowadzisz oba w Pobrane » Ustawienia » Rozszerzenia » Amazon S3 na swojej stronie WordPress.

Logowanie do konta Amazon S3

Jeśli nie masz jeszcze konta AWS, utwórz je na stronie Amazon S3 przed kontynuowaniem.

Zaloguj się na swoje konto Amazon S3 i przejdź do strony Użytkownicy. Możesz znaleźć tę stronę, klikając nazwę swojego konta w prawym górnym rogu, a następnie Poświadczenia bezpieczeństwa » Użytkownicy w sekcji Zarządzanie dostępem po lewej stronie strony.

Konfiguracja użytkownika IAM

Jeśli masz już użytkownika IAM, którego chcesz użyć, wybierz tego użytkownika.

Dodaj użytkownika

Jeśli potrzebujesz nowego, kliknij przycisk Utwórz użytkownika i postępuj zgodnie z instrukcjami. Będziesz musiał uzyskać poświadczenia bezpieczeństwa i przypisać politykę uprawnień do użytkownika.

Ustaw szczegóły użytkownika

Wprowadź nazwę użytkownika według własnego wyboru i kliknij Dalej.

Ustaw uprawnienia

Na następnym ekranie ustawisz uprawnienia użytkownika.

1. Wybierz Dołącz polityki bezpośrednio.
2. W polu Filtruj wprowadź „S3full”, aby zawęzić wyniki do polityk Amazon S3.
3. Zaznacz pole wyboru AmazonS3FullAccess.
4. Pomiń sekcję „Ustaw granicę uprawnień – opcjonalnie”.
5. Kliknij Dalej.

Chcesz bardziej restrykcyjnych uprawnień zamiast pełnego dostępu do konta? AmazonS3FullAccess zapewnia dostęp do każdego zasobnika i każdej operacji S3 na Twoim koncie AWS. Zobacz Ograniczanie dostępu do określonych zasobników poniżej, aby uzyskać politykę ograniczoną tylko do zasobnika używanego przez EDD.

Przegląd i tworzenie

Potwierdź, że Twoje uprawnienia odpowiadają powyższym krokom, a następnie kliknij Utwórz użytkownika.

Uzyskiwanie kluczy dostępu

Będziesz potrzebować użytkownika IAM skonfigurowanego z uprawnieniami z powyższych kroków. Jeśli już masz użytkownika IAM z uprawnieniami AmazonS3FullAccess, możesz go użyć.

Przejdź do nazwy użytkownika IAM, którą utworzyłeś, wyświetlanej na stronie Użytkownicy AWS. Wybierz kartę Poświadczenia zabezpieczeń, a następnie Utwórz klucz dostępu.

Wybierz Usługa strony trzeciej i zaznacz Potwierdź.

Na następnym ekranie wybierz Utwórz klucz dostępu. Nie musisz dodawać znacznika opisu.

Zapisz swój Klucz dostępu i Klucz tajny dostępu.

Twój użytkownik IAM ma teraz uprawnienia do dostępu i przesyłania plików do zasobnika S3, co zapewnia Twojemu sklepowi EDD dostęp do Twoich plików i możliwość tworzenia bezpiecznych linków do pobierania dla klientów.

Dodaj swój Klucz dostępu i Klucz tajny dostępu do ustawień Amazon S3 Twojego sklepu EDD w sekcji Pobrane » Ustawienia » Rozszerzenia » Amazon S3.

Jeśli potrzebujesz więcej pomocy w tworzeniu użytkowników IAM lub dołączaniu zasad, zobacz przewodnik Amazon dotyczący tworzenia użytkowników IAM.

Ogranicz dostęp do określonych zasobników

Jeśli Twoje konto S3 jest używane do innych celów i chcesz ograniczyć swojego użytkownika IAM (tego, którego używa Twój sklep EDD) do określonych zasobników, utwórz niestandardową zasadę zamiast używać AmazonS3FullAccess.

Wybierz Dołącz zasady bezpośrednio, a następnie Utwórz zasadę.

Dodaj poniżej szczegóły zasady za pomocą edytora JSON. Zastąp bucket-name-here nazwą zasobnika (lub zasobników), do których chcesz, aby Twój sklep EDD miał dostęp.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "VisualEditor0",
            "Effect": "Allow",
            "Action": [
                "s3:PutObject",
                "s3:GetObjectAcl",
                "s3:GetObject",
                "s3:ListBucketMultipartUploads",
                "s3:AbortMultipartUpload",
                "s3:ListBucket",
                "s3:ListMultipartUploadParts"
            ],
            "Resource": [
                "arn:aws:s3:::bucket-name-here",
                "arn:aws:s3:::bucket-name-here/*"
            ]
        },
        {
            "Sid": "VisualEditor1",
            "Effect": "Allow",
            "Action": "s3:ListAllMyBuckets",
            "Resource": "*"
        }
    ]
}

Dzięki tej zasadzie wszystkie nazwy Twoich zasobników są nadal widoczne, ale tylko zasobniki wymienione w sekcji Zasób są dostępne. Jeśli EDD spróbuje uzyskać dostęp do zasobnika, który nie znajduje się na liście Zasób, zobaczysz błąd PHP.

Konfiguracja Amazon S3

Jeśli jeszcze tego nie zrobiłeś, przejdź do Pobrane » Ustawienia » Rozszerzenia » Amazon S3, aby wprowadzić swoje klucze dostępu i tajne klucze Amazon S3.

Wprowadź domyślny bucket

Na tym ekranie wprowadzisz również inne informacje o koncie, takie jak Twój Domyślny zasobnik Amazon S3.

To jest domyślny zasobnik, do którego chcesz przesyłać pliki. Aby utworzyć nowe zasobniki lub zobaczyć listę swoich bieżących zasobników, przejdź do swojego Konsoli S3 (będziesz musiał się zalogować, aby uzyskać do niej dostęp).

Utwórz zasobnik, którego chcesz używać jako domyślnego. Nadal możesz wybrać inny zasobnik na plik podczas przesyłania.

Ustaw uprawnienia bucketu

Włącz Blokuj cały dostęp publiczny dla swojego zasobnika, aby ograniczyć nieautoryzowany dostęp do plików. EDD zapewnia klientom tymczasowy dostęp do plików, więc sam zasobnik nie musi być publiczny.

Wprowadź punkt końcowy Amazon S3 (opcjonalnie)

Punkt końcowy Amazon S3 to punkt końcowy używany przez Twój zasobnik.

Zazwyczaj możesz zostawić to pole puste. Jeśli Twoja witryna ma problemy z dostępem do Twojego zasobnika, spróbuj zmienić go na punkt końcowy dla regionu Twojego zasobnika.

Znajdź region swojego zasobnika, logując się na swoje konto Amazon S3, klikając S3 i sprawdzając kolumnę regionu obok każdego zasobnika. Następnie znajdź pasujący punkt końcowy w Dokumentacji regionów S3 firmy Amazon.

Skopiuj i wklej ten punkt końcowy w pole, a następnie zapisz.

Pole Punkt końcowy Amazon S3 działa również z Cloudflare R2 i innymi dostawcami przechowywania danych zgodnymi z S3, nie tylko z AWS. Jeśli używasz R2 lub podobnej usługi, wprowadź tutaj jej punkt końcowy w ten sam sposób.

Czas ważności linku (opcjonalnie)

Ostatnie pole ustawień w rozszerzeniu EDD Amazon S3 to Czas ważności linku. Jest to liczba minut, przez które dynamicznie generowany adres URL pobierania pozostaje ważny.

Gdy klient kliknie link do pobrania, EDD generuje nowy, tymczasowy adres URL pliku w Amazon S3. To ustawienie kontroluje, jak długo ten adres URL działa, zanim wygaśnie.

Jeśli pozostawisz to pole puste, link domyślnie pozostaje ważny przez 5 minut.

Nazwa folderu FES (opcjonalnie)

Jeśli używasz Frontend Submissions w połączeniu z Amazon S3, to ustawienie kontroluje sposób organizacji plików dostawców w Twoim zasobniku S3. Wybierz, czy pliki mają być przechowywane w folderach nazwanych według nazwy użytkownika każdego dostawcy, czy jego identyfikatora użytkownika.

Zobacz Amazon S3 i Frontend Submissions więcej informacji o tym, jak te dwie funkcje współpracują ze sobą.

---

Używanie Amazon S3 z EDD

Przesyłasz pliki do produktu do pobrania w taki sam sposób jak wcześniej, ale ta funkcja daje Ci dwie nowe zakładki w narzędziu do przesyłania multimediów: Prześlij do Amazon S3 i Biblioteka Amazon S3.

Przesyłanie do Amazon S3 przez EDD

Kiedy przesyłasz plik z zakładki Prześlij do Amazon S3, Easy Digital Downloads automatycznie przesyła go na Twoje konto Amazon S3.

Każdy plik przesłany w ten sposób jest również dostępny z Twojej Biblioteki Mediów WordPress, tak jak każdy inny plik multimedialny.

Dodawanie plików już znajdujących się w AWS do EDD

Każdy plik już znajdujący się w S3 jest dostępny z Twojej Biblioteki Mediów WordPress poprzez zakładkę Biblioteka Amazon S3 w narzędziu do przesyłania multimediów.

Możesz również ręcznie dodać pliki do pola Adres URL pliku.

Wymuszanie pobierania plików

Czasami Twoja przeglądarka próbuje wyświetlić lub odtworzyć plik zamiast go pobrać, na przykład otwierając muzykę lub wideo bezpośrednio w przeglądarce. Zazwyczaj można to naprawić za pomocą ustawień serwera WWW, ale pliki przechowywane na Amazon S3 całkowicie ignorują ustawienia serwera WWW.

Zamiast tego musisz skonfigurować to bezpośrednio w S3.

Uwaga: To ustawienie dotyczy poszczególnych plików lub folderów, a nie całego zasobnika.

Otwieranie właściwości pliku

W zasobniku S3 znajdź plik, z którym chcesz pracować, zaznacz go i kliknij Akcje » Zmień metadane.

Kliknij Dodaj metadane, ustaw Typ na Zdefiniowany przez system, Klucz na Content-Disposition, a Wartość na attachment. Kliknij Zapisz zmiany.

Wymusza to pobranie pliku zamiast odtwarzania lub wyświetlania go w przeglądarce.

---

Rozwiązywanie problemów i FAQ