Amazon S3 beállítása a letöltésekhez

Az API Manager a frissítési és letöltési fájlokat Amazon S3-ról is ki tudja szolgálni. A fájl linkjét beilleszted a termék Letölthető fájlok részének Fájl URL mezőjébe, a bővítmény pedig biztonságos, lejáró linkbe csomagolja, ugyanúgy, mint a helyi szerveren tárolt fájlokat.

Ez a fejezet az API Manager S3-kapcsolatát írja le. Ha a WooCommerce letölthető termékeit általában szeretnéd S3-ra szinkronizálni, ahhoz külön bővítmény való.

Az S3 beállításai a bolton

Az S3 kulcsai az API Manager → Konfiguráció → Letöltések fülön vannak.

https://minta-bolt.hu/wp-admin/admin.php?page=wcam_api_manager_settings&tab=downloads

A kép az AWS-hozzáférési kulcs ID, az AWS titkos hozzáférési kulcs és az Amazon S3 régió mezőt mutatja, alatta a Letöltési linkek résszel.

Beállítás	Mit csinál
AWS-hozzáférési kulcs ID	Az AWS-felhasználó hozzáférési kulcsának azonosítója.
AWS titkos hozzáférési kulcs	A titkos kulcs, az adatbázisban erősen titkosítva tárolódik.
Amazon S3 régió	Az a régió, ahol a tároló (bucket) van.
URL-lejárati idő	A letöltési linkek érvényessége napokban.

A kulcsokat biztonságosabb a wp-config.php fájlban megadni, így nem kerülnek az adatbázisba:

define( 'WC_AM_AWS3_ACCESS_KEY_ID', 'a_te_hozzaferesi_kulcsod' );
define( 'WC_AM_AWS3_SECRET_ACCESS_KEY', 'a_te_titkos_kulcsod' );

1. Korlátozott jogú AWS-felhasználó

A cél egy olyan felhasználó, aki csak az S3-tárolókat olvashatja, és más Amazon-szolgáltatáshoz nem fér hozzá. Így nem kell a fő (root) fiók kulcsait használnod, amelyek az AWS-fiók minden szolgáltatásához hozzáférést adnak.

1. Jelentkezz be az AWS-be (vagy hozz létre fiókot), és nyisd meg az Identity and Access Management (IAM) felületet.
2. A biztonsági hitelesítő adatoknál válaszd a Users (felhasználók) listát, és hozz létre egy új felhasználót programozott hozzáféréssel.
3. Adj neki csak S3-olvasási jogot, más szolgáltatást ne.
4. A létrehozás utolsó lépésében töltsd le a .csv fájlt, és tárold biztonságos helyen. Ebben van az Access Key ID és a Secret Access Key, amelyet a wp-config.php-ba vagy az API Manager beállításaiba kell írnod. A titkos kulcsot és a .csv fájlt csak ezen a sikerképernyőn kapod meg, később már nem tudod megnézni.

A korlátozott felhasználók létrehozására más módszerek is vannak, a lényeg az, hogy a hozzáférés csak a szükséges erőforrásokra szűküljön.

2. Tároló létrehozása és fájl feltöltése

1. Nyisd meg az Amazon S3 felületet, és kattints a Create bucket gombra.
2. Adj nevet a tárolónak, és válaszd ki a régiót. A tároló neve nem kell, hogy egyezzen az IAM-felhasználó nevével, a kettő független.
3. A varázsló további lépéseiben fogadd el az alapértelmezett beállításokat, módosítani nem kell semmit.
4. A létrehozott tárolóba töltsd fel a terméked fájlját. Zip fájlnál a Content-Type legyen application/zip.

Alapból csak a root fióknak van hozzáférése a tárolóhoz és a fájlokhoz, a vásárlóknak és az új IAM-felhasználónak nincs. Ezt a következő lépésben állítod be.

3. Tárolószabály (bucket policy)

1. Az IAM felületen nyisd meg az új felhasználót, és másold ki a User ARN értékét.
2. Az S3 felületen válaszd ki a tárolót, majd Permissions → Bucket Policy. Az oldal alján kattints a Policy generator hivatkozásra.
3. A szabálytípusnál válaszd az S3 Bucket Policy lehetőséget, a Principal mezőbe illeszd be a User ARN-t.
4. Az Actions listában csak a GetObject legyen kijelölve.
5. Az Amazon Resource Name (ARN) mezőbe írd: arn:aws:s3:::a-te-tarolod-neve/*.
6. Kattints az Add Statement, majd a Generate Policy gombra, és másold ki a kapott kódot.
7. Illeszd be a tárolószabály mezőjébe, és mentsd.

A kész szabály így néz ki:

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": {
                "AWS": "arn:aws:iam::123456789012:user/a-te-felhasznalod"
            },
            "Action": "s3:GetObject",
            "Resource": "arn:aws:s3:::a-te-tarolod-neve/*"
        }
    ]
}

A Principal a felhasználó ARN-je. A Resource a tároló neve arn:aws:s3::: előtaggal és /* utótaggal: a perjel a határoló, a csillag pedig a tároló alatti összes fájlt jelenti.

4. A fájl bekötése a termékbe

1. Az S3 felületen nyisd meg a feltöltött fájlt, és másold ki az URL-jét.
2. A terméken illeszd be a Letölthető fájlok → Fájl URL mezőbe.

Egy tárolóba több fájl is kerülhet, így egy helyen tarthatod őket. Ha a fájl neve változik, a termékben a linket is át kell írnod.

Hogyan működik a letöltés?

A bővítmény biztonságos linket készít az S3-hivatkozás köré. A link akkor jön létre, amikor a vevő megnyitja a Fiókom → Licencelt letöltések oldalt, és akkor is, amikor a kliensszoftver frissítést kér az API-n. A link tartalmazza az S3 számára szükséges adatokat: a korlátozott IAM-felhasználó titkosított hozzáférési adatait, a kért fájlt és a lejárati időt. Az S3 ez alapján hitelesíti a kérést, és csak olvasási jogot ad.

A linkek érvényességét az URL-lejárati idő állítja be (a helyi felületen napokban).

Új kiadások és új tárolók

• Új kiadásnál a legegyszerűbb ugyanazzal a fájlnévvel lecserélni a régi fájlt a tárolóban, így a termékben lévő link nem változik.
• Új tárolóhoz ismételd meg a 2. és 3. lépést, a tárolószabályban csak a User ARN-t és a tároló nevét kell átírnod.