Login
Login
Atualizado em 18 de February de 2026

Ao usar arquivos de buckets S3 em recursos externos, como um site, você pode encontrar um erro de CORS (Cross-Origin Resource Sharing). Esse erro ocorre quando o navegador bloqueia requisições entre origens diferentes para os recursos do seu bucket.

Para resolver esse problema, é necessário configurar regras específicas de CORS para o bucket, permitindo requisições de outras origens. Você pode configurar o CORS no painel de controle da Hostman ou via AWS CLI.

Configurar no Painel de Controle

  1. Vá até a seção Armazenamento S3 e clique no bucket desejado.

  2. Na aba Configurações, clique em Alterar ao lado do parâmetro CORS.

6aea3616 9274 4d94 A4ab 6f6bd28d0135

  1. Preencha os parâmetros necessários para a regra de CORS:

    • Allowed Origins: Especifica as origens de onde as requisições para o bucket são permitidas. Exemplo: https://example.com. Você pode usar * para permitir requisições de todos os domínios.
    • Allowed Methods: Define os métodos HTTP permitidos para requisições CORS.
    • Allowed Headers: Especifica os cabeçalhos permitidos nas requisições. Exemplo: Authorization, Content-Type. Você pode usar * para permitir todos os cabeçalhos.
    • Expose Headers: Lista de cabeçalhos que estarão acessíveis ao cliente na resposta. Por padrão, o acesso a alguns cabeçalhos é bloqueado pelo navegador. Exemplo: ETag, x-amz-meta-custom-header.
    • Max Age Seconds: Define o tempo, em segundos, em que os resultados das requisições CORS podem ser armazenados em cache pelo cliente. Exemplo: 3600 (1 hora).

Você pode criar múltiplas regras (por exemplo, permitir métodos diferentes para origens diferentes) clicando em Adicionar regra.

655cde73 7f4b 435e A03e 1321e29a9a3b

  1. Salve as alterações clicando em Salvar.

Configurar via AWS CLI

Veja como configurar CORS para um bucket S3 usando a ferramenta AWS CLI.

Criar um arquivo de regras CORS

Primeiro, crie um arquivo cors.json com a configuração de CORS desejada. Este arquivo permitirá requisições GET e HEAD aos objetos do bucket. Exemplo:

{
  "CORSRules": [
    {
      "AllowedHeaders": ["*"],
      "AllowedMethods": ["GET", "HEAD"],
      "AllowedOrigins": ["*"]
    }
  ]
}
  • AllowedMethods: Especifica os métodos HTTP permitidos. Neste exemplo, GET e HEAD estão autorizados.

  • AllowedOrigins: * significa que requisições são permitidas de qualquer domínio. Para restringir o acesso a um domínio específico, substitua o asterisco pelo nome do domínio. Por exemplo, se seu site estiver hospedado em https://example.com, substitua a linha por:

"AllowedOrigins": ["https://example.com"]

Enviar regras CORS para o bucket

Após criar o arquivo de regras CORS, envie-o para o bucket usando o comando:

aws s3api put-bucket-cors --bucket <bucket_name> --endpoint-url https://s3.hmstorage.net --cors-configuration file://cors.json

Substitua <bucket_name> pelo nome do seu bucket.

Verificar regras CORS

Para confirmar que as regras CORS foram aplicadas corretamente, use o comando:

aws s3api get-bucket-cors --bucket <bucket_name> --endpoint-url https://s3.hmstorage.net

Excluir regras CORS

Se for necessário remover as regras atuais, execute o comando:

aws s3api delete-bucket-cors --bucket <bucket_name> --endpoint-url https://s3.hmstorage.net

Este comando excluirá todas as regras CORS existentes para o bucket.

Esta página foi útil?
Atualizado em 18 de February de 2026

Tem perguntas,
comentários ou preocupações?

Nossos profissionais estão disponíveis para ajudá-lo a qualquer momento,
seja para assistência ou apenas se você não souber por onde começar.
Envie-nos um e-mail
Hostman's Support