O que é SSO corporativo?

SSO corporativo, ou login federado, permite que usuários entrem na Nvoip usando o provedor de identidade da empresa, como Google Workspace, Microsoft Entra ID, Okta, ADFS ou outro provedor compatível com OIDC ou SAML.

Na prática, o usuário informa o e-mail corporativo na tela de login, clica em Entrar com SSO corporativo, autentica no provedor da empresa e volta para o painel da Nvoip já autenticado. A senha local da Nvoip não é usada nesse fluxo.

Quando usar cada formato

O que configurar na Nvoip

1. Abra Configurações > SSO corporativo.
2. Escolha o provedor: Google Workspace, Microsoft Entra ID, Okta, OIDC personalizado ou SAML 2.0 personalizado.
3. Preencha os dados do aplicativo criado no provedor.
4. Adicione e verifique o domínio corporativo usado nos e-mails dos usuários.
5. Teste o fluxo antes de ativar.
6. Depois do teste com sucesso, clique em Ativar SSO.

URLs usadas na integração

Sempre copie as URLs exibidas na tela da Nvoip. Em produção, os valores esperados são:

Domínio verificado

O domínio verificado define quais e-mails corporativos podem usar a configuração de SSO. Ao adicionar um domínio, a Nvoip mostra um registro TXT. Esse TXT deve ser criado no DNS público do domínio.

Depois que o DNS propagar, clique em Verificar. A ativação do SSO só fica disponível depois que pelo menos um domínio estiver verificado.

Regras de acesso

O que é grupo vindo do IdP?

Grupo vindo do IdP é o valor que Google Workspace, Microsoft Entra ID, Okta ou outro provedor envia para a Nvoip durante o login. Esse valor pode ser o nome do grupo, o e-mail do grupo ou um ID/UUID.

Na Nvoip, use exatamente o valor que o provedor envia. O teste de SSO mostra os grupos recebidos, então o caminho mais seguro é testar com um usuário real e copiar os valores exibidos.

Mapeamento de grupos

O mapeamento de grupos é opcional. Nesta fase, usuários criados automaticamente entram como usuário secundário. Use o mapeamento para deixar explícito qual grupo do provedor deve gerar esse perfil.

Permissões detalhadas do painel, como relatórios, financeiro, webphone, chat e configurações, continuam sendo ajustadas nas permissões do usuário dentro da Nvoip depois que o usuário existir.

SCIM não é login

SCIM não autentica o usuário. Ele serve para sincronizar o cadastro e o status do usuário entre o diretório da empresa e a Nvoip. O login continua acontecendo por OIDC ou SAML.

Na implementação atual, o SCIM da Nvoip cria ou atualiza usuários secundários, desativa usuários quando recebe active=false ou uma remoção, e não apaga o usuário permanentemente.

Como saber se funcionou?

1. Na tela de SSO corporativo, clique em Testar.
2. Faça login no provedor com um usuário do domínio configurado.
3. Ao voltar para a Nvoip, confira se a tela de callback mostra sucesso, e-mail e grupos recebidos.
4. Depois do teste, clique em Ativar SSO.
5. Saia do painel, informe o e-mail corporativo na tela de login e clique em Entrar com SSO corporativo.

Boas práticas

• Comece com um usuário de teste antes de liberar para toda a empresa.
• Mantenha Forçar SSO desativado até validar login, domínio e grupos.
• Se usar grupos, crie grupos específicos para a Nvoip, como nvoip-usuarios e nvoip-admins.
• Prefira valores estáveis para grupos. No Microsoft Entra ID, Object ID costuma ser mais estável que nome.
• Guarde Client Secret e tokens SCIM apenas em locais seguros do provedor. Não envie segredos por e-mail ou chat.

Consulte também

• Como configurar SSO com Google Workspace na Nvoip
• Como configurar SSO com Microsoft Entra ID e Active Directory na Nvoip
• Como configurar SSO com Okta na Nvoip
• Como configurar SCIM na Nvoip