Modules AWS S3

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

Conditions d’accès

Pour utiliser les fonctionnalités décrites dans cet article, vous devez disposer des éléments suivants :

Adobe Workfront forfait*
Pro ou un forfait supérieur
Adobe Workfront licence*
Plan, Work
Adobe Workfront Fusion licence**

Exigences de licence actuelle : aucune exigence de licence Workfront Fusion

Ou

Exigence de licence héritée : Workfront Fusion for Work Automation and Integration

Produit

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

Ou

Exigences du produit hérité : votre entreprise doit acheter Adobe Workfront Fusion et Adobe Workfront pour utiliser les fonctionnalités décrites dans cet article.

Pour connaître la formule, le type de licence ou l’accès dont vous disposez, contactez vote administrateur ou administratrice Workfront.

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

Conditions préalables

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

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

  3. Cliquez sur Ajouter un utilisateur.

  4. Saisissez le nom du nouvel utilisateur et sélectionnez l'option Accès programmatique dans la section Type d'accès .

  5. Cliquez sur Joindre directement les stratégies 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.

  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 les ID de la clé d'accès et Clé d'accès secrète de l'étape 7 aux champs respectifs et 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 des modules AWS S3, Workfront Fusion affiche les champs répertoriés ci-dessous. Des champs AWS S3 supplémentaires peuvent également s’afficher, en fonction 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 de mappage situé au-dessus d’un champ ou d’une fonction s’affiche, vous pouvez l’utiliser pour définir des variables et des fonctions pour ce champ. Pour plus d’informations, consultez Mapper les informations d’un module à un autre dans Adobe Workfront Fusion.

Actions

Créer un compartiment

Connection
Pour plus d'informations sur la connexion de votre compte AWS à Workfront Fusion, reportez-vous à la section Connexion AWS à Workfront Fusion de cet article.
Name
Saisissez le nom du nouveau compartiment.
Region
Sélectionnez votre point de terminaison régional. Pour plus d’informations, voir la discussion sur les points de terminaison régionaux dans la documentation AWS.

Obtenir un fichier

Télécharge un fichier depuis un compartiment.

Connection
Pour plus d'informations sur la connexion de votre compte AWS à Workfront Fusion, reportez-vous à la section Connexion AWS à Workfront Fusion de cet article.
Region
Sélectionnez votre point de terminaison régional. Pour plus d’informations, voir la discussion sur les points d’entrée régionaux dans la documentation AWS.
Compartiment
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.

Télécharger le fichier

Connection
Pour plus d'informations sur la connexion de votre compte AWS à Workfront Fusion, reportez-vous à la section Connexion AWS à Workfront Fusion de cet article.
Region
Sélectionnez votre point de terminaison 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.
En-têtes (facultatif)
Insérez des en-têtes de requête. Les en-têtes disponibles se trouvent dans la documentation AWS S3 - Objet PUT.

Effectuer un appel API

Pour une discussion détaillée sur l’API Amazon S3, voir Amazon S3 REST API Introduction.

Connection
Pour plus d'informations sur la connexion de votre compte AWS à Workfront Fusion, reportez-vous à la section Connexion AWS à Workfront Fusion de cet article.
Region
Sélectionnez votre point de terminaison 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 les 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 suivants. Pour plus d’en-têtes de requête, reportez-vous à la AWS S3 documentation de l’API.

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 opérations et les opérations 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 Résumé MD5 128 bits encodé en base64 du message (sans en-têtes), selon la 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 données que celles envoyées initialement. Bien qu’il 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 de requête REST, consultez la page REST Authentication du Amazon Guide du développeur de services de stockage simple.
Date Date et heure actuelles en fonction du demandeur. 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 Date .
Attendez

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 rejeté en fonction 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 demandes de style de chemin d’accès, la valeur est s3.amazonaws.com. Pour les demandes de style virtuel, la valeur est BucketName.s3.amazonaws.com. Pour plus d’informations, voir Hébergement virtuel dans le Amazon Simple Storage Service Developer Guide.

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

x-amz-content-sha256 Lorsque vous utilisez la version 4 de signature pour authentifier la requête, cet en-tête fournit un hachage de la 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 pas de charge utile. Pour plus d’informations, voir Calculs de signature pour l’en-tête d’autorisation : transfert de charge utile en plusieurs blocs (téléchargement fragmenté) (AWS Signature version 4).
x-amz-date Date et heure actuelles en fonction du demandeur. 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 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 :

  • Fournissez 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 autre pour le jeton utilisateur. Lorsque 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 Lancement de requêtes .

Cet en-tête est requis pour les requêtes qui utilisent Amazon DevPay et les requêtes 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.

Remarque :

lors de l’utilisation d’instructions conditionnelles telles que if dans votre JSON, placez les guillemets en dehors de l’instruction conditionnelle.

Recherches

Fichiers de liste

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

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

Dossiers de liste

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

Connection
Pour plus d'informations sur la connexion de votre compte AWS à Workfront Fusion, reportez-vous à la section Connexion AWS à Workfront Fusion de cet article.
Region
Sélectionnez votre point de terminaison régional. Pour plus d’informations, voir la discussion sur les points de terminaison régionaux dans la documentation AWS.
Compartiment
Sélectionnez le compartiment Amazon S3 que vous souhaitez rechercher dans les 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