Moduli AWS S3

I moduli S3 di Adobe Workfront Fusion AWS consentono di eseguire operazioni sui bucket S3.

Requisiti di accesso

Espandi per visualizzare i requisiti di accesso per la funzionalità descritta in questo articolo.
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:

URL di base
code language-none
https://s3.{{parameters.region}}.amazonaws.com
Tag API
v1.5.21

Connettere AWS a Workfront Fusion connect-aws-to-workfront-fusion

Connettere AWS a Workfront Fusion utilizzando una connessione federata

Espandere per visualizzare le istruzioni per questo tipo di connessione.

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.

  1. Accedi alla console AWS e passa a IAM > Provider di identità.

  2. Selezionare Aggiungi provider.

  3. Per Tipo provider, selezionare Connessione OpenID.

  4. Nell’URL del provider, immetti quanto segue, quindi seleziona Ottieni identificazione personale:

    code language-none
    https://oidc.automations.adobe.com
    
  5. In Pubblico, immetti quanto segue:

    code language-none
    sts.amazonaws.com
    
  6. Selezionare Aggiungi provider.

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

  1. In IAM, vai a Ruoli e seleziona Crea ruolo.

  2. Per Tipo di entità attendibile, selezionare Identità Web.

  3. Nel provider di identità, selezionare oidc.automations.adobe.com.

  4. In Pubblico, selezionare sts.amazonaws.com.

  5. 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 è necessario AmazonS3FullAccess.

  6. Assegna al ruolo un nome chiaro e riconoscibile. Ad esempio, WorkfrontFusionFederatedConnection.

  7. Seleziona Crea ruolo.

  8. Aprire il ruolo appena creato e copiare il relativo ARN dall’area Riepilogo. Si presenta così: arn:aws:iam::123456789012:role/WorkfrontFusionFederatedConnection

  9. Continua con Crea la connessione in Workfront Fusion.

Creare la connessione in Workfront Fusion

  1. Nella schermata di configurazione della connessione del modulo, seleziona il tipo di connessione federata.
  2. Immettere il ruolo ARN copiato in Creare il ruolo IAM.
  3. 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.
  1. 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.
  2. 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.

  1. In una nuova scheda del browser, torna alla console AWS e apri il ruolo creato.

  2. Selezionare la scheda Relazioni di trust, quindi selezionare Modifica criterio di attendibilità.

  3. Sostituisci il criterio con il seguente, sostituendo i tuoi valori:

    • Sostituisci 123456789012 con il tuo ID account AWS
    • Sostituire il valore sub con 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"
         }
        }
       }
     ]
    }
    
  4. Seleziona Aggiorna criterio.

  5. 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:
code language-none
"oidc.automations.adobe.com:sub": [ "fusion:6e5b1c2a345bd8d1ed98b6b4f1459818:28964", "fusion:6e5b1c2a345bd8d1ed98b6b4f1459818:29011"
    ]
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

  1. Tornare alla scheda del browser Workfront Fusion, dove il pannello di connessione è ancora aperto.

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

Espandere per visualizzare le istruzioni per questo tipo di connessione.

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.

  1. Accedi al tuo account AWS IAM.

  2. Passa a Gestione identità e accessi > Gestione accessi > Utenti.

  3. Fare clic su Aggiungi utente.

  4. Immettere il nome del nuovo utente e selezionare l’opzione Accesso a livello di codice nella sezione Tipo di accesso.

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

  6. Passare alle altre finestre di dialogo, quindi fare clic su Crea utente.

  7. Copia l’ID chiave di accesso e la Chiave di accesso segreta forniti.

  8. Passare a Workfront Fusion e aprire la finestra di dialogo Crea connessione del modulo AWS S3.

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

Pulsante di attivazione/disattivazione Mappa

Azioni

Crea bucket

Questo modulo di azione crea un bucket in AWS.

Connessione
Per istruzioni sulla connessione dell’account AWS a Workfront Fusion, consulta Connettere AWS a Workfront Fusion in questo articolo.
Nome
Immetti il nome del nuovo bucket.
Region
Seleziona l’endpoint regionale. Per ulteriori informazioni, consulta endpoint regionali nella documentazione di AWS.

Ottieni file

Questo modulo di azione scarica un file da un bucket.

Connessione
Per istruzioni sulla connessione dell’account AWS a Workfront Fusion, consulta Connettere AWS a Workfront Fusion in questo articolo.
Region
Seleziona l’endpoint regionale. Per ulteriori informazioni, consulta endpoint regionali nella documentazione di AWS.
Bucket
Seleziona il bucket da cui desideri scaricare il file.
Percorso
Immettere il percorso del file. Esempio: /photos/2019/February/image023.jpg.

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.

Connessione
Per istruzioni sulla connessione dell’account AWS a Workfront Fusion, consulta Connettere AWS a Workfront Fusion in questo articolo.
Region
Seleziona l’endpoint regionale. Per ulteriori informazioni, consulta endpoint regionali nella documentazione di AWS.
URL
Immetti un URL host. Il percorso deve essere relativo a https://s3.<selected-region>.amazonaws.com/.
Metodo
Seleziona il metodo di richiesta HTTP necessario per configurare la chiamata API. Per ulteriori informazioni, vedere HTTP metodi di richiesta in Adobe Workfront Fusion.
Intestazioni

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 è s3.amazonaws.com. Per le richieste in stile virtuale, il valore è BucketName.s3.amazonaws.com. Per ulteriori informazioni, vedi Hosting virtuale nella documentazione di AWS.

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:

  • Fornire token di sicurezza per le operazioni Amazon DevPay. Ogni richiesta che utilizza Amazon DevPay richiede due intestazioni x-amz-security-token: una per il token di prodotto e una per il token utente. Quando Amazon S3 riceve una richiesta autenticata, confronta la firma calcolata con la firma fornita. Le intestazioni con più valori formattate in modo non corretto utilizzate per calcolare una firma possono causare problemi di autenticazione.
  • Fornisci un token di sicurezza quando utilizzi credenziali di sicurezza temporanee. Quando effettui richieste utilizzando le credenziali di sicurezza temporanee ottenute da IAM, devi fornire un token di sicurezza utilizzando questa intestazione. Per ulteriori informazioni sulle credenziali di sicurezza temporanee, vedere Creazione di richieste.

Questa intestazione è necessaria per le richieste che utilizzano Amazon DevPay e per le richieste firmate utilizzando credenziali di sicurezza temporanee.

Stringa di query
Aggiungi le stringhe di query desiderate, ad esempio parametri o campi modulo.
Corpo

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.

Connessione
Per istruzioni sulla connessione dell’account AWS a Workfront Fusion, consulta Connettere AWS a Workfront Fusion in questo articolo.
Region
Seleziona l’endpoint regionale. Per ulteriori informazioni, consulta endpoint regionali nella documentazione di AWS.
Cartella
Specificare la cartella di destinazione in cui si desidera caricare un file.
File di origine
Seleziona un file di origine da un modulo precedente oppure mappa il nome e i dati del file di origine.
Headers (facoltativo)

Per ogni intestazione da aggiungere, fare clic su Aggiungi elemento e immettere la chiave e il valore dell'intestazione.

Per le intestazioni disponibili, vedi PutObject nella documentazione di AWS.

Ricerche

File di elenco

Restituisce un elenco di file da una posizione specificata.

Connessione
Per istruzioni sulla connessione dell’account AWS a Workfront Fusion, consulta Connettere AWS a Workfront Fusion in questo articolo.
Region
Seleziona l’endpoint regionale. Per ulteriori informazioni, consulta endpoint regionali nella documentazione di AWS.
Bucket
Selezionare il bucket Amazon S3 in cui cercare i file.
Prefix
Immetti il percorso di una cartella in cui cercare i file, ad esempio workfrontfusion/work.

Cartelle elenco

Restituisce un elenco di cartelle da una posizione specificata.

Connessione
Per istruzioni sulla connessione dell’account AWS a Workfront Fusion, consulta Connettere AWS a Workfront Fusion in questo articolo.
Region
Seleziona l’endpoint regionale. Per ulteriori informazioni, consulta endpoint regionali nella documentazione di AWS.
Bucket
Selezionare il bucket Amazon S3 in cui si desidera cercare le cartelle.
Prefix (facoltativo)
Percorso di una cartella in cui cercare le cartelle, ad esempio workfrontfusion/work.
recommendation-more-help
workfront-fusion-help-workfront-fusion