Passo 1 | Comece com SSO
Single Sign-On (SSO) permite que as pessoas façam login no seu app Base44 usando um provedor de identidade externo que suporta OpenID Connect (OIDC), como Google, Microsoft, GitHub, Okta, Apple ou Kakao, em vez de criar um login separado para seu app.- Single sign-on (SSO) está disponível para apps Base44 no plano Elite ou superior.
- Para conectar um provedor como Kakao via SSO, você precisa da sua própria conta nesse provedor e um app configurado lá. Você é responsável por criar e gerenciar o client ID, client secret, redirect URI e quaisquer outras credenciais no dashboard do seu provedor de identidade.
- Vá para o editor do seu app na Base44.
- Verifique a barra de endereço do seu navegador e encontre o app ID entre
/apps/e/editor/na URL. - Construa seu redirect URI substituindo
{{APP_ID}}neste formato pelo seu app ID:https://app.base44.com/api/apps/{{APP_ID}}/auth/sso/callback
Exemplo: da URL do app ao redirect URI
Exemplo: da URL do app ao redirect URI
Passo 2 | Escolha seu provedor
Comece escolhendo o provedor de identidade que sua equipe já usa. Você pode escolher uma opção nativa (Google, Microsoft, GitHub ou Okta), ou usar Advanced / Manual configuration para conectar qualquer provedor OIDC, incluindo Kakao ou seu próprio IdP.Google Workspace
Microsoft 365 / Entra ID
GitHub
Okta
Advanced / Manual configuration
Google Workspace
Use Google Workspace como seu provedor de SSO com uma aplicação Web OAuth 2.0. Primeiro, crie um client OAuth 2.0 no Google Cloud Console para seu projeto, depois adicione essas credenciais na Base44. Para configurar Google Workspace SSO na Base44:- No editor do seu app, clique em Dashboard.
- Clique em Settings.
- Clique em Authentication.
- Clique em Set Up ao lado de Single sign-on (SSO).
- Em Select SSO provider, escolha Google Workspace.
- Digite seu Client ID e Client Secret do Google.
- Mantenha Scope como
openid email profile. - Deixe Discovery URL com o valor padrão.
- Clique em Enable SSO.

Microsoft
Use Microsoft Entra ID (Azure AD) como seu provedor de SSO pelo seu portal Azure. A Base44 suporta configurações Microsoft single-tenant e multi-tenant. O que você insere no campo Tenant ID controla quais contas podem fazer login. Para configurar Microsoft SSO na Base44:- No editor do seu app, clique em Dashboard.
- Clique em Settings.
- Clique em Authentication.
- Clique em Set Up ao lado de Single sign-on (SSO).
- Em Select SSO provider, escolha Microsoft Azure AD.
- Digite seu Azure Client ID (Application (client) ID) e Client Secret.
- No campo Tenant ID, digite um valor com base em quais contas quer permitir:
- Seu directory (tenant) ID do Azure: Apenas usuários da sua organização específica.
common: Contas Microsoft pessoais e contas de trabalho/escola (Microsoft 365).organizations: Apenas contas de trabalho e escola (Microsoft 365).
- Mantenha Scope como
openid email profile. - A Discovery URL preenche automaticamente com base no tenant ID que você inseriu. Confirme que parece correta antes de continuar.
- Clique em Enable SSO.

GitHub
Use um app OAuth do GitHub como seu provedor de SSO. Crie um app OAuth nas GitHub Developer Settings, depois conecte-o na Base44. Para configurar GitHub SSO na Base44:- No editor do seu app, clique em Dashboard.
- Clique em Settings.
- Clique em Authentication.
- Clique em Set Up ao lado de Single sign-on (SSO).
- Em Select SSO provider, escolha GitHub.
- Digite seu Client ID e Client Secret do GitHub.
- Mantenha Scope como
user:email. - Mantenha os valores padrão de Auth Endpoint, Token Endpoint e Userinfo Endpoint para GitHub.
- Clique em Enable SSO.

Okta
Use Okta como seu provedor de SSO. No seu Okta Admin Console, crie uma aplicação Web OIDC para seu app Base44, depois adicione as credenciais na Base44. Para configurar Okta SSO na Base44:- No editor do seu app, clique em Dashboard.
- Clique em Settings.
- Clique em Authentication.
- Clique em Set Up ao lado de Single sign-on (SSO).
- Em Select SSO provider, escolha Okta.
- Digite o seguinte:
- Client Id: Seu client ID do Okta.
- Client Secret: Seu client secret do Okta.
- Okta Domain: Apenas seu subdomínio Okta, não o domínio completo (por exemplo, digite
your-company, nãoyour-company.okta.com). - Scope: Mantenha
openid email profile. - Discovery URL: Preenche automaticamente quando você insere seu domínio Okta.
- Clique em Enable SSO.

Advanced / Manual configuration
Use Advanced / Manual configuration para conectar qualquer provedor de identidade compatível com OIDC que não é coberto pelas opções nativas. Isso inclui provedores como Kakao, desde que suportem OIDC e você os configure com os detalhes corretos do seu provedor. Para configurar Advanced / Manual configuration na Base44:- No editor do seu app, clique em Dashboard.
- Clique em Settings.
- Clique em Authentication.
- Clique em Set Up ao lado de Single sign-on (SSO).
- Em Select SSO provider, escolha Advanced / Manual Configuration.
- Preencha os seguintes campos usando os valores do seu provedor:
- Name: Um nome para essa configuração de SSO (por exemplo,
Auth0,Keycloak,Kakaoou o nome do seu provedor de identidade). - Client Id: Seu client ID OIDC.
- Client Secret: Seu client secret OIDC.
- Scope: Mantenha
openid email profile. - Discovery URL: A discovery URL do seu provedor, se disponível.
- Auth Endpoint, Token Endpoint, Userinfo Endpoint, Jwks Uri: Se você não está usando uma discovery URL, cole cada endpoint da documentação do seu provedor.
- Name: Um nome para essa configuração de SSO (por exemplo,
- Clique em Enable SSO.

Passo 3 | Teste seu login SSO
Depois de configurar SSO, teste se tudo funciona como esperado. Para testar seu login SSO:- Faça logout do seu app se estiver atualmente logado.
- Vá para a tela de login do seu app.
- Clique em Log in with SSO ou selecione o provedor que você configurou.
- Faça login usando um endereço de e-mail do seu domínio aprovado.
Perguntas frequentes
Clique em uma pergunta para saber mais sobre SSO.Preciso configurar SSO se uso apenas um login?
Preciso configurar SSO se uso apenas um login?
O que é um redirect URI e onde uso?
O que é um redirect URI e onde uso?
https://app.base44.com/api/apps/{{APP_ID}}/auth/sso/callback{{APP_ID}} pelo seu app ID Base44 real.O que é uma discovery URL e preciso adicioná-la?
O que é uma discovery URL e preciso adicioná-la?
- Para Google, você não precisa inserir uma discovery URL. A Base44 cuida automaticamente.
- Para Microsoft (Azure / Entra ID), a discovery URL preenche automaticamente com base no tenant ID que você insere. O formato é
https://login.microsoftonline.com/{TENANT_ID}/v2.0/.well-known/openid-configuration, onde{TENANT_ID}é seu directory tenant ID,commonouorganizations. - Para Okta, a discovery URL preenche automaticamente quando você insere seu subdomínio Okta.
- Para GitHub, você pode deixar o campo discovery URL em branco.
- Para provedores Advanced / Manual como Kakao, siga a documentação do seu provedor. Se eles fornecem uma discovery URL, cole no campo Discovery URL. Se não, insira os endpoints individuais.
E se eu vir um erro ao fazer login usando SSO?
E se eu vir um erro ao fazer login usando SSO?
- Seu redirect URI na Base44 corresponde exatamente ao do dashboard do seu provedor.
- Seu client ID, client secret e, se usado, Discovery URL estão corretos.
- O scope está definido como
openid email profiletanto na configuração do seu provedor quanto na Base44 (ou um scope de e-mail equivalente).
Por que o login do Google ainda mostra "base44.com" em vez do nome do meu app após configurar SSO personalizado?
Por que o login do Google ainda mostra "base44.com" em vez do nome do meu app após configurar SSO personalizado?
base44.com como nome ou badge do app, seu projeto Google personalizado ainda não foi totalmente aprovado. Uma vez que o Google aprove seu projeto, o próprio nome ou marca do seu app aparecerá em vez de base44.com.Como posso garantir que o nome do meu app aparece no login do Google em vez de "base44.com"?
Como posso garantir que o nome do meu app aparece no login do Google em vez de "base44.com"?
base44.com.Quais aplicações comumente usam SSO ou OAuth?
Quais aplicações comumente usam SSO ou OAuth?

