Pular para o conteúdo principal
O provisionamento SCIM está disponível no plano Enterprise. A integração de diretório (Microsoft Graph) está disponível nos planos Teams e Enterprise. Ambas são no nível organizacional e configuradas por um administrador.
Há duas maneiras de conectar o Microsoft Entra ID (anteriormente Azure Active Directory) ao Wave Connect. Ambas criam e atualizam usuários do Wave Connect a partir do seu diretório. Elas diferem em quem é sincronizado, em como funciona o desligamento e no que mantém a conexão ativa.

Qual Devo Usar?

O provisionamento SCIM é a abordagem que a Microsoft recomenda para manter um aplicativo sincronizado com o Entra ID. Escolha a integração Graph somente no plano Teams ou para uma importação pontual.

Configurar o Provisionamento SCIM

1

Crie um token SCIM no Wave Connect

Acesse Configurações → Segurança e localize o card Sincronização de diretório. Clique em Configurar para abrir o modal Configurar SCIM. Copie o Endpoint SCIM (https://app.wavecnct.com/api/scim) e clique em Criar token. Dê um nome ao token e clique em Criar. Copie o token agora. Ele só é exibido uma vez.
2

Crie o aplicativo empresarial

No centro de administração do Microsoft Entra, acesse Aplicativos empresariais → Novo aplicativo → Criar seu próprio aplicativo. Insira um nome como “Wave Connect”, escolha Integrar qualquer outro aplicativo que você não encontrar na galeria (Não listado na galeria) e clique em Criar.
3

Insira as credenciais SCIM

Abra o novo aplicativo e acesse Provisionamento → Introdução. Defina o Modo de Provisionamento como Automático. Em Credenciais de Administrador, cole o endpoint SCIM em URL do Locatário e o token em Token Secreto. Clique em Testar Conexão e depois em Salvar.
4

Revise os mapeamentos de atributos

Em Mapeamentos, abra Provisionar Usuários do Microsoft Entra ID e compare com a tabela abaixo. Os padrões do Entra cobrem a maioria das linhas. Você só precisa editar as linhas do e-mail principal, locale e externalId. Deixe Provisionar Grupos do Microsoft Entra ID habilitado se quiser que os grupos do Entra se tornem equipes do Wave Connect.
5

Atribua usuários e grupos

Acesse Usuários e grupos e atribua as pessoas e os grupos que devem ter uma conta Wave Connect. Somente os usuários atribuídos são provisionados.
6

Inicie o provisionamento

De volta a Provisionamento, defina o Status de Provisionamento como Ativado e clique em Salvar, ou clique em Iniciar provisionamento. O Entra executa um ciclo inicial e, depois, um ciclo incremental aproximadamente a cada 40 minutos. Para verificar um único usuário sem esperar, use Provisionar sob demanda.

Mapeamento de Atributos

O Wave Connect lê estes atributos SCIM. A coluna Campo no Wave Connect mostra onde cada valor é armazenado.
Os mapeamentos padrão do Entra já cobrem userName, name.givenName, name.familyName, title, os números de telefone, addresses[type eq "work"].locality e active. Somente três linhas precisam ser editadas: garanta que o mapeamento do e-mail comercial defina primary como True, altere o destino de preferredLanguage de preferredLanguage para locale e altere a origem de externalId de mailNickname para objectId.
Outras observações sobre o mapeamento:
  • Os números de telefone são validados e armazenados no formato internacional. Valores de preenchimento e valores contendo apenas ramal são descartados em vez de fazer a sincronização falhar.
  • roles[].value definido como USER, ADMIN ou OWNER (em maiúsculas) define a função na organização. O Entra não envia funções por padrão, então os novos usuários são criados como usuários.
  • A extensão enterprise department não é armazenada no perfil. A atribuição de equipes por departamento pode ser habilitada pelo suporte do Wave Connect.
  • Um valor de locale deve ser um dos idiomas suportados pelo Wave Connect; caso contrário, o usuário recebe inglês.

Grupos Se Tornam Equipes

Quando o provisionamento de grupos está habilitado, cada grupo do Entra atribuído ao aplicativo se torna uma equipe do Wave Connect. O displayName do grupo se torna o nome da equipe e o objectId do grupo é armazenado como ID externo da equipe. Se já existir uma equipe com o mesmo nome no Wave Connect, o grupo é mesclado a ela. Um usuário do Wave Connect pertence a uma única equipe. Se um usuário estiver em vários grupos atribuídos, o último grupo provisionado pelo Entra prevalece. Uma organização pode ter até 75 equipes. Excluir um grupo no Entra exclui a equipe no Wave Connect. Seus usuários são mantidos e seus contatos são movidos para a organização. Cada equipe pode ter um template diferente, de modo que os usuários em grupos diferentes recebam automaticamente o layout de cartão, a identidade visual e os campos bloqueados corretos. Consulte Templates.

Desligamento

Quando um usuário tem a atribuição removida do aplicativo, é desabilitado ou excluído de forma reversível (soft delete) no Entra, o serviço de provisionamento envia active = false. O Wave Connect desativa o usuário:
  • Ele não consegue mais fazer login e suas sessões são revogadas.
  • Ele aparece com o selo SUSPENDED em Usuários.
  • Seu cartão NFC, perfil e contatos são mantidos.
  • Ele continua contando como um assento.
O Entra mantém um usuário excluído de forma reversível por 30 dias e, em seguida, envia uma solicitação de exclusão. O Wave Connect então remove o usuário permanentemente, exclui seu perfil e contatos e desvincula seu cartão NFC para que ele possa ser atribuído a outra pessoa. Se você não quiser o período de carência de 30 dias, abra Configurações → Segurança → Sincronização de diretório → Configurar e ative Excluir usuário imediatamente em vez de suspendê-lo. A desativação então exclui o usuário permanentemente de imediato. Para trazer de volta um usuário desativado, atribua-o novamente ao aplicativo no Entra. O próximo ciclo de provisionamento envia active = true e reativa a conta.
Você pode habilitar o login único no mesmo aplicativo empresarial. Consulte Login Único (SAML).

Integração de Diretório (Microsoft Graph)

A integração de diretório conecta o Wave Connect ao seu tenant por meio da API do Microsoft Graph usando a conta de um administrador. É mais simples de configurar do que o SCIM, mas sincroniza o tenant inteiro e depende da conta que fez a conexão.

Como Conectar

Há dois pontos de entrada. Eles criam a mesma integração, mas com um padrão diferente para a Sincronização de usuários, a chave que aplica as alterações do diretório automaticamente.
  1. Acesse Integrações → Microsoft Entra ID e clique em Instalar App.
  2. Deixe Importar automaticamente novos usuários de Microsoft Entra ID ativado, ou desative se quiser apenas uma importação manual. Clique em Continuar.
  3. Faça login com uma conta Microsoft que possa conceder consentimento de administrador no tenant e aceite a solicitação de consentimento.
Com essa chave ativada, todos os usuários do tenant são criados no Wave Connect conforme as notificações de alteração chegam, e as alterações futuras são aplicadas automaticamente. Ela aparece como Sincronização de usuários nas Configurações da integração.
Com a Sincronização de usuários ativada, esta integração adiciona um usuário do Wave Connect, e um assento, para cada usuário do tenant, incluindo convidados. Não há como limitá-la a um grupo.

Permissões

O Wave Connect solicita os escopos delegados openid, offline_access, profile, User.Read.All e Directory.Read.All na conta do administrador que faz a conexão. O Wave Connect apenas lê o diretório. Ele nunca grava no Entra. A integração é executada com o token de atualização desse administrador. Se o token for revogado (por exemplo, o administrador sai da empresa, sua senha é redefinida com revogação de sessão ou uma política de acesso condicional bloqueia a atualização), o Wave Connect exclui a integração e um administrador precisa reconectá-la.

O Que É Sincronizado

Direção da sincronização: Entra ID → Wave Connect (somente de entrada). As fotos de perfil só são obtidas durante uma importação manual ou pré-visualização e armazenadas como cópia no Wave Connect. Os usuários criados pela Sincronização de usuários não recebem foto.

Sincronização de Usuários e Desativação

Após a conexão, o Wave Connect assina as notificações de alteração do Microsoft Graph para usuários (criados, atualizados, excluídos). As assinaturas duram três dias e são renovadas automaticamente a partir das notificações de ciclo de vida do Graph. As notificações são ignoradas enquanto a Sincronização de usuários estiver desativada. Quando um usuário é excluído no Entra, ou sua conta é desabilitada (accountEnabled = false), o Wave Connect o desativa: o login é bloqueado, ele aparece com o selo SUSPENDED em Usuários, e seu cartão, perfil e contatos são mantidos. Ele continua contando como um assento. Reabilitar a conta no Entra não o reativa no Wave Connect. Entre em contato com support@wavecnct.com para reativar um usuário, ou exclua-o em Usuários.

Limitações

  • O tenant inteiro é sincronizado. Os convidados são incluídos. Não há delimitação por atribuição.
  • Grupos e departamentos do Entra não são sincronizados. As equipes devem ser gerenciadas no Wave Connect.
  • Sem foto para os usuários criados pela Sincronização de usuários.
  • A conexão depende de uma única conta de administrador e é removida quando o token dessa conta é revogado.
  • Os usuários nunca são excluídos pela integração, apenas desativados.

Desconectar

Acesse Integrações → Microsoft Entra ID → Configurações e clique em Desconectar. Isso exclui a conexão armazenada no Wave Connect. Nada é revogado na Microsoft, e a assinatura do Graph simplesmente expira em até três dias. Os usuários existentes do Wave Connect são mantidos e deixam de ser atualizados. Para remover o acesso do Wave Connect do lado da Microsoft, revogue o consentimento do aplicativo empresarial no centro de administração do Entra.

Usando Ambos

O SCIM e a integração Graph podem estar ativos ao mesmo tempo. Nesse caso, os usuários provisionados via SCIM recebem a foto de perfil da conexão Graph, correspondida por e-mail. Mantenha a Sincronização de usuários desativada na integração Graph quando usar SCIM. Com ela ativada, a integração Graph cria todos os usuários do tenant, o que ignora a delimitação por atribuição que você configurou no aplicativo empresarial.

Solução de Problemas

Verifique se a URL do Locatário é exatamente https://app.wavecnct.com/api/scim, sem barra final, e se o Token Secreto é o token completo do modal Configurar SCIM. Um token só pode ser copiado no momento da criação, então crie um novo se o perdeu. Os tokens são excluídos quando a organização sai do plano Enterprise.
O Entra provisiona em ciclos de aproximadamente 40 minutos. Use Provisionar sob demanda no usuário para enviá-lo imediatamente e verifique o resultado nos Logs de provisionamento. Uma solicitação com falha geralmente significa que um atributo obrigatório está ausente: name.givenName, name.familyName ou um e-mail principal em uma atualização.
Com SCIM, o usuário precisa estar atribuído ao aplicativo. Se a atribuição foi removida, atribua-o novamente e o Entra envia active = true. Com a integração Graph, a reabilitação nunca reativa o usuário. Entre em contato com support@wavecnct.com para reativá-lo.
Quando o SCIM cria um usuário cujo e-mail já pertence a uma conta pessoal (fora da organização) do Wave Connect, e o domínio do e-mail é um dos seus domínios verificados, essa conta é movida para a sua organização e atualizada em vez de criar uma nova. O cartão e os contatos existentes são mantidos. Verifique o domínio antes de provisionar para que essas contas sejam migradas em vez de duplicadas.
Com SCIM, o e-mail de login é o e-mail principal, que o mapeamento recomendado obtém de mail. Com a integração Graph, é o userPrincipalName (ou mail para convidados). Se um usuário tiver mail e UPN diferentes, mapeie userPrincipalName para o e-mail principal no Entra, para que as duas abordagens coincidam.