Pular para o conteúdo principal
Disponível no plano Enterprise. Somente proprietários da organização podem configurar provedores de identidade.

Visão Geral

O SSO permite que sua equipe faça login no Wave Connect pelo provedor de identidade (IdP) da sua organização. Em vez de gerenciar uma senha separada para o Wave Connect, os usuários se autenticam com as mesmas credenciais que usam para tudo o mais. O Wave Connect suporta SAML 2.0 e OpenID Connect (OIDC) e funciona com qualquer provedor de identidade compatível com os padrões, incluindo Okta, Microsoft Entra ID, Google Workspace, OneLogin, JumpCloud e Ping Identity. Você mesmo configura em Configurações → Segurança → Provedores de identidade.

Como Funciona

Existem dois fluxos de login, dependendo de o usuário já ter ou não uma conta Wave Connect.
Os usuários também podem iniciar o SSO diretamente com esta URL: https://app.wavecnct.com/auth/sso?org=YOUR_ORG_SLUG. Substitua YOUR_ORG_SLUG pelo seu Nome de Usuário da Organização, encontrado nas configurações da organização. A mesma URL é exibida como URL de início quando você configura o SAML.
Sem conta ainda: O usuário clica em Continuar com SSO na página de login do Wave Connect e insere o nome de usuário da sua organização no campo Nome de usuário da empresa. O Wave Connect o redireciona para o seu provedor de identidade, ele se autentica e sua conta é criada automaticamente no primeiro login. O e-mail declarado pelo seu IdP deve estar em um dos domínios verificados da sua organização; caso contrário, o login é recusado. Conta existente com SSO obrigatório: O usuário insere seu e-mail normalmente. O Wave Connect detecta que o SSO é obrigatório para a organização e o redireciona para o seu provedor de identidade para autenticação.
Recomendamos provisionar os usuários com antecedência via SCIM para que as contas estejam prontas, e atribuídas à equipe correta, antes de a sua equipe fazer o primeiro login. Se você usa Microsoft Entra ID, consulte o guia do Entra ID para configurar ambos no mesmo aplicativo empresarial.
As contas criadas pelo SSO leem as claims padrão de nome, sobrenome e e-mail. A claim name padrão do Microsoft Entra ID, que contém o e-mail, é aceita como e-mail. As claims de nome também podem carregar telefone, cidade, cargo, idioma e função (USER ou ADMIN).

Configuração

SAML

1

Abra Provedores de identidade

Acesse Configurações → Segurança → Provedores de identidade e clique em Configurar ao lado de SAML.
2

Copie os detalhes do Wave Connect para o seu IdP

A primeira etapa do modal Configurar SAML mostra os valores de que o seu IdP precisa:
  • ID da Entidade: wave-connect
  • URL do Serviço de Consumo de Declaração (ACS): https://app.wavecnct.com/__/auth/handler
  • URL de início: https://app.wavecnct.com/auth/sso?org=YOUR_ORG_SLUG
No seu provedor de identidade, crie um aplicativo SAML 2.0 para o Wave Connect com esses valores. Defina o formato do Name ID como endereço de e-mail. Clique em Próximo.
3

Insira os detalhes do seu IdP

No aplicativo SAML do seu IdP, copie:
  • ID da Entidade: o URI identificador do seu provedor de identidade
  • URL de SSO: a URL da página de login do seu provedor de identidade
  • Certificados x509: o certificado de assinatura no formato PEM, de -----BEGIN CERTIFICATE----- a -----END CERTIFICATE-----
4

Salve e teste

Deixe Forçar login via SSO para seus usuários desativado, clique em Salvar e teste com um usuário pela URL de início antes de tornar o SSO obrigatório para todos.
Apenas um provedor de identidade pode ser configurado por vez. Para trocar de SAML para OIDC, ou para um IdP diferente, remova o provedor atual primeiro. Removê-lo faz todos os usuários voltarem ao login por código de e-mail ou telefone.

OIDC

1

Crie um aplicativo OIDC no seu IdP

Registre um aplicativo web para o Wave Connect com o URI de redirecionamento https://app.wavecnct.com/__/auth/handler. Defina o tipo de autenticação do cliente como Client Secret Basic.
2

Abra Provedores de identidade

Acesse Configurações → Segurança → Provedores de identidade e clique em Configurar ao lado de OpenID Connect.
3

Insira os detalhes do seu IdP

No modal Configurar OIDC, preencha ID do Cliente, Segredo do Cliente e Emissor (a URL do emissor do seu IdP). Mantenha Tipo de Resposta em Code. O fluxo implícito está disponível, mas não é recomendado.
4

Salve e teste

Deixe Forçar login via SSO para seus usuários desativado, clique em Salvar e teste com um usuário antes de tornar o SSO obrigatório para todos.

Tornando o SSO Obrigatório

Assim que o SSO estiver funcionando, você pode exigi-lo para que todos os usuários façam login pelo seu provedor de identidade. Isso desativa o login por código de e-mail e telefone para a sua organização. Abra Configurações → Segurança → Provedores de identidade, edite o seu provedor, ative Forçar login via SSO para seus usuários e clique em Atualizar. Os usuários existentes que tentarem fazer login com o e-mail são redirecionados para o seu provedor de identidade.
Certifique-se de que o proprietário que está tornando o SSO obrigatório consegue fazer login pelo IdP primeiro. Uma vez obrigatório, todos os membros da organização, incluindo os proprietários, precisam se autenticar por ele.