Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Utilizza passaggi predefiniti

Quando crei un flusso di lavoro, puoi scegliere di aggiungere uno dei seguenti passaggi predefiniti descritti in questo argomento. Puoi anche scegliere di aggiungere le tue fasi di elaborazione dei file personalizzate. Per ulteriori informazioni, consulta Utilizza passaggi di elaborazione dei file personalizzati.

Copia il file

Una fase di copia del file crea una copia del file caricato in una nuova posizione Amazon S3. Attualmente, puoi utilizzare una fase di copia del file solo con Amazon S3.

La seguente fase di copia del file copia i file nella test cartella inamzn-s3-demo-destination-bucket.

Se la fase di copia del file non è la prima fase del flusso di lavoro, è possibile specificare la posizione del file. Specificando la posizione del file, puoi copiare il file utilizzato nel passaggio precedente o il file originale che è stato caricato. È possibile utilizzare questa funzionalità per creare più copie del file originale mantenendo intatto il file di origine per l'archiviazione e la conservazione dei record. Per un esempio, consulta Esempio di tag ed eliminazione del flusso di lavoro.

Fornisci il bucket e i dettagli chiave

È necessario fornire il nome del bucket e una chiave per la destinazione della fase di copia del file. La chiave può essere un nome di percorso o un nome di file. Se la chiave viene considerata un nome di percorso o un nome di file è determinato dal fatto che si termini la chiave con il carattere barra (/).

Se il carattere finale è/, il file viene copiato nella cartella e il suo nome non cambia. Se il carattere finale è alfanumerico, il file caricato viene rinominato con il valore chiave. In questo caso, se esiste già un file con quel nome, il comportamento dipende dall'impostazione del campo Sovrascrivi esistente.

Ad esempio, se il valore della chiave ètest/, i file caricati vengono copiati nella cartella. test Se il valore della chiave ètest/today, (e l'opzione Sovrascrivi esistente è selezionata), ogni file caricato viene copiato in un file indicato today nella test cartella e ogni file successivo sovrascrive quello precedente.

Utilizzate una variabile denominata in una fase di copia del file

In una fase di copia del file, è possibile utilizzare una variabile per copiare dinamicamente i file in cartelle specifiche dell'utente. Attualmente, puoi usare ${transfer:UserName} or ${transfer:UploadDate} come variabile per copiare i file in una posizione di destinazione per l'utente specificato che sta caricando i file o in base alla data corrente.

Nel seguente esempio, se l'utente richard-roe carica un file, questo viene copiato nella cartella. amzn-s3-demo-destination-bucket/richard-roe/processed/ Se l'utente mary-major carica un file, questo viene copiato nella cartella. amzn-s3-demo-destination-bucket/mary-major/processed/

Allo stesso modo, è possibile ${transfer:UploadDate} utilizzarla come variabile per copiare i file in una posizione di destinazione denominata per la data corrente. Nell'esempio seguente, se imposti la destinazione ${transfer:UploadDate}/processed su il 1° febbraio 2022, i file caricati vengono copiati nella amzn-s3-demo-destination-bucket/2022-02-01/processed/ cartella.

Puoi anche usare entrambe queste variabili insieme, combinando le loro funzionalità. Ad esempio, è possibile impostare il prefisso della chiave Destinazione sufolder/${transfer:UserName}/${transfer:UploadDate}/, che creerebbe ad esempio cartelle annidate. folder/marymajor/2023-01-05/

Autorizzazioni IAM per la fase di copia

Per consentire la corretta esecuzione di una fase di copia, assicurati che il ruolo di esecuzione del flusso di lavoro contenga le seguenti autorizzazioni.

{
    "Sid": "ListBucket",
    "Effect": "Allow",
    "Action": "s3:ListBucket",
    "Resource": [
        "arn:aws:s3:::amzn-s3-demo-destination-bucket"
    ]
}, {
    "Sid": "HomeDirObjectAccess",
    "Effect": "Allow",
    "Action": [
        "s3:PutObject",
        "s3:GetObject",
        "s3:DeleteObjectVersion",
        "s3:DeleteObject",
        "s3:GetObjectVersion"
    ],
    "Resource": "arn:aws:s3:::amzn-s3-demo-destination-bucket/*"
}

Decifra il file

Il blog AWS di archiviazione contiene un post che descrive come decrittografare semplicemente i file senza scrivere alcun codice utilizzando i flussi di lavoro Transfer Family Managed, crittografare e decrittografare i file con PGP e. AWS Transfer Family

Algoritmi di crittografia simmetrica supportati

Per la decrittografia PGP, Transfer Family supporta algoritmi di crittografia simmetrica utilizzati per crittografare i dati effettivi dei file all'interno dei file PGP.

Usa la decrittografia PGP nel tuo flusso di lavoro

Transfer Family include il supporto integrato per la decrittografia Pretty Good Privacy (PGP). Puoi utilizzare la decrittografia PGP sui file caricati tramite SFTP, FTPS o FTP su Amazon Simple Storage Service (Amazon S3) o Amazon Elastic File System (Amazon EFS).

Per utilizzare la decrittografia PGP, devi creare e archiviare le chiavi private PGP che verranno utilizzate per la decrittografia dei tuoi file. Gli utenti possono quindi crittografare i file utilizzando le chiavi di crittografia PGP corrispondenti prima di caricarli sul server Transfer Family. Dopo aver ricevuto i file crittografati, puoi decrittografarli nel tuo flusso di lavoro. Per un tutorial dettagliato, consulta Configurazione di un flusso di lavoro gestito per la decrittografia di un file.

Per informazioni sugli algoritmi PGP supportati e sui consigli, consulta. Algoritmi di crittografia e decrittografia PGP

Aggiungi una fase di decrittografia

Una fase di decrittografia decrittografa un file crittografato che è stato caricato su Amazon S3 o Amazon EFS come parte del flusso di lavoro. Per informazioni dettagliate sulla configurazione della decrittografia, consulta. Usa la decrittografia PGP nel tuo flusso di lavoro

Quando si crea la fase di decrittografia per un flusso di lavoro, è necessario specificare la destinazione dei file decrittografati. È inoltre necessario selezionare se sovrascrivere i file esistenti se un file esiste già nella posizione di destinazione. Puoi monitorare i risultati del flusso di decrittografia e ottenere log di controllo per ogni file in tempo reale utilizzando Amazon Logs. CloudWatch

Dopo aver scelto il tipo di file Decrypt per il tuo passaggio, viene visualizzata la pagina Configura i parametri. Inserisci i valori per la sezione Configura i parametri di decrittografia PGP.

Le opzioni disponibili sono le seguenti:

La schermata seguente mostra un esempio delle opzioni che è possibile scegliere per la fase di decrittografia del file.

Autorizzazioni IAM per la fase di decrittografia

Per consentire la corretta esecuzione di una fase di decrittografia, assicurati che il ruolo di esecuzione del flusso di lavoro contenga le seguenti autorizzazioni.

{
    "Sid": "ListBucket",
    "Effect": "Allow",
    "Action": "s3:ListBucket",
    "Resource": [
        "arn:aws:s3:::amzn-s3-demo-destination-bucket"
    ]
}, {
    "Sid": "HomeDirObjectAccess",
    "Effect": "Allow",
    "Action": [
        "s3:PutObject",
        "s3:GetObject",
        "s3:DeleteObjectVersion",
        "s3:DeleteObject",
        "s3:GetObjectVersion"
    ],
    "Resource": "arn:aws:s3:::amzn-s3-demo-destination-bucket/*"
}, {
    "Sid": "Decrypt",
    "Effect": "Allow",
    "Action": [
        "secretsmanager:GetSecretValue",
    ],
    "Resource": "arn:aws:secretsmanager:region:account-id:secret:aws/transfer/*"
}

File di tag

Per contrassegnare i file in arrivo per un'ulteriore elaborazione a valle, utilizza un passaggio di tag. Inserisci il valore del tag che desideri assegnare ai file in arrivo. Attualmente, l'operazione con i tag è supportata solo se utilizzi Amazon S3 per lo storage del tuo server Transfer Family.

Il seguente passaggio di tag di esempio assegna scan_outcome e clean come chiave e valore del tag, rispettivamente.

Per consentire il completamento di una fase di etichettatura, assicurati che il ruolo di esecuzione del flusso di lavoro contenga le seguenti autorizzazioni.

{
            "Sid": "Tag",
            "Effect": "Allow",
            "Action": [
                "s3:PutObjectTagging",
                "s3:PutObjectVersionTagging"
            ],
            "Resource": [
                "arn:aws:s3:::amzn-s3-demo-bucket/*"
            ]
}

Elimina file

Per eliminare un file elaborato da una fase precedente del flusso di lavoro o per eliminare il file caricato originariamente, utilizza una fase di eliminazione del file.

Per consentire la corretta esecuzione di una fase di eliminazione, assicurati che il ruolo di esecuzione del flusso di lavoro contenga le seguenti autorizzazioni.

{
            "Sid": "Delete",
            "Effect": "Allow",
            "Action": [
                "s3:DeleteObjectVersion",
                "s3:DeleteObject"
            ],
            "Resource": "arn:aws:secretsmanager:region:account-ID:secret:aws/transfer/*"
        }

Variabili denominate per i flussi di lavoro

Per le fasi di copia e decrittografia, puoi utilizzare una variabile per eseguire azioni in modo dinamico. Attualmente, AWS Transfer Family supporta le seguenti variabili denominate.

Esempio di tag ed eliminazione del flusso di lavoro

L'esempio seguente illustra un flusso di lavoro che contrassegna i file in arrivo che devono essere elaborati da un'applicazione a valle, come una piattaforma di analisi dei dati. Dopo aver etichettato il file in arrivo, il flusso di lavoro elimina quindi il file originariamente caricato per risparmiare sui costi di archiviazione.

Console

Esempio: etichettare e spostare il flusso di lavoro

1. Apri la AWS Transfer Family console all'indirizzo https://console.aws.amazon.com/transfer/.

2. Nel riquadro di navigazione a sinistra, scegli Flussi di lavoro.

3. Nella pagina Flussi di lavoro, scegli Crea flusso di lavoro.

4. Nella pagina Crea flusso di lavoro, inserisci una descrizione. Questa descrizione viene visualizzata nella pagina Flussi di lavoro.

5. Aggiungi il primo passaggio (copia).

   1. Nella sezione Passaggi nominali, scegli Aggiungi passaggio.

   2. Scegli Copia file, quindi scegli Avanti.

   3. Inserisci il nome del passaggio, quindi seleziona un bucket di destinazione e un prefisso chiave.

      

   4. Scegli Avanti, quindi rivedi i dettagli della fase.

   5. Scegli Crea passaggio per aggiungere il passaggio e continuare.

6. Aggiungi il secondo passaggio (tag).

   1. Nella sezione Passaggi nominali, scegli Aggiungi passaggio.

   2. Scegli Tag file, quindi scegli Avanti.

   3. Inserisci il nome del passaggio.

   4. Per Posizione del file, seleziona Contrassegna il file creato dal passaggio precedente.

   5. Inserisci una Key (chiave) e un Value (valore).

      

   6. Scegli Avanti, quindi rivedi i dettagli della fase.

   7. Scegli Crea passaggio per aggiungere il passaggio e continuare.

7. Aggiungi il terzo passaggio (elimina).

   1. Nella sezione Passaggi nominali, scegli Aggiungi passaggio.

   2. Scegli Elimina file, quindi scegli Avanti.

      

   3. Inserisci il nome del passaggio.

   4. Per Posizione del file, seleziona Elimina il file sorgente originale.

   5. Scegli Avanti, quindi rivedi i dettagli del passaggio.

   6. Scegli Crea passaggio per aggiungere il passaggio e continuare.

8. Rivedi la configurazione del flusso di lavoro, quindi scegli Crea flusso di lavoro.

CLI

Esempio: etichetta e sposta il flusso di lavoro

1. Salva il codice seguente in un file; ad esempio,tagAndMoveWorkflow.json. Sostituisci ogni user input placeholder con le tue informazioni.

   [
      {
          "Type": "COPY",
          "CopyStepDetails": {
             "Name": "CopyStep",
             "DestinationFileLocation": {
                "S3FileLocation": {
                   "Bucket": "amzn-s3-demo-bucket",
                   "Key": "test/"
                }
             }
          }
      },
      {
          "Type": "TAG",
          "TagStepDetails": {
             "Name": "TagStep",
             "Tags": [
                {
                   "Key": "name",
                   "Value": "demo"
                }
             ],
             "SourceFileLocation": "${previous.file}"
          }
      },
      {
         "Type": "DELETE",
         "DeleteStepDetails":{
            "Name":"DeleteStep",
            "SourceFileLocation": "${original.file}"
         }
     }
   ]

   Il primo passaggio copia il file caricato in una nuova posizione Amazon S3. Il secondo passaggio aggiunge un tag (coppia chiave-valore) al file (previous.file) che è stato copiato nella nuova posizione. Infine, il terzo passaggio elimina il file originale (). original.file

2. Crea un flusso di lavoro dal file salvato. Sostituisci ogni user input placeholder con le tue informazioni.

   aws transfer create-workflow --description "short-description" --steps file://path-to-file --region region-ID

   Ad esempio:

   aws transfer create-workflow --description "copy-tag-delete workflow" --steps file://tagAndMoveWorkflow.json --region us-east-1

   Nota

   Per maggiori dettagli sull'utilizzo dei file per caricare i parametri, vedi Come caricare i parametri da un file.

3. Aggiornare un server esistente.

   Nota

   Questo passaggio presuppone che tu disponga già di un server Transfer Family e che desideri associarvi un flusso di lavoro. In caso contrario, vediConfigurazione di un endpoint server SFTP, FTPS o FTP. Sostituisci ogni user input placeholder con le tue informazioni.

   aws transfer update-server --server-id server-ID --region region-ID 
     --workflow-details '{"OnUpload":[{ "WorkflowId": "workflow-ID","ExecutionRole": "execution-role-ARN"}]}'

   Ad esempio:

   aws transfer update-server --server-id s-1234567890abcdef0 --region us-east-2 
     --workflow-details '{"OnUpload":[{ "WorkflowId": "w-abcdef01234567890","ExecutionRole": "arn:aws:iam::111111111111:role/nikki-wolf-execution-role"}]}'