Amazon S3

A extensão Amazon S3 para Easy Digital Downloads permite que você hospede arquivos de download em sua conta Amazon S3. Isso é seguro e mais confiável do que armazenar os arquivos em sua própria conta de hospedagem.

Neste Artigo

Criando uma conta IAM
Chaves de acesso IAM
Configuração
Usando Amazon S3 Com EDD
Forçando o Download de Arquivos
Problemas e Perguntas Comuns

Criando uma conta IAM

Para que o Easy Digital Downloads se conecte à sua conta Amazon S3, você precisará criar um usuário IAM e anexar uma política de permissões a esse usuário. Você pode clicar em Mostrar Credenciais de Segurança do Usuário para ver a chave de acesso e a chave secreta. Estes são os valores que você precisa inserir em seu site WordPress em Downloads → Configurações → Extensões → Amazon S3.

1. Faça login na sua conta Amazon S3

Faça login na sua conta Amazon S3 e navegue até a página de Usuários. Esta página pode ser encontrada clicando no nome da sua conta no canto superior direito e clicando em Credenciais de Segurança > Usuários (Em Gerenciamento de Acesso no lado esquerdo da página).

2. Configurar Usuário IAM

A. Adicionar Usuário

Se você tem um usuário IAM existente que deseja usar, clique nesse usuário. Se precisar criar um novo usuário, clique no botão azul Criar Usuário e siga as instruções. Agora você precisa obter credenciais de segurança e também anexar uma política de permissões ao usuário.

B. Definir detalhes do usuário:

Nome de usuário: Crie um nome de usuário de sua escolha e clique em Avançar.

C. Definir permissões

1. Selecione a caixa “Anexar políticas diretamente”.
2. Em seguida, na caixa Filtrar , digite “S3full”. Isso filtrará os resultados para aqueles que são relevantes para o Amazon S3.
3. Marque a caixa para AmazonS3FullAccess.
4. Ignore a seção “Definir limite de permissões – opcional”.
5. Clique em Avançar.

D. Revisar e criar

Confirme se suas permissões correspondem às instruções acima. Caso contrário, não há nada para configurar aqui, clique em Criar usuário.

3. Obter Chaves de Acesso

Você precisará de uma conta IAM usando as permissões nas etapas acima. Se você criou uma conta IAM no passado com as permissões AmazonS3FullAccess, pode usar a conta existente.

A. Clique no nome do usuário IAM criado acima, listado em sua página de Usuários da AWS.

B. Clique na aba Credenciais de Segurança e clique em Criar Chave de Acesso.

C. Selecione Serviço de terceiros e Marque Confirmar.

D. Clique em Criar chave de acesso. Nenhuma tag de descrição é necessária.

E. Salve a Chave de acesso & Chave de acesso secreta.

Observação: Você não poderá acessar a chave secreta novamente para este usuário, portanto, certifique-se de salvar o arquivo. Se você perder as credenciais, precisará criar uma nova chave de acesso.

Seu usuário IAM agora deve ter permissão total para acessar e fazer upload de arquivos para o bucket S3. Isso fornece à sua loja EDD acesso aos seus arquivos e a capacidade de criar links de download seguros para os clientes.

F. Adicione a Chave de acesso e a Chave de acesso secreta às configurações Amazon S3 da sua loja EDD em Downloads → Configurações → Extensões → Amazon S3.

Se precisar de mais ajuda para criar usuários IAM ou anexar políticas, consulte o guia da Amazon sobre como criar usuários IAM para mais informações.

Limitar Acesso a Buckets Específicos

Se sua conta S3 for usada para outros fins e você quiser limitar sua conta IAM (Loja EDD) a buckets específicos, você pode criar uma política personalizada em vez de AmazonS3FullAccess. Isso é feito em vez da Etapa 3 da seção Definir Permissões.

Clique em "Anexar políticas existentes diretamente" e selecione "Criar Política":

Adicione os detalhes da política abaixo por meio do editor JSON. Atualize bucket-name-here com o(s) nome(s) dos buckets que você deseja que sejam acessíveis através da sua loja EDD.

{
    "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": "*"
        }
    ]
}

Ao usar esta política, todos os nomes de Bucket serão visualizáveis, mas apenas aqueles que você colocar na seção Recursos serão acessíveis. Se um bucket que não está incluído na lista de Recursos for acessado via EDD, ocorrerá um erro PHP. Esperamos melhorar isso em uma versão futura.

Configuração

Assim que a extensão for instalada e ativada, você poderá navegar para Downloads → Configurações → Extensões → Amazon S3 e inserir as informações da sua conta Amazon S3.

1. Insira o ID da Chave de Acesso e a Chave Secreta

O ID da Chave de Acesso e a Chave Secreta são obtidos criando um usuário IAM em sua conta S3. Veja
nosso guia acima para informações sobre como criar um usuário IAM com as permissões adequadas.

2. Insira um Bucket Padrão

Este é o bucket padrão para o qual você deseja que os arquivos sejam enviados. Para criar novos buckets ou obter uma lista dos seus buckets atuais, vá para o seu Console S3 (você deve estar logado para acessar o console). Insira o nome do bucket que você gostaria de usar como padrão aqui. Ao enviar arquivos para o Amazon S3, você terá a opção de selecionar o bucket para o qual deseja enviar o arquivo.

Permissões do Bucket

Seu bucket deve ter a opção Bloquear todo o acesso público ATIVADA, a fim de restringir o acesso não autorizado a arquivos. O EDD fornecerá acesso temporário a arquivos para os clientes.

3. Insira um Host Amazon S3 (Opcional)

Este é o host S3 que seu bucket está usando. Na maioria das vezes, este campo pode ser deixado em branco. No entanto, se o seu site tiver problemas para acessar seu bucket, tente alterá-lo para o Endpoint da região do seu bucket, para o seu bucket padrão.

Você pode encontrar a região do seu bucket fazendo login na sua conta AmazonS3, clicando em S3 e, em seguida, olhando a coluna de região listada ao lado de cada bucket. Ela indicará qual é a região. Assim que souber, encontre o host correspondente correto listado na Documentação de Regiões da Amazon S3. Copie e cole esse host e clique em salvar no seu WordPress.

4. Tempo de Expiração do Link (Opcional)

Este é o número de minutos que o URL gerado dinamicamente é válido. Quando um cliente clica em um link de download entregue pelo Easy Digital Downloads, um novo URL para o arquivo no Amazon S3 é gerado na hora. Este é o número de minutos que o novo URL secreto é válido.

Isso completa a configuração do Amazon S3.

Usando Amazon S3 com EDD

Você fará upload de arquivos para um produto para download exatamente da mesma forma que antes, mas terá duas novas abas no uploader de mídia chamadas Upload para Amazon S3 e Biblioteca Amazon S3.

Quando você carrega um arquivo desta aba, ele será automaticamente carregado para sua conta Amazon S3. Qualquer arquivo que você carregar para o S3 será acessível a partir da sua Biblioteca de Mídia do WordPress, assim como qualquer outro arquivo de mídia.

Enviando para Amazon S3 via EDD

Quando você carrega um arquivo desta aba, ele será automaticamente carregado para sua conta Amazon S3.

Adicionando arquivos já no Amazon S3 ao EDD

Qualquer arquivo que você carregar para o S3 será acessível a partir da sua Biblioteca de Mídia do WordPress, assim como qualquer outro arquivo de mídia, através da Biblioteca Amazon S3 no uploader de mídia.

Alternativamente, você pode adicionar arquivos ao URL do Arquivo manualmente:

Forçando o Download de Arquivos

Às vezes, seu navegador da web tentará exibir ou reproduzir qualquer arquivo que você esteja baixando, e você pode acabar reproduzindo música ou vídeo dentro do seu navegador, em vez de salvá-lo. Existem várias coisas que podem ser feitas para evitar isso e forçar a opção de salvar, mas se você estiver armazenando seus arquivos no Amazon S3, então quaisquer configurações em seu servidor web são ignoradas.

Em vez de confiar nas configurações do seu servidor web, você deve configurar as opções corretamente no S3. Veja como elas devem ser definidas.

Nota: Esta configuração é aplicada a um arquivo e/ou pasta, mas não ao bucket inteiro

Abrindo Propriedades

1. No seu Bucket S3, encontre o arquivo com o qual deseja trabalhar e selecione-o.
2. Clique em Ações >  Alterar metadados. 
   
3. Clique em Adicionar Metadados e defina o Tipo como Definido pelo Sistema, Chave como Content-Disposition e defina o Valor como attachment e Salvar alterações.
   

Isso forçará o download em vez de reproduzir ou exibir no seu navegador.

Problemas e Perguntas Comuns:

Arquivos abrem no navegador em vez de baixar

Isso pode ser resolvido Forçando Downloads de Arquivos.

Os clientes poderão ver o URL real do arquivo e simplesmente baixá-lo diretamente?

Não, o cliente verá um URL que leva à sua própria loja, onde o EDD traduzirá a localização para que o download funcione sem que o cliente veja o URL de origem da Amazon.

Erro: problema de certificado SSL: impossível obter certificado de emissor local

Este erro significa que o certificado SSL no servidor do seu site é inválido ou está instalado incorretamente. Para resolver isso, entre em contato com sua empresa de hospedagem e solicite que eles verifiquem se o certificado está instalado corretamente e é válido.

Erro:Acesso Negado

Este erro significa que o ID da chave de acesso e a chave secreta que você está usando não têm as permissões necessárias para acessar os buckets e recursos do S3.

Para resolver isso, você precisará anexar uma nova política de permissões ao usuário IAM. Consulte nosso
guia sobre como criar um usuário IAM com as permissões adequadas para resolver este erro.

Você também pode ver esta mensagem de erro se copiou o URL da Amazon S3 e o colou no campo URL do Arquivo do seu Download. Por favor, consulte a nota acima sobre os passos corretos que precisam ser tomados para vincular seus arquivos aos seus Downloads.

Erro:RequestTimeTooSkewed

Este erro ocorre devido a uma configuração incorreta das configurações de fuso horário do seu servidor web. Para resolvê-lo, entre em contato com sua empresa de hospedagem e peça que eles reconfigurem as configurações de fuso horário corretamente.

Erro:SignatureDoesNotMatch

Se você receber este erro, seguido por uma mensagem de erro que diz
A assinatura da solicitação que calculamos não corresponde à assinatura que você forneceu, provavelmente significa que o nome do seu bucket contém letras maiúsculas ou espaços. Para resolver o problema, renomeie seu bucket para que ele não contenha letras maiúsculas. Você também pode criar um novo bucket sem letras maiúsculas no nome para resolvê-lo.

Erro: NoSuchKey A chave especificada não existe

Este erro ocorre quando há um problema com a forma como o arquivo, ou até mesmo o bucket, é nomeado. Toda pontuação e caracteres especiais devem ser removidos.

Por exemplo: Se você tem um arquivo chamado test-file-one.mp4.zip mude para testfileone.zip

Outros erros ou problemas ao carregar arquivos para a Amazon S3

Se você tiver problemas para carregar arquivos para a Amazon S3 ou acessar arquivos existentes na Amazon S3, consulte os passos abaixo para resolver o problema.

1. Verifique as configurações do seu Host Amazon S3 em Downloads → Configurações → Extensões → Amazon S3. Certifique-se de que seu host esteja configurado corretamente, incluindo a verificação de que você configurou a região correta (leia o ponto sobre Host Amazon S3 acima para ver como fazer isso).
2. Certifique-se de que o nome do arquivo esteja dentro do limite máximo de 1024 caracteres. Você pode encontrar mais informações na documentação da Amazon sobre como formatar corretamente seus nomes de arquivo.
3. Se você mudou recentemente para uma nova conta Amazon S3 e está tendo problemas para fazer upload de arquivos para seus buckets, este é geralmente um problema temporário que pode ocorrer logo após a criação de novos buckets ou contas. Ele deve se resolver automaticamente após algumas horas. Consulte a documentação da Amazon para mais informações sobre isso.
4. Ainda sem sucesso? Entre em contato com o suporte e inclua a mensagem de erro exata ou o comportamento que você está experimentando.

Atualizações de Licença de Software falhando devido a Download falhou. Erro cURL 8: Invalid Content-Length: value

É possível que a extensão Amazon S3 não esteja forçando o redirecionamento para downloads. Se você vir este erro, tente
definir o Método de Download como Forçado.

Cliente vê Falha na atualização: Download falhou. Erro interno do servidor ao tentar atualizar um plugin

Confirme se o arquivo de origem a ser usado para atualizações automáticas está selecionado nas configurações de licenciamento do Download.

Você provavelmente verá o seguinte erro fatal do PHP no arquivo de log de erros PHP da loja:

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