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

Développez pour afficher les exigences d’accès aux fonctionnalités de cet article.

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

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Package Adobe Workfront Tous
Licence Adobe Workfront

Nouveau : Standard

Ou

En cours : Travail ou version ultérieure

Licence Adobe Workfront Fusion **

Actuel : aucune exigence de licence Workfront Fusion

Ou

Hérité : Workfront Fusion pour l’automatisation et l’intégration du travail

Produit

Nouveau :

  • Sélectionnez ou le package Prime Workfront : votre entreprise doit acheter Adobe Workfront Fusion.
  • Package Ultimate Workfront : Workfront Fusion est inclus.

Ou

Actuel : votre entreprise doit acheter Adobe Workfront Fusion.

Pour plus d’informations sur les informations contenues dans ce tableau, voir Conditions d’accès requises dans la documentation.

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 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 AWS S3Créer une connexion du module de.

  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, voir Mappage des informations d’un module à un autre.

Basculement de carte

Actions

Créer un compartiment

Ce module d’action crée un compartiment dans AWS.

Connection
Pour plus d’informations sur la connexion de votre compte AWS à Workfront Fusion, voir Connexion de 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 points d’entrée régionaux dans la documentation d’AWS.

Obtenir un fichier

Ce module d’action télécharge un fichier à partir d’un compartiment.

Connection
Pour plus d’informations sur la connexion de votre compte AWS à Workfront Fusion, voir Connexion de AWS à Workfront Fusion dans cet article.
Region
Sélectionnez votre point d’entrée régional. Pour plus d’informations, voir 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.

Effectuer un appel API

Ce module d’action effectue un appel personnalisé à l’API AWS S3.

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 plus d’informations sur la connexion de votre compte AWS à Workfront Fusion, voir Connexion de AWS à Workfront Fusion dans cet article.
Region
Sélectionnez votre point d’entrée régional. Pour plus d’informations, voir points d’entrée régionaux dans la documentation AWS.
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, consultez méthodes de requête HTTP dans Adobe Workfront Fusion.
Headers

Ajoutez un en-tête de requête. Pour chaque en-tête à ajouter, cliquez sur Ajouter un élément et saisissez l’en-tê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, consultez Signature et authentification de requêtes REST dans la documentation d’AWS.
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, consultez Hébergement virtuel dans la documentation d’AWS.

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 Calculs de signature pour l’en-tête d’autorisation dans la documentation d’AWS.
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 :

Lorsque vous utilisez des instructions conditionnelles telles que if dans votre JSON, placez les guillemets à l’extérieur de l’instruction conditionnelle.

Charger un fichier

Ce module d’action charge un fichier dans un compartiment AWS S3.

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

Pour chaque en-tête à ajouter, cliquez sur Ajouter un élément et saisissez la clé et la valeur de l’en-tête.

Pour connaître les en-têtes disponibles, voir PutObject dans la documentation d’AWS.

Recherches

Répertorier les fichiers

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, voir Connexion de AWS à Workfront Fusion dans cet article.
Region
Sélectionnez votre point d’entrée régional. Pour plus d’informations, voir points d’entrée régionaux dans la documentation AWS.
Bucket
Sélectionnez le compartiment Amazon S3 dans lequel rechercher des fichiers.
Prefix
Entrez un chemin d’accès à un dossier dans lequel rechercher des fichiers, tel que workfrontfusion/work.

Répertorier des dossiers

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, voir Connexion de AWS à Workfront Fusion dans cet article.
Region
Sélectionnez votre point d’entrée régional. Pour plus d’informations, voir 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