Amazon S3

The Amazon S3 extension for Easy Digital Downloads allows you to host download files in your Amazon S3 account. This is secure and more reliable than storing the files on your own hosting account.

In Dit Artikel

Creating an IAM account
IAM access keys
Installatie
Using Amazon S3 With EDD
Forcing Files to Download
Common Issues and Questions

Creating an IAM account

In order for Easy Digital Downloads to connect to your Amazon S3 account, you will need to create an IAM user and attach a permissions policy to the user. You can click Show User Security Credentials to view the access key and secret key. These are the values you need to enter in your WordPress site at Downloads → Settings → Extensions → Amazon S3.

1. Log into your Amazon S3 account

Log into your Amazon S3 account and navigate to the Users page. This page can be found by clicking on your account name in the top right corner and clicking on Security Credentials > Users (Under Access management on the left side of the page).

2. Setup IAM User

A. Add User

If you have an existing IAM user you wish to use, click on that user. If you need to create a new user, click the blue Create User button and follow the prompts. You now need to obtain security credentials and also attach a permissions policy to the user.

B. Set user details:

User name: Create User name of your choice and click Next.

C. Set permissions

1. Select “Attach policies directly” box.
2. Then, in the Filter box, enter “S3full”. That will filter the results down to those that are relevant for Amazon S3.
3. Check the box for AmazonS3FullAccess.
4. Ignore “Set permissions boundary – optional” section.
5. Click Next.

D. Review and create

Confirm your permissions match the instructions above. Otherwise, there is nothing to configure here, click Create user.

3. Get Access Keys

You will need an IAM account using the permissions in the above steps. If you’ve created an IAM account in the past with the AmazonS3FullAccess permissions, you can use the existing account.

A. Click IAM user name created above, listed in your AWS Users page.

B. Click on the Security Credentials tab and click Create Access Key.

C. Select Third-party service and Check Confirm.

D. Click Create access key. Not description tag is required.

E. Save Access key & Secret access key.

Note: You will not be able to access the secret key ever again for this user, so make sure that you save the file. If you lose the credentials, you will need to create a new access key.

Uw IAM-gebruiker zou nu volledige toestemming moeten hebben om toegang te krijgen tot en bestanden te uploaden naar de S3-bucket. Dit geeft uw EDD-winkel toegang tot uw bestanden en de mogelijkheid om veilige downloadlinks voor klanten te maken.

F. Voeg Access key & Secret access key toe aan de Amazon S3-instellingen van uw EDD-winkel onder Downloads → Instellingen → Extensies → Amazon S3.

Als u meer hulp nodig heeft bij het maken van IAM-gebruikers of het koppelen van beleidsregels, raadpleeg dan de handleiding van Amazon voor het maken van IAM-gebruikers voor meer informatie.

Beperk toegang tot specifieke buckets

Als uw S3-account voor andere doeleinden wordt gebruikt en u uw IAM-account (EDD Store) wilt beperken tot specifieke buckets, kunt u een aangepast beleid maken in plaats van AmazonS3FullAccess. Dit wordt gedaan in plaats van Stap 3 van de sectie Machtigingen instellen.

Klik op "Bestaande beleidsregels direct koppelen", selecteer vervolgens "Beleid maken":

Voeg de onderstaande beleidsdetails toe via de JSON-editor. Werk bucket-name-here bij met de naam/namen van de buckets waartoe u toegang wilt via uw EDD-winkel.

{
    "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": "*"
        }
    ]
}

Bij gebruik van dit beleid zijn alle bucketnamen zichtbaar, maar alleen de buckets die u in de sectie Resources plaatst, zijn toegankelijk. Als een bucket die niet in de Resource-lijst is opgenomen, wordt benaderd via EDD, treedt er een PHP-fout op. We hopen dit in een toekomstige release te verbeteren.

Installatie

Zodra de extensie is geïnstalleerd en geactiveerd, kunt u navigeren naar Downloads → Instellingen → Extensies → Amazon S3 en uw Amazon S3-accountgegevens invoeren.

1. Voer de Access Key ID en Secret Key in

De Access Key ID en Secret Key worden verkregen door een IAM-gebruiker aan te maken in uw S3-account. Zie
onze handleiding hierboven voor informatie over hoe u een IAM-gebruiker met de juiste machtigingen aanmaakt.

2. Voer een standaard Bucket in

Dit is de standaardbucket waarnaar u bestanden wilt uploaden. Om nieuwe buckets te maken of een lijst van uw huidige buckets te krijgen, gaat u naar uw S3 Console (u moet zijn ingelogd om toegang te krijgen tot de console). Voer hier de naam in van de bucket die u als standaard wilt gebruiken. Bij het uploaden van bestanden naar Amazon S3 heeft u de optie om de bucket te selecteren waarnaar u het bestand wilt uploaden.

Bucketmachtigingen

Uw bucket moet Alle openbare toegang blokkeren AAN hebben staan om ongeautoriseerde toegang tot bestanden te beperken. EDD biedt klanten tijdelijke toegang tot bestanden.

3. Voer een Amazon S3 Host in (Optioneel)

Dit is de S3-host die uw bucket gebruikt. Meestal kan dit veld leeg worden gelaten. Als uw site echter problemen heeft met het benaderen van uw bucket, probeer dit dan te wijzigen in de Endpoint voor de regio van uw bucket, voor uw standaardbucket.

U kunt de regio van uw bucket vinden door in te loggen op uw Amazon S3-account, op S3 te klikken en vervolgens naar de kolom regio te kijken die naast elke bucket wordt weergegeven. Daar staat de regio vermeld. Zodra u die weet, zoekt u de juiste bijbehorende host op in de Amazon S3 Regio Documentatie. Kopieer en plak die host en klik op opslaan in uw WordPress.

4. Koppeling Vervaltijd (Optioneel)

Dit is het aantal minuten dat de dynamisch gegenereerde URL geldig is. Wanneer een klant op een downloadlink klikt die door Easy Digital Downloads wordt geleverd, wordt er ter plekke een nieuwe URL voor het bestand op Amazon S3 gegenereerd. Dit is het aantal minuten dat de nieuwe, geheime URL geldig is.

Hiermee is de installatie van Amazon S3 voltooid.

Amazon S3 gebruiken met EDD

U uploadt bestanden naar een downloadbaar product op precies dezelfde manier als voorheen, maar u heeft twee nieuwe tabbladen in de mediabibliotheek-uploader, genaamd Uploaden naar Amazon S3 en Amazon S3 Bibliotheek.

Wanneer u een bestand uploadt vanaf dit tabblad, wordt het automatisch naar uw Amazon S3-account geüpload. Elk bestand dat u naar S3 uploadt, is toegankelijk vanuit uw WordPress Media Library, net als elk ander mediabestand.

Uploaden naar Amazon S3 via EDD

Wanneer u een bestand uploadt vanaf dit tabblad, wordt het automatisch naar uw Amazon S3-account geüpload.

Bestanden die al op Amazon S3 staan toevoegen aan EDD

Elk bestand dat u naar S3 uploadt, is toegankelijk vanuit uw WordPress Media Library, net als elk ander mediabestand, via de Amazon S3 Bibliotheek in de mediabibliotheek-uploader.

U kunt ook handmatig bestanden toevoegen aan de Bestand URL:

Forcing Files to Download

Soms probeert uw webbrowser het bestand dat u downloadt weer te geven of af te spelen, en kunt u muziek of video's in uw browser afspelen in plaats van ze op te slaan. Er zijn verschillende dingen die gedaan kunnen worden om dit te voorkomen en de opslagoptie te forceren, maar als u uw bestanden opslaat op Amazon S3, worden alle instellingen op uw webserver genegeerd.

In plaats van te vertrouwen op de instellingen van uw webserver, moet u de opties correct configureren in S3. Hier ziet u hoe ze ingesteld moeten zijn.

Opmerking: Deze instelling wordt toegepast op een bestand en/of map, maar niet op de hele bucket

Eigenschappen Openen

1. Zoek in uw S3 Bucket het bestand waarmee u wilt werken en selecteer het.
2. Klik op Acties >  Metadata wijzigen. 
   
3. Klik op Metadata Toevoegen en stel het Type in op Systeemeigen, de Sleutel op Content-Disposition en de Waarde op attachment en Wijzigingen opslaan.
   

Dit dwingt het bestand om gedownload te worden in plaats van afgespeeld of weergegeven in uw browser.

Veelvoorkomende problemen en vragen:

Bestanden openen in de browser in plaats van te downloaden

Dit kan worden opgelost door Bestanden te dwingen tot downloaden.

Zullen klanten de daadwerkelijke URL van het bestand kunnen zien en het rechtstreeks kunnen downloaden?

Nee, de klant ziet een URL die naar uw eigen winkel leidt, waar EDD de locatie zal vertalen zodat de download werkt zonder dat de klant de originele Amazon-bron-URL ziet.

Fout: SSL-certificaatprobleem: kan lokaal uitgevend certificaat niet verkrijgen

Deze fout betekent dat het SSL-certificaat op de server van uw website ongeldig is of onjuist is geïnstalleerd. Neem contact op met uw hostingprovider en vraag hen om te verifiëren dat het certificaat correct is geïnstalleerd en geldig is.

Fout:Toegang geweigerd

Deze fout betekent dat de gebruiker van de toegangssleutel-ID en geheime sleutel die u gebruikt, niet over de benodigde machtigingen beschikt om S3-buckets en -bronnen te benaderen.

Om dit op te lossen, moet u een nieuw machtingenbeleid koppelen aan de IAM-gebruiker. Zie onze
handleiding voor het maken van een IAM-gebruiker met de juiste machtigingen om deze fout op te lossen.

U kunt deze foutmelding ook zien als u de URL van Amazon S3 hebt gekopieerd en in het veld Bestand-URL van uw Download hebt geplakt. Raadpleeg de opmerking hierboven over de juiste stappen die moeten worden genomen om uw bestanden aan uw Downloads te koppelen.

Fout:RequestTimeTooSkewed

Deze fout treedt op vanwege een verkeerde configuratie van de tijdzone-instellingen van uw webserver. Neem contact op met uw hostingprovider en vraag hen om de tijdzone-instellingen correct te herconfigureren.

Fout:SignatureDoesNotMatch

Als u deze fout ontvangt, gevolgd door een foutmelding die zegt
De door ons berekende aanvraaghandtekening komt niet overeen met de door u verstrekte handtekening, betekent dit waarschijnlijk dat uw bucketnaam hoofdletters of spaties bevat. Om het probleem op te lossen, hernoemt u uw bucket zodat deze geen hoofdletters bevat. U kunt ook een nieuwe bucket maken zonder hoofdletters in de naam om het probleem op te lossen.

Fout: NoSuchKey De opgegeven sleutel bestaat niet

Deze fout treedt op wanneer er een probleem is met de manier waarop het bestand, of zelfs de bucket, is benoemd. Alle interpunctie en speciale tekens moeten worden verwijderd.

Bijvoorbeeld: Als u een bestand hebt met de naam test-file-one.mp4.zip wijzig het dan in testfileone.zip

Andere fouten of problemen bij het uploaden van bestanden naar Amazon S3

Als u problemen ondervindt bij het uploaden van bestanden naar Amazon S3 of bij het benaderen van bestaande bestanden in Amazon S3, raadpleeg dan de onderstaande stappen om het probleem op te lossen.

1. Controleer uw Amazon S3 Host-instellingen in Downloads → Instellingen → Extensies → Amazon S3. Zorg ervoor dat uw host correct is ingesteld, inclusief het controleren of u de juiste regio hebt ingesteld (lees het punt over Amazon S3 Host hierboven om te zien hoe u dit doet).
2. Zorg ervoor dat de bestandsnaam van uw bestand binnen de limiet van 1024 tekens valt. U vindt meer informatie in Amazon's documentatie over hoe u uw bestandsnamen correct formatteert.
3. Als u onlangs bent overgeschakeld naar een nieuw Amazon S3-account en problemen ondervindt bij het uploaden van bestanden naar uw bucket(s), is dit doorgaans een tijdelijk probleem dat zich kort na het aanmaken van nieuwe buckets of accounts kan voordoen. Het zou zichzelf na een paar uur automatisch moeten oplossen. Zie Amazon's documentatie voor meer informatie hierover.
4. Nog steeds geen succes? Neem contact op met ondersteuning en vermeld de exacte foutmelding of het gedrag dat u ervaart.

Softwarelicentie-updates mislukken vanwege Download mislukt. cURL-fout 8: Ongeldige Content-Length: waarde

Het is mogelijk dat de Amazon S3-extensie geen omleiding forceert voor downloads. Als u deze fout ziet, probeer dan
de Downloadmethode in te stellen op Geforceerd.

Klant ziet Update mislukt: Download mislukt. Interne serverfout bij het proberen een plugin bij te werken

Bevestig dat het bronbestand dat voor automatische updates moet worden gebruikt, is geselecteerd in de licentie-instellingen van de download.

U zult waarschijnlijk de volgende PHP Fatal error zien in het PHP-foutlogboekbestand van de winkel:

PHP Fatal error:  Uncaught InvalidArgumentException: Found 2 errors while validating the input provided for the GetObject operation:
[Key] is missing and is a required parameter
[Key] expected string length to be >= 1, but found string length of 0 in /home/ph198/public_html/wp-content/plugins/edd-amazon-s3/vendor/aws/aws-sdk-php/src/Api/Validator.php:65