Pular para o conteúdo principal
O Okta permite que sua equipe faça login no seu workspace empresarial da Base44 com as credenciais existentes do Okta. Você cria um aplicativo OpenID Connect (OIDC) no Okta, permite que a Base44 o use e depois adiciona seus detalhes ao seu workspace.
Bom saber:
  • O single sign-on do workspace está disponível em um plano Enterprise (Business ou Enterprise). Workspaces criados antes de outubro de 2026 também podem usar o single sign-on do workspace no plano Elite.
  • Para adicionar e atualizar membros automaticamente, use o provisionamento SCIM para o Okta.

Como funciona

A Base44 faz o login da sua equipe através do Okta usando OIDC. Para isso, você precisa criar um app OIDC no Okta e depois inserir 3 valores no seu workspace da Base44 em Configurações > Autenticação:
  • ID do cliente: Do seu app do Okta.
  • Segredo do cliente: Do seu app do Okta.
  • Domínio Okta: Seu subdomínio do Okta (por exemplo, your-company), ou seu domínio de URL personalizado completo do Okta, se você tiver um (por exemplo, login.your-company.com).
Os passos abaixo mostram como criar o app no Okta e encontrar cada valor. A Base44 preenche o Escopo e a URL de descoberta para você, e você pode editar a Discovery URL se precisar.
Painel de Authentication da Base44 configurado com o Okta como provedor de SSO

O formulário de configuração de SSO nas configurações de Authentication da Base44


Configurando o single sign-on

Siga estes passos para criar o app do Okta, permitir que a Base44 o use e conectá-lo ao seu workspace da Base44.
Antes de começar, confira se você tem:
  • Acesso de proprietário ou admin ao seu workspace empresarial da Base44.
  • Acesso de admin à sua organização Okta.
  • Seu workspace ID, a string de caracteres após /workspace/ na URL do seu workspace empresarial.
  • Seu domínio do Okta. Use seu subdomínio (por exemplo, your-company), ou seu domínio de URL personalizado completo do Okta, se sua equipe fizer login por ele (por exemplo, login.your-company.com).

Passo 1: Criar um app OIDC

Crie o aplicativo OIDC que representa o login da Base44. Para criar o app:
  1. No Okta Admin Console, vá para Applications > Applications e clique em Create App Integration.
  2. Defina Sign-in method como OIDC - OpenID Connect.
  3. Defina Application type como Web Application.
  4. Clique em Avançar.
Diálogo Create a new app integration do Okta com OIDC e Web Application selecionados

Criando uma integração de app OIDC no Okta

Passo 2: Configurar o app

Defina o nome do app, as redirect URIs e quem pode usá-lo. Para configurar o app:
  1. Digite um Nome do aplicativo, por exemplo, Base44 - nome do seu workspace.
  2. Em Sign-in redirect URIs, adicione a URL de callback de login do seu workspace, substituindo {{WORKSPACE_ID}} pelo seu workspace ID: https://app.base44.com/api/workspaces/{{WORKSPACE_ID}}/auth/sso/callback. Se seus apps também usam o SSO do workspace, adicione também a URL de callback de login de apps do workspace: https://app.base44.com/api/workspace_apps/{{WORKSPACE_ID}}/auth/sso/callback. A Base44 mostra as duas URLs no painel de configuração de SSO para você copiá-las.
  3. Em Sign-out redirect URIs, adicione https://app.base44.com.
  4. Em Controlled access, escolha quem pode usar o app, por exemplo, Allow everyone in your organization to access.
  5. Clique em Salvar.
Os campos Sign-in e Sign-out redirect URI do Okta, cada um ainda com o valor padrão localhost

Definindo as redirect URIs de login e logout no Okta

Passo 3: Obter suas credenciais

A Base44 precisa de 3 valores para se conectar ao seu app do Okta.
  • ID do cliente: Na aba Geral do app.
  • Segredo do cliente: Na aba Geral do app.
  • Domínio Okta: Seu subdomínio do Okta (por exemplo, your-company). Se sua equipe faz login por um domínio de URL personalizado do Okta, insira esse domínio completo (por exemplo, login.your-company.com).

Passo 4: Permitir a Base44 no seu servidor de autorização

O Okta só emite tokens para apps que uma política do servidor de autorização permite. Para adicionar uma regra de política de acesso:
  1. Vá para Segurança > API > Authorization Servers e abra o servidor default.
  2. Na aba Access Policies, clique em Add Rule ou edite uma regra existente.
  3. Nomeie a regra (por exemplo, Allow Base44), defina o grant type como Authorization Code e aplique-a ao seu app Base44 (ou a todos os clients), a todos os usuários e a quaisquer scopes.
  4. Clique em Create Rule.
Na aba Geral do seu app Base44 no Okta, desative o Federation Broker Mode. Com ele ativado, o login pode falhar com “You are not allowed to access this app.”

Passo 5: Adicionar seus detalhes na Base44

Adicione as credenciais do app OIDC ao seu workspace. Para configurar o SSO na Base44:
  1. Clique no nome do seu workspace no canto inferior esquerdo da sua conta.
  2. Clique em Configurações.
  3. Clique em Autenticação.
  4. Clique em Configurar ao lado de Configuração de Login Único.
  5. Em Selecionar provedor SSO, escolha Okta.
  6. Insira seu ID do cliente, Segredo do cliente e Domínio Okta. Use seu subdomínio (por exemplo, your-company), ou seu domínio de URL personalizado completo do Okta, se você tiver um (por exemplo, login.your-company.com). Se sua organização Okta usa API Access Management com servidores de autorização personalizados, insira a URL do issuer incluindo o caminho do servidor de autorização, como https://login.your-company.com/oauth2/default.
  7. Mantenha o Escopo como openid email profile.
  8. A URL de descoberta é preenchida automaticamente a partir do Okta Domain que você inseriu e fica marcada como Automática. Você pode editá-la se precisar apontar a Base44 para outro lugar, e ela então aparece como Modificada. Para voltar ao valor gerado, clique em Redefinir para automático.
  9. Clique em Ativar SSO.
Algumas organizações Okta não retornam o claim email no servidor de autorização padrão, então o login falha com Email not returned by OAuth provider. Para corrigir isso, aponte a Base44 para o seu servidor de autorização do Okta incluindo o caminho do servidor de autorização no campo Domínio Okta, como https://your-domain.okta.com/oauth2/default. A URL de descoberta capta esse caminho automaticamente. Você também pode editar a URL de descoberta diretamente. Se sua organização não tem um servidor de autorização personalizado, esse endereço retorna um 404, então use seu domínio Okta simples e mapeie o claim email no perfil do seu app do Okta.

Passo 6: Atribuir usuários

Sua equipe pode fazer login assim que você a atribuir ao seu app do Okta. Para atribuir usuários:
  1. No seu app do Okta, vá para a aba Assignments.
  2. Clique em Assign, depois em Assign to People ou Assign to Groups.
  3. Selecione os usuários ou grupos que devem poder fazer login, clique em Assign e depois em Save and Go Back.
Para adicionar e atualizar membros automaticamente em vez de atribuí-los manualmente, configure o provisionamento SCIM para o Okta.

Removendo o SSO do Okta

Remover sua configuração de SSO desativa o SSO no seu workspace. Isso também exclui o Okta como seu provedor, junto com as credenciais que você salvou. Depois disso, seus membros entram na Base44 como faziam antes de você configurar o SSO. Para remover, siga os passos em removendo sua configuração de SSO.

Perguntas frequentes

Selecione uma pergunta abaixo para saber mais sobre o SSO do Okta.
Adicione uma regra de política de acesso no servidor de autorização padrão (Passo 4), desative o Federation Broker Mode na aba Geral do app e confirme que o usuário está atribuído ao app.
O servidor de autorização padrão do Okta nem sempre retorna o claim email. Adicione o caminho do servidor de autorização ao seu Domínio Okta, como https://your-domain.okta.com/oauth2/default, para que o e-mail seja retornado. Veja o aviso no Passo 5.
Sim. Se sua equipe faz login por um domínio de URL personalizado do Okta (por exemplo, login.your-company.com), insira esse domínio completo no campo Domínio Okta em vez do seu subdomínio .okta.com. A Base44 constrói a Discovery URL a partir dele automaticamente.
Sim. Apps OIDC do Okta não suportam SCIM, então o SSO usa um app OIDC e o SCIM usa um app SCIM 2.0 separado. Veja Provisionamento SCIM para o Okta.
Esta página foi traduzida usando IA. Para as informações mais precisas e atualizadas, consulte a versão em inglês.