Pular para o conteúdo
Infrastructure
Qual o jeito mais simples de colocar login num app que eu fiz com IA

Qual o jeito mais simples de colocar login num app que eu fiz com IA

Login sem senha num app React feito com Claude Code, Cursor ou outro agente: um endereço de documentação para o agente ler, uma chave pública e o código de 8 caracteres no e-mail.

Ciro Cesar Maciel5 min de leituraFeito com ajuda de IA

Nesta página · 8 seções
  1. Por que login sem senha é o mais simples
  2. O caminho com o agente
  3. Quando o caminho é outro
  4. Administrar os usuários pelo agente
  5. Perguntas frequentes
  6. Para continuar lendo
  7. Login sem construir login
  8. Fontes

Você pediu um app ao Claude Code, ao Cursor ou a outro agente, e ele funciona. Agora precisa de login, e a primeira resposta do agente costuma ser montar tudo do zero: tabela de usuários, hash de senha, e-mail de confirmação, tela de "esqueci a senha". São muitas peças, e cada uma é um lugar onde um app feito às pressas deixa uma porta aberta. O jeito mais simples é não construir nenhuma delas: usar um serviço de login que o agente consiga integrar sozinho, lendo uma documentação feita para ele.

Por que login sem senha é o mais simples

Quase todo o trabalho de um login tradicional existe por causa da senha. Ela precisa ser guardada com hash, ter regra de tamanho e ser recuperável quando a pessoa esquece. E vira alvo de vazamento, ataque de força bruta e reaproveitamento de senha de outro site.

O Auth tira a senha do caminho. A pessoa entra de três jeitos:

  • Código no e-mail. Ela digita o e-mail, recebe um código de 8 caracteres e cola na tela. O e-mail traz um código, não um link, então não há endereço de retorno para configurar nem callback para alguém sequestrar.

  • Google. Quando o dono da aplicação liga as credenciais dele no painel.

  • Apple. Da mesma forma, com as credenciais do dono.

A conta nasce no primeiro código, já verificada. Não existe cadastro separado, link mágico, recuperação de senha nem verificação de e-mail à parte, porque não há senha para recuperar. Para o agente, isso significa menos tela para escrever e menos coisa para errar.

O caminho com o agente

1. Dar ao agente a documentação certa

O Auth tem um único arquivo com tudo o que um desenvolvedor ou um agente precisa: https://myinfrastructure.click/products/auth/llms.txt. Ele começa por um passo a passo de login num app React e tem uma seção do que não existe, que impede o agente de inventar funções como signUp ou forgotPassword.

Cole o endereço na conversa e peça a integração. Um agente que lê o arquivo antes de escrever código acerta os nomes do pacote e das rotas na primeira tentativa.

2. A chave pública

O frontend precisa de uma chave pública, que começa com pu_. Ela pode ir no bundle; não é segredo. Você a encontra no painel do Auth, em Chaves de API da aplicação, e ela vai no .env:

VITE_AUTH_PUBLIC_KEY=pu_...

Se você ainda não tem conta, o agente consegue criar conta, aplicação e chaves sozinho, pela mesma entrada por código que o usuário final usa. O único passo humano é ler o código no seu e-mail e informar a ele.

Se o app tem backend próprio, ele usa outra chave, a secreta, que começa com ak_ e fica só no servidor, numa variável de ambiente. Peça as duas de uma vez quando a integração tiver as duas pontas.

3. O que o agente escreve

Num app React com Vite, o agente:

  1. Instala @ciromaciel/auth-react e as dependências de interface que o pacote usa.

  2. Envolve o app com AuthProvider, passando a chave pública.

  3. Cria a rota /auth/signin com o componente SignIn.

  4. Protege as rotas logadas com Protect, sempre com redirectTo="/auth/signin". O padrão do componente aponta para /login, que não existe, e esse é o erro mais comum.

  5. Opcionalmente, põe a página de perfil com UserProfile.

No localhost, o primeiro login funciona sem liberar origem nenhuma. Em produção, o Auth aprende a origem da aplicação no primeiro acesso vindo de um domínio de verdade, ou você a define no painel. Endereços de preview, como *.vercel.app ou *.pages.dev, autenticam normalmente, mas nunca viram a origem oficial.

Quando o caminho é outro

  • Next.js sem React Router. Os componentes usam o React Router por dentro, então um projeto Next puro não os usa. Nesse caso, o agente integra pela API HTTP, que faz o mesmo fluxo de código por e-mail, ou monta a parte logada como app React com Vite.

  • Você quer senha. O Auth não tem senha nenhuma, por escolha. Se a senha for requisito do seu público, procure um serviço que a ofereça.

  • Permissões finas por usuário. O login entrega a identidade da pessoa, isolada por aplicação. Organizações e papéis existem no painel administrativo do Auth, mas não chegam ao app pelo SDK nem pelo token; a regra de quem pode o quê fica no seu app.

Administrar os usuários pelo agente

Depois que o login está no ar, o Auth tem um servidor MCP para administrar a aplicação: listar usuários, ver estatísticas, revogar sessões. O agente conecta pelo endereço da aplicação e você aprova no navegador, sem chave. Vale lembrar a diferença: o MCP administra, e o SDK é o que coloca o login dentro do app.

Perguntas frequentes

Por que o e-mail traz um código e não um link?

Um link precisaria de um endereço de retorno, e esse endereço é justamente o que um atacante tenta trocar. Com o código, não há destino para gravar nem callback para sequestrar. O único passo humano que sobra é ler o código, e é ele que prova que quem pediu o acesso alcança aquela caixa de e-mail.

Preciso escrever a tela de login?

Não. O componente SignIn já é a tela inteira, com o campo de e-mail, o campo de código e os botões de Google e Apple quando estão ligados. Dá para ajustar a cor ao tema do seu app.

O que acontece se a pessoa usar outro e-mail?

Nasce outra conta. A identidade é o e-mail: quem entra com o mesmo e-mail pelo código ou pelo Google cai na mesma conta.

Funciona com o Claude Code, o Cursor e o Codex?

Sim. A integração é código comum num projeto React, e qualquer agente que leia a documentação faz o mesmo caminho.

Para continuar lendo

Login sem construir login

O Auth dá ao seu app login sem senha, com código no e-mail, Google e Apple, e uma documentação que o agente lê inteira antes de integrar. Conhecer o Auth

Fontes

XLinkedInWhatsAppE-mail

Quem escreveu

Ciro Cesar Maciel

Sou marido, pai e trabalho com tecnologia há mais de duas décadas, construindo sistemas para grandes empresas e liderando times técnicos. Desde 2024 desenvolvo ferramentas digitais e aplico Inteligência Artificial para viver e trabalhar com mais clareza, e escrevo aqui sobre isso.

Todos os textos

Continue lendo

Comentários

Seu e-mail fica com Infrastructure para moderar e responder. O comentário aparece depois de aprovado.