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
-
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.
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
-
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
-
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
- 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
-
Defina as opções de configuração para o URL personalizado:
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
-