Módulos de AWS S3

Los módulos S3 de Adobe Workfront Fusion AWS le permiten realizar operaciones en los bloques de S3.

Requisitos de acceso

Expanda para ver los requisitos de acceso para la funcionalidad en este artículo.
table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Paquete de Adobe Workfront

Cualquier paquete del flujo de trabajo de Adobe Workfront y cualquier paquete de integración y automatización de Adobe Workfront

Workfront Ultimate

Paquetes Workfront Prime y Select, con una compra adicional de Workfront Fusion.

Licencias de Adobe Workfront

Estándar

Trabajo o superior

Licencia de Adobe Workfront Fusion

Basado en operaciones: disponible para organizaciones con licencias basadas en operaciones

Basado en conector (heredado): Workfront Fusion for Work Automation and Integration

Producto Si su organización tiene un paquete de Workfront Select o Prime que no incluye la automatización y la integración de Workfront, su organización debe adquirir Adobe Workfront Fusion.

Para obtener más información sobre el contenido de esta tabla, consulte Requisitos de acceso en la documentación.

Para obtener información sobre las licencias de Adobe Workfront Fusion, consulte licencias de Adobe Workfront Fusion.

Requisitos previos

Para usar los módulos AWS S3 debe tener una cuenta de Amazon Web Service.

Información de la API de AWS S3

El conector AWS S3 utiliza lo siguiente:

URL base
code language-none
https://s3.{{parameters.region}}.amazonaws.com
Etiqueta de API
Versión 1.5.21

Conexión de AWS a Workfront Fusion connect-aws-to-workfront-fusion

Conexión de AWS a Workfront Fusion mediante una conexión federada

Expanda para ver las instrucciones de este tipo de conexión.

Una conexión federada permite a Workfront Fusion acceder a su cuenta de AWS sin necesidad de crear un usuario de IAM ni almacenar una clave de acceso en Fusion.
En su lugar, registra Workfront Fusion como proveedor de identidad de confianza en su cuenta de AWS y configura qué conexión de Fusion única puede utilizar una función de IAM determinada. Cuando se ejecuta la conexión, Fusion presenta una prueba de identidad de corta duración y AWS devuelve credenciales temporales que caducan por su cuenta. Nunca se crea, almacena ni gira ninguna clave de larga duración.

note
NOTE
La configuración de esta conexión requiere dos visitas a la consola de AWS. Primero cree la función, después cree la conexión en Workfront Fusion y, a continuación, vuelva a AWS para finalizar la directiva de confianza. Esto se debe a que parte de la directiva de confianza identifica una conexión específica y ese identificador no existe hasta que se crea la conexión.

Requisitos previos para conectar AWS a Workfront Fusion mediante una conexión federada

Para crear esta conexión, necesita lo siguiente:

  • Permiso en AWS IAM para crear un proveedor de identidad y crear y editar funciones. Esto suele significar la política o equivalente. Si no tiene este acceso, pregunte a alguien en su nube o
    Equipo de seguridad para completar los pasos de AWS por usted.
  • La capacidad de crear conexiones en Workfront Fusion.

Añadir Workfront Fusion como proveedor de identidad en AWS

Este paso indica a AWS que se puede confiar en los tokens emitidos por Workfront Fusion. Haga esto una vez por cuenta de AWS. Si alguien de su organización ya agregó este proveedor, vaya a Crear la función IAM.

  1. Inicie sesión en la consola de AWS y vaya a IAM > Proveedores de identidad.

  2. Seleccione Agregar proveedor.

  3. Para el tipo de proveedor, seleccione OpenID Connect.

  4. En la dirección URL del proveedor, escriba lo siguiente y, a continuación, seleccione Obtener huella digital:

    code language-none
    https://oidc.automations.adobe.com
    
  5. En Audience, introduzca lo siguiente:

    code language-none
    sts.amazonaws.com
    
  6. Seleccione Agregar proveedor.

  7. Continúe con Crear el rol de IAM.

Creación de la función IAM

La función define lo que la conexión puede hacer en su cuenta de AWS. Puede crear un rol por conexión, de modo que el acceso de cada conexión se pueda conceder y revocar de forma independiente.

  1. En IAM, vaya a Roles y seleccione Crear rol.

  2. Para el tipo de entidad de confianza, seleccione Identidad web.

  3. En Proveedor de identidad, seleccione oidc.automations.adobe.com.

  4. En Audiencia, seleccione sts.amazonaws.com.

  5. Seleccione Siguiente y, a continuación, adjunte las directivas de permisos que necesita esta conexión.
    Conceda únicamente los permisos que realmente utiliza la conexión. Por ejemplo, una conexión que solo lee de
    un bloque no necesita AmazonS3FullAccess.

  6. Asigne un nombre claro y reconocible a la función. Por ejemplo, WorkfrontFusionFederatedConnection.

  7. Seleccione Crear rol.

  8. Abra la función que acaba de crear y copie su ARN del área Resumen. Tiene el siguiente aspecto: arn:aws:iam::123456789012:role/WorkfrontFusionFederatedConnection

  9. Continuar a Crear la conexión en Workfront Fusion.

Creación de la conexión en Workfront Fusion

  1. En la pantalla de configuración de la conexión del módulo, seleccione el tipo de conexión federada.
  2. Escriba el ARN de la función que copió en Crear la función IAM.
  3. Seleccione Crear.
    Workfront Fusion muestra tres valores. Los utiliza en el siguiente procedimiento.
table 0-row-2 1-row-2 2-row-2 html-authored no-header
Emisor Siempre https://oidc.automations.adobe.com. Esto coincide con el proveedor de identidad que agregó en AWS.
Asunto Identifica esta conexión. Se ve como fusion:6e5b1c2a345bd8d1ed98b6b4f1459818:28964. Es diferente para cada conexión que cree.
Público Siempre sts.amazonaws.com.
  1. Deje este panel abierto y copie el valor Asunto.

    note
    NOTE
    No cierre el panel ni seleccione Cancelar. La conexión no finaliza hasta que complete los procedimientos restantes. Si cierra el panel, debe eliminar la conexión y volver a iniciarla, ya que una nueva conexión recibe un nuevo Asunto.
  2. Continuar a Agregar la conexión a la directiva de confianza del rol.

Agregar la conexión a la directiva de confianza de la función

Hasta que complete este procedimiento, la función confía en Workfront Fusion en general, pero aún no permite que esta conexión específica la utilice.

  1. En una nueva pestaña del explorador, vuelva a la consola de AWS y abra la función que ha creado.

  2. Seleccione la ficha Relaciones de confianza y, a continuación, seleccione Editar directiva de confianza.

  3. Reemplace la directiva por lo siguiente, reemplazando sus propios valores:

    • Reemplazar 123456789012 con su ID de cuenta de AWS
    • Reemplace el valor sub por el asunto que copió de Workfront Fusion.
    code language-none
    {
      "Version": "2012-10-17",
      "Statement": [
        {
          "Effect": "Allow",
          "Principal": {
            "Federated": "arn:aws:iam::123456789012:oidc-provider/oidc.automations.adobe.com"
        },
        "Action": "sts:AssumeRoleWithWebIdentity", "Condition": {
         "StringEquals": {
           "oidc.automations.adobe.com:sub": "fusion:6e5b1c2a345bd8d1ed98b6b4f1459818:28964",
           "oidc.automations.adobe.com:aud": "sts.amazonaws.com"
         }
        }
       }
     ]
    }
    
  4. Seleccione Actualizar directiva.

  5. Continuar a Verificar la conexión.

note tip
TIP
Para permitir que más de una conexión utilice el mismo rol, enumere los sujetos como una matriz. AWS permite utilizar la función si el token coincide con cualquier valor de la lista:
code language-none
"oidc.automations.adobe.com:sub": [ "fusion:6e5b1c2a345bd8d1ed98b6b4f1459818:28964", "fusion:6e5b1c2a345bd8d1ed98b6b4f1459818:29011"
    ]
No reemplace el subvalor por un comodín. Al hacerlo, cualquier conexión de su organización puede utilizar la función, incluidas las conexiones creadas posteriormente por otras personas

Comprobar la conexión

  1. Vuelva a la pestaña del explorador de Workfront Fusion, donde el panel de conexión sigue abierto.

  2. Haga clic en Guardar.

    Workfront Fusion se pone en contacto con AWS, que comprueba la directiva de confianza y devuelve credenciales temporales. Si todo está configurado correctamente, la conexión se valida correctamente y puede continuar con la configuración del módulo.
    Si la verificación falla, el panel permanece abierto y muestra el error. Corrija el problema en AWS y vuelva a seleccionar Guardar. No es necesario volver a crear la conexión y el asunto no cambia.

A partir de este punto, la conexión renueva sus propias credenciales. No hay ninguna clave para girar y no caduca nada que necesite mantener.

Resolución de problemas

table 0-row-3 1-row-3 2-row-3 3-row-3 html-authored
Error Lo que significa Qué comprobar
InvalidIdentityToken AWS no pudo relacionar el token con un proveedor de identidad registrado. Compruebe que ha añadido el proveedor de identidad descrito en Añadir Workfront Fusion como proveedor de identidad en AWS y que su URL es exactamente https://oidc.automations.adobe.com, sin barra diagonal.
Acceso denegado al asumir la función El proveedor de identidad está registrado, pero la directiva de confianza no coincide con esta conexión. Compruebe que el subvalor de la política de confianza sea carácter a carácter idéntico al Asunto mostrado en Workfront Fusion y que aud sea sts.amazonaws.com. La causa más común es un asunto copiado de una conexión diferente.
La conexión funciona y falla más tarde Compruebe si las directivas de permisos de la función han cambiado o si la función se ha eliminado y vuelto a crear. Volver a crear una función no cambia su ARN, pero restablece su directiva de confianza.

Conexión de AWS a Workfront Fusion con un usuario de API

Expanda para ver las instrucciones de este tipo de conexión.

Para conectar a AWS S3 a Workfront Fusion, debe conectar su cuenta de AWS a Workfront Fusion. Para hacerlo, primero necesitará crear un usuario de API en AWS IAM.

  1. Inicie sesión en su cuenta de AWS IAM.

  2. Navegue a Gestión de Identidad y Accesos > Gestión de Accesos > Usuarios.

  3. Haga clic en Agregar usuario.

  4. Introduce el nombre del nuevo usuario y selecciona la opción Acceso programático en la sección Tipo de acceso.

  5. Haga clic en Vincular políticas existentes directamente, luego busque AmazonS3FullAccess en la barra de búsqueda. Haga clic en él cuando aparezca y luego haga clic en Siguiente.

  6. Continúe con las otras pantallas de diálogo y luego haga clic en Crear usuario.

  7. Copie el ID de clave de acceso y la Clave de acceso secreta proporcionados.

  8. Vaya a Workfront Fusion y abra el diálogo Crear una conexión del módulo AWS S3.

  9. Introduzca el ID de clave de acceso y la Clave de acceso secreta del paso 7 en los campos correspondientes y haga clic en Continuar para establecer la conexión.

Se ha establecido la conexión. Puede continuar con la configuración del módulo.

Módulos de AWS S3 y sus campos

Al configurar módulos de AWS S3, Workfront Fusion muestra los campos que se indican a continuación. Junto a estos, pueden aparecer campos de AWS S3 adicionales, en función de factores como el nivel de acceso del que disponga en la aplicación o el servicio. El título en negrita en un módulo indica un campo obligatorio.

Si ve el botón Asignar encima de un campo o función, puede utilizarlo para establecer variables y funciones para ese campo. Para obtener más información, consulte Asignar información de un módulo a otro.

Conmutador Asignar

Acciones

Crear cubo

Este módulo de acción crea un bloque en AWS.

Connection
Para obtener instrucciones sobre cómo conectar su cuenta de AWS a Workfront Fusion, consulte Conexión de AWS a Workfront Fusion en este artículo.
Name
Introduzca el nombre del cubo.
Region
Seleccione el punto final regional. Para obtener más información, consulte extremos regionales en la documentación de AWS.

Obtener archivo

Este módulo de acción descarga un archivo desde un bloque.

Connection
Para obtener instrucciones sobre cómo conectar su cuenta de AWS a Workfront Fusion, consulte Conexión de AWS a Workfront Fusion en este artículo.
Region
Seleccione el punto final regional. Para obtener más información, vea extremos regionales en la documentación de AWS.
Bucket
Seleccione el cubo desde el que desee descargar el archivo.
Path
Introduzca la ruta al archivo. Ejemplo: /photos/2019/February/image023.jpg.

Realización de una llamada API

Este módulo de acción realiza una llamada personalizada a la API de AWS S3.

Para obtener una explicación sobre la API de Amazon S3, consulte Introducción a la API REST de Amazon S3 ​.

Connection
Para obtener instrucciones sobre cómo conectar su cuenta de AWS a Workfront Fusion, consulte Conexión de AWS a Workfront Fusion en este artículo.
Region
Seleccione el punto final regional. Para obtener más información, vea extremos regionales en la documentación de AWS.
URL
Introduzca una URL de host. La ruta debe ser relativa a https://s3.<selected-region>.amazonaws.com/.
Method
Seleccione el método de petición HTTP que necesita para configurar la llamada de API. Para obtener más información, consulte HTTP métodos de solicitud en Adobe Workfront Fusion.
Headers

Añada un encabezado de solicitud. Para cada encabezado que desee agregar, haga clic en Agregar elemento e introduzca el encabezado. Puede utilizar los siguientes encabezados de solicitud comunes. Para obtener más encabezados de solicitud, consulte la documentación de la API de AWS S3.

Workfront Fusion añade encabezados de autorización automáticamente.

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 layout-auto
Nombre del encabezado Descripción
Content-Length Longitud del mensaje (sin encabezados) según RFC 2616. Este encabezado es necesario para PUT y las operaciones que cargan XML, como el registro y las ACL.
Content-Type El tipo de contenido del recurso, en caso de que el contenido de la solicitud esté en el cuerpo. Ejemplo: text/plain.
Content-MD5 Resumen MD5 de 128 bits codificado en base64 del mensaje (sin los encabezados) según RFC 1864. Este encabezado se puede utilizar como comprobación de integridad de mensajes para comprobar que los datos son los mismos que se enviaron originalmente. Aunque es opcional, se recomienda utilizar el mecanismo Content-MD5 como comprobación de integridad de extremo a extremo. Para obtener más información acerca de la autenticación de solicitudes de REST, consulte Firma y autenticación de solicitudes REST en la documentación de AWS.
Date La fecha y hora actuales según el solicitante. Ejemplo: Wed, 01 Mar 2006 12:00:00 GMT. Cuando especifique el encabezado Authorization , debe especificar el encabezado x-amz-date o Date .
Expect

Cuando la aplicación utiliza 100-continue, no envía el cuerpo de la solicitud hasta que reciba una confirmación. Si el mensaje se rechaza en función de los encabezados, no se envía el cuerpo del mensaje. Este encabezado solo se puede utilizar si envía un cuerpo.

Valores válidos: 100-continue

Host

Para solicitudes path-style, el valor es s3.amazonaws.com. Para solicitudes de estilo virtual, el valor es BucketName.s3.amazonaws.com. Para obtener más información, consulte Alojamiento virtual en la documentación de AWS.

Este encabezado es necesario para HTTP 1.1 (la mayoría de los kits de herramientas lo añaden automáticamente); opcional para las solicitudes HTTP/1.0.

x-amz-content-sha256 Cuando se utiliza la versión de firma 4 para autenticar la solicitud, este encabezado proporciona un hash de la carga útil de la solicitud. Al cargar un objeto en fragmentos, establezca el valor en STREAMING-AWS4-HMAC-SHA256-PAYLOAD para indicar que la firma cubre solo los encabezados y que no hay carga útil. Para obtener más información, consulte Cálculos de firma para el encabezado de autorización en la documentación de AWS.
x-amz-date La fecha y hora actuales según el solicitante. Ejemplo: Wed, 01 Mar 2006 12:00:00 GMT. Cuando especifique el encabezado Authorization , debe especificar el encabezado x-amz-date o Date . Si especifica ambos, el valor especificado del encabezado x-amz-date tiene prioridad.
x-amz-security-token

Este encabezado se puede utilizar en los siguientes casos:

  • Debe proporcionar tokens de seguridad para las operaciones de Amazon DevPay. Cada solicitud que usa Amazon DevPay requiere dos encabezados x-amz-security-token: uno para el token de producto y otro para el token de usuario. Cuando Amazon S3 recibe una solicitud autenticada, compara la firma calculada con la firma proporcionada. El uso de encabezados de varios valores con un formato incorrecto para calcular una firma puede causar problemas de autenticación.
  • Debe proporcionar un token de seguridad cuando utilice credenciales de seguridad temporales. Al realizar solicitudes con credenciales de seguridad temporales obtenidas de IAM, debe proporcionar un token de seguridad mediante este encabezado. Para obtener más información sobre las credenciales de seguridad temporales, vaya a Creación de solicitudes.

Este encabezado es necesario para las solicitudes que usan Amazon DevPay y las solicitudes que se firman con credenciales de seguridad temporales.

Query String
Añada las cadenas de consulta deseadas, como parámetros o campos de formulario.
Body

Añada el contenido del cuerpo para la llamada API en forma de objeto JSON estándar.

Nota:

Cuando utilice afirmaciones condicionales como if en su JSON, coloque las comillas fuera de la afirmación condicional.

Cargar archivo

Este módulo de acción carga un archivo en un contenedor de AWS S3.

Connection
Para obtener instrucciones sobre cómo conectar su cuenta de AWS a Workfront Fusion, consulte Conexión de AWS a Workfront Fusion en este artículo.
Region
Seleccione el punto final regional. Para obtener más información, vea extremos regionales en la documentación de AWS.
Folder
Especifique la carpeta de destino en la que desea cargar un archivo.
Archivo de origen
Seleccione un archivo de origen de un módulo anterior o asigne el nombre y los datos del archivo de origen.
Headers (opcional)

Para cada encabezado que desee agregar, haga clic en Agregar elemento e introduzca la clave y el valor del encabezado.

Para ver los encabezados disponibles, consulte PutObject en la documentación de AWS.

Búsquedas

Listar archivos

Devuelve una lista de archivos de una ubicación especificada.

Connection
Para obtener instrucciones sobre cómo conectar su cuenta de AWS a Workfront Fusion, consulte Conexión de AWS a Workfront Fusion en este artículo.
Region
Seleccione el punto final regional. Para obtener más información, vea extremos regionales en la documentación de AWS.
Bucket
Seleccione el grupo Amazon S3 en el que desea buscar archivos.
Prefijo
Introduzca una ruta a una carpeta en la que buscar archivos, como workfrontfusion/work.

Listar carpetas

Devuelve una lista de carpetas desde una ubicación especificada.

Connection
Para obtener instrucciones sobre cómo conectar su cuenta de AWS a Workfront Fusion, consulte Conexión de AWS a Workfront Fusion en este artículo.
Region
Seleccione el punto final regional. Para obtener más información, vea extremos regionales en la documentación de AWS.
Bucket
Seleccione el cubo de Amazon S3 en el que desea buscar carpetas.
Prefix (opcional)
Ruta a una carpeta en la que buscar carpetas, como workfrontfusion/work.
recommendation-more-help
workfront-fusion-help-workfront-fusion