Modules AWS S3

Les modules S3 d’Adobe Workfront Fusion AWS permettent d’effectuer des opérations sur vos compartiments S3.

Conditions d’accès

Vous devez disposer des accès suivants pour utiliser les fonctionnalités de cet article :

Adobe Workfront formule*
Pro ou une version ultérieure
Adobe Workfront licence*
Plan, Work
Adobe Workfront Fusion licence**

Exigences de licence actuelles : aucune exigence de licence Workfront Fusion requise.

Ou

Ancienne exigence de licence : Workfront Fusion pour l’automatisation et l’intégration du travail

Produit

Exigences actuelles du produit : si vous disposez du plan de Adobe Workfront Select ou Prime, votre entreprise doit acheter du Adobe Workfront Fusion et Adobe Workfront utiliser les fonctionnalités décrites dans cet article. Workfront Fusion est inclus dans le plan de Workfront Ultimate.

Ou

Exigences liées aux produits hérités : votre entreprise doit acheter Adobe Workfront Fusion ainsi qu’Adobe Workfront pour utiliser la fonctionnalité décrite dans cet article.

Pour connaître la formule, le type de licence ou l’accès dont vous disposez, contactez votre équipe d’administration Workfront.

Pour plus d’informations sur les licences Adobe Workfront Fusion, voir Licences Adobe Workfront Fusion.

Conditions préalables

Pour utiliser les modules AWS S3, vous devez disposer d’un compte Amazon Web Service.

Informations sur l’API S3 d’AWS

Le connecteur AWS S3 utilise les éléments suivants :

URL de base
https://s3.{{parameters.region}}.amazonaws.com
Balise API
v1.5.21

Connecter AWS à Workfront Fusion connect-aws-to-workfront-fusion

Pour connecter AWS S3 à Workfront Fusion, vous devez connecter votre compte AWS à Workfront Fusion. Pour ce faire, vous devez d’abord créer un utilisateur d’API dans AWS IAM.

  1. Connectez-vous à votre compte AWS IAM.

  2. Accédez à Identity and Access Management > Access Management > Users.

  3. Cliquez sur Add User.

  4. Saisissez le nom du nouvel utilisateur et sélectionnez l’option Programmatic access dans la section Access type .

  5. Cliquez sur Attach existing policies directly, puis recherchez des AmazonS3FullAccess dans la barre de recherche. Cliquez dessus lorsqu’il apparaît, puis cliquez sur Next.

  6. Parcourez les autres écrans de la boîte de dialogue, puis cliquez sur Create User.

  7. Copiez les Access key ID et Secret access key fournis.

  8. Accédez à Workfront Fusion et ouvrez la boîte de dialogue Create a connection du module AWS S3 .

  9. Saisissez les Access key ID et Secret access key de l’étape 7 aux champs respectifs, puis cliquez sur Continue pour établir la connexion.

La connexion a été établie. Vous pouvez poursuivre la configuration du module.

Modules AWS S3 et leurs champs

Lorsque vous configurez les modules AWS S3, Workfront Fusion affiche les champs répertoriés ci-dessous. En plus de ces derniers, des champs AWS S3 supplémentaires peuvent s’afficher, selon des facteurs tels que votre niveau d’accès dans l’application ou le service. Un titre en gras dans un module indique un champ obligatoire.

Si le bouton « Mapper » apparaît au-dessus d’un champ ou d’une fonction, vous pouvez l’utiliser pour définir des variables et des fonctions pour ce champ. Pour plus d’informations, voir Mappage des informations d’un module à un autre.

Basculement de carte

Actions

Create Bucket

Connection
Pour obtenir des instructions sur la connexion de votre compte AWS à Workfront Fusion, voir Connecter AWS à Workfront Fusion dans cet article.
Name
Saisissez le nom du nouveau compartiment.
Region
Sélectionnez votre point d’entrée régional. Pour plus d’informations, voir la discussion sur les points d’entrée régionaux dans la documentation AWS.

Get File

Télécharge un fichier depuis un compartiment.

Connection
Pour obtenir des instructions sur la connexion de votre compte AWS à Workfront Fusion, voir Connecter AWS à Workfront Fusion dans cet article.
Region
Sélectionnez votre point d’entrée régional. Pour plus d’informations, voir la discussion sur les points d’entrée régionaux dans la documentation AWS.
Bucket
Sélectionnez le compartiment à partir duquel vous souhaitez télécharger le fichier.
Path
Saisissez le chemin d’accès au fichier. Exemple : /photos/2019/February/image023.jpg.

Upload File

Connection
Pour obtenir des instructions sur la connexion de votre compte AWS à Workfront Fusion, voir Connecter AWS à Workfront Fusion dans cet article.
Region
Sélectionnez votre point d’entrée régional. Pour plus d’informations, voir la discussion sur les points d’entrée régionaux dans la documentation AWS.
Folder (facultatif)
Indiquez le dossier cible vers lequel vous souhaitez charger un fichier.
Source file
Sélectionnez un fichier source à partir d’un module précédent ou mappez le nom et les données du fichier source.
Headers (facultatif)
Insérez des en-têtes de requête. Les en-têtes disponibles se trouvent dans la documentation AWS S3 - PUT objet.

Make an API Call

Pour obtenir des informations détaillées sur l’API Amazon S3, consultez Amazon S3 REST Présentation de l’API.

Connection
Pour obtenir des instructions sur la connexion de votre compte AWS à Workfront Fusion, voir Connecter AWS à Workfront Fusion dans cet article.
Region
Sélectionnez votre point d’entrée régional. Pour plus d’informations, voir la discussion sur les points d’entrée régionaux dans la documentation AWS.
URL
URL Saisissez une URL hôte. Le chemin doit être relatif à https://s3.<selected-region>.amazonaws.com/.
Method
Sélectionnez la méthode de requête HTTP dont vous avez besoin pour configurer l’appel API. Pour plus d’informations, voir HTTP des méthodes de requête dans Adobe Workfront Fusion.
Headers

Ajoutez un en-tête de requête. Vous pouvez utiliser les en-têtes de requête courants qui suivent. Pour obtenir davantage d’en-têtes de requête, voir la documentation de l’API AWS S3.

Workfront Fusion Ajoute automatiquement des en-têtes d’autorisation.

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
Nom de l’en-tête Description
Content-Length Longueur du message (sans en-têtes) conformément à la norme RFC 2616. Cet en-tête est requis pour les PUT et les opérations qui chargent du code XML, telles que la journalisation et les listes de contrôle d’accès.
Content-Type Type de contenu de la ressource, au cas où le contenu de la requête se trouverait dans le corps. Exemple : text/plain.
Content-MD5 Synthèse MD5 128 bits encodée en base64 du message (sans en-têtes), selon la norme RFC 1864. Cet en-tête peut être utilisé comme contrôle d’intégrité du message pour vérifier que les données sont les mêmes que celles envoyées initialement. Bien que cela soit facultatif, nous vous recommandons d’utiliser le mécanisme Content-MD5 comme contrôle d’intégrité de bout en bout. Pour plus d’informations sur REST’authentification de requête, accédez à REST Authentification dans le Guide de développement du service Amazon Simple Storage.
Date Date et heure actuelles en fonction du demandeur ou de la demandeuse. Exemple : Wed, 01 Mar 2006 12:00:00 GMT. Lorsque vous spécifiez l’en-tête Authorization , vous devez spécifier l’en-tête x-amz-date ou l’en-tête Date .
Expect

Lorsque votre application utilise 100-continue, elle n’envoie pas le corps de la requête tant qu’elle n’a pas reçu d’accusé de réception. Si le message est refusé en raison des en-têtes, le corps du message n’est pas envoyé. Cet en-tête ne peut être utilisé que si vous envoyez un corps.

Valeurs valides : 100-continue

Host

Pour les requêtes path-style, la valeur est s3.amazonaws.com. Pour les requêtes virtual-style, la valeur est BucketName.s3.amazonaws.com. Pour plus d’informations, voir la section Hébergement virtuel dans le Guide de développement du service de stockage simple Amazon.

Cet en-tête est obligatoire pour HTTP 1.1 (la plupart des kits d’outils ajoutent cet en-tête automatiquement). Il est facultatif pour les requêtes HTTP/1.0.

x-amz-content-sha256 Lorsque vous utilisez la version 4 de la signature pour authentifier la requête, cet en-tête fournit un hachage du payload de la requête. Lors du chargement d’un objet en blocs, définissez la valeur sur STREAMING-AWS4-HMAC-SHA256-PAYLOAD pour indiquer que la signature couvre uniquement les en-têtes et qu’il n’y a aucun payload. Pour plus d’informations, voir la section Calculs de signatures pour l’en-tête d’autorisation : transférer le payload en plusieurs blocs (chargement fragmenté) (AWS Signature version 4).
x-amz-date Date et heure actuelles en fonction du demandeur ou de la demandeuse. Exemple : Wed, 01 Mar 2006 12:00:00 GMT. Lorsque vous spécifiez l’en-tête Authorization , vous devez spécifier l’en-tête x-amz-date ou l’en-tête Date . Si vous spécifiez les deux, la valeur spécifiée pour l’en-tête x-amz-date est prioritaire.
x-amz-security-token

Cet en-tête peut être utilisé dans les scénarios suivants :

  • Fournir des jetons de sécurité pour les opérations Amazon DevPay. Chaque requête qui utilise Amazon DevPay nécessite deux en-têtes x-amz-security-token : un pour le jeton de produit et un pour le jeton d’utilisation. Lorsqu’Amazon S3 reçoit une requête authentifiée, il compare la signature calculée à la signature fournie. Les en-têtes à plusieurs valeurs mal formatés, utilisés pour calculer une signature, peuvent entraîner des problèmes d’authentification.
  • Fournissez un jeton de sécurité lors de l’utilisation d’informations d’identification de sécurité temporaires. Lors de l’exécution de requêtes à l’aide d’informations d’identification de sécurité temporaires obtenues auprès d’IAM, vous devez fournir un jeton de sécurité à l’aide de cet en-tête. Pour en savoir plus sur les informations d’identification de sécurité temporaires, voir la section Effectuer des demandes.

Cet en-tête est obligatoire pour les requêtes qui utilisent Amazon DevPay et celles qui sont signées à l’aide d’informations d’identification de sécurité temporaires.

Query String
Ajoutez les chaînes de requête souhaitées, telles que des paramètres ou des champs de formulaire.
Body

Ajoutez le contenu du corps de l’appel API sous la forme d’un objet JSON standard.

Note :

Lors de l’utilisation d’instructions conditionnelles telles que if dans votre fichier JSON, placez les guillemets autour de l’instruction conditionnelle.

Recherches

List Files

Renvoie une liste de fichiers à partir d’un emplacement spécifié.

Connection
Pour obtenir des instructions sur la connexion de votre compte AWS à Workfront Fusion, voir Connecter AWS à Workfront Fusion dans cet article.
Region
Sélectionnez votre point d’entrée régional. Pour plus d’informations, voir la discussion sur les points d’entrée régionaux dans la documentation AWS.
Bucket
Sélectionnez le compartiment Amazon S3 dans lequel rechercher des fichiers.
Prefix (facultatif)
Chemin d’accès à un dossier dans lequel rechercher des fichiers, par exemple workfrontfusion/work.

List Folders

Renvoie une liste de dossiers à partir d’un emplacement spécifié.

Connection
Pour obtenir des instructions sur la connexion de votre compte AWS à Workfront Fusion, voir Connecter AWS à Workfront Fusion dans cet article.
Region
Sélectionnez votre point d’entrée régional. Pour plus d’informations, voir la discussion sur les points d’entrée régionaux dans la documentation AWS.
Bucket
Sélectionnez le compartiment Amazon S3 dans lequel rechercher des dossiers.
Prefix (facultatif)
Chemin d’accès à un dossier dans lequel rechercher des dossiers, par exemple workfrontfusion/work.
recommendation-more-help
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3