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
| table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header | |
|---|---|
| Package Adobe Workfront |
Tout package de workflow Adobe Workfront et tout package d’automatisation et d’intégration Adobe Workfront Workfront Ultimate Packages Workfront Prime et Select, avec l’achat supplémentaire de Workfront Fusion. |
| Licences Adobe Workfront |
Standard Travail ou supérieur |
| Licence Adobe Workfront Fusion |
Basé sur les opérations : disponible pour les organisations disposant de licences basées sur les opérations Basé sur un connecteur (hérité) : Workfront Fusion pour l’automatisation et l’intégration du travail |
| Produit | Si votre organisation dispose d’un package Workfront Select ou Prime qui n’inclut pas l’automatisation et l’intégration de Workfront, elle doit acquérir Adobe Workfront Fusion. |
Pour plus d’informations sur le contenu de ce tableau, consultez Conditions d’accès requises dans la documentation.
Pour plus d’informations sur les licences Adobe Workfront Fusion, consultez 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 :
Connecter AWS à Workfront Fusion connect-aws-to-workfront-fusion
Connexion d’AWS à Workfront Fusion à l’aide d’une connexion fédérée
- Prérequis pour connecter AWS à Workfront Fusion à l’aide d’une connexion fédérée
- Ajout de Workfront Fusion comme fournisseur d’identité dans AWS
- Créer le rôle IAM
- Création de la connexion dans Workfront Fusion
- Ajouter la connexion à la politique d’approbation du rôle
- Vérifier la connexion
- Dépannage
Une connexion fédérée permet à Workfront Fusion d’accéder à votre compte AWS sans que vous ne créiez un utilisateur IAM ou stockiez une clé d’accès dans Fusion.
Au lieu de cela, vous enregistrez Workfront Fusion en tant que fournisseur d’identité approuvé dans votre compte AWS et vous configurez la connexion Fusion unique autorisée à utiliser un rôle IAM particulier. Lorsque la connexion s’exécute, Fusion présente une preuve d’identité de courte durée et AWS renvoie des informations d’identification temporaires qui expirent d’elles-mêmes. Aucune clé de longue durée n’est jamais créée, stockée ou pivotée.
| note |
|---|
| NOTE |
| La configuration de cette connexion nécessite deux visites sur la console AWS. Créez d’abord le rôle, puis la connexion dans Workfront Fusion, et revenez ensuite à AWS pour terminer la politique d’approbation. Cela est dû au fait qu’une partie de la politique d’approbation identifie une connexion spécifique et que cet identifiant n’existe pas tant que la connexion n’a pas été créée. |
Prérequis pour connecter AWS à Workfront Fusion à l’aide d’une connexion fédérée
Pour créer cette connexion, vous avez besoin des éléments suivants :
- Autorisation de créer un fournisseur d’identité et de créer et modifier des rôles dans l’IAM AWS. Cela signifie généralement la politique ou l’équivalent. Si vous ne disposez pas de cet accès, demandez à quelqu’un sur votre cloud ou
équipe de sécurité pour suivre les étapes d’AWS. - Possibilité de créer des connexions dans Workfront Fusion.
Ajout de Workfront Fusion comme fournisseur d’identité dans AWS
Cette étape indique à AWS que les jetons émis par Workfront Fusion peuvent être approuvés. Vous effectuez cette opération une fois par compte AWS. Si un membre de votre organisation a déjà ajouté ce fournisseur, passez à Créer le rôle IAM.
-
Connectez-vous à la console AWS et accédez à IAM > Fournisseurs d’identité.
-
Sélectionnez Ajouter un fournisseur.
-
Pour le type de fournisseur , sélectionnez OpenID Connect.
-
Dans l’URL du fournisseur, saisissez ce qui suit, puis sélectionnez Obtenir l’empreinte numérique :
code language-none https://oidc.automations.adobe.com -
Dans Audience, saisissez ce qui suit :
code language-none sts.amazonaws.com -
Sélectionnez Ajouter un fournisseur.
-
Passez à Créer le rôle IAM .
Créer le rôle IAM
Le rôle définit ce que la connexion est autorisée à faire dans votre compte AWS. Vous créez un rôle par connexion, de sorte que l’accès à chaque connexion puisse être accordé et révoqué indépendamment.
-
Dans IAM, accédez à Rôles et sélectionnez Créer un rôle.
-
Pour Type d’entité de confiance, sélectionnez Identité web.
-
Dans Fournisseur d’identités, sélectionnez
oidc.automations.adobe.com. -
Dans Audience, sélectionnez
sts.amazonaws.com. -
Sélectionnez Suivant, puis joignez les politiques d’autorisation dont cette connexion a besoin.
Accordez uniquement les autorisations que la connexion utilise réellement. Par exemple, une connexion qui ne lit que depuis
un compartiment n’a pas besoin d’êtreAmazonS3FullAccess. -
Donnez au rôle un nom clair et reconnaissable. Par exemple,
WorkfrontFusionFederatedConnection. -
Sélectionnez Créer un rôle.
-
Ouvrez le rôle que vous venez de créer et copiez son ARN depuis la zone Résumé . Voici à quoi cela ressemble :
arn:aws:iam::123456789012:role/WorkfrontFusionFederatedConnection
Création de la connexion dans Workfront Fusion
- Dans l’écran de configuration de la connexion du module, sélectionnez le type de connexion fédérée .
- Saisissez le rôle ARN que vous avez copié dans Créer le rôle IAM.
- Sélectionnez Créer.
Workfront Fusion affiche trois valeurs. Vous les utiliserez dans la procédure suivante.
| table 0-row-2 1-row-2 2-row-2 html-authored no-header | |
|---|---|
| Émetteur | Toujours https://oidc.automations.adobe.com. Cela correspond au fournisseur d’identité que vous avez ajouté dans AWS. |
| Objet | Identifie cette connexion. On dirait fusion:6e5b1c2a345bd8d1ed98b6b4f1459818:28964. Il est différent pour chaque connexion que vous créez. |
| Audience | Toujours sts.amazonaws.com. |
-
Laissez ce panneau ouvert et copiez la valeur Objet .
note NOTE Ne fermez pas le panneau et ne sélectionnez pas Annuler. La connexion n'est pas terminée tant que vous n'avez pas terminé les procédures restantes. Si vous fermez le panneau, vous devez supprimer la connexion et recommencer, car une nouvelle connexion reçoit un nouvel objet. -
Passez à Ajouter la connexion à la politique d’approbation du rôle.
Ajouter la connexion à la politique d’approbation du rôle
Tant que vous n’avez pas terminé cette procédure, le rôle n’approuve pas Workfront Fusion en général, mais ne permet pas encore à cette connexion spécifique de l’utiliser.
-
Dans un nouvel onglet du navigateur, revenez à la console AWS et ouvrez le rôle que vous avez créé.
-
Sélectionnez l’onglet Relations d’approbation puis sélectionnez Modifier la politique d’approbation.
-
Remplacez la politique par ce qui suit, en substituant vos propres valeurs :
- Remplacez
123456789012par votre ID de compte AWS - Remplacez la valeur
subpar l’objet que vous avez copié à partir 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" } } } ] } - Remplacez
-
Sélectionnez Mettre à jour la politique.
-
Passez à Vérifier la connexion.
| note tip | ||
|---|---|---|
| TIP | ||
| Pour permettre à plusieurs connexions d’utiliser le même rôle, répertoriez les objets sous la forme d’un tableau. AWS permet d’utiliser le rôle si le jeton correspond à une valeur de la liste : | ||
|
||
| Ne remplacez pas la sous-valeur par un caractère générique. Cela permet à toute connexion de votre organisation d’utiliser le rôle, y compris les connexions créées ultérieurement par d’autres personnes |
Vérifier la connexion
-
Revenez à l’onglet du navigateur de Workfront Fusion, où le panneau de connexion est toujours ouvert.
-
Cliquer sur Enregistrer.
Workfront Fusion contacte AWS, qui vérifie la politique d’approbation et renvoie les informations d’identification temporaires. Si tout est configuré correctement, la connexion est validée avec succès et vous pouvez poursuivre la configuration du module.
Si la vérification échoue, le panneau reste ouvert et affiche l’erreur. Corrigez le problème dans AWS et sélectionnez à nouveau Enregistrer. Vous n’avez pas besoin de recréer la connexion et l’objet ne change pas.
À partir de maintenant, la connexion renouvelle ses propres informations d’identification. Il n’y a aucune clé à faire pivoter et rien n’expire que vous devez gérer.
Dépannage
| table 0-row-3 1-row-3 2-row-3 3-row-3 html-authored | ||
|---|---|---|
| Erreur | Signification | Éléments à vérifier |
| InvalidIdentityToken | AWS n’a pas pu faire correspondre le jeton à un fournisseur d’identité enregistré. | Vérifiez que vous avez ajouté le fournisseur d’identité décrit dans Ajout de Workfront Fusion en tant que fournisseur d’identité dans AWS et que son URL est exactement https://oidc.automations.adobe.com, sans barre oblique. |
| Accès refusé lors de l’attribution du rôle | Le fournisseur d'identité est enregistré, mais la stratégie d'approbation ne correspond pas à cette connexion. | Vérifiez que la sous-valeur dans la politique d’approbation est caractère pour caractère identique à l’objet affiché dans Workfront Fusion et que aud est sts.amazonaws.com. Un objet copié à partir d’une autre connexion est la cause la plus courante. |
| La connexion fonctionne, puis échoue ultérieurement | Vérifiez si les politiques d’autorisation du rôle ont changé ou si le rôle a été supprimé et recréé. La recréation d’un rôle ne modifie pas son ARN, mais elle réinitialise sa politique d’approbation. |
Connexion d’AWS à Workfront Fusion à l’aide d’un utilisateur d’API
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.
-
Connectez-vous à votre compte AWS IAM.
-
Accédez à Gestion des identités et des accès > Gestion des accès > Utilisateurs et utilisatrices.
-
Cliquez sur Ajouter un utilisateur ou une utilisatrice.
-
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.
-
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.
-
Passez aux autres écrans de la boîte de dialogue, puis cliquez sur Créer un utilisateur ou une utilisatrice.
-
Copiez l’ID de clé d’accès et la Clé d’accès secrète fournis.
-
Accédez à Workfront Fusion et ouvrez la boîte de dialogue Créer une connexion du module de AWS S3.
-
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 Mappage d’informations d’un module à l’autre.
Actions
Créer un compartiment
Ce module d’action crée un compartiment dans AWS.
Obtenir un fichier
Ce module d’action télécharge un fichier à partir d’un compartiment.
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.
https://s3.<selected-region>.amazonaws.com/.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 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 :
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. |
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.
Recherches
Répertorier les fichiers
Renvoie une liste de fichiers à partir d’un emplacement spécifié.
Répertorier des dossiers
Renvoie une liste de dossiers à partir d’un emplacement spécifié.