> ## Documentation Index
> Fetch the complete documentation index at: https://www.octoparse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Integrazione Amazon S3

> Carica i file esportati da Octoparse in Amazon S3: autorizzazioni IAM, Access Key, nomi dei file e sovrascrittura.

Carica i dati estratti direttamente in un bucket Amazon S3. Sono supportati diversi formati di file.

## Prerequisiti

* Piano Professionale Octoparse o superiore
* Account AWS con il bucket S3 di destinazione già creato
* Utente IAM con autorizzazione `s3:PutObject` sul bucket

***

## Configurare le autorizzazioni IAM

Octoparse usa una Access Key per scrivere su S3: crea un utente IAM dedicato e concedigli soltanto le autorizzazioni minime necessarie.

Esempio di policy con autorizzazioni minime:

```json theme={null}
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": ["s3:PutObject"],
      "Resource": "arn:aws:s3:::your-bucket-name/*"
    }
  ]
}
```

Dopo aver creato l'utente IAM, genera una Access Key in **Credenziali di sicurezza** e salva Access Key ID e Secret Access Key.

***

## Configurare l'esportazione

Compila le impostazioni nell'ordine seguente:

**Nome configurazione**

Assegna un nome alla configurazione per poterla riutilizzare. Dal menu puoi scegliere una configurazione esistente o digitare un nuovo nome per crearne una.

**Dettagli di connessione**

| Campo             | Descrizione                                              |
| ----------------- | -------------------------------------------------------- |
| Autenticazione    | Metodo di autenticazione; al momento soltanto Access key |
| Access key ID     | Access Key ID dell'utente IAM                            |
| Secret access key | Secret Access Key dell'utente IAM                        |
| Area di servizio  | Regione AWS, selezionata dal menu                        |
| Bucket            | Nome del bucket di destinazione                          |

> **Sicurezza:** la Access Key può scrivere nel bucket. Non condividerla, non inserirla in un repository di codice e ruotala periodicamente.

**Esporta dati come**

Scegli il formato del file: Excel, CSV, HTML, JSON o XML.

**Impostazioni del nome file**

| Opzione                                  | Descrizione                                                                  |
| ---------------------------------------- | ---------------------------------------------------------------------------- |
| Uguale al nome dell'attività             | Il file usa il nome dell'attività; le esportazioni ripetute lo sovrascrivono |
| Aggiungi timestamp al nome dell'attività | Ogni esportazione crea un nuovo file e conserva la cronologia                |
| Usa nome personalizzato                  | Specifica manualmente il nome del file                                       |

**Quando esiste già un file con lo stesso nome**

| Opzione                                | Descrizione                                                |
| -------------------------------------- | ---------------------------------------------------------- |
| Crea nuovo file con timestamp corrente | Conserva l'originale e aggiunge un timestamp al nuovo file |
| Sostituisci il file esistente          | Sovrascrive l'originale                                    |
| Aggiungi nuovi dati al file esistente  | Accoda i dati al file esistente, solo CSV o Excel          |

Fai clic su **Conferma** per salvare la configurazione e avviare l'esportazione.

***

## Errori comuni

| Errore             | Causa                                            | Soluzione                                      |
| ------------------ | ------------------------------------------------ | ---------------------------------------------- |
| `InvalidKeySecret` | Access Key ID o Secret Access Key errata         | Verifica nuovamente le credenziali             |
| `NoSuchBucket`     | Nome bucket errato o inesistente                 | Verifica il nome del bucket                    |
| `PermissionDenied` | Autorizzazioni IAM insufficienti                 | Controlla che la policy includa `s3:PutObject` |
| `IllegalLocation`  | Regione del bucket diversa dall'Area di servizio | Seleziona la regione effettiva del bucket      |
| `FormatError`      | Configurazione non valida                        | Verifica che ogni campo sia compilato          |