Moduli AWS S3
I moduli S3 di Adobe Workfront Fusion AWS consentono di eseguire operazioni sui bucket S3.
Requisiti di accesso
| table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header | |
|---|---|
| Pacchetto Adobe Workfront |
Qualsiasi pacchetto Workflow di Adobe Workfront, e qualsiasi pacchetto Automation and Integration di Adobe Workfront. Workfront Ultimate Pacchetti Workfront Prime e Select, con un ulteriore acquisto di Workfront Fusion. |
| Licenze Adobe Workfront |
Standard Work o successiva |
| Licenza di Adobe Workfront Fusion |
Basato su operazioni: disponibile per le organizzazioni con licenze basate su operazioni Basata su connettore (precedente): Workfront Fusion for Work Automation and Integration |
| Prodotto | Se la tua organizzazione dispone di un pacchetto Workfront Select o Prime che non include Workfront Automation and Integration, dovrà acquistare Adobe Workfront Fusion. |
Per ulteriori dettagli sulle informazioni contenute in questa tabella, consulta Requisiti di accesso nella documentazione.
Per informazioni sulle licenze di Adobe Workfront Fusion, consulta Licenze di Adobe Workfront Fusion.
Prerequisiti
Per utilizzare i moduli AWS S3, è necessario disporre di un account Amazon Web Service.
Informazioni sull’API di AWS S3
Il connettore AWS S3 utilizza quanto segue:
Connettere AWS a Workfront Fusion connect-aws-to-workfront-fusion
Connettere AWS a Workfront Fusion utilizzando una connessione federata
- Prerequisiti per la connessione di AWS a Workfront Fusion tramite una connessione federata
- Aggiungere Workfront Fusion come provider di identità in AWS
- Creare il ruolo IAM
- Creare la connessione in Workfront Fusion
- Aggiungere la connessione al criterio di attendibilità del ruolo
- Verificare la connessione
- Risoluzione dei problemi
Una connessione federata consente a Workfront Fusion di accedere all’account AWS senza dover creare un utente IAM o archiviare una chiave di accesso in Fusion.
Al contrario, si registra Workfront Fusion come provider di identità attendibile nell’account AWS e si configura quale singola connessione Fusion è autorizzata a utilizzare un particolare ruolo IAM. Quando la connessione viene eseguita, Fusion presenta una prova di identità di breve durata e AWS restituisce credenziali temporanee che scadono autonomamente. Non viene mai creata, memorizzata o ruotata alcuna chiave di lunga durata.
| note |
|---|
| NOTE |
| La configurazione di questa connessione richiede due visite alla console AWS. È innanzitutto necessario creare il ruolo, quindi creare la connessione in Workfront Fusion, quindi tornare ad AWS per completare il criterio di attendibilità. Questo perché parte del criterio di attendibilità identifica una connessione specifica e tale identificatore non esiste finché non viene creata la connessione. |
Prerequisiti per la connessione di AWS a Workfront Fusion tramite una connessione federata
Per creare questa connessione, è necessario disporre dei seguenti elementi:
- Autorizzazione in AWS IAM per creare un provider di identità e per creare e modificare ruoli. Questo di solito significa la polizza o equivalente. Se non disponi di questo accesso, chiedi a qualcuno sul tuo cloud o
team di sicurezza per completare i passaggi di AWS. - Possibilità di creare connessioni in Workfront Fusion.
Aggiungere Workfront Fusion come provider di identità in AWS
Questo passaggio indica ad AWS che i token rilasciati da Workfront Fusion possono essere considerati attendibili. Puoi eseguire questa operazione una volta per ogni account AWS. Se un utente dell’organizzazione ha già aggiunto questo provider, passa a Crea il ruolo IAM.
-
Accedi alla console AWS e passa a IAM > Provider di identità.
-
Selezionare Aggiungi provider.
-
Per Tipo provider, selezionare Connessione OpenID.
-
Nell’URL del provider, immetti quanto segue, quindi seleziona Ottieni identificazione personale:
code language-none https://oidc.automations.adobe.com -
In Pubblico, immetti quanto segue:
code language-none sts.amazonaws.com -
Selezionare Aggiungi provider.
-
Continuare a Creare il ruolo IAM.
Creare il ruolo IAM
Il ruolo definisce l’operazione che la connessione può eseguire nell’account AWS. È possibile creare un ruolo per ogni connessione, in modo che l’accesso di ogni connessione possa essere concesso e revocato in modo indipendente.
-
In IAM, vai a Ruoli e seleziona Crea ruolo.
-
Per Tipo di entità attendibile, selezionare Identità Web.
-
Nel provider di identità, selezionare
oidc.automations.adobe.com. -
In Pubblico, selezionare
sts.amazonaws.com. -
Seleziona Avanti, quindi allega i criteri di autorizzazione necessari per la connessione.
Concedi solo le autorizzazioni effettivamente utilizzate dalla connessione. Ad esempio, una connessione che legge solo da
per un bucket non è necessarioAmazonS3FullAccess. -
Assegna al ruolo un nome chiaro e riconoscibile. Ad esempio,
WorkfrontFusionFederatedConnection. -
Seleziona Crea ruolo.
-
Aprire il ruolo appena creato e copiare il relativo ARN dall’area Riepilogo. Si presenta così:
arn:aws:iam::123456789012:role/WorkfrontFusionFederatedConnection -
Continua con Crea la connessione in Workfront Fusion.
Creare la connessione in Workfront Fusion
- Nella schermata di configurazione della connessione del modulo, seleziona il tipo di connessione federata.
- Immettere il ruolo ARN copiato in Creare il ruolo IAM.
- Seleziona Crea.
In Workfront Fusion vengono visualizzati tre valori. Utilizzale nella procedura successiva.
| table 0-row-2 1-row-2 2-row-2 html-authored no-header | |
|---|---|
| Emittente | Sempre https://oidc.automations.adobe.com. Corrisponde al provider di identità aggiunto in AWS. |
| Soggetto | Identifica questa connessione. È fusion:6e5b1c2a345bd8d1ed98b6b4f1459818:28964. È diversa per ogni connessione creata. |
| Pubblico | Sempre sts.amazonaws.com. |
-
Lasciate aperto questo pannello e copiate il valore Oggetto.
note NOTE Non chiudere il pannello e non selezionare Annulla. La connessione non viene completata fino a quando non vengono completate le procedure rimanenti. Se chiudi il pannello, devi eliminare la connessione e riavviarla, perché a una nuova connessione viene assegnato un nuovo Oggetto. -
Continua con Aggiungi la connessione al criterio di attendibilità del ruolo.
Aggiungere la connessione al criterio di attendibilità del ruolo
Fino a quando non si completa questa procedura, il ruolo considera attendibile Workfront Fusion in generale, ma non consente ancora l’utilizzo di questa connessione specifica.
-
In una nuova scheda del browser, torna alla console AWS e apri il ruolo creato.
-
Selezionare la scheda Relazioni di trust, quindi selezionare Modifica criterio di attendibilità.
-
Sostituisci il criterio con il seguente, sostituendo i tuoi valori:
- Sostituisci
123456789012con il tuo ID account AWS - Sostituire il valore
subcon l’oggetto copiato da 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" } } } ] } - Sostituisci
-
Seleziona Aggiorna criterio.
-
Continua con Verifica la connessione.
| note tip | ||
|---|---|---|
| TIP | ||
| Per consentire a più connessioni di utilizzare lo stesso ruolo, elencare i soggetti come un array. AWS consente di utilizzare il ruolo se il token corrisponde a qualsiasi valore nell’elenco: | ||
|
||
| Non sostituire il valore secondario con un carattere jolly. In questo modo qualsiasi connessione dell’organizzazione può utilizzare il ruolo, incluse le connessioni create in seguito da altri utenti |
Verificare la connessione
-
Tornare alla scheda del browser Workfront Fusion, dove il pannello di connessione è ancora aperto.
-
Fai clic su Salva.
Workfront Fusion contatta AWS, che controlla il criterio di attendibilità e restituisce credenziali temporanee. Se tutto è configurato correttamente, la connessione viene convalidata correttamente e puoi procedere con la configurazione del modulo.
Se la verifica non riesce, il pannello rimane aperto e visualizza l’errore. Correggi il problema in AWS e seleziona nuovamente Salva. Non è necessario ricreare la connessione e l’oggetto non cambia.
Da questo punto in poi, la connessione rinnova le proprie credenziali. Non c’è alcuna chiave da ruotare e non c’è nessuna scadenza da mantenere.
Risoluzione dei problemi
| table 0-row-3 1-row-3 2-row-3 3-row-3 html-authored | ||
|---|---|---|
| Errore | Che cosa significa | Cosa controllare |
| InvalidIdentityToken | AWS non è riuscito a far corrispondere il token con un provider di identità registrato. | Verifica di aver aggiunto il provider di identità descritto in Aggiungere Workfront Fusion come provider di identità in AWS e che il relativo URL sia esattamente https://oidc.automations.adobe.com, senza barra finale. |
| Accesso negato quando si assume il ruolo | Il provider di identità è registrato, ma i criteri di attendibilità non corrispondono a questa connessione. | Verificare che il valore secondario nel criterio di attendibilità sia identico a carattere per carattere all'oggetto visualizzato in Workfront Fusion e che il valore aud sia sts.amazonaws.com. La causa più comune è un oggetto copiato da una connessione diversa. |
| La connessione funziona, quindi ha esito negativo in un secondo momento | Verificare se i criteri di autorizzazione del ruolo sono stati modificati o se il ruolo è stato eliminato e ricreato. La ricreazione di un ruolo non modifica il relativo ARN, ma reimposta i criteri di attendibilità. |
Connettere AWS a Workfront Fusion utilizzando un utente API
Per connettere AWS S3 a Workfront Fusion è necessario connettere l’account AWS a Workfront Fusion. A tale scopo, è innanzitutto necessario creare un utente API in AWS IAM.
-
Accedi al tuo account AWS IAM.
-
Passa a Gestione identità e accessi > Gestione accessi > Utenti.
-
Fare clic su Aggiungi utente.
-
Immettere il nome del nuovo utente e selezionare l’opzione Accesso a livello di codice nella sezione Tipo di accesso.
-
Fai clic su Allega direttamente i criteri esistenti, quindi cerca AmazonS3FullAccess nella barra di ricerca. Fare clic su di esso quando viene visualizzato, quindi fare clic su Avanti.
-
Passare alle altre finestre di dialogo, quindi fare clic su Crea utente.
-
Copia l’ID chiave di accesso e la Chiave di accesso segreta forniti.
-
Passare a Workfront Fusion e aprire la finestra di dialogo Crea connessione del modulo AWS S3.
-
Immetti l’ID chiave di accesso e la Chiave di accesso segreta dal passaggio 7 ai rispettivi campi e fai clic su Continua per stabilire la connessione.
La connessione è stata stabilita. Puoi procedere con la configurazione del modulo.
Moduli AWS S3 e relativi campi
Quando configuri i moduli AWS S3, in Workfront Fusion vengono visualizzati i campi elencati di seguito. Insieme a questi, potrebbero essere visualizzati altri campi di AWS S3, a seconda di fattori quali il tuo livello di accesso nell’app o nel servizio. Un titolo in grassetto in un modulo indica un campo obbligatorio.
Se visualizzi il pulsante Map (Mappa) sopra un campo o una funzione, puoi utilizzarlo per impostare variabili e funzioni per tale campo. Per ulteriori informazioni, consulta Mappare le informazioni da un modulo a un altro.
Azioni
Crea bucket
Questo modulo di azione crea un bucket in AWS.
Ottieni file
Questo modulo di azione scarica un file da un bucket.
Effettuare una chiamata API
Questo modulo di azione effettua una chiamata personalizzata all’API AWS S3.
Per informazioni dettagliate sull’API Amazon S3, vedere Amazon S3 REST Introduzione all’API.
https://s3.<selected-region>.amazonaws.com/.Aggiungi un’intestazione di richiesta. Per ogni intestazione che si desidera aggiungere, fare clic su Aggiungi elemento e immettere l'intestazione. Puoi utilizzare le seguenti intestazioni di richiesta comuni. Per ulteriori intestazioni di richiesta fare riferimento alla documentazione API AWS S3.
Workfront Fusion aggiunge automaticamente le intestazioni di autorizzazione.
| 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 | |
|---|---|
| Nome intestazione | Descrizione |
| Content-Length | Lunghezza del messaggio (senza intestazioni) in base alla RFC 2616. Questa intestazione è necessaria per PUTs e le operazioni di caricamento di XML, ad esempio log e ACL. |
| Content-Type | Il tipo di contenuto della risorsa, nel caso in cui il contenuto della richiesta sia nel corpo. Esempio: text/plain. |
| Content-MD5 | Il digest MD5 a 128 bit codificato in base a base64 del messaggio (senza le intestazioni) in base alla RFC 1864. Questa intestazione può essere utilizzata come controllo di integrità del messaggio per verificare che i dati siano gli stessi dati inviati originariamente. Sebbene sia opzionale, si consiglia di utilizzare il meccanismo Content-MD5 come controllo di integrità end-to-end. Per ulteriori informazioni sull'autenticazione delle richieste REST, vedere Firma e autenticazione delle richieste REST nella documentazione di AWS. |
| Date | Data e ora correnti in base al richiedente. Esempio: Wed, 01 Mar 2006 12:00:00 GMT. Quando si specifica l'intestazione Authorization , è necessario specificare l'intestazione x-amz-date o Date . |
| expected |
Quando l'applicazione utilizza 100-continue, non invia il corpo della richiesta finché non riceve una conferma. Se il messaggio viene rifiutato in base alle intestazioni, il corpo del messaggio non viene inviato. Questa intestazione può essere utilizzata solo se invii un corpo. Valori validi: 100-continue |
| Host |
Per le richieste di tipo percorso, il valore è Questa intestazione è obbligatoria per HTTP 1.1 (la maggior parte dei toolkit aggiunge questa intestazione automaticamente); facoltativa per le richieste HTTP/1.0. |
| x-amz-content-sha256 | Quando si utilizza la firma versione 4 per autenticare la richiesta, questa intestazione fornisce un hash del payload della richiesta. Quando si carica un oggetto in blocchi, impostare il valore su STREAMING-AWS4-HMAC-SHA256-PAYLOAD per indicare che la firma copre solo le intestazioni e che non è presente alcun payload. Per ulteriori informazioni, consulta Calcoli della firma per l'intestazione di autorizzazione nella documentazione di AWS. |
| x-amz-date | Data e ora correnti in base al richiedente. Esempio: Wed, 01 Mar 2006 12:00:00 GMT. Quando si specifica l'intestazione Authorization , è necessario specificare l'intestazione x-amz-date o Date . Se si specificano entrambi, il valore specificato per l'intestazione x-amz-date ha la precedenza. |
| x-amz-security-token |
Questa intestazione può essere utilizzata nei seguenti scenari:
Questa intestazione è necessaria per le richieste che utilizzano Amazon DevPay e per le richieste firmate utilizzando credenziali di sicurezza temporanee. |
Aggiungi il contenuto del corpo della chiamata API sotto forma di oggetto JSON standard.
Nota:
Quando utilizzi istruzioni condizionali come if nel codice JSON, racchiudi l’istruzione condizionale tra virgolette.
Carica file
Questo modulo di azione carica un file in un bucket AWS S3.
Ricerche
File di elenco
Restituisce un elenco di file da una posizione specificata.
Cartelle elenco
Restituisce un elenco di cartelle da una posizione specificata.