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 version supérieure
Adobe Workfront licence*
Plan, Work
Adobe Workfront Fusion licence**

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

Ou

Exigences de licence héritées : Workfront Fusion for Work Automation and Integration

Produit

Exigences actuelles du produit : si vous avez le plan Select ou Prime Adobe Workfront, votre entreprise doit acheter Adobe Workfront Fusion ainsi que Adobe Workfront pour utiliser la fonctionnalité décrite dans cet article. Workfront Fusion est inclus dans la formule 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 AWS S3

Le connecteur AWS S3 utilise les fonctionnalités suivantes :

URL de base
https://s3.{{parameter.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 ou une utilisatrice d’API dans AWS IAM.

  1. Connectez-vous à votre compte AWS IAM.

  2. Accédez à Gestion des identités et des accès  > Gestion des accès  > Utilisateurs et utilisatrices.

  3. Cliquez sur Ajouter un utilisateur ou une utilisatrice.

  4. Saisissez le nom du nouvel utilisateur ou de la nouvelle utilisatrice et sélectionnez l’option Accès programmatique dans la section Type d’accès.

  5. Cliquez sur Associer directement des politiques existantes, puis recherchez AmazonS3FullAccess dans la barre de recherche. Cliquez dessus lorsqu’il apparaît, puis cliquez sur Suivant.

  6. Passez aux autres écrans de la boîte de dialogue, puis cliquez sur Créer un utilisateur ou une utilisatrice.

  7. Copiez l’ID de clé d’accès et la Clé d’accès secrète fournis.

  8. Accédez à Workfront Fusion et ouvrez la boîte de dialogue Créer une connexion du module AWS S3.

  9. Saisissez l’ID de clé d’accès et la Clé d’accès secrète de l’étape 7 dans les champs respectifs, puis cliquez sur Continuer 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, consultez la section Mappage des informations d’un module à un autre dans Adobe Workfront Fusion.

Actions

Créer un compartiment

Connection
Pour obtenir des instructions sur la connexion de votre compte AWS à Workfront Fusion, voir la section 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.

Obtenir un fichier

Télécharge un fichier depuis un compartiment.

Connection
Pour obtenir des instructions sur la connexion de votre compte AWS à Workfront Fusion, voir la section 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.

Charger le fichier

Connection
Pour obtenir des instructions sur la connexion de votre compte AWS à Workfront Fusion, voir la section 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 - objet PUT.

Réaliser un appel API

Pour consulter une discussion détaillée de l’API Amazon S3, voir la section Présentation de l’API Amazon S3 ​ REST.

Connection
Pour obtenir des instructions sur la connexion de votre compte AWS à Workfront Fusion, voir la section 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 la section Méthodes de requête HTTP 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 obligatoire pour les opérations et les requêtes PUT 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 l’authentification des requêtes REST, voir la section Authentification REST dans le Guide de développement du service de stockage simple Amazon.
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

Répertorier les fichiers

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 la section 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.

Répertorier des dossiers

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 la section 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
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43