Amazon S3

L'estensione Amazon S3 per Easy Digital Downloads ti consente di ospitare i file di download nel tuo account Amazon S3. Questo è sicuro e più affidabile rispetto all'archiviazione dei file sul tuo account di hosting.

In Questo Articolo

Creazione di un account IAM
Chiavi di accesso IAM
Configurazione
Utilizzo di Amazon S3 con EDD
Forzare il download dei file
Problemi e domande comuni

Creazione di un account IAM

Affinché Easy Digital Downloads possa connettersi al tuo account Amazon S3, dovrai creare un utente IAM e allegare una policy di autorizzazioni all'utente. Puoi fare clic su Mostra credenziali di sicurezza utente per visualizzare la chiave di accesso e la chiave segreta. Questi sono i valori che devi inserire nel tuo sito WordPress in Download → Impostazioni → Estensioni → Amazon S3.

1. Accedi al tuo account Amazon S3

Accedi al tuo account Amazon S3 e vai alla pagina Utenti. Questa pagina si trova facendo clic sul nome del tuo account nell'angolo in alto a destra e facendo clic su Credenziali di sicurezza > Utenti (Sotto Gestione accessi sul lato sinistro della pagina).

2. Configura utente IAM

A. Aggiungi utente

Se hai un utente IAM esistente che desideri utilizzare, fai clic su quell'utente. Se devi creare un nuovo utente, fai clic sul pulsante blu Crea utente e segui le istruzioni. Ora devi ottenere le credenziali di sicurezza e allegare una policy di autorizzazioni all'utente.

B. Imposta i dettagli dell'utente:

Nome utente: Crea un nome utente a tua scelta e fai clic su Avanti.

C. Imposta le autorizzazioni

1. Seleziona la casella "Allega policy direttamente".
2. Quindi, nella casella Filtro , inserisci "S3full". Ciò filtrerà i risultati in quelli pertinenti per Amazon S3.
3. Seleziona la casella per AmazonS3FullAccess.
4. Ignora la sezione "Imposta limite delle autorizzazioni – facoltativo".
5. Fai clic su Avanti.

D. Rivedi e crea

Conferma che le tue autorizzazioni corrispondano alle istruzioni sopra. Altrimenti, non c'è nulla da configurare qui, fai clic su Crea utente.

3. Ottieni chiavi di accesso

Avrai bisogno di un account IAM che utilizzi le autorizzazioni nei passaggi precedenti. Se hai creato un account IAM in passato con le autorizzazioni AmazonS3FullAccess, puoi utilizzare l'account esistente.

A. Fai clic sul nome utente IAM creato sopra, elencato nella tua pagina Utenti AWS.

B. Fai clic sulla scheda Credenziali di sicurezza e fai clic su Crea chiave di accesso.

C. Seleziona Servizio di terze parti e Seleziona Conferma.

D. Fai clic su Crea chiave di accesso. Non è richiesta alcuna tag di descrizione.

E. Salva Chiave di accesso & Chiave di accesso segreta.

Nota: Non potrai più accedere alla chiave segreta per questo utente, quindi assicurati di salvare il file. Se perdi le credenziali, dovrai creare una nuova chiave di accesso.

Il tuo utente IAM dovrebbe ora avere il permesso completo di accedere e caricare file nel bucket S3. Questo fornisce al tuo negozio EDD l'accesso ai tuoi file e la capacità di creare link di download sicuri per i clienti.

F. Aggiungi la chiave di accesso e la chiave di accesso segreta alle impostazioni Amazon S3 del tuo negozio EDD sotto Download → Impostazioni → Estensioni → Amazon S3.

Se hai bisogno di ulteriore assistenza nella creazione di utenti IAM o nell'associazione di policy, consulta la guida di Amazon sulla creazione di utenti IAM per maggiori informazioni.

Limita l'accesso a bucket specifici

Se il tuo account S3 viene utilizzato per altri scopi e desideri limitare il tuo account IAM (Negozio EDD) a bucket specifici, puoi creare una policy personalizzata al posto di AmazonS3FullAccess. Questo viene fatto al posto del Passaggio 3 della sezione Imposta autorizzazioni.

Fai clic su "Allega policy esistenti direttamente", quindi seleziona "Crea policy":

Aggiungi i dettagli della policy di seguito tramite l'editor JSON. Aggiorna bucket-name-here con il nome (i) dei bucket a cui desideri che il tuo negozio EDD possa accedere.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "VisualEditor0",
            "Effect": "Allow",
            "Action": [
                "s3:PutObject",
                "s3:GetObjectAcl",
                "s3:GetObject",
                "s3:ListBucketMultipartUploads",
                "s3:AbortMultipartUpload",
                "s3:ListBucket",
                "s3:ListMultipartUploadParts"
            ],
            "Resource": [
                "arn:aws:s3:::bucket-name-here",
                "arn:aws:s3:::bucket-name-here/*"
            ]
        },
        {
            "Sid": "VisualEditor1",
            "Effect": "Allow",
            "Action": "s3:ListAllMyBuckets",
            "Resource": "*"
        }
    ]
}

Quando utilizzi questa policy, tutti i nomi dei bucket saranno visibili, ma solo quelli che inserisci nella sezione Risorse saranno accessibili. Se un bucket non incluso nell'elenco Risorse viene accessibile tramite EDD, si verificherà un errore PHP. Speriamo di migliorare questo aspetto in una versione futura.

Configurazione

Una volta che l'estensione è installata e attivata, puoi navigare su Download → Impostazioni → Estensioni → Amazon S3 e inserire le informazioni del tuo account Amazon S3.

1. Inserisci l'Access Key ID e la Secret Key

L'Access Key ID e la Secret Key si ottengono creando un utente IAM nel tuo account S3. Vedi
la nostra guida sopra per informazioni su come creare un utente IAM con le autorizzazioni appropriate.

2. Inserisci un Bucket predefinito

Questo è il bucket predefinito in cui desideri caricare i file. Per creare nuovi bucket o ottenere un elenco dei tuoi bucket correnti, vai alla tua Console S3 (devi aver effettuato l'accesso per accedere alla console). Inserisci qui il nome del bucket che desideri utilizzare come predefinito. Durante il caricamento di file su Amazon S3, avrai la possibilità di selezionare il bucket in cui desideri caricare il file.

Autorizzazioni del bucket

Il tuo bucket dovrebbe avere l'opzione Blocca tutto l'accesso pubblico ATTIVA, al fine di limitare l'accesso non autorizzato ai file. EDD fornirà accesso temporaneo ai file ai clienti.

3. Inserisci un Host Amazon S3 (Facoltativo)

Questo è l'host S3 che il tuo bucket sta utilizzando. La maggior parte delle volte questo campo può essere lasciato vuoto. Tuttavia, se il tuo sito ha problemi ad accedere al tuo bucket, prova a cambiarlo con l'Endpoint per la regione del tuo bucket, per il tuo bucket predefinito.

Puoi trovare la regione del tuo bucket accedendo al tuo account AmazonS3, facendo clic su S3 e quindi guardando la colonna della regione elencata accanto a ciascun bucket. Verrà indicata la regione. Una volta che la conosci, trova l'host corrispondente corretto elencato nella Documentazione sulle regioni di Amazon S3. Copia e incolla quell'host e fai clic su Salva in WordPress.

4. Scadenza del link (Opzionale)

Questo è il numero di minuti per cui l'URL generato dinamicamente è valido. Quando un cliente fa clic su un link di download fornito da Easy Digital Downloads, un nuovo URL per il file su Amazon S3 viene generato al volo. Questo è il numero di minuti per cui il nuovo URL segreto è valido.

Questo completa la configurazione di Amazon S3.

Utilizzo di Amazon S3 con EDD

Caricherai i file in un prodotto scaricabile esattamente nello stesso modo di prima, ma avrai due nuove schede nell'uploader multimediale chiamate Carica su Amazon S3 e Libreria Amazon S3.

Quando carichi un file da questa scheda, verrà automaticamente caricato sul tuo account Amazon S3. Qualsiasi file che carichi su S3 sarà accessibile dalla tua Libreria multimediale di WordPress, proprio come qualsiasi altro file multimediale.

Caricamento su Amazon S3 tramite EDD

Quando carichi un file da questa scheda, verrà automaticamente caricato sul tuo account Amazon S3.

Aggiunta di file già presenti su Amazon S3 a EDD

Qualsiasi file che carichi su S3 sarà accessibile dalla tua Libreria multimediale di WordPress, proprio come qualsiasi altro file multimediale, tramite la Libreria Amazon S3 nell'uploader multimediale.

In alternativa, puoi aggiungere i file manualmente all'URL del file:

Forzare il download dei file

A volte il tuo browser web tenterà di visualizzare o riprodurre qualsiasi file tu stia scaricando, e potresti finire per riprodurre musica o video all'interno del tuo browser, invece di salvarlo. Ci sono una varietà di cose che possono essere fatte per prevenire ciò e forzare l'opzione di salvataggio, ma se stai archiviando i tuoi file su Amazon S3, allora qualsiasi impostazione sul tuo server web viene ignorata.

Invece di fare affidamento sulle impostazioni del tuo server web, devi configurare correttamente le opzioni in S3. Ecco come dovrebbero essere impostate.

Nota: questa impostazione viene applicata a un file e/o cartella, ma non all'intero bucket

Apertura delle proprietà

1. Nel tuo bucket S3 trova il file con cui desideri lavorare e selezionalo.
2. Fai clic su Azioni >  Cambia metadati. 
   
3. Fai clic su Aggiungi metadati e imposta il Tipo su Definito dal sistema, la Chiave su Content-Disposition e il Valore su attachment e Salva modifiche.
   

Ciò forzerà il download anziché la riproduzione o la visualizzazione nel browser.

Problemi e domande comuni:

I file si aprono nel browser invece di essere scaricati

Questo problema può essere risolto forzando il download dei file.

I clienti potranno vedere l'URL effettivo del file e scaricarlo direttamente?

No, il cliente vedrà un URL che punta al tuo negozio, dove EDD tradurrà la posizione in modo che il download funzioni senza che il cliente veda l'URL sorgente originale di Amazon.

Errore: problema certificato SSL: impossibile ottenere il certificato dell'emittente locale

Questo errore indica che il certificato SSL sul server del tuo sito web non è valido o è installato in modo errato. Per risolvere, contatta la tua società di hosting e chiedi loro di verificare che il certificato sia installato correttamente e sia valido.

Errore:Accesso negato

Questo errore indica che l'ID chiave di accesso e la chiave segreta che stai utilizzando non dispongono delle autorizzazioni necessarie per accedere ai bucket e alle risorse S3.

Per risolvere questo problema, dovrai allegare una nuova policy di autorizzazioni all'utente IAM. Consulta la nostra
guida alla creazione di un utente IAM con le autorizzazioni appropriate per risolvere questo errore.

Potresti anche visualizzare questo messaggio di errore se hai copiato l'URL da Amazon S3 e incollato nel campo URL del file del tuo Download. Si prega di consultare la nota sopra riguardo ai passaggi corretti che devono essere eseguiti per collegare i tuoi file ai tuoi Download.

Errore:RequestTimeTooSkewed

Questo errore si verifica a causa di una errata configurazione delle impostazioni del fuso orario del tuo server web. Per risolverlo, contatta la tua società di hosting e chiedi loro di riconfigurare correttamente le impostazioni del fuso orario.

Errore:SignatureDoesNotMatch

Se ricevi questo errore, seguito da un messaggio di errore che dice
La firma della richiesta che abbiamo calcolato non corrisponde alla firma che hai fornito, è probabile che il nome del tuo bucket contenga lettere maiuscole o spazi. Per risolvere il problema, rinomina il tuo bucket in modo che non contenga lettere maiuscole. Puoi anche creare un nuovo bucket senza lettere maiuscole nel nome per risolverlo.

Errore: NoSuchKey La chiave specificata non esiste

Questo errore si verifica quando c'è un problema con il modo in cui il file, o anche il bucket, è denominato. La punteggiatura e i caratteri speciali dovrebbero essere rimossi.

Ad esempio: Se hai un file chiamato test-file-one.mp4.zip cambialo in testfileone.zip

Altri errori o problemi durante il caricamento di file su Amazon S3

Se hai problemi a caricare file su Amazon S3 o ad accedere a file esistenti su Amazon S3, consulta i passaggi seguenti per risolvere il problema.

1. Controlla le impostazioni dell'host Amazon S3 in Download → Impostazioni → Estensioni → Amazon S3. Assicurati che il tuo host sia configurato correttamente, verificando anche di aver impostato la regione corretta (leggi il punto sull'host Amazon S3 sopra per vedere come fare).
2. Assicurati che il nome del file sia entro il limite massimo di 1024 caratteri. Puoi trovare maggiori informazioni nella documentazione di Amazon su come formattare correttamente i nomi dei file.
3. Se sei passato di recente a un nuovo account Amazon S3 e hai problemi a caricare file nei tuoi bucket, questo è tipicamente un problema temporaneo che può verificarsi poco dopo la creazione di nuovi bucket o account. Dovrebbe risolversi automaticamente dopo alcune ore. Consulta la documentazione di Amazon per maggiori informazioni.
4. Ancora nessun risultato? Contatta il supporto e includi il messaggio di errore esatto o il comportamento che stai riscontrando.

Aggiornamenti della licenza software non riusciti a causa di Download fallito. Errore cURL 8: Invalid Content-Length: value

È possibile che l'estensione Amazon S3 non stia forzando il reindirizzamento per i download. Se vedi questo errore, prova a
impostare il Metodo di Download su Forzato.

Il cliente vede Aggiornamento fallito: Download fallito. Errore interno del server quando tenta di aggiornare un plugin

Conferma che il file sorgente da utilizzare per gli aggiornamenti automatici sia selezionato nelle impostazioni di licenza del Download.

Probabilmente vedrai il seguente errore fatale PHP nel file di log degli errori PHP dello store:

PHP Fatal error:  Uncaught InvalidArgumentException: Found 2 errors while validating the input provided for the GetObject operation:
[Key] is missing and is a required parameter
[Key] expected string length to be >= 1, but found string length of 0 in /home/ph198/public_html/wp-content/plugins/edd-amazon-s3/vendor/aws/aws-sdk-php/src/Api/Validator.php:65