Amazon S3

Die Amazon S3-Erweiterung für Easy Digital Downloads ermöglicht es Ihnen, Download-Dateien in Ihrem Amazon S3-Konto zu hosten. Dies ist sicher und zuverlässiger als die Speicherung der Dateien auf Ihrem eigenen Hosting-Konto.

In diesem Artikel

Erstellen eines IAM-Kontos
IAM-Zugriffsschlüssel
Einrichtung
Verwendung von Amazon S3 mit EDD
Erzwingen von Downloads
Häufige Probleme und Fragen

Erstellen eines IAM-Kontos

Damit Easy Digital Downloads eine Verbindung zu Ihrem Amazon S3-Konto herstellen kann, müssen Sie einen IAM-Benutzer erstellen und dem Benutzer eine Berechtigungsrichtlinie zuweisen. Sie können auf Benutzer-Sicherheitsanmeldeinformationen anzeigen klicken, um den Zugriffsschlüssel und den geheimen Schlüssel anzuzeigen. Dies sind die Werte, die Sie auf Ihrer WordPress-Website unter Downloads → Einstellungen → Erweiterungen → Amazon S3 eingeben müssen.

1. Melden Sie sich bei Ihrem Amazon S3-Konto an

Melden Sie sich bei Ihrem Amazon S3-Konto an und navigieren Sie zur Seite Benutzer. Diese Seite finden Sie, indem Sie in der oberen rechten Ecke auf Ihren Kontonamen klicken und dann auf Sicherheitsanmeldeinformationen > Benutzer (unter Zugriffsverwaltung auf der linken Seite der Seite) klicken.

2. IAM-Benutzer einrichten

A. Benutzer hinzufügen

Wenn Sie einen vorhandenen IAM-Benutzer verwenden möchten, klicken Sie auf diesen Benutzer. Wenn Sie einen neuen Benutzer erstellen müssen, klicken Sie auf die blaue Schaltfläche Benutzer erstellen und folgen Sie den Anweisungen. Sie müssen nun Sicherheitsanmeldeinformationen abrufen und dem Benutzer eine Berechtigungsrichtlinie zuweisen.

B. Benutzereinstellungen festlegen:

Benutzername: Erstellen Sie einen Benutzernamen Ihrer Wahl und klicken Sie auf Weiter.

C. Berechtigungen festlegen

1. Wählen Sie das Kontrollkästchen „Richtlinien direkt anfügen“ aus.
2. Geben Sie dann im Feld Filtern „S3full“ ein. Dadurch werden die Ergebnisse auf die für Amazon S3 relevanten gefiltert.
3. Aktivieren Sie das Kontrollkästchen für AmazonS3FullAccess.
4. Ignorieren Sie den Abschnitt „Berechtigungsboundary festlegen – optional“.
5. Klicken Sie auf Weiter.

D. Überprüfen und erstellen

Bestätigen Sie, dass Ihre Berechtigungen den obigen Anweisungen entsprechen. Andernfalls gibt es hier nichts zu konfigurieren. Klicken Sie auf Benutzer erstellen.

3. Zugriffsschlüssel abrufen

Sie benötigen ein IAM-Konto mit den Berechtigungen aus den obigen Schritten. Wenn Sie in der Vergangenheit ein IAM-Konto mit den Berechtigungen AmazonS3FullAccess erstellt haben, können Sie das vorhandene Konto verwenden.

A. Klicken Sie auf den oben erstellten IAM-Benutzernamen, der auf Ihrer AWS-Seite Benutzer aufgeführt ist.

B. Klicken Sie auf die Registerkarte Sicherheitsanmeldeinformationen und klicken Sie auf Zugriffsschlüssel erstellen.

C. Wählen Sie Drittanbieterdienst und aktivieren Sie Bestätigen.

D. Klicken Sie auf Zugriffsschlüssel erstellen. Es ist kein Beschreibungstag erforderlich.

E. Speichern Sie den Zugriffsschlüssel und den geheimen Zugriffsschlüssel.

Hinweis: Sie können den geheimen Schlüssel für diesen Benutzer nie wieder abrufen. Stellen Sie daher sicher, dass Sie die Datei speichern. Wenn Sie die Anmeldeinformationen verlieren, müssen Sie einen neuen Zugriffsschlüssel erstellen.

Ihr IAM-Benutzer sollte nun die volle Berechtigung zum Zugriff auf und Hochladen von Dateien in den S3-Bucket haben. Dies gibt Ihrem EDD-Shop Zugriff auf Ihre Dateien und die Möglichkeit, sichere Download-Links für Kunden zu erstellen.

F. Fügen Sie Zugriffsschlüssel & Geheimen Zugriffsschlüssel zu den Amazon S3-Einstellungen Ihres EDD-Shops unter Downloads → Einstellungen → Erweiterungen → Amazon S3. hinzu.

Wenn Sie weitere Hilfe beim Erstellen von IAM-Benutzern oder beim Anhängen von Richtlinien benötigen, lesen Sie das Handbuch von Amazon zum Erstellen von IAM-Benutzern für weitere Informationen.

Zugriff auf bestimmte Buckets beschränken

Wenn Ihr S3-Konto für andere Zwecke verwendet wird und Sie Ihr IAM-Konto (EDD Store) auf bestimmte Buckets beschränken möchten, können Sie anstelle von AmazonS3FullAccess eine benutzerdefinierte Richtlinie erstellen. Dies geschieht anstelle von Schritt 3 des Abschnitts Berechtigungen festlegen.

Click “Attach existing policies directly”, then select “Create Policy”:

Fügen Sie die Richtliniendetails unten über den JSON-Editor hinzu. Ersetzen Sie bucket-name-here durch den Namen (die Namen) der Buckets, auf die Sie über Ihren EDD-Shop zugreifen möchten.

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

Wenn Sie diese Richtlinie verwenden, werden alle Bucket-Namen angezeigt, aber nur die, die Sie im Abschnitt Ressourcen angeben, sind zugänglich. Wenn über EDD auf einen Bucket zugegriffen wird, der nicht in der Ressourcenliste enthalten ist, tritt ein PHP-Fehler auf. Wir hoffen, dies in einer zukünftigen Version zu verbessern.

Einrichtung

Sobald die Erweiterung installiert und aktiviert ist, können Sie zu Downloads → Einstellungen → Erweiterungen → Amazon S3 navigieren und Ihre Amazon S3-Kontoinformationen eingeben.

1. Zugriffsschlüssel-ID und geheimer Schlüssel eingeben

Die Zugriffsschlüssel-ID und der geheime Schlüssel werden durch Erstellen eines IAM-Benutzers in Ihrem S3-Konto erhalten. Siehe
unser obiges Handbuch für Informationen zur Erstellung eines IAM-Benutzers mit den entsprechenden Berechtigungen.

2. Standard-Bucket eingeben

Dies ist der Standard-Bucket, in den Dateien hochgeladen werden sollen. Um neue Buckets zu erstellen oder eine Liste Ihrer aktuellen Buckets zu erhalten, gehen Sie zu Ihrer S3-Konsole (Sie müssen angemeldet sein, um auf die Konsole zugreifen zu können). Geben Sie hier den Namen des Buckets ein, den Sie als Standard verwenden möchten. Beim Hochladen von Dateien nach Amazon S3 haben Sie die Möglichkeit, den Bucket auszuwählen, in den die Datei hochgeladen werden soll.

Bucket-Berechtigungen

Ihr Bucket sollte Alle öffentlichen Zugriffe blockieren aktiviert haben, um unbefugten Zugriff auf Dateien zu beschränken. EDD stellt Kunden temporären Zugriff auf Dateien zur Verfügung.

3. Amazon S3-Host eingeben (optional)

Dies ist der S3-Host, den Ihr Bucket verwendet. Meistens kann dieses Feld leer gelassen werden. Wenn Ihre Website jedoch Probleme beim Zugriff auf Ihren Bucket hat, versuchen Sie, dies auf den Endpunkt für die Region Ihres Buckets für Ihren Standard-Bucket zu ändern.

Sie können die Region Ihres Buckets finden, indem Sie sich in Ihr AmazonS3-Konto einloggen, auf S3 klicken und dann die Spalte „Region“ neben jedem Bucket betrachten. Dort steht, welche Region es ist. Sobald Sie diese kennen, finden Sie den passenden Host in der Amazon S3 Region Dokumentation. Kopieren Sie diesen Host und fügen Sie ihn ein und klicken Sie in WordPress auf Speichern.

4. Link-Ablaufzeit (Optional)

Dies ist die Anzahl der Minuten, für die die dynamisch generierte URL gültig ist. Wenn ein Kunde auf einen von Easy Digital Downloads bereitgestellten Download-Link klickt, wird eine neue URL für die Datei auf Amazon S3 „on the fly“ generiert. Dies ist die Anzahl der Minuten, für die die neue, geheime URL gültig ist.

Damit ist die Einrichtung von Amazon S3 abgeschlossen.

Amazon S3 mit EDD verwenden

Sie laden Dateien auf ein herunterladbares Produkt auf genau die gleiche Weise hoch wie zuvor, aber Sie haben zwei neue Registerkarten im Media Uploader namens Upload to Amazon S3 und Amazon S3 Library.

Wenn Sie eine Datei von dieser Registerkarte hochladen, wird sie automatisch in Ihr Amazon S3-Konto hochgeladen. Jede Datei, die Sie auf S3 hochladen, ist von Ihrer WordPress-Mediathek aus zugänglich, genau wie jede andere Mediendatei.

Hochladen auf Amazon S3 über EDD

Wenn Sie eine Datei von dieser Registerkarte hochladen, wird sie automatisch in Ihr Amazon S3-Konto hochgeladen.

Hinzufügen von bereits auf Amazon S3 vorhandenen Dateien zu EDD

Jede Datei, die Sie auf S3 hochladen, ist von Ihrer WordPress-Mediathek aus zugänglich, genau wie jede andere Mediendatei, über die Amazon S3 Library im Media Uploader.

Alternativ können Sie Dateien manuell zur Date-URL hinzufügen:

Dateien zum Download erzwingen

Manchmal versucht Ihr Webbrowser, die Datei, die Sie herunterladen, anzuzeigen oder abzuspielen, und Sie hören stattdessen Musik oder Video in Ihrem Browser, anstatt sie zu speichern. Es gibt verschiedene Möglichkeiten, dies zu verhindern und die Speicheroption zu erzwingen, aber wenn Sie Ihre Dateien auf Amazon S3 speichern, werden alle Einstellungen auf Ihrem Webserver ignoriert.

Anstatt sich auf die Einstellungen Ihres Webservers zu verlassen, müssen Sie die Optionen in S3 richtig konfigurieren. Hier ist, wie sie eingestellt sein sollten.

Hinweis: Diese Einstellung wird auf eine Datei und/oder einen Ordner angewendet, aber nicht auf den gesamten Bucket

Eigenschaften öffnen

1. Suchen Sie in Ihrem S3-Bucket die Datei, mit der Sie arbeiten möchten, und wählen Sie sie aus.
2. Click Actions >  Change metadata. 
   
3. Click Add Metadata and set the Type to System Defined, Key to Content-Disposition and set the Value to attachment and Save changes.
   

Dies erzwingt den Download anstelle der Wiedergabe oder Anzeige in Ihrem Browser.

Häufige Probleme und Fragen:

Dateien werden im Browser geöffnet anstatt heruntergeladen

Dies kann durch Erzwingen des Downloads von Dateien behoben werden.

Können Kunden die tatsächliche URL der Datei sehen und sie einfach direkt herunterladen?

Nein, der Kunde sieht eine URL, die zu Ihrem eigenen Shop führt, wo EDD den Speicherort übersetzt, sodass der Download funktioniert, ohne dass der Kunde die ursprüngliche Amazon-Quell-URL sieht.

Fehler: SSL-Zertifikatsproblem: Lokales Ausstellerzertifikat kann nicht abgerufen werden

Dieser Fehler bedeutet, dass das SSL-Zertifikat auf dem Server Ihrer Website ungültig ist oder falsch installiert wurde. Um dies zu beheben, wenden Sie sich an Ihr Hosting-Unternehmen und bitten Sie es, die ordnungsgemäße Installation und Gültigkeit des Zertifikats zu überprüfen.

Fehler: Zugriff verweigert

Dieser Fehler bedeutet, dass der von Ihnen verwendete Zugriffsschlüssel-ID und der geheime Schlüssel nicht über die erforderlichen Berechtigungen zum Zugriff auf S3-Buckets und -Ressourcen verfügen.

Um dies zu beheben, müssen Sie dem IAM-Benutzer eine neue Berechtigungsrichtlinie zuweisen. Sehen Sie sich unseren
Leitfaden zur Erstellung eines IAM-Benutzers mit den entsprechenden Berechtigungen an, um diesen Fehler zu beheben.

Sie können diese Fehlermeldung auch sehen, wenn Sie die URL von Amazon S3 kopiert und in das Feld „Datei-URL“ Ihres Downloads eingefügt haben. Bitte beachten Sie den obigen Hinweis zu den richtigen Schritten, die unternommen werden müssen, um Ihre Dateien mit Ihren Downloads zu verknüpfen.

Fehler: RequestTimeTooSkewed

Dieser Fehler tritt aufgrund einer Fehlkonfiguration der Zeiteinstellungen Ihres Webservers auf. Um ihn zu beheben, wenden Sie sich an Ihr Hosting-Unternehmen und bitten Sie es, die Zeiteinstellungen ordnungsgemäß neu zu konfigurieren.

Fehler: SignatureDoesNotMatch

Wenn Sie diesen Fehler erhalten, gefolgt von einer Fehlermeldung wie
Die von uns berechnete Anforderungssignatur stimmt nicht mit der von Ihnen bereitgestellten Signatur überein, bedeutet dies wahrscheinlich, dass Ihr Bucket-Name Großbuchstaben oder Leerzeichen enthält. Um das Problem zu beheben, benennen Sie Ihren Bucket so um, dass er keine Großbuchstaben enthält. Sie können auch einen neuen Bucket ohne Großbuchstaben im Namen erstellen, um das Problem zu beheben.

Fehler: NoSuchKey Der angegebene Schlüssel existiert nicht

Dieser Fehler tritt auf, wenn es ein Problem mit der Benennung der Datei oder sogar des Buckets gibt. Alle Satzzeichen und Sonderzeichen sollten entfernt werden.

Zum Beispiel: Wenn Sie eine Datei namens test-file-one.mp4.zip haben, ändern Sie sie in testfileone.zip

Andere Fehler oder Probleme beim Hochladen von Dateien nach Amazon S3

Wenn Sie Probleme beim Hochladen von Dateien nach Amazon S3 oder beim Zugriff auf vorhandene Dateien in Amazon S3 haben, konsultieren Sie die folgenden Schritte, um das Problem zu beheben.

1. Überprüfen Sie Ihre Amazon S3-Host-Einstellungen unter Downloads → Einstellungen → Erweiterungen → Amazon S3. Stellen Sie sicher, dass Ihr Host korrekt eingerichtet ist, einschließlich der Überprüfung, ob Sie die richtige Region eingestellt haben (lesen Sie den Punkt zu Amazon S3 Host oben, um zu erfahren, wie Sie dies tun).
2. Stellen Sie sicher, dass der Dateiname Ihrer Datei innerhalb des maximalen Limits von 1024 Zeichen liegt. Weitere Informationen finden Sie in der Dokumentation von Amazon, wie Sie Ihre Dateinamen korrekt formatieren.
3. Wenn Sie kürzlich zu einem neuen Amazon S3-Konto gewechselt sind und Probleme beim Hochladen von Dateien in Ihre Buckets haben, handelt es sich hierbei normalerweise um ein vorübergehendes Problem, das kurz nach der Erstellung neuer Buckets oder Konten auftreten kann. Es sollte sich nach einigen Stunden automatisch beheben. Weitere Informationen hierzu finden Sie in der Dokumentation von Amazon.
4. Immer noch kein Erfolg? Kontaktieren Sie den Support und geben Sie die genaue Fehlermeldung oder das Verhalten an, das Sie erleben.

Softwarelizenz-Updates schlagen fehl, da der Download fehlgeschlagen ist. cURL-Fehler 8: Ungültiger Content-Length: Wert

Es ist möglich, dass die Amazon S3-Erweiterung die Umleitung für Downloads nicht erzwingt. Wenn Sie diesen Fehler sehen, versuchen Sie
die Download-Methode auf Erzwingen zu setzen.

Kunde sieht Update fehlgeschlagen: Download fehlgeschlagen. Interner Serverfehler beim Versuch, ein Plugin zu aktualisieren

Stellen Sie sicher, dass die Quelldatei, die für automatische Updates verwendet werden soll, in den Lizenzierungseinstellungen des Downloads ausgewählt ist.

Sie werden wahrscheinlich den folgenden PHP Fatal-Fehler in der PHP-Fehlerprotokolldatei des Shops sehen:

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