Amazon S3

L'extension Amazon S3 pour Easy Digital Downloads vous permet d'héberger vos fichiers de téléchargement dans votre compte Amazon S3. C'est plus sûr et plus fiable que de stocker les fichiers sur votre propre compte d'hébergement.

Dans cet article

Création d'un compte IAM
Clés d'accès IAM
Configuration
Utilisation d'Amazon S3 avec EDD
Forcer le téléchargement des fichiers
Problèmes et questions courants

Création d'un compte IAM

Pour qu'Easy Digital Downloads puisse se connecter à votre compte Amazon S3, vous devrez créer un utilisateur IAM et lui attacher une politique d'autorisations. Vous pouvez cliquer sur Afficher les informations d'identification de sécurité de l'utilisateur pour voir la clé d'accès et la clé secrète. Ce sont les valeurs que vous devez saisir sur votre site WordPress dans Téléchargements → Paramètres → Extensions → Amazon S3.

1. Connectez-vous à votre compte Amazon S3

Connectez-vous à votre compte Amazon S3 et accédez à la page Utilisateurs. Cette page se trouve en cliquant sur le nom de votre compte dans le coin supérieur droit et en cliquant sur Informations d'identification de sécurité > Utilisateurs (Sous Gestion des accès sur le côté gauche de la page).

2. Configuration de l'utilisateur IAM

A. Ajouter un utilisateur

Si vous avez un utilisateur IAM existant que vous souhaitez utiliser, cliquez sur cet utilisateur. Si vous devez créer un nouvel utilisateur, cliquez sur le bouton bleu Créer un utilisateur et suivez les instructions. Vous devez maintenant obtenir les informations d'identification de sécurité et attacher une politique d'autorisations à l'utilisateur.

B. Définir les détails de l'utilisateur :

Nom d'utilisateur : Créez un nom d'utilisateur de votre choix et cliquez sur Suivant.

C. Définir les autorisations

1. Sélectionnez la case « Attacher directement les politiques ».
2. Ensuite, dans la case Filtrer , saisissez « S3full ». Cela filtrera les résultats pour ne garder que ceux pertinents pour Amazon S3.
3. Cochez la case pour AmazonS3FullAccess.
4. Ignorez la section « Définir la limite d'autorisations – facultatif ».
5. Cliquez sur Suivant.

D. Examiner et créer

Confirmez que vos autorisations correspondent aux instructions ci-dessus. Sinon, il n'y a rien à configurer ici, cliquez sur Créer un utilisateur.

3. Obtenir les clés d'accès

Vous aurez besoin d'un compte IAM utilisant les autorisations des étapes ci-dessus. Si vous avez créé un compte IAM dans le passé avec les autorisations AmazonS3FullAccess, vous pouvez utiliser le compte existant.

A. Cliquez sur le nom d'utilisateur IAM créé ci-dessus, répertorié sur votre page Utilisateurs AWS.

B. Cliquez sur l'onglet Informations d'identification de sécurité et cliquez sur Créer une clé d'accès.

C. Sélectionnez Service tiers et cochez Confirmer.

D. Cliquez sur Créer une clé d'accès. Aucune balise de description n'est requise.

E. Enregistrez la clé d'accès et la clé d'accès secrète.

Remarque : Vous ne pourrez plus jamais accéder à la clé secrète de cet utilisateur, alors assurez-vous de sauvegarder le fichier. Si vous perdez les identifiants, vous devrez créer une nouvelle clé d'accès.

Votre utilisateur IAM devrait maintenant avoir la permission complète d'accéder et de téléverser des fichiers dans le compartiment S3. Cela donne à votre boutique EDD l'accès à vos fichiers et la capacité de créer des liens de téléchargement sécurisés pour les clients.

F. Ajoutez la clé d'accès et la clé d'accès secrète aux paramètres Amazon S3 de votre boutique EDD sous Téléchargements → Paramètres → Extensions → Amazon S3.

Si vous avez besoin d'aide supplémentaire pour créer des utilisateurs IAM ou attacher des politiques, consultez le guide d'Amazon sur la création d'utilisateurs IAM pour plus d'informations.

Limiter l'accès à des compartiments spécifiques

Si votre compte S3 est utilisé à d'autres fins et que vous souhaitez limiter votre compte IAM (Boutique EDD) à des compartiments spécifiques, vous pouvez créer une politique personnalisée à la place d'AmazonS3FullAccess. Ceci est fait à la place de l'étape 3 de la section Définir les autorisations.

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

Ajoutez les détails de la politique ci-dessous via l'éditeur JSON. Mettez à jour bucket-name-here avec le(s) nom(s) des compartiments auxquels vous souhaitez que votre boutique EDD ait accès.

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

Lorsque vous utilisez cette politique, tous les noms de compartiments seront visibles, mais seuls ceux que vous placez dans la section Ressources seront accessibles. Si un compartiment qui n'est pas inclus dans la liste des ressources est accédé via EDD, une erreur PHP se produira. Nous espérons améliorer cela dans une future version.

Configuration

Une fois l'extension installée et activée, vous pouvez naviguer vers Téléchargements → Paramètres → Extensions → Amazon S3 et entrer les informations de votre compte Amazon S3.

1. Entrez l'ID de clé d'accès et la clé secrète

L'ID de clé d'accès et la clé secrète sont obtenus en créant un utilisateur IAM dans votre compte S3. Voir
notre guide ci-dessus pour savoir comment créer un utilisateur IAM avec les bonnes permissions.

2. Entrez un compartiment par défaut

Ceci est le compartiment par défaut vers lequel vous souhaitez que les fichiers soient téléchargés. Afin de créer de nouveaux compartiments ou d'obtenir une liste de vos compartiments actuels, allez dans votre Console S3 (vous devez être connecté pour accéder à la console). Entrez ici le nom du compartiment que vous souhaitez utiliser par défaut. Lors du téléchargement de fichiers sur Amazon S3, vous aurez la possibilité de sélectionner le compartiment vers lequel vous souhaitez que le fichier soit téléchargé.

Permissions du compartiment

Votre compartiment doit avoir l'option Bloquer tout accès public activée, afin de restreindre l'accès non autorisé aux fichiers. EDD fournira un accès temporaire aux fichiers aux clients.

3. Entrez un hôte Amazon S3 (Facultatif)

Ceci est l'hôte S3 que votre compartiment utilise. La plupart du temps, ce champ peut être laissé vide. Cependant, si votre site a des problèmes pour accéder à votre compartiment, essayez de le remplacer par l'Endpoint de la région de votre compartiment, pour votre compartiment par défaut.

Vous pouvez trouver la région de votre bucket en vous connectant à votre compte Amazon S3, en cliquant sur S3, puis en regardant la colonne de région listée à côté de chaque bucket. Elle indiquera la région. Une fois que vous la connaissez, trouvez l'hôte correspondant sur la Documentation des régions Amazon S3. Copiez et collez cet hôte, puis enregistrez dans votre WordPress.

4. Durée de validité du lien (Optionnel)

Ceci est le nombre de minutes pendant lesquelles l'URL générée dynamiquement est valide. Lorsqu'un client clique sur un lien de téléchargement fourni par Easy Digital Downloads, une nouvelle URL pour le fichier sur Amazon S3 est générée à la volée. C'est le nombre de minutes pendant lesquelles la nouvelle URL secrète est valide.

Ceci termine la configuration d'Amazon S3.

Utilisation d'Amazon S3 avec EDD

Vous téléchargerez des fichiers vers un produit téléchargeable de la même manière qu'auparavant, mais vous aurez deux nouveaux onglets dans l'outil d'ajout de médias appelés Télécharger vers Amazon S3 et Bibliothèque Amazon S3.

Lorsque vous téléchargez un fichier depuis cet onglet, il sera automatiquement téléchargé sur votre compte Amazon S3. Tout fichier que vous téléchargez sur S3 sera accessible depuis votre bibliothèque de médias WordPress, comme tout autre fichier multimédia.

Téléchargement vers Amazon S3 via EDD

Lorsque vous téléchargez un fichier depuis cet onglet, il sera automatiquement téléchargé sur votre compte Amazon S3.

Ajout de fichiers déjà sur Amazon S3 à EDD

Tout fichier que vous téléchargez sur S3 sera accessible depuis votre bibliothèque de médias WordPress, comme tout autre fichier multimédia, via la Bibliothèque Amazon S3 dans l'outil d'ajout de médias.

Alternativement, vous pouvez ajouter des fichiers à l'URL du fichier manuellement :

Forcer le téléchargement des fichiers

Parfois, votre navigateur Web essaiera d'afficher ou de lire le fichier que vous téléchargez, et vous pourriez finir par écouter de la musique ou regarder une vidéo dans votre navigateur, au lieu de l'enregistrer. Il existe diverses choses qui peuvent être faites pour empêcher cela et forcer l'option d'enregistrement, mais si vous stockez vos fichiers sur Amazon S3, alors tous les paramètres de votre serveur Web sont ignorés.

Au lieu de vous fier aux paramètres de votre serveur Web, vous devez configurer correctement les options dans S3. Voici comment elles doivent être définies.

Remarque : Ce paramètre est appliqué à un fichier et/ou un dossier, mais pas à l'ensemble du bucket

Ouverture des propriétés

1. Dans votre bucket S3, trouvez le fichier que vous souhaitez traiter et sélectionnez-le.
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.
   

Cela forcera son téléchargement au lieu de sa lecture ou de son affichage dans votre navigateur.

Problèmes et questions courants :

Les fichiers s'ouvrent dans le navigateur au lieu d'être téléchargés

Cela peut être résolu en Forçant le téléchargement des fichiers.

Les clients pourront-ils voir l'URL réelle du fichier et le télécharger directement ?

Non, le client verra une URL menant à votre propre boutique, où EDD traduira l'emplacement afin que le téléchargement fonctionne sans que le client ne voie l'URL source originale d'Amazon.

Erreur : problème de certificat SSL : impossible d'obtenir le certificat de l'émetteur local

Cette erreur signifie que le certificat SSL sur le serveur de votre site Web est invalide ou mal installé. Pour résoudre ce problème, contactez votre société d'hébergement et demandez-lui de vérifier que le certificat est correctement installé et valide.

Erreur : Accès refusé

Cette erreur signifie que l'utilisateur de l'ID de clé d'accès et de la clé secrète que vous utilisez n'a pas les autorisations nécessaires pour accéder aux compartiments et aux ressources S3.

Pour résoudre ce problème, vous devrez attacher une nouvelle stratégie d'autorisations à l'utilisateur IAM. Consultez notre
guide sur la création d'un utilisateur IAM avec les autorisations appropriées pour résoudre cette erreur.

Vous pouvez également voir ce message d'erreur si vous avez copié l'URL d'Amazon S3 et l'avez collée dans le champ URL du fichier de votre téléchargement. Veuillez consulter la note ci-dessus concernant les étapes appropriées à suivre pour lier vos fichiers à vos téléchargements.

Erreur : RequestTimeTooSkewed

Cette erreur se produit en raison d'une mauvaise configuration des paramètres de fuseau horaire de votre serveur Web. Pour la résoudre, contactez votre société d'hébergement et demandez-lui de reconfigurer correctement les paramètres du fuseau horaire.

Erreur : SignatureDoesNotMatch

Si vous recevez cette erreur, suivie d'un message d'erreur indiquant
La signature de la requête que nous avons calculée ne correspond pas à la signature que vous avez fournie, cela signifie probablement que le nom de votre compartiment contient des lettres majuscules ou des espaces. Pour résoudre le problème, renommez votre compartiment afin qu'il ne contienne aucune lettre majuscule. Vous pouvez également créer un nouveau compartiment sans lettres majuscules dans le nom pour le résoudre.

Erreur : NoSuchKey La clé spécifiée n'existe pas

Cette erreur se produit lorsqu'il y a un problème avec la façon dont le fichier, ou même le compartiment, est nommé. Toute ponctuation et caractères spéciaux doivent être supprimés.

Par exemple : Si vous avez un fichier nommé test-file-one.mp4.zip changez-le en testfileone.zip

Autres erreurs ou problèmes lors du téléchargement de fichiers sur Amazon S3

Si vous rencontrez des problèmes pour télécharger des fichiers sur Amazon S3 ou pour accéder à des fichiers existants sur Amazon S3, consultez les étapes ci-dessous pour résoudre le problème.

1. Vérifiez les paramètres de votre hôte Amazon S3 dans Téléchargements → Paramètres → Extensions → Amazon S3. Assurez-vous que votre hôte est correctement configuré, y compris la vérification que vous avez défini la bonne région (lisez le point sur l'hôte Amazon S3 ci-dessus pour savoir comment faire).
2. Assurez-vous que le nom de fichier de votre fichier est dans la limite maximale de 1024 caractères. Vous trouverez plus d'informations dans la documentation d'Amazon sur la façon de formater correctement vos noms de fichiers.
3. Si vous avez récemment basculé vers un nouveau compte Amazon S3 et que vous rencontrez des difficultés pour téléverser des fichiers dans vos compartiments, il s'agit généralement d'un problème temporaire qui peut survenir peu après la création de nouveaux compartiments ou comptes. Il devrait se résoudre automatiquement après quelques heures. Consultez la documentation d'Amazon pour plus d'informations à ce sujet.
4. Toujours pas de succès ? Contactez le support et incluez le message d'erreur exact ou le comportement que vous rencontrez.

Mises à jour de licence de logiciel échouées en raison de Download failed. cURL error 8: Invalid Content-Length: value

Il est possible que l'extension Amazon S3 ne force pas la redirection pour les téléchargements. Si vous rencontrez cette erreur, essayez de définir la méthode de téléchargement sur Forcé.

Le client voit Update Failed: Download failed. Internal Server Error en tentant de mettre à jour un plugin

Confirmez que le fichier source à utiliser pour les mises à jour automatiques est sélectionné dans les paramètres de licence du téléchargement.

Vous verrez probablement l'erreur fatale PHP suivante dans le fichier journal des erreurs PHP de la boutique :

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