Proyecta Auth

Autenticação de usuários integrada. Login com e-mail e Google — com controle de acesso baseado em funções.

O Proyecta Auth gerencia a autenticação de usuários nos apps que você cria. Os usuários clicam em entrar ou cadastrar-se, uma página do Proyecta Auth é aberta (em um popup por padrão), eles escolhem o método preferido, se autenticam e retornam ao seu app já conectados.

Métodos de login suportados

Método	Disponibilidade
Google	Todos os planos
E-mail (código de acesso único)	Todos os planos

Adicione autenticação ao seu app

Basta pedir à IA:

Add user authentication to my app with Google and email login.
Show a profile menu in the header when the user is signed in.

Ativar a autenticação não significa escrever um sistema de login do zero. A página de login, o handler de callback OAuth e o hook de estado de autenticação (AuthProvider / useAuth) já vêm incluídos no template do app. A autenticação é uma capacidade que você ativa: quando você solicita, o Proyecta provisiona o cliente de autenticação do seu app, define a configuração de login e exibe a interface de login pré-construída (por exemplo, um menu de perfil no seu cabeçalho) — assim você obtém o fluxo testado do template integrado, e não rotas improvisadas.

Visualize seus usuários

Abra o painel admin → Members do seu próprio app para ver todos que fizeram login e gerenciar seus acessos. (A antiga aba Usuários do builder foi incorporada ao admin do app.)

Funções e permissões

Todo app vem com um sistema de funções integrado — três níveis, do menor ao maior acesso:

• User — qualquer usuário final conectado (o padrão para todos que fazem login).
• Staff — acesso elevado às partes operacionais do seu admin.
• Admin — acesso completo, incluindo o gerenciamento das funções de outras pessoas.

Você gerencia quem tem qual função no painel admin → Members do seu app — promova ou rebaixe pessoas por lá, e o servidor aplica todas as verificações de função. O primeiro admin é o e-mail que você designa na criação do app (consulte Admin Panel). Você não precisa construir nada disso — tudo já vem com cada app.

Perguntas frequentes

Posso usar um provedor de autenticação personalizado em vez do Proyecta Auth?

O Proyecta Auth é o provedor integrado e o caminho suportado — ele cuida do login, do callback OAuth e da sessão para você. Integrar um SDK de autenticação de terceiros arbitrário a um app gerado não é suportado (o build bloqueia pacotes de autenticação no servidor como NextAuth e Supabase Auth). SSO corporativo via seu próprio provedor de identidade está no roadmap — consulte SSO & SAML.

Posso usar fluxos de login dentro do app em vez de um redirecionamento?

O app gerado por padrão usa um fluxo de login baseado em popup — a página do Proyecta Auth abre em uma janela popup em vez de substituir a página atual. Um fluxo baseado em redirecionamento completo também é suportado e pode ser solicitado à IA.

Posso ocultar métodos de login específicos?

Ainda não. Todos os métodos de login habilitados são exibidos aos usuários. A exibição seletiva está chegando em breve.

E se os usuários não estiverem recebendo os e-mails com OTP?

Verifique as pastas de spam, tente um método de login alternativo ou outro endereço de e-mail, ou peça à sua equipe de TI para colocar proyecta.dev e notifications.proyecta.dev na lista de permissões.

Posso me passar por um usuário para fins de suporte?

Ainda não. Use o controle de acesso baseado em funções para criar visualizações de admin que mostrem dados específicos de cada usuário.

Em breve

• Personalização da página de login — customize cores, logotipo e layout para combinar com a identidade visual do seu app
• Microsoft OAuth — faça login com uma conta Microsoft
• SAML / SSO — single sign-on corporativo (previsto para o plano Studio)
• SMS OTP — código de acesso único via mensagem de texto
• E-mail / senha — credenciais tradicionais com fluxo de redefinição de senha
• Provedores OAuth adicionais — GitHub, Apple e outros
• Métodos de login seletivos — escolha quais métodos aparecem na página de login
• Impersonação de usuário — faça login como um usuário para depuração e suporte