Saltar al contenido principal

Federação

Federação de login​

A federação deixa as pessoas do seu tenant entrarem na Console com a conta da empresa. A página Federação lista os provedores de identidade do tenant, com o tipo, o estado e o último teste de conexão.

Provedores aceitos:

  • Microsoft Entra ID: o ID (ou o domínio verificado) do seu tenant Entra; contas de outras organizações não entram.
  • Google: contas Google, com o domínio do Google Workspace opcional.
  • OpenID Connect: qualquer provedor OIDC, pela URL de discovery (https://…/.well-known/openid-configuration).

Se a página disser que a federação ainda não está habilitada no seu tenant, nada foi configurado: a função fica disponível assim que a NNumbers habilitar.

Permissões necessárias: iam.federation.read para ver e iam.federation.manage para configurar.

Configurar um provedor​

  1. No seu provedor, crie um aplicativo OAuth para a NNumbers e anote o client_id e o segredo. Cadastre nele, como URI de redirecionamento, a URL de retorno que a tela Adicionar provedor mostra assim que você digita o identificador (URL de retorno).
  2. Em Adicionar provedor, escolha o tipo, um identificador curto (letras minúsculas, dígitos e hífen), o nome que as pessoas verão no login, o client_id, o segredo e, conforme o tipo, o tenant Entra, o domínio Google ou a URL de discovery. Os escopos openid, email e profile são pedidos sempre; informe só os escopos a mais, se o provedor precisar.
  3. Testar conexão: a NNumbers busca a configuração pública do provedor (e, no OpenID Connect, as chaves de assinatura), sem login. O resultado fica registrado. Google e Microsoft Entra ID podem ser testados antes de ativar; um provedor OpenID Connect precisa estar ativo para o teste.
  4. Ativar: o provedor aparece na tela de login do tenant.

Trocar o client_id, a URL de discovery, o tenant Entra ID ou o segredo desfaz o último teste: teste a conexão de novo depois de salvar.

O segredo é cifrado no seu navegador antes de sair dele e só é aberto no momento de ser gravado no serviço de login do tenant, o único lugar onde fica. O IAM nunca o vê em claro e ninguém o lê de volta: para trocar, edite o provedor e informe o novo.

URL de retorno​

O provedor só devolve a pessoa para a NNumbers pela URL de retorno cadastrada no aplicativo dele (no Entra ID, "URI de redirecionamento"; no Google, "URIs de redirecionamento autorizados"). Ela é única por provedor:

  • em Adicionar provedor, ela aparece assim que você digita o identificador, antes de salvar, com o botão de copiar;
  • no detalhe do provedor (clique no nome dele na lista), com o botão de copiar.

Se a tela disser que a URL ainda não aparece no seu tenant, peça-a ao suporte da NNumbers informando o identificador do provedor.

Quem entra por um provedor pela primeira vez ganha uma conta no tenant, sem acesso: conceda os papéis na tela do usuário. Uma conta existente nunca é vinculada só porque o e-mail é igual; o vínculo exige que a pessoa confirme a identidade.

Desativar tira o provedor da tela de login (as contas continuam); Remover apaga o provedor. Com o login por senha desligado (Segurança), o último provedor ativo e com o último teste bem-sucedido não pode sair.