Nowość w Endora Commerce: wbudowany CRM z szansami sprzedażowymi Zobacz →
Endora Commerce

Integracja z Amazon S3

Amazon S3 może być miejscem, w którym Endora Commerce trzyma pliki z biblioteki zasobów: zdjęcia produktów, karty katalogowe, załączniki i grafiki stron CMS. Poniżej: co trafia do bucketu, jak działają pliki prywatne i co ustawić po stronie AWS.

Co faktycznie ląduje w buckecie

Amazon S3 to obiektowa pamięć masowa AWS: pliki leżą w bucketach przypisanych do regionu, a dostęp odbywa się przez API. W Endora Commerce S3 jest jednym z trzech magazynów biblioteki zasobów, obok Google Cloud Storage i dysku lokalnego. Aktywny jest zawsze jeden, a domyślnie platforma startuje na dysku lokalnym.

Do biblioteki trafiają obrazy, wideo, pliki PDF i inne dokumenty, które potem są używane w kilku miejscach:

  • galerie zdjęć produktów i główne obrazy kategorii,
  • załączniki produktów, np. karty techniczne czy deklaracje,
  • pliki produktów wirtualnych do pobrania,
  • grafiki i dokumenty osadzone na stronach CMS.

Z tego samego magazynu korzystają też inne moduły. Pliki feedów produktowych, np. dla Google Merchant Center, są zapisywane w buckecie jako prywatne, pod własnym prefiksem i poza biblioteką zasobów, a na zewnątrz wydaje je sama platforma, nie adres S3.

Publiczne i prywatne: jak to wygląda w S3

Widoczność ustawia się osobno dla każdego zasobu, nie raz dla całego bucketu.

  • Zasób publiczny ma stały adres. Domyślnie jest to adres bucketu w regionie, a po podaniu własnej domeny lub adresu CDN linki są budowane na niej.
  • Zasób prywatny nie ma stałego adresu. Przy każdym odczycie panel lub sklep dostaje nowy, podpisany adres (presigned URL, podpis V4 z SDK AWS), ważny domyślnie 300 sekund. Czas ważności jest ustawieniem.

Dla kupującego B2B oznacza to, że link do dokumentu skopiowany z przeglądarki i wysłany dalej po kilku minutach przestaje działać. Warto pamiętać o dwóch rzeczach wynikających z działania samego S3: podpisany adres działa dla każdego, kto go ma, do chwili wygaśnięcia, a przy stałych kluczach użytkownika IAM jego ważność nie może przekroczyć 7 dni.

Co przygotować po stronie AWS

  1. Bucket w wybranym regionie. Dla firm z Polski i UE zwykle będzie to region europejski.
  2. Użytkownik IAM z kluczem dostępowym, ograniczony do tego jednego bucketu. Platforma wgrywa, odczytuje i usuwa obiekty, zmienia ich ACL oraz sprawdza dostępność bucketu, więc polityka powinna obejmować s3:PutObject, s3:GetObject, s3:DeleteObject, s3:PutObjectAcl i s3:ListBucket.
  3. Decyzja w sprawie ACL. Widoczność zasobu jest przekładana na ACL obiektu (public-read albo private), tymczasem nowe buckety mają ACL domyślnie wyłączone (ustawienie „Bucket owner enforced”) i włączoną blokadę dostępu publicznego. W takiej konfiguracji S3 odrzuca zapis obiektu z ACL innym niż pełna kontrola właściciela. Jeśli pliki publiczne mają być serwowane prosto z bucketu, trzeba świadomie włączyć ACL i dopuścić publiczne ACL. Szczegóły opisuje dokumentacja AWS: Object Ownership.

Ustawienia w panelu

Konfiguracja znajduje się w Ustawieniach, w grupie Storage.

UstawienieDo czego służy
assets.s3.bucket, assets.s3.regionNazwa bucketu i region, oba wymagane
assets.s3.access_key_id, assets.s3.secret_access_keyKlucz użytkownika IAM
assets.s3.prefixOpcjonalny prefiks kluczy, przydatny przy buckecie dzielonym z innym systemem
assets.s3.public_base_urlOpcjonalny adres CDN lub własnej domeny dla plików publicznych
assets.s3.endpointOpcjonalny endpoint usługi zgodnej z S3, np. MinIO

Po zapisaniu można wywołać test połączenia (POST /api/v1/admin/assets/storage/self-check), który sprawdza, czy bucket jest osiągalny przy podanych danych.

Dwie rzeczy, o których warto wiedzieć przed startem:

  • Dostęp do Ustawień powinny mieć tylko zaufane osoby, a klucz IAM nie powinien mieć uprawnień poza tym bucketem.
  • Przełączenie magazynu nie przenosi plików. Każdy zasób pamięta, gdzie został zapisany, i jest stamtąd odczytywany, więc po przejściu z dysku lokalnego na S3 stare pliki zostają na dysku, a nowe trafiają do bucketu. Oba magazyny muszą pozostać dostępne.

Usuwanie plików

Usunięty zasób znika z list, ale przez domyślnie 30 dni można go przywrócić. Dopiero potem proces w tle kasuje obiekt z bucketu, a jeśli S3 odmówi, np. po odwołaniu klucza, ponawia próbę. Pliku używanego przez produkt, kategorię lub stronę CMS nie da się usunąć, dopóki nie zostanie odpięty.

Kiedy S3, a kiedy coś innego

  • S3: gdy infrastruktura już działa w AWS, aplikacja ma więcej niż jedną instancję albo pliki mają mieć kopie i wersjonowanie niezależne od serwera aplikacji.
  • Google Cloud Storage: gdy reszta środowiska jest w Google Cloud. Model widoczności i ustawień jest taki sam.
  • Dysk lokalny: przy developmencie i prostych wdrożeniach na jednym serwerze, pod warunkiem że wolumen z plikami jest objęty kopią zapasową razem z bazą.

Pozostałe integracje infrastrukturalne i biznesowe są zebrane na stronie integracji.

Sprawdźmy, co da się podłączyć u Ciebie

Umów bezpłatną konsultację. Przejdziemy przez Twój ERP, magazyn i procesy sprzedaży, i pokażemy, jak wygląda ścieżka integracji krok po kroku.

Michał Zabielski, założyciel i CEO Endory

Michał Zabielski

Założyciel i CEO Endory

Odpowiadamy w ciągu jednego dnia roboczego.