Amazon S3

La extensión Amazon S3 para Easy Digital Downloads te permite alojar archivos de descarga en tu cuenta de Amazon S3. Esto es seguro y más fiable que almacenar los archivos en tu propia cuenta de hosting.

En este artículo

Creación de una cuenta IAM
Claves de acceso IAM
Configuración
Uso de Amazon S3 con EDD
Forzar la descarga de archivos
Problemas y preguntas comunes

Creación de una cuenta IAM

Para que Easy Digital Downloads pueda conectarse a tu cuenta de Amazon S3, necesitarás crear un usuario IAM y adjuntarle una política de permisos. Puedes hacer clic en Mostrar credenciales de seguridad del usuario para ver la clave de acceso y la clave secreta. Estos son los valores que necesitas introducir en tu sitio de WordPress en Descargas → Ajustes → Extensiones → Amazon S3.

1. Inicia sesión en tu cuenta de Amazon S3

Inicia sesión en tu cuenta de Amazon S3 y navega a la página de Usuarios. Esta página se encuentra haciendo clic en el nombre de tu cuenta en la esquina superior derecha y haciendo clic en Credenciales de seguridad > Usuarios (Debajo de Gestión de acceso en el lado izquierdo de la página).

2. Configuración del usuario IAM

A. Añadir usuario

Si tienes un usuario IAM existente que deseas utilizar, haz clic en ese usuario. Si necesitas crear un nuevo usuario, haz clic en el botón azul Crear usuario y sigue las instrucciones. Ahora necesitas obtener credenciales de seguridad y también adjuntar una política de permisos al usuario.

B. Establecer detalles del usuario:

Nombre de usuario: Crea un nombre de usuario de tu elección y haz clic en Siguiente.

C. Establecer permisos

1. Selecciona la casilla “Adjuntar políticas directamente”.
2. Luego, en el cuadro Filtrar , introduce “S3full”. Esto filtrará los resultados a los que son relevantes para Amazon S3.
3. Marca la casilla de AmazonS3FullAccess.
4. Ignora la sección “Establecer límite de permisos – opcional”.
5. Haz clic en Siguiente.

D. Revisar y crear

Confirma que tus permisos coinciden con las instrucciones anteriores. De lo contrario, no hay nada que configurar aquí, haz clic en Crear usuario.

3. Obtener claves de acceso

Necesitarás una cuenta IAM que utilice los permisos de los pasos anteriores. Si has creado una cuenta IAM en el pasado con los permisos AmazonS3FullAccess, puedes usar la cuenta existente.

A. Haz clic en el nombre de usuario IAM creado anteriormente, listado en tu página de Usuarios de AWS.

B. Haz clic en la pestaña Credenciales de seguridad y haz clic en Crear clave de acceso.

C. Selecciona Servicio de terceros y marca Confirmar.

D. Haz clic en Crear clave de acceso. No se requiere ninguna etiqueta de descripción.

E. Guarda la Clave de acceso y la Clave de acceso secreta.

Nota: No podrás volver a acceder a la clave secreta de este usuario, así que asegúrate de guardar el archivo. Si pierdes las credenciales, necesitarás crear una nueva clave de acceso.

Tu usuario de IAM debería tener ahora permiso completo para acceder y subir archivos al bucket de S3. Esto proporciona a tu tienda EDD acceso a tus archivos y la capacidad de crear enlaces de descarga seguros para los clientes.

F. Añade la Clave de acceso y la Clave de acceso secreta a la configuración de Amazon S3 de tu tienda EDD en Descargas → Ajustes → Extensiones → Amazon S3.

Si necesitas más ayuda para crear usuarios de IAM o adjuntar políticas, consulta la guía de Amazon sobre la creación de usuarios de IAM para obtener más información.

Limitar el acceso a buckets específicos

Si tu cuenta de S3 se utiliza para otros fines y deseas limitar tu cuenta de IAM (Tienda EDD) a buckets específicos, puedes crear una política personalizada en lugar de AmazonS3FullAccess. Esto se hace en lugar del Paso 3 de la sección Establecer permisos.

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

Añade los detalles de la política a continuación a través del editor JSON. Actualiza bucket-name-here con el nombre o nombres de los buckets a los que deseas que se pueda acceder a través de tu tienda EDD.

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

Al usar esta política, todos los nombres de Bucket serán visibles, pero solo los que coloques en la sección Recursos serán accesibles. Si se accede a un bucket que no está incluido en la lista de Recursos a través de EDD, se producirá un error de PHP. Esperamos mejorar esto en una futura versión.

Configuración

Una vez que la extensión esté instalada y activada, puedes navegar a Descargas → Ajustes → Extensiones → Amazon S3 e introducir la información de tu cuenta de Amazon S3.

1. Introduce la Clave de Acceso y la Clave Secreta

La Clave de Acceso y la Clave Secreta se obtienen creando un usuario de IAM en tu cuenta de S3. Consulta
nuestra guía anterior para obtener información sobre cómo crear un usuario de IAM con los permisos adecuados.

2. Introduce un Bucket por defecto

Este es el bucket por defecto al que deseas que se suban los archivos. Para crear nuevos buckets u obtener una lista de tus buckets actuales, ve a tu Consola S3 (debes iniciar sesión para acceder a la consola). Introduce aquí el nombre del bucket que deseas utilizar como predeterminado. Al subir archivos a Amazon S3, tendrás la opción de seleccionar el bucket al que deseas que se suba el archivo.

Permisos del Bucket

Tu bucket debe tener la opción Bloquear todo el acceso público ACTIVADA, para restringir el acceso no autorizado a los archivos. EDD proporcionará acceso temporal a los archivos a los clientes.

3. Introduce un Host de Amazon S3 (Opcional)

Este es el host S3 que está utilizando tu bucket. La mayoría de las veces, este campo se puede dejar en blanco. Sin embargo, si tu sitio tiene problemas para acceder a tu bucket, intenta cambiarlo al Endpoint de la región de tu bucket, para tu bucket predeterminado.

Puede encontrar la regi ilde{n} de su bucket iniciando sesi ilde{n} en su cuenta de AmazonS3, haciendo clic en S3 y, a continuaci ilde{o}n, echando un vistazo a la columna de regi ilde{o}n que aparece junto a cada bucket. Ah ilde{i} se indicar ilde{a} cu ilde{a}l es la regi ilde{o}n. Una vez que lo sepa, busque el host correcto correspondiente en la Documentaci ilde{o}n de Regiones de Amazon S3. Copie y pegue ese host y haga clic en guardar en su WordPress.

4. Tiempo de caducidad del enlace (Opcional)

Este es el n ilde{u}mero de minutos que la URL generada din ilde{a}micamente es v ilde{a}lida. Cuando un cliente hace clic en un enlace de descarga entregado por Easy Digital Downloads, se genera una nueva URL para el archivo en Amazon S3 sobre la marcha. Este es el n ilde{u}mero de minutos que la nueva y secreta URL es v ilde{a}lida.

Esto completa la configuraci ilde{o}n de Amazon S3.

Uso de Amazon S3 con EDD

Subir ilde{a} archivos a un producto descargable exactamente de la misma manera que antes, pero tendr ilde{a} dos nuevas pesta ilde{n}as en el cargador de medios llamadas Subir a Amazon S3 y Biblioteca de Amazon S3.

Cuando suba un archivo desde esta pesta ilde{n}a, se subir ilde{a} autom ilde{a}ticamente a su cuenta de Amazon S3. Cualquier archivo que suba a S3 ser ilde{a} accesible desde su Biblioteca de Medios de WordPress, al igual que cualquier otro archivo multimedia.

Subir a Amazon S3 a trav ilde{e}s de EDD

Cuando suba un archivo desde esta pesta ilde{n}a, se subir ilde{a} autom ilde{a}ticamente a su cuenta de Amazon S3.

A ilde{n}adir archivos ya existentes en Amazon S3 a EDD

Cualquier archivo que suba a S3 ser ilde{a} accesible desde su Biblioteca de Medios de WordPress, al igual que cualquier otro archivo multimedia, a trav ilde{e}s de la Biblioteca de Amazon S3 en el cargador de medios.

Alternativamente, puede a ilde{n}adir archivos a la URL del archivo manualmente:

Forzar la descarga de archivos

A veces, su navegador web intentar ilde{a} mostrar o reproducir el archivo que est ilde{a} descargando, y podr ilde{a} terminar reproduciendo m ilde{u}sica o v ilde{i}deo dentro de su navegador, en lugar de guardarlo. Hay una variedad de cosas que se pueden hacer para evitar esto y forzar la opci ilde{o}n de guardar, pero si est ilde{a} almacenando sus archivos en Amazon S3, entonces se ignoran los ajustes de su servidor web.

En lugar de depender de la configuraci ilde{o}n de su servidor web, debe configurar las opciones correctamente en S3. As ilde{i} es como deben configurarse.

Nota: Esta configuraci ilde{o}n se aplica a un archivo y/o carpeta, pero no a todo el bucket

Abrir propiedades

1. En su Bucket de S3, busque el archivo con el que desea trabajar y selecci ilde{o}nelo.
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.
   

Esto lo forzar ilde{a} a descargarse en lugar de reproducirse o mostrarse en su navegador.

ilde{C}uestiones y problemas comunes:

Los archivos se abren en el navegador en lugar de descargarse

Esto se puede resolver Forzando la descarga de archivos.

¿Podrán los clientes ver la URL real del archivo y simplemente descargarlo directamente?

No, el cliente verá una URL que va a su propia tienda, donde EDD traducirá la ubicación para que la descarga funcione sin que el cliente vea la URL de origen de Amazon.

Error: Problema con el certificado SSL: no se puede obtener el certificado del emisor local

Este error significa que el certificado SSL en el servidor de su sitio web es inválido o está instalado incorrectamente. Para resolver esto, póngase en contacto con su empresa de alojamiento y solicite que verifiquen que el certificado está instalado correctamente y es válido.

Error: Acceso Denegado

Este error significa que el usuario de la clave de acceso y la clave secreta que está utilizando no tiene los permisos necesarios para acceder a los buckets y recursos de S3.

Para resolver esto, deberá adjuntar una nueva política de permisos al usuario de IAM. Consulte nuestra
guía sobre cómo crear un usuario de IAM con los permisos adecuados para resolver este error.

También puede ver este mensaje de error si copió la URL de Amazon S3 y la pegó en el campo URL del archivo de su Descarga. Consulte la nota anterior sobre los pasos adecuados que deben seguirse para vincular sus archivos a sus Descargas.

Error: La hora de la solicitud está demasiado desfasada

Este error se produce debido a una configuración incorrecta de la configuración de zona horaria del servidor web. Para resolverlo, póngase en contacto con su empresa de alojamiento y pídales que reconfiguren la configuración de zona horaria correctamente.

Error: La firma no coincide

Si recibe este error, seguido de un mensaje de error que dice
La firma de la solicitud que calculamos no coincide con la firma que proporcionó, es probable que el nombre de su bucket contenga letras mayúsculas o espacios. Para resolver el problema, cambie el nombre de su bucket para que no contenga letras mayúsculas. También puede crear un nuevo bucket sin letras mayúsculas en el nombre para resolverlo.

Error: NoSuchKey La clave especificada no existe

Este error se produce cuando hay un problema con la forma en que se nombra el archivo, o incluso el bucket. Se deben eliminar todos los signos de puntuación y caracteres especiales.

Por ejemplo: Si tiene un archivo llamado test-file-one.mp4.zip cámbielo a testfileone.zip

Otros errores o problemas al subir archivos a Amazon S3

Si tiene problemas para subir archivos a Amazon S3 o para acceder a archivos existentes en Amazon S3, consulte los pasos a continuación para resolver el problema.

1. Compruebe la configuración de su host de Amazon S3 en Descargas → Configuración → Extensiones → Amazon S3. Asegúrese de que su host esté configurado correctamente, incluyendo la verificación de que ha configurado la región correcta (lea el punto sobre el host de Amazon S3 anteriormente para ver cómo hacerlo).
2. Asegúrese de que el nombre de archivo de su archivo esté dentro del límite máximo de 1024 caracteres. Puede encontrar más información en la documentación de Amazon sobre cómo formatear correctamente los nombres de sus archivos.
3. Si ha cambiado recientemente a una nueva cuenta de Amazon S3 y tiene problemas para subir archivos a sus buckets, este es típicamente un problema temporal que puede ocurrir poco después de crear nuevos buckets o cuentas. Debería resolverse automáticamente después de unas horas. Consulte la documentación de Amazon para obtener más información al respecto.
4. ¿Todavía no tiene éxito? Póngase en contacto con soporte e incluya el mensaje de error exacto o el comportamiento que está experimentando.

Actualizaciones de licencias de software fallidas debido a Descarga fallida. Error de cURL 8: valor de Content-Length no válido

Es posible que la extensión de Amazon S3 no esté forzando la redirección para las descargas. Si ve este error, intente
establecer el Método de descarga en Forzado.

El cliente ve Actualización fallida: Descarga fallida. Error interno del servidor al intentar actualizar un plugin

Confirme que el archivo de origen que se utilizará para las actualizaciones automáticas está seleccionado en la configuración de licencias de la Descarga.

Probablemente verá el siguiente error fatal de PHP en el archivo de registro de errores de PHP de la tienda:

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