> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Gerenciando login e cadastro
> Escolha como as pessoas se cadastram e acessam seu app com autenticação.
Todos os novos apps Base44 vêm com páginas de login personalizadas integradas. Você obtém páginas prontas de login, register, forgot password e reset password que pode personalizar para combinar com o design do seu app. A Base44 cuida da autenticação com segurança nos bastidores.
Se você tem um app existente com páginas de login e quer mudar para as novas páginas de login personalizadas, veja [login personalizado para apps existentes](/Setting-up-your-app/Managing-login-and-registration#custom-login-for-existing-apps).
***
## Sobre suas páginas de login
Se seu app exige login, a Base44 configura páginas de login e cadastro para você. Elas vivem dentro do seu app, então você pode personalizar o design, traduzi-las para qualquer idioma e adicionar sua própria marca.
Seu app vem com as seguintes páginas prontas para personalizar:
* **Página de login:** Onde os visitantes do seu app fazem login.
* **Página de cadastro:** Onde novos visitantes criam uma conta.
* **Página de forgot password:** Onde visitantes podem solicitar um e-mail de redefinição de senha.
* **Página de reset password:** Onde visitantes definem uma nova senha após solicitar uma redefinição.
### Editando suas páginas de login
Você pode mudar o design, cores e conteúdo de qualquer uma dessas páginas diretamente do editor.
**Para editar uma página de login:**
1. Abra o editor do seu app.
2. (Opcional) Clique no drop-down de página no topo do editor e selecione a página que quer editar (por exemplo, **Login**).
3. Digite seu pedido no chat. Por exemplo:
```text theme={null}
Add my logo to the login page and change the background color to dark blue.
```
### Escolhendo seus métodos de sign-in
Você pode oferecer múltiplas formas para as pessoas se cadastrarem, como e-mail, Google ou outros provedores, para que o login permaneça simples, seguro e familiar. Você pode habilitar mais de uma opção.
Depois de habilitar um provedor, você precisa adicionar um botão para esse provedor às suas páginas. Siga os passos abaixo para aprender como.
**Para adicionar um provedor de login social às suas páginas de login personalizadas:**
1. Clique em **Dashboard** no editor do seu app.
2. Clique em **Settings**.
3. Clique em **Authentication**.
4. Habilite o toggle do provedor que quer adicionar.
5. Clique em **Add to pages** abaixo do provedor.
6. A IA adiciona o botão de sign-in do provedor às suas páginas de login e register.
SSO está disponível apenas no plano Elite. Saiba mais sobre [configurar SSO](/Setting-up-your-app/Setting-up-SSO).
Para que o login do Facebook funcione, a pessoa fazendo login precisa de uma conta Facebook verificada. Se o e-mail ou identidade dela no Facebook não estiver verificado, o Facebook pode bloquear o login e mostrar uma mensagem de erro. Ela deve completar o processo de confirmação de identidade do Facebook na conta Meta antes de fazer login no seu app com Facebook.
### Sobre a página de reset password
As páginas forgot password e reset password funcionam em par. Quando alguém solicita uma redefinição de senha, a Base44 envia um e-mail com um link para `/reset-password` no domínio do seu app. Esse caminho é fixo e não pode ser alterado.
A IA constrói tanto `/forgot-password` quanto `/reset-password` automaticamente quando suas páginas de login personalizadas são criadas. Não renomeie nem mova nenhuma das páginas. Se alguma das páginas estiver faltando, o fluxo de redefinição de senha não funcionará.
Links de reset são de uso único. Uma vez que alguém redefine a senha, o link no e-mail para de funcionar. Se tentar usar novamente, verão um erro de inválido ou expirado. Precisam solicitar um novo e-mail de redefinição na sua página `/forgot-password`.
Se seu app tem um domínio personalizado, o e-mail de reset usa automaticamente esse domínio no link. Nenhuma configuração extra é necessária.
### Login personalizado para apps existentes
As páginas de login personalizadas foram lançadas para todos os usuários em 2 de junho de 2026. Se você tem apps existentes com as páginas de login nativas da Base44, e quer mudá-las para as novas páginas de login personalizadas, siga os passos abaixo.
**Para habilitar login personalizado em um app existente:**
1. Clique em **Dashboard** no editor do seu app.
2. Clique em **Overview**.
3. Clique no dropdown **App visibility** e selecione **Public**.
4. Revise os detalhes no modal e clique em **Enable custom auth**.
5. A Base44 escreve automaticamente um prompt de wiring no chat de IA para conectar as páginas às rotas do seu app e envia ao chat de IA.
Depois de completar o passo 5, você verá novas páginas de login, register, forgot password e reset password no seu drop-down Pages no topo do editor do seu app.
6. Publique seu app para que as páginas de login personalizadas entrem no ar.
Se decidir voltar às páginas de login padrão da Base44:
1. Volte para **Public (deprecated)** no dropdown **App visibility** no dashboard do app.
2. Clique em **Revert** na mensagem de wiring no chat, depois **Confirm**.
***
## Personalizando o login do Google
A Base44 oferece 2 formas de configurar o login do Google, para que você possa gerenciar como as pessoas experimentam o sign-in e como sua marca é exibida:
* **Login Google padrão:** Configuração rápida usando as credenciais da Base44. A janela de login mostra "Sign in with Google" e tem a marca de [base44.com](http://base44.com). Para usar esse método, habilite o toggle **Google authentication** e selecione **Use the default Base44 OAuth**.
* **Custom Google OAuth:** Conecte seu próprio client ID e secret do Google Cloud no painel Authentication. As pessoas verão o domínio do seu app, não "base44.com" quando fizerem login com o Google. Isso é ideal para empresas que exigem uma experiência totalmente com marca ou precisam atender requisitos enterprise.
Você deve estar em um plano Builder ou superior para usar custom Google OAuth. Você também deve ter um [método de pagamento conectado ao seu projeto](https://cloud.google.com/billing/docs/how-to/payment-methods) no Google Cloud Console.
**Para configurar custom Google OAuth:**
1. [Conecte um domínio personalizado](/Setting-up-your-app/Setting-up-your-custom-domain) ao seu app.
2. Vá para o [Google Cloud Console](https://console.cloud.google.com/) e crie um novo projeto para seu app.
3. Verifique seu domínio [aqui](https://search.google.com/search-console/welcome).
4. Configure seu app OAuth completando as seguintes informações:
1. **Overview:** Digite as informações do seu app.
2. **Branding:** Configure a marca do seu app ([saiba mais sobre branding](https://support.google.com/cloud/answer/13804963)):
1. Adicione seu logo. Deve ser similar ao logo do seu app.
2. Crie uma home page no seu app seguindo [estas diretrizes](https://support.google.com/cloud/answer/13807376).
3. Crie uma política de privacidade vinculada da sua home page seguindo [estas diretrizes](https://support.google.com/cloud/answer/13806988).
4. Adicione uma página de suporte ao seu app.
5. Adicione seu domínio como domínio autorizado.
3. **Audience:** Escolha se seu app é para uso interno ou externo.
4. **Clients:** Obtenha seu Client ID e Secret:
1. Clique em **Create client.**
2. Digite os seguintes detalhes:
* **Authorized JavaScript origins:** Digite o domínio do seu app.
* **Authorized redirect URIs:** Digite `https://app.base44.com/api/apps/auth/callback`
3. Clique em **Create.**
5. **Data Access:** Selecione os seguintes scopes:
* `openid`
* `https://www.googleapis.com/auth/userinfo.email`
Você deve adicionar uma landing page ao seu app que inclua sua política de privacidade e termos de serviço. Essas páginas devem ser públicas e não atrás de login. Isso é obrigatório para a aprovação do Google OAuth.
5. Volte à Base44 e finalize a configuração do seu login personalizado:
1. Clique em **Dashboard** no editor do seu app.
2. Clique em **Settings**.
3. Clique em **Authentication**.
4. Habilite o toggle **Google authentication**.
5. Selecione **Use a custom OAuth from Google Console.**
6. Digite as informações relevantes do seu app Google OAuth e clique em **Update**.
Uma vez que você complete os passos acima, precisa aguardar o Google verificar e aprovar seu app, o que pode levar até 5 dias.
***
## Coleta de dados no sign-up
Personalize a experiência do seu app coletando detalhes chave das pessoas quando se cadastram. Você pode pedir ao chat para gerar um formulário de cadastro personalizado que reúne informações além de apenas e-mail e senha (ex.: nome completo, empresa ou papel) para que você possa fazer o onboarding das pessoas suavemente e adaptar a experiência delas no app desde o início.
**Escolha onde armazenar os dados:**
* **Users dataset:** Armazena dados com segurança, visível apenas para admins do app. Ideal para detalhes sensíveis ou somente para admin.
* **Dataset conectado:** Armazena respostas do usuário num dataset separado voltado ao público. Recomendado para dados exibidos ou compartilhados no app (como nomes de empresa).
Se você coleta dados pessoais no sign-up, como nomes ou detalhes da empresa, certifique-se de que seu app tem uma política de privacidade que explica o que você coleta e como usa. Isso é um requisito legal em muitas regiões e também é obrigatório se você usar Google OAuth.
***
## Login nativo da Base44
O login nativo da Base44 é a opção de autenticação legada. Todos os novos apps usam as páginas de login personalizadas descritas acima. Se você tem um app existente no login nativo, pode migrar para páginas de login personalizadas na página **Overview** do seu app (veja os passos acima).
Com o login nativo, a tela de login aparece automaticamente. Você escolhe quais métodos de sign-in oferecer e a Base44 cuida do resto. O design é gerenciado pela Base44 e não pode ser alterado.
### Escolhendo seus métodos de sign-in
Você pode oferecer múltiplas formas para as pessoas se cadastrarem, como e-mail, Google ou outros provedores, para que o login permaneça simples, seguro e familiar. Você pode habilitar mais de uma opção.
**Para escolher seus métodos de sign-in:**
1. Clique em **Dashboard** no editor do seu app.
2. Clique em **Settings**.
3. Clique em **Authentication**.
4. Habilite o toggle ao lado das opções relevantes de autenticação:
* **Email and password**: Permite que as pessoas criem uma conta com endereço de e-mail e senha segura.
* **Google**: Permite que as pessoas façam login usando credenciais da conta Google.
* **Microsoft**: Permite que as pessoas façam login usando credenciais Microsoft.
* **Facebook**: Permite que as pessoas façam login usando credenciais do Facebook.
* **Apple**: Permite que as pessoas façam login usando a conta Apple.
* **Single sign-on (SSO)**: Conecte um provedor de identidade externo que suporta OIDC, como Okta ou o provedor de identidade da sua empresa, para que as pessoas possam fazer login usando credenciais desse provedor.
***
## Perguntas frequentes
Clique em uma pergunta abaixo para saber mais sobre autenticação.
Se as pessoas não recebem e-mails de verificação ou redefinição de senha, comece com essas verificações:
* Peça que verifiquem as pastas de spam ou lixo eletrônico caso o e-mail tenha sido filtrado.
* Avise que pode levar alguns minutos para alguns provedores de e-mail entregarem a mensagem.
* Peça que adicionem [app@base44.com](mailto:app@base44.com) aos remetentes seguros ou allowlist para que e-mails futuros não sejam bloqueados.
* Durante o cadastro, incentive a digitar o endereço de e-mail em minúsculas e verificar erros de digitação.
Se ainda não receberem o e-mail, peça que cliquem no link de reenvio no seu app.
Se isso não funcionar, remova o registro deles da lista Users no seu dashboard e peça que se cadastrem novamente com o mesmo endereço de e-mail.
Se várias pessoas relatarem o mesmo problema ao mesmo tempo, ou se reenvio e novo cadastro não resolverem, entre em contato com o suporte da Base44 com a URL do seu app e os endereços de e-mail afetados para que possamos verificar problemas de entrega ou da plataforma.
Se seu app tem páginas de login personalizadas e o link de redefinição de senha leva a uma página em branco ou erro, verifique se sua página reset password está exatamente no caminho `/reset-password`. O link no e-mail está fixo nesse caminho.
Isso geralmente acontece quando a conta Facebook da pessoa não está totalmente verificada. O Facebook pode bloquear o login até que ela confirme a identidade e verifique o e-mail na conta.
Peça a ela:
1. Abra o Facebook e vá para **Settings and privacy**.
2. Vá para **Accounts Center**.
3. Vá para **Verification** e depois **Identity confirmation**.
4. Complete os passos de confirmação de identidade.
Depois de terminar o fluxo de verificação do Facebook, ela pode tentar fazer login no seu app novamente com Facebook. O Facebook controla esse requisito, não a Base44, então você não pode ignorá-lo nas configurações do seu app.
Você pode fazer isso com páginas de login personalizadas. Quando seu app tem páginas de login personalizadas, você tem uma landing page pública e suas outras páginas verificam se o visitante está logado. Peça à IA para proteger páginas específicas para que visitantes que não estão logados sejam redirecionados para sua página de login.
Por exemplo:
```text theme={null}
Make all pages except the landing page require login. Redirect visitors who are not logged in to the Login page.
```
A Base44 lida automaticamente com todas as senhas de forma segura nos bastidores. Se alguém esquecer a senha, pode redefini-la na sua página de login clicando em **Forgot password?**. Isso envia a pessoa para sua página `/forgot-password`, e o e-mail de reset leva à sua página `/reset-password`.
Sim. Adicionar uma opção de logout mantém as coisas seguras e dá tranquilidade às pessoas. Você pode pedir ao chat para incluir um **botão Logout** e colocá-lo na barra lateral ou no cabeçalho do app, onde melhor se encaixar no seu design.
Sim. A Base44 suporta provedores de autenticação externos que usam OpenID Connect (OIDC), incluindo provedores como Kakao.
Se você está no plano Elite, pode conectar provedores externos como Google, Microsoft, GitHub, Okta ou Kakao usando Single sign-on (SSO) e a opção Advanced / Manual configuration. Você precisa da sua própria conta no provedor de identidade, e é responsável por criar e gerenciar o app, client ID, client secret, redirect URI e quaisquer outras credenciais nesse provedor.
Para instruções passo a passo, veja o guia sobre [configurar SSO](/Setting-up-your-app/Setting-up-SSO) na Base44.
O SDK da Base44 não suporta `User.login()`, então se você tentar usar no seu código, verá um erro.
Para lidar com login em apps sem páginas de login personalizadas, sempre use `base44.auth.redirectToLogin(nextUrl)`. Esse método envia o usuário para a página de login e o traz de volta ao seu site depois que ele faz login.
Se está tendo problemas com autenticação, verifique se está usando esse método correto no seu app.
**Incorreto (causará erro):**
```js theme={null}
User.login(nextUrl);
```
**Correto:**
```js theme={null}
base44.auth.redirectToLogin(nextUrl);
```
**Dica:** Se vir um erro como "TypeError: User.login is not a function", verifique seus imports e garanta que está usando `base44.auth.redirectToLogin` em vez disso.
Sim. Páginas de login personalizadas são páginas regulares na base de código do seu app, então você pode abri-las e visualizá-las na janela de preview.
Para testar os fluxos completos de sign-up e login, publique seu app e abra a URL ao vivo num navegador. Complete o fluxo com um endereço de e-mail válido para ver a mesma experiência que seus visitantes terão.
A causa mais comum é que seu app está definido como **Private**. Em um app privado, apenas usuários explicitamente convidados por e-mail podem fazer login. Qualquer outra pessoa verá um erro de login inválido, mesmo que insira credenciais válidas.
**Para verificar e atualizar a visibilidade do seu app:**
1. Clique em **Dashboard** no editor do seu app.
2. Clique em **Overview**.
3. Em **App Visibility**, verifique a configuração atual.
* Se estiver definido como **Private**, verifique se o usuário foi convidado. Vá para **Users** e clique em **Invite User** para adicioná-lo.
* Se quer que qualquer um possa se cadastrar e fazer login, mude a visibilidade para **Public**.
**Outras causas possíveis:**
* O usuário inseriu um e-mail ou senha incorretos.
* O usuário não verificou o endereço de e-mail após se cadastrar.
* A sessão de login expirou. Peça ao usuário para tentar fazer login novamente.
Esta página foi traduzida usando IA. Para informações mais precisas e atualizadas, consulte a [versão em inglês](/).