Armazenar URLs

Cada site em uma instalação Adobe Commerce ou 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 seguros começam com https.

  • URL basehttp://www.yourdomain.com/magento/
  • URL de base segurahttps://www.yourdomain.com/magento/
  • URL com endereço IPhttp://###.###.###.###/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 o URL do administrador, consulte Usar um URL de administração personalizado.

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 para HTTPS URLs a serem usados 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 de 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 seu domínio, você poderá configurar um ou ambos os URLs básicos para operar com SSL (Secure Sockets Layer) criptografado e Segurança da camada de transporte protocolo TLS.

IMPORTANT
A Adobe recomenda que todas as páginas de um site de produção sejam transmitidas, 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 fornecer todas as páginas HTTPS por padrão. Se o armazenamento está funcionando com o protocolo padrão, você pode melhorar a segurança ativando Segurança de Transporte Restrita HTTP (HSTS) e atualização de qualquer solicitação de página não segura. HSTS é um protocolo de aceitação que impede os navegadores de renderizarem o padrão HTTP páginas que são transmitidas com protocolo não seguro para o domínio especificado. Porque os mecanismos de pesquisa podem já ter indexado cada página da loja com o padrão HTTP você pode configurar o Commerce para atualizar qualquer solicitação de página não segura para o HTTPS automaticamente, para que você não perca tráfego. Quando o Commerce é configurado para usar URLs seguros para a loja e o Administrador, dois campos adicionais são exibidos para permitir a ativação HSTS.

Configurar o URL de base

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

  2. Em Geral no painel esquerdo, escolha Web.

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

    • Base URL — Digite o URL de base totalmente qualificado da 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 note
      NOTE
      Não altere o espaço reservado no Base Link URL ​campo. É 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 o URL base para arquivos de visualizaçã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 o URL de 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 da Web {width="600" modal="regular"}

    note note
    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. Expandir Seletor de expansão o Base URLs (Secure) e faça o seguinte:

    Configuração geral - URLs de base seguros {width="600" modal="regular"}

    • Secure Base URL — Digite 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 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 o URL de base seguro para arquivos de visualizaçã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 o URL de base seguro para 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 quiser que o armazenamento exiba somente 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 servidor.

    A maioria das instalações do Commerce usa o padrão X-Forward-Proto 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 variável Adicionar código da loja aos URLs está definida como Yes, você deve incluir códigos de loja nos 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 "Página 404 Não Encontrada" erros.
  1. No Admin barra lateral, vá para Stores > Settings>Configuration.

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

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

  4. Definir 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 {width="600" modal="regular"}

  5. Quando terminar, clique em Save Config.

  6. Clique em 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 o URL inseguro (http://), faça o seguinte:

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

Usar um URL de administração personalizado

Como um prática recomendada de segurança, o Adobe recomenda que você use um URL de administrador exclusivo em vez do padrão administrador ou um termo comum, como back-end. 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 do administrador padrão: 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 o URL do administrador seguindo o instruções no Guia da infraestrutura do Adobe Commerce na nuvem.

Método 1: alterar do Administrador

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

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

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

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

    Configuração avançada - URL de base do administrador {width="600" modal="regular"}

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

    • Definir Use Custom Admin URL para Yes.

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

      note note
      NOTE
      O URL do administrador deve estar na mesma instalação do Commerce e ter a mesma raiz do documento que a loja.
    • Definir Custom Admin Path para Yes.

    • Para Custom Admin Path, insira o caminho a ser usado como o nome da pasta de administrador 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 app/etc/env.php em um editor de texto e altere o valor de frontName parâmetro do backend seção. Em seguida, salve o arquivo.

    Use somente caracteres minúsculos.

    note note
    NOTE
    Esse método permite alterar o Caminho do administrador, mas não o URL do administrador.
    note tip
    TIP
    Para o Adobe Commerce na infraestrutura em nuvem, é possível configurar um caminho de administrador personalizado usando o ADMIN_URL na interface do usuário da nuvem. Consulte a Tópico de variáveis de administrador no Guia do Commerce na infraestrutura em nuvem.
    • Caminho do administrador padrão

      code language-php?start_inline=1
      'backend' => [
       'frontName' => 'admin'
      ],
      
    • Novo Caminho do Administrador

      code language-php?start_inline=1
      'backend' => [
          'frontName' => 'backend'
      ],
      
  2. Use um dos seguintes métodos para limpar o cache:

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

    • No servidor, execute o seguinte:

      code language-terminal
      php bin/magento cache:flush
      
    note note
    NOTE
    As alterações efetuadas utilizando o método 1 têm prioridade sobre as alterações app/etc/env.php arquivo.

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

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

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

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

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:

    code language-terminal
    php bin/magento config:set admin/url/use_custom 0
    
  2. Para reverter para o Caminho do administrador padrão (definido na variável app/etc/env.php conforme descrito no Método 2), execute este comando :

    code language-terminal
    php bin/magento config:set admin/url/use_custom_path 0
    
  3. Use um dos seguintes métodos para limpar o cache:

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

    • No servidor, execute o seguinte:

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