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 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 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 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 sobre 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-Proto
padrão para identificar o protocolo comoHTTP
ouHTTPS
. 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, o 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.php
em um editor de texto e altere o valor do parâmetrofrontName
da 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_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
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
-