Con el conector Amazon® S3®, puedes utilizar comandos en una cadena para interactuar con Amazon Simple Storage Service® (S3). Por ejemplo, con este conector, puedes:
- Crear y gestionar buckets S3
- Enumerar y eliminar objetos S3
- Subir, descargar y copiar archivos en S3.
Nota: Este conector ha sido creado por Workiva y conecta con un sistema de terceros. Aunque nuestro equipo de asistencia puede ayudarte a configurar este conector dentro de tu espacio de trabajo, no podemos solucionar ni ayudar de ningún otro modo con los problemas que se originen fuera de la plataforma Workiva.
Requisitos previos
Para habilitar la conexión a Amazon S3, el conector utiliza la interfaz de línea de comandos (CLI) de Amazon Web Services® (AWS) para S3. Para configurar el conector, necesitarás:
- Un usuario de integración designado creado en Amazon S3 para el conector
- ID y secreto de la clave de acceso del usuario de la integración
- El código para la región de AWS para conectarse a
- Para una instancia S3 alojada en una dirección distinta del punto final predeterminado, la URL a la que conectar
Crea un usuario de integración de AWS para el conector
- En la consola de AWS, haz clic en IAM en Seguridad, Identidad y Cumplimiento.
- En la pestaña Usuarios, haz clic en Agregar un usuario.
- Debajo de Establecer detalles del usuario, introduce un nombre que sea único para ayudar a identificar al usuario de la integración, como Workiva.
- Debajo de Selecciona el tipo de acceso a AWS, selecciona Acceso programático, y haz clic en Siguiente: Permisos de :.
- Haz clic en Adjuntar directamente las políticas existentes, selecciona una política que admita el acceso a S3, como AmazonS3FullAccess, y haz clic en Siguiente: Etiquetas.
- Añade cualquier etiqueta opcional para identificar o aclarar mejor la intención del usuario, y haz clic en Siguiente: Revisando.
- Revisa los datos y permisos del usuario, y haz clic en Crear usuario.
- Registra el ID y el secreto de la clave de acceso del usuario para la configuración del conector.
Establecer el conector Amazon S3
Nota: Para que el conector esté disponible para su uso en las cadenas de tu organización, un administrador de seguridad de la organización primero lo habilita desde Configuración.
- En el Generador de cadenas, haz clic en Conexiones y, a continuación, en Crear en la parte superior derecha.
- Debajo de Conector Conexión, selecciona Amazon S3 y el CloudRunner predeterminado.
- En Información básica, introduce un nombre único y una descripción para ayudar a identificar el conector.
- En Propiedades, ingresa los detalles de la conexión:
Propiedad Detalles ID de la clave de acceso Introduce el ID de la clave de acceso del usuario de la integración. Clave de acceso Secreto Introduce el secreto de la clave de acceso del usuario de la integración. Región predeterminada Introduce el código para la región de AWS a la que conectarse. Punto final alternativo Para conectarte a una instancia de Amazon S3 alojada en una dirección diferente a la del punto final predeterminado, introduce la URL del punto final al que conectarte. Nota: Todas las credenciales sensibles se cifran automáticamente y se almacenan con un cifrado Advanced Encryption Standard (AES)-256.
- Selecciona los entornos para utilizar la conexión y haz clic en Guardar.
- Para probar la conexión, crea y ejecuta una cadena con el comando List Buckets del conector, y comprueba que devuelve un resultado válido.
Conexiones S3 compatibles con FIPS
Si necesitas una conexión S3 compatible con FIPS, consulta la página de Amazon FIPS Endpoints by Service para localizar el punto final que necesitas. Introduce ese punto final en la configuración del comando S3 en el campo Punto final alternativo.
Solución de problemas
Si falla la conexión a Amazon S3:
- Verifica el ID de la clave de acceso y el secreto del usuario de integración.
- Comprueba el código de región de AWS introducido para el conector.
- Si tu instancia de Amazon S3 está alojada en una dirección diferente a la del punto final predeterminado, comprueba la URL del punto final alternativo.