{"section":"tutorials","requestedLocale":"pt","requestedSlug":"configurar-login-persistente-para-clientes","locale":"pt","slug":"configurar-login-persistente-para-clientes","path":"docs/pt/tutorials/autenticação/conceitos-básicos-de-autenticação/configurar-login-persistente-para-clientes.md","branch":"main","content":"O login persistente permite manter o cliente autenticado na sua loja virtual por mais tempo, sem exigir um novo login a cada 24 horas. Ao habilitar essa funcionalidade, você define por quantos dias o cliente permanece conectado, diretamente pela página **Autenticação** no Admin VTEX, sem precisar abrir um chamado com o Suporte VTEX.\n\n> ℹ️ O login persistente afeta apenas as sessões de clientes na loja virtual. As sessões de login dos usuários administrativos no Admin VTEX não são afetadas por essa configuração.\n\n## Como funciona\n\nAo acessar a loja, o cliente recebe um cookie de acesso (`VtexIdclientAutCookie_{account}`) com duração fixa de 24 horas, que não pode ser configurada. Quando o login persistente está habilitado, a plataforma também emite um token de atualização (`vid_rt`), responsável por renovar o acesso do cliente sem exigir um novo login, pelo período que você configurar.\n\nAlguns pontos importantes sobre o funcionamento dessa configuração:\n\n* O login persistente é opcional e vem desabilitado por padrão. Se você não configurar nada, o comportamento da sua loja não muda.\n* A duração pode ser qualquer número inteiro de dias, de **1** a **365**.\n* Ao habilitar o login persistente pela primeira vez, a duração padrão é de **1 dia**. Você pode alterá-la a qualquer momento.\n* Alterações na configuração (incluindo desabilitar o login persistente) valem apenas para os novos logins realizados após a mudança. Sessões já ativas continuam se comportando como estavam antes da alteração.\n* Se você desabilitar o login persistente e depois o habilitar novamente, a última duração salva é restaurada (a configuração não volta automaticamente para 1 dia).\n* A forma como o acesso do cliente é renovado depende da tecnologia do storefront. Em lojas headless e FastStore, são necessárias etapas adicionais, descritas em [Etapas adicionais por tipo de loja](#etapas-adicionais-por-tipo-de-loja).\n\n## Pré-requisitos\n\nPara habilitar ou alterar o login persistente, o usuário deve ter um [perfil de acesso](https://help.vtex.com/pt/docs/tutorials/perfis-de-acesso) com o recurso **Write Account Config**, na categoria Account Configuration do produto VTEX ID. Sem essa permissão, a alteração não é salva e uma mensagem de erro é exibida.\n\n## Habilitar o login persistente\n\nPara começar a usar o login persistente, habilite a funcionalidade no card correspondente da página **Autenticação**:\n\n1. Na barra superior do Admin VTEX, clique no avatar do seu perfil, marcado pela inicial do seu email.\n2. Clique em **Configurações da conta > Autenticação**.\n3. Na aba **Loja virtual**, localize o card **Login persistente**, abaixo dos métodos de login.\n4. Clique no interruptor para habilitar a funcionalidade.\n    ![Card Login persistente na aba Loja virtual](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/autenticação/conceitos-básicos-de-autenticação/configurar-login-persistente-para-clientes_1.png)\n\nAo habilitar, uma notificação confirma a ativação e informa a duração que passa a valer para os novos logins (1 dia, no primeiro uso, ou a última duração salva, em uma reativação).\n\n## Etapas adicionais por tipo de loja\n\nDepois de habilitar o login persistente, confira se a sua loja precisa de alguma etapa adicional. O que muda é a forma como o acesso do cliente é renovado, que depende da tecnologia do storefront.\n\nEm lojas com [Store Framework](https://developers.vtex.com/docs/guides/store-framework) ou [CMS Portal (Legado)](https://help.vtex.com/pt/docs/tracks/cms-portal-legado), basta habilitar o login persistente no Admin VTEX, pois a renovação do acesso do cliente na loja é automática.\n\nEm lojas headless, além de habilitar o login persistente no Admin VTEX, é necessário implementar a renovação do acesso do cliente por meio das APIs do VTEX ID. O guia para desenvolvedores [Refresh token flow for headless implementations](https://developers.vtex.com/docs/guides/refresh-token-flow-for-headless-implementations) explica como fazer essa implementação.\n\nSe a sua loja usa FastStore, além de habilitar o login persistente no Admin VTEX, é necessário habilitar o refresh token no projeto, conforme o guia [Enabling refresh token on FastStore](https://developers.vtex.com/docs/guides/faststore/session-enabling-refresh-token).\n\n## Configurar a duração do login persistente\n\nA duração configurada não é exibida diretamente no card. Para consultá-la ou alterá-la, siga os passos abaixo:\n\n1. Na barra superior do Admin VTEX, clique no avatar do seu perfil, marcado pela inicial do seu email.\n2. Clique em **Configurações da conta > Autenticação**.\n3. Na aba **Loja virtual**, no card **Login persistente**, clique em `Editar`.\n\n    Uma janela é aberta com a duração atualmente configurada, em dias.\n    ![Janela de configuração da duração do login persistente](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/autenticação/conceitos-básicos-de-autenticação/configurar-login-persistente-para-clientes_2.png)\n4. No campo **Duração da sessão**, informe um número inteiro entre **1** e **365** dias.\n5. Clique em `Salvar`.\n\nSe o valor informado estiver fora do intervalo permitido ou não for um número inteiro, uma mensagem de erro é exibida e a alteração não é salva.\n\nVocê pode configurar a duração mesmo com o login persistente desabilitado. Nesse caso, o valor é salvo e passa a valer assim que a funcionalidade for habilitada.\n\n## Desabilitar o login persistente\n\nSe não quiser mais manter os clientes conectados por um período estendido, desabilite a funcionalidade a qualquer momento:\n\n1. Na barra superior do Admin VTEX, clique no avatar do seu perfil, marcado pela inicial do seu email.\n2. Clique em **Configurações da conta > Autenticação**.\n3. Na aba **Loja virtual**, no card **Login persistente**, clique no interruptor para desabilitar a funcionalidade.\n\nA partir desse momento, os novos logins de clientes deixam de receber o token de atualização, voltando ao comportamento padrão de expiração em 24 horas. Sessões já ativas não são alteradas por essa mudança.\n\n## Saiba mais\n\n- [Refresh token flow for headless implementations](https://developers.vtex.com/docs/guides/refresh-token-flow-for-headless-implementations)\n- [Enabling refresh token on FastStore](https://developers.vtex.com/docs/guides/faststore/session-enabling-refresh-token)\n- [Autenticação](https://help.vtex.com/pt/docs/tutorials/autenticacao)"}