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
| 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:
Conexión de AWS a Workfront Fusion connect-aws-to-workfront-fusion
Conexión de AWS a Workfront Fusion mediante una conexión federada
- Requisitos previos para conectar AWS a Workfront Fusion mediante una conexión federada
- Añadir Workfront Fusion como proveedor de identidad en AWS
- Creación de la función IAM
- Creación de la conexión en Workfront Fusion
- Agregar la conexión a la directiva de confianza de la función
- Comprobar la conexión
- Resolución de problemas
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.
-
Inicie sesión en la consola de AWS y vaya a IAM > Proveedores de identidad.
-
Seleccione Agregar proveedor.
-
Para el tipo de proveedor, seleccione OpenID Connect.
-
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 -
En Audience, introduzca lo siguiente:
code language-none sts.amazonaws.com -
Seleccione Agregar proveedor.
-
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.
-
En IAM, vaya a Roles y seleccione Crear rol.
-
Para el tipo de entidad de confianza, seleccione Identidad web.
-
En Proveedor de identidad, seleccione
oidc.automations.adobe.com. -
En Audiencia, seleccione
sts.amazonaws.com. -
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 necesitaAmazonS3FullAccess. -
Asigne un nombre claro y reconocible a la función. Por ejemplo,
WorkfrontFusionFederatedConnection. -
Seleccione Crear rol.
-
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 -
Continuar a Crear la conexión en Workfront Fusion.
Creación de la conexión en Workfront Fusion
- En la pantalla de configuración de la conexión del módulo, seleccione el tipo de conexión federada.
- Escriba el ARN de la función que copió en Crear la función IAM.
- 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. |
-
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. -
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.
-
En una nueva pestaña del explorador, vuelva a la consola de AWS y abra la función que ha creado.
-
Seleccione la ficha Relaciones de confianza y, a continuación, seleccione Editar directiva de confianza.
-
Reemplace la directiva por lo siguiente, reemplazando sus propios valores:
- Reemplazar
123456789012con su ID de cuenta de AWS - Reemplace el valor
subpor 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" } } } ] } - Reemplazar
-
Seleccione Actualizar directiva.
-
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: | ||
|
||
| 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
-
Vuelva a la pestaña del explorador de Workfront Fusion, donde el panel de conexión sigue abierto.
-
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
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.
-
Inicie sesión en su cuenta de AWS IAM.
-
Navegue a Gestión de Identidad y Accesos > Gestión de Accesos > Usuarios.
-
Haga clic en Agregar usuario.
-
Introduce el nombre del nuevo usuario y selecciona la opción Acceso programático en la sección Tipo de acceso.
-
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.
-
Continúe con las otras pantallas de diálogo y luego haga clic en Crear usuario.
-
Copie el ID de clave de acceso y la Clave de acceso secreta proporcionados.
-
Vaya a Workfront Fusion y abra el diálogo Crear una conexión del módulo AWS S3.
-
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.
Acciones
Crear cubo
Este módulo de acción crea un bloque en AWS.
Obtener archivo
Este módulo de acción descarga un archivo desde un bloque.
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 .
https://s3.<selected-region>.amazonaws.com/.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 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:
Este encabezado es necesario para las solicitudes que usan Amazon DevPay y las solicitudes que se firman con credenciales de seguridad temporales. |
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.
Búsquedas
Listar archivos
Devuelve una lista de archivos de una ubicación especificada.
Listar carpetas
Devuelve una lista de carpetas desde una ubicación especificada.