Skip to main content
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.
Importante:
  • O single sign-on do workspace está disponível apenas em workspaces empresariais. Se você não vê essa opção, entre em contato com sua equipe de conta da Base44.
  • 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 Settings > Authentication:
  • Client ID: Do seu app do Okta.
  • Client Secret: Do seu app do Okta.
  • Okta domain: 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 Scope e a Discovery URL 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 Next.
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 App name, 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 vão usar 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 Save.
Configurações de sign-in e sign-out redirect URI do aplicativo Okta

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.
  • Client ID: Na aba General do app.
  • Client Secret: Na aba General do app.
  • Okta domain: 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 Security > 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 General 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 Settings.
  3. Clique em Authentication.
  4. Ative o botão ao lado de Single Sign-On Configuration.
  5. Em Select SSO Provider, escolha Okta.
  6. Insira seu Client ID, Client Secret e Okta Domain. 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 Scope como openid email profile.
  8. A Discovery URL é preenchida automaticamente a partir do Okta Domain que você inseriu e fica marcada como Auto. Você pode editá-la se precisar apontar a Base44 para outro lugar, e ela então aparece como Modified. Para voltar ao valor gerado, clique em Reset to auto.
  9. Clique em Enable 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 Okta Domain, como https://your-domain.okta.com/oauth2/default. A Discovery URL capta esse caminho automaticamente. Você também pode editar a Discovery URL 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.

​
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 General 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 Okta Domain, 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 Okta Domain 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.