Amazon S3

De Amazon S3-extensie voor Easy Digital Downloads stelt u in staat om downloadbestanden te hosten in uw Amazon S3-account. Dit is veilig en betrouwbaarder dan de bestanden op uw eigen hostingaccount op te slaan.

In Dit Artikel

Een IAM-account aanmaken
IAM-toegangssleutels
Installatie
Amazon S3 gebruiken met EDD
Bestanden forceren om te downloaden
Veelvoorkomende problemen en vragen

Een IAM-account aanmaken

Om Easy Digital Downloads verbinding te laten maken met uw Amazon S3-account, moet u een IAM-gebruiker aanmaken en een machtigingsbeleid aan de gebruiker koppelen. U kunt op Gebruikersbeveiligingsgegevens weergeven klikken om de toegangssleutel en geheime sleutel te bekijken. Dit zijn de waarden die u op uw WordPress-site moet invoeren bij Downloads → Instellingen → Extensies → Amazon S3.

1. Log in op uw Amazon S3-account

Log in op uw Amazon S3-account en ga naar de Gebruikerspagina. Deze pagina vindt u door op uw accountnaam in de rechterbovenhoek te klikken en op Beveiligingsgegevens > Gebruikers (onder Toegangsbeheer aan de linkerkant van de pagina) te klikken.

2. IAM-gebruiker instellen

A. Gebruiker toevoegen

Als u een bestaande IAM-gebruiker hebt die u wilt gebruiken, klikt u op die gebruiker. Als u een nieuwe gebruiker moet aanmaken, klikt u op de blauwe knop Gebruiker aanmaken en volgt u de aanwijzingen. U moet nu beveiligingsgegevens verkrijgen en ook een machtigingsbeleid aan de gebruiker koppelen.

B. Gebruikersgegevens instellen:

Gebruikersnaam: Maak een gebruikersnaam naar keuze en klik op Volgende.

C. Machtigingen instellen

1. Selecteer het vakje "Beleidsregels direct koppelen".
2. Voer vervolgens in het Filter vak "S3full" in. Dat filtert de resultaten tot degenen die relevant zijn voor Amazon S3.
3. Vink het vakje voor AmazonS3FullAccess aan.
4. Negeer de sectie "Machtigingsgrens instellen - optioneel".
5. Klik op Volgende.

D. Beoordelen en aanmaken

Controleer of uw machtigingen overeenkomen met de bovenstaande instructies. Anders is er hier niets te configureren, klik op Gebruiker aanmaken.

3. Toegangssleutels ophalen

U hebt een IAM-account nodig met de machtigingen uit de bovenstaande stappen. Als u in het verleden een IAM-account hebt aangemaakt met de AmazonS3FullAccess-machtigingen, kunt u het bestaande account gebruiken.

A. Klik op de IAM-gebruikersnaam die hierboven is aangemaakt, vermeld op de Gebruikerspagina van uw AWS.

B. Klik op het tabblad Beveiligingsgegevens en klik op Toegangssleutel aanmaken.

C. Selecteer Dienst van derden en vink Bevestigen aan.

D. Klik op Toegangssleutel aanmaken. Er is geen beschrijvingstag vereist.

E. Sla de Toegangssleutel & Geheime toegangssleutel op.

Opmerking: U krijgt de geheime sleutel voor deze gebruiker nooit meer te zien, dus zorg ervoor dat u het bestand opslaat. Als u de gegevens kwijtraakt, moet u een nieuwe toegangssleutel aanmaken.

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:

Bestanden forceren om te downloaden

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