DocumentaçãoCommerceLojas e experiência de compra

Somente PaaS

Armazenar URLs

Última atualização: 5 de maio de 2025
  • Tópicos:

Criado para:

  • Iniciante
  • Intermediário
  • Administrador
  • Usuário

Cada site em uma instalação do Adobe Commerce ou do Magento Open Source tem um URL base atribuído à loja e outro URL atribuído ao administrador. O Adobe usa variáveis para definir links internos em relação ao URL base, o que permite mover toda uma loja de um local para outro sem atualizar os links. URLs base padrão começam com http e URLs base seguras começam com https.

  • URL Base — http://www.yourdomain.com/magento/
  • URL de Base Segura — https://www.yourdomain.com/magento/
  • URL com endereço IP — http://###.###.###.###/magento/ ou https://###.###.###.###/magento/
IMPORTANT
Não altere o URL de administração da configuração de URL base padrão. Para alterar o caminho ou a URL do Administrador, consulte Usar uma URL de Administrador personalizada.

Usar um protocolo seguro

Os URLs de base da sua loja foram inicialmente configurados durante a instalação do Adobe Commerce. Se um certificado de segurança estava disponível no momento, você poderia especificar HTTPS URLs para serem usadas para o armazenamento, Admin ou ambos. Se a instalação do Adobe Commerce incluir várias lojas ou se você planejar adicionar mais lojas posteriormente, poderá incluir o código da loja no URL. Todos os recursos e operações do Adobe podem ser usados com protocolo seguro.

Se um certificado de segurança não estava disponível para o domínio no momento da instalação, atualize a configuração antes de iniciar o armazenamento. Depois que um certificado de segurança for estabelecido para o seu domínio, você poderá configurar uma ou ambas as URLs de base para operar com o protocolo SSL e o protocolo TLS Transport Layer Security.

IMPORTANT
A Adobe recomenda transmitir todas as páginas de um site de produção, incluindo páginas de conteúdo e de produtos, usando um protocolo seguro.

O Adobe Commerce e o Magento Open Source podem ser configurados para entregar todas as páginas em HTTPS por padrão. Se o armazenamento estiver funcionando com o protocolo padrão, você poderá melhorar a segurança habilitando o HTTP Strict Transport Security (HSTS) e atualizando todas as solicitações de página não seguras. HSTS é um protocolo de aceitação que impede que os navegadores renderizem páginas HTTP padrão que são transmitidas com protocolo não seguro para o domínio especificado. Como os mecanismos de pesquisa podem já ter indexado cada página do seu armazenamento com URLs HTTP padrão, você pode configurar o Commerce para atualizar automaticamente todas as solicitações de página não seguras para HTTPS, de modo que não perca tráfego. Quando o Commerce é configurado para usar URLs seguras para a loja e o Administrador, dois campos adicionais são exibidos para permitir que você habilite o HSTS.

Configurar o URL de base

  1. Na barra lateral Admin, vá para Stores > Settings>Configuration.

  2. Em Geral, no painel esquerdo, escolha Web.

  3. Expandir Seletor de expansão a seção Base URL.

    • Base URL — Insira a URL de base totalmente qualificada para sua loja. Certifique-se de finalizar o URL com uma barra, para que ele possa ser estendido com Chaves de URL adicionais de sua loja. Por exemplo: http://yourdomain.com/

      NOTE
      Não altere o espaço reservado no campo Base Link URL. É um espaço reservado usado para criar links relativos ao URL de base.

    • Base URL for Static View Files — (Opcional) Especifique um local alternativo para a URL base dos arquivos de exibição estáticos inserindo o caminho que começa com o seguinte espaço reservado:

      {{unsecure_base_url}}

    • Base URL for User Media Files — (Opcional) Especifique um local alternativo para a URL base dos arquivos de mídia do usuário inserindo o caminho que começa com o seguinte espaço reservado:

      {{unsecure_base_url}}

      Para uma instalação típica, não há necessidade de atualizar os caminhos para os arquivos de visualização estáticos ou arquivos de mídia, pois eles são relativos ao URL base.

    Configuração geral - URLs de base Web

    NOTE
    Os espaços reservados entre chaves duplas são tags de marcação para variáveis.

  4. Quando terminar, clique em Save Config.

Configurar o URL básico seguro

Se o domínio tiver um certificado de segurança válido, você poderá configurar os URLs da loja e do administrador para transmitir dados por um canal seguro (https). Sem um certificado de segurança válido, seu armazenamento não pode operar com o protocolo seguro (SSL/TLS).

  1. Expanda Seletor de expansão a seção Base URLs (Secure) e faça o seguinte:

    Configuração geral - URLs de base segura

    • Secure Base URL — Insira o URL base seguro completo, seguido por uma barra. Por exemplo: https://yourdomain.com/

    • Secure Base Link URL — Não altere o espaço reservado no campo de URL do link base seguro. É usado para criar links relativos ao URL base seguro.

    • Secure Base URL for Static View Files — (Opcional) Especifique um local alternativo para a URL base segura para arquivos de exibição estáticos inserindo o caminho que começa com o seguinte espaço reservado:

      {{secure_base_url}}

    • Secure Base URL for User Media Files — (Opcional) Especifique um local alternativo para a URL de base segura dos arquivos de mídia do usuário inserindo o caminho que começa com o seguinte espaço reservado:

      {{secure_base_url}}

  2. Para melhorar a segurança, defina as duas opções a seguir como Yes.

    • Use Secure URLs on Storefront
    • Use Secure URLs in Admin

  3. Para Enhanced Security Settings, faça o seguinte:

    • Enable HTTP Strict Transport Security (HSTS) — Se você quiser que seu armazenamento exiba apenas solicitações de página HTTPS seguras, defina como Yes.

    • Upgrade Insecure Requests — Para atualizar qualquer solicitação de páginas HTTP não seguras padrão para proteger HTTPS, defina como Yes.

  4. Defina o Offloader Header para o seu servidor.

    A maioria das instalações do Commerce usa o X-Forward-Proto padrão para identificar o protocolo como HTTP ou HTTPS. Se a configuração do servidor usar um offloader_header diferente, insira-o aqui.

  5. Quando terminar, clique em Save Config.

Incluir o código de armazenamento em URLs

NOTE
Quando a opção Adicionar código de armazenamento a URLs estiver definida como Yes, você deverá incluir códigos de armazenamento nas URLs do navegador. Essa configuração garante que as regravações de URL sejam mapeadas corretamente e que todas as páginas sejam abertas com êxito, sem erros "Página 404 Não Encontrada".

  1. Na barra lateral Admin, vá para Stores > Settings>Configuration.

  2. Em General, no painel esquerdo, escolha Web.

  3. Expandir Seletor de expansão a seção URL Options.

  4. Defina Add Store Code de acordo com sua preferência:

    • URL with Store Code: http://www.yourdomain.com/magento/[store-code]/index.php/url-identifier
    • URL without Store Code: http://www.yourdomain.com/magento/index.php/url-identifier

    Configuração geral - Opções de URL da Web

  5. Quando terminar, clique em Save Config.

  6. Clique no link Cache Management na mensagem, na parte superior do espaço de trabalho. Em seguida, siga as instruções para atualizar o cache.

    Mensagem de gerenciamento de cache

Solução de problemas de URL

Se, após seguir as instruções de configuração, algumas páginas continuarem a ser fornecidas com a URL insegura (http://), faça o seguinte:

  • Altere o URL de base (não seguro) para o URL HTTPS seguro.
  • No servidor, edite o arquivo .htaccess (ou balanceador de carga) para que a URL não segura seja redirecionada para a URL segura.

Usar um URL de administração personalizado

Como uma prática recomendada de segurança, a Adobe recomenda que você use uma URL de Administrador exclusiva em vez do admin padrão ou um termo comum, como backend. Embora não proteja diretamente o site contra um determinado mau ator, pode reduzir a exposição a scripts que tentam obter acesso não autorizado.

NOTE
Verifique com seu provedor de hospedagem antes de implementar um URL de administrador personalizado. Alguns provedores de hospedagem exigem um URL padrão para atender às regras de proteção por firewall.

Em uma instalação típica, o URL e o caminho do administrador seguem imediatamente o URL de base. O caminho do Administrador é um diretório abaixo da raiz.

  • URL Base Padrão: http://yourdomain.com/magento/
  • Caminho Padrão do Administrador: admin
  • URL e Caminho Padrão do Administrador: http://yourdomain.com/magento/admin

Embora seja possível alterar o URL do administrador e o caminho para outro local, qualquer erro remove o acesso ao administrador e deve ser corrigido do servidor.

NOTE
Como precaução, não tente alterar o URL do administrador sozinho, a menos que você saiba como editar arquivos de configuração no servidor. Para projetos do Adobe Commerce implantados na infraestrutura em nuvem, altere a URL do Administrador seguindo as instruções no Guia do Adobe Commerce na Infraestrutura em Nuvem.

Método 1: alterar do Administrador

  1. Na barra lateral Admin, vá para Stores > Settings>Configuration.

  2. No painel esquerdo, expanda Advanced e escolha Admin.

  3. Expandir Seletor de expansão a seção Admin Base URL.

  4. Defina as opções de configuração para o URL personalizado:

    Configuração avançada - URL de base do administrador

    Se necessário, desmarque a caixa de seleção Use system value para alterar a configuração.

    • Defina Use Custom Admin URL como Yes.

    • Digite o Custom Admin URL: http://yourdomain.com/magento/

      NOTE
      O URL do administrador deve estar na mesma instalação do Commerce e ter a mesma raiz do documento que a loja.

    • Defina Custom Admin Path como Yes.

    • Para Custom Admin Path, insira o caminho a ser usado como o nome da pasta de administração personalizada.

      Exemplo: sample_custom_admin

  5. Quando terminar, clique em Save Config.

  6. Depois que as alterações forem salvas, saia do Administrador e faça logon novamente usando o novo URL e caminho do Administrador.

Método 2: alterar o caminho Admin a partir da linha de comando do servidor

  1. Abra o arquivo app/etc/env.php em um editor de texto e altere o valor do parâmetro frontName da seção backend. Em seguida, salve o arquivo.

    Use somente caracteres minúsculos.

    NOTE
    Esse método permite alterar o Caminho do administrador, mas não o URL do administrador.
    TIP
    Para o Adobe Commerce na infraestrutura em nuvem, você pode configurar um caminho de administrador personalizado usando a variável ADMIN_URL na interface de usuário da nuvem. Consulte o tópico sobre variáveis de administrador no Guia do Commerce na Infraestrutura da Nuvem.

    • Caminho Padrão do Administrador

      'backend' => [
 'frontName' => 'admin'
],

    • Novo Caminho do Administrador

      'backend' => [
    'frontName' => 'backend'
],

  2. Use um dos seguintes métodos para limpar o cache:

    • Na barra lateral Admin, vá para System > Tools>Cache Management. Em seguida, clique em Flush Magento Cache.

    • No servidor, execute o seguinte:

      php bin/magento cache:flush
    NOTE
    As alterações feitas usando o Método 1 têm prioridade sobre as alterações feitas no arquivo app/etc/env.php.

Método 3: alterar o caminho do administrador usando a CLI do Commerce

Você pode usar o comando setup:config:set da CLI para alterar o Caminho do Administrador. O exemplo a seguir usa a opção --backend-frontname para alterar o caminho da raiz do Commerce para um novo caminho de Administrador:

bin/magento setup:config:set --backend-frontname="backend_front_name"

Este comando atualiza a opção de configuração backend > frontName no arquivo app/etc/env.php.

Restaurar o URL e o caminho do administrador padrão

Caso tenha definido um URL de administrador inválido ou um Caminho do administrador e tenha perdido o acesso ao back-end, há uma maneira de corrigi-lo na linha de comando.

  1. Para reverter para o URL padrão do Administrador, execute este comando:

    php bin/magento config:set admin/url/use_custom 0

  2. Para reverter para o Caminho do Administrador padrão (definido em app/etc/env.php, conforme descrito no Método 2), execute este comando:

    php bin/magento config:set admin/url/use_custom_path 0

  3. Use um dos seguintes métodos para limpar o cache:

    • Na barra lateral Admin, vá para System > Tools>Cache Management. Em seguida, clique em Flush Magento Cache.

    • No servidor, execute o seguinte:

      php bin/magento cache:flush
recommendation-more-help
dacea746-44a9-4368-b3fb-3bcff64c6be1