Armazenar URLs
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/ouhttps://###.###.###.###/magento/
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.
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
-
Na barra lateral Admin, vá para Stores > Settings>Configuration.
-
Em Geral, no painel esquerdo, escolha Web.
-
Expandir
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 note 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.
{width="600" modal="regular"}
note note NOTE Os espaços reservados entre chaves duplas são tags de marcação para variáveis. -
-
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).
-
Expanda
a seção Base URLs (Secure) e faça o seguinte:
{width="600" modal="regular"}
-
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}}
-
-
Para melhorar a segurança, defina as duas opções a seguir como
Yes.- Use Secure URLs on Storefront
- Use Secure URLs in Admin
-
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.
-
-
Defina o Offloader Header para o seu servidor.
A maioria das instalações do Commerce usa o
X-Forward-Protopadrão para identificar o protocolo comoHTTPouHTTPS. Se a configuração do servidor usar um offloader_header diferente, insira-o aqui. -
Quando terminar, clique em Save Config.
Incluir o código de armazenamento em URLs
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".-
Na barra lateral Admin, vá para Stores > Settings>Configuration.
-
Em General, no painel esquerdo, escolha Web.
-
Expandir
a seção URL Options.
-
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
{width="600" modal="regular"}
- URL with Store Code:
-
Quando terminar, clique em Save Config.
-
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.
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.
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.
Método 1: alterar do Administrador
-
Na barra lateral Admin, vá para Stores > Settings>Configuration.
-
No painel esquerdo, expanda Advanced e escolha Admin.
-
Expandir
a seção Admin Base URL.
-
Defina as opções de configuração para o URL personalizado:
{width="600" modal="regular"}
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 note 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
-
-
Quando terminar, clique em Save Config.
-
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
-
Abra o arquivo
app/etc/env.phpem um editor de texto e altere o valor do parâmetrofrontNameda seçãobackend. 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, você pode configurar um caminho de administrador personalizado usando a variável ADMIN_URLna 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
code language-php?start_inline=1 'backend' => [ 'frontName' => 'admin' ], -
Novo Caminho do Administrador
code language-php?start_inline=1 'backend' => [ 'frontName' => 'backend' ],
-
-
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:
code language-bash php bin/magento cache:flush
note note 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.
-
Para reverter para o URL padrão do Administrador, execute este comando:
code language-bash php bin/magento config:set admin/url/use_custom 0 -
Para reverter para o Caminho do Administrador padrão (definido em
app/etc/env.php, conforme descrito no Método 2), execute este comando:code language-bash php bin/magento config:set admin/url/use_custom_path 0 -
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:
code language-bash php bin/magento cache:flush
-