Partilhar via

Tutorial: Configurar o Bonusly para provisionamento automático de usuários

  • Artigo

O objetivo deste tutorial é demonstrar as etapas a serem executadas em Bonusly e Microsoft Entra ID para configurar o Microsoft Entra ID para provisionar e desprovisionar automaticamente usuários e/ou grupos para Bonusly.

Nota

Este tutorial descreve um conector criado sobre o Serviço de Provisionamento de Usuário do Microsoft Entra. Para obter detalhes importantes sobre o que esse serviço faz, como funciona e perguntas frequentes, consulte Automatizar o provisionamento e o desprovisionamento de usuários para aplicativos SaaS com o Microsoft Entra ID.

Pré-requisitos

O cenário descrito neste tutorial pressupõe que você já tenha o seguinte:

  • Um inquilino do Microsoft Entra
  • Um inquilino bônus
  • Uma conta de usuário em Bônus com permissões de administrador

Nota

A integração de provisionamento do Microsoft Entra depende da API REST Bonusly, que está disponível para desenvolvedores Bonusly.

Antes de configurar o Bonusly para provisionamento automático de usuários com o Microsoft Entra ID, você precisa adicionar o Bonusly da galeria de aplicativos do Microsoft Entra à sua lista de aplicativos SaaS gerenciados.

Para adicionar Bonusly da galeria de aplicativos do Microsoft Entra, execute as seguintes etapas:

  1. Entre no centro de administração do Microsoft Entra como pelo menos um administrador de aplicativos na nuvem.

  2. Navegue até Identity>Applications>Enterprise applications>Novo aplicativo.

  3. Na caixa de pesquisa, digite Bônus, selecione Bônus no painel de resultados e clique no botão Adicionar para adicionar o aplicativo.

    Bônus na lista de resultados

Atribuindo usuários ao Bonusly

O Microsoft Entra ID usa um conceito chamado "atribuições" para determinar quais usuários devem receber acesso a aplicativos selecionados. No contexto do provisionamento automático de usuários, somente os usuários e/ou grupos que foram "atribuídos" a um aplicativo no Microsoft Entra ID são sincronizados.

Antes de configurar e habilitar o provisionamento automático de usuários, você deve decidir quais usuários e/ou grupos no Microsoft Entra ID precisam acessar o Bônus. Uma vez decidido, você pode atribuir esses usuários e/ou grupos ao Bonusly seguindo as instruções aqui:

Dicas importantes para atribuir usuários ao Bonusly

  • Recomenda-se que um único usuário do Microsoft Entra seja atribuído ao Bonusly para testar a configuração de provisionamento automático do usuário. Usuários e/ou grupos adicionais podem ser atribuídos posteriormente.

  • Ao atribuir um usuário ao Bônus, você deve selecionar qualquer função válida específica do aplicativo (se disponível) na caixa de diálogo de atribuição. Os usuários com a função Acesso Padrão são excluídos do provisionamento.

Configurando o provisionamento automático de usuários para Bonusly

Esta seção orienta você pelas etapas para configurar o serviço de provisionamento do Microsoft Entra para criar, atualizar e desabilitar usuários e/ou grupos em Bônus com base em atribuições de usuário e/ou grupo na ID do Microsoft Entra.

Gorjeta

Você também pode optar por ativar o logon único baseado em SAML para Bonusly, seguindo as instruções fornecidas no tutorial de logon único Bonusly. O logon único pode ser configurado independentemente do provisionamento automático do usuário, embora esses dois recursos se complementem.

Para configurar o provisionamento automático de usuários para Bonusly no Microsoft Entra ID:

  1. Entre no centro de administração do Microsoft Entra como pelo menos um administrador de aplicativos na nuvem.

  2. Navegue até Aplicativos de identidade>>Aplicativos>corporativos Bônus.

    Painel Aplicações empresariais

  3. Na lista de aplicativos, selecione Bônus.

    O link Bônus na lista de Aplicativos

  4. Selecione o separador Aprovisionamento.

    Captura de tela da guia Bônus - Provisionamento. Em Gerenciar, o provisionamento é realçado.

  5. Defina o Modo de Aprovisionamento como Automático.

    Captura de ecrã a mostrar uma caixa de listagem Modo de Aprovisionamento, com Automático selecionado e realçado.

  6. Na seção Credenciais de administrador, insira o token secreto da sua conta de bônus, conforme descrito na Etapa 6.

    Captura de ecrã da secção Credenciais de administrador. A caixa de token secreta está vazia, mas a caixa está realçada.

  7. O Token Secreto para sua conta de Bônus está localizado em Integrações de Empresa > Administradora>. Na seção Se você quiser codificar, clique em API > Create New API Access Token para criar um novo Secret Token.

    Captura de tela do menu Bônus. Em Admin, Company é destacado. Em Empresa, as integrações são destacadas.

    Captura de tela da seção Se você quiser codificar do site Bônus, com A P I em destaque.

    Screenshot do site Bonusly. A guia Serviços está aberta. Em Seus tokens de acesso A P I, Criar novo token de acesso A P I é realçado.

  8. Na tela seguinte, digite um nome para o token de acesso na caixa de texto fornecida e pressione Create Api Key. O novo token de acesso aparecerá por alguns segundos em um pop-up.

    Captura de tela da página Novo token de acesso do site Bônus. Uma caixa sem rótulo contém Meu Token e o botão de tecla Criar um P I é realçado.

    Screenshot do site Bonusly. É visível uma notificação que exibe Novo token de acesso criado, seguido por um token indecifrável.

  9. Ao preencher os campos mostrados na Etapa 5, clique em Testar Conexão para garantir que o Microsoft Entra ID possa se conectar ao Bônus. Se a ligação falhar, certifique-se de que a sua conta Bonusly tem permissões de administrador e tente novamente.

    Captura de ecrã da secção Credenciais de administrador. O botão Conexão de texto é realçado.

  10. No campo Email de notificação, digite o endereço de e-mail de uma pessoa ou grupo que deve receber as notificações de erro de provisionamento e marque a caixa de seleção Enviar uma notificação por e-mail quando ocorrer uma falha.

    Captura de ecrã a mostrar uma caixa de e-mail de Notificação vazia. É visível uma opção rotulada como Enviar uma notificação por e-mail quando ocorre uma falha.

  11. Clique em Guardar.

  12. Na seção Mapeamentos, selecione Sincronizar usuários do Microsoft Entra com Bônus.

  13. Analise os atributos de usuário sincronizados do ID do Microsoft Entra para o Bonusly na seção Mapeamento de Atributos. Os atributos selecionados como propriedades correspondentes são usados para corresponder às contas de usuário em Bônus para operações de atualização. Selecione o botão Salvar para confirmar as alterações.

    Captura de ecrã da página Mapeamentos de Atributos. Uma tabela lista os atributos do Microsoft Entra, os atributos Bonusly correspondentes e o status correspondente.

  14. Para configurar filtros de âmbito, veja as instruções seguintes disponibilizadas no Tutorial de filtro de âmbito.

  15. Para habilitar o serviço de provisionamento do Microsoft Entra para Bônus, altere o Status de Provisionamento para Ativado na seção Configurações.

    Captura de ecrã da secção Definições. A alternância de status de provisionamento está definida como Desativado.

  16. Defina os usuários e/ou grupos que você gostaria de provisionar para Bonusly escolhendo os valores desejados em Escopo na seção Configurações.

    Captura de ecrã a mostrar a caixa de listagem Âmbito. A opção Sincronizar apenas usuários e grupos atribuídos está selecionada na caixa.

  17. Quando estiver pronto para aprovisionar, clique em Guardar.

    Captura de tela de Salvando a configuração de provisionamento.

Esta operação inicia a sincronização inicial de todos os usuários e/ou grupos definidos em Escopo na seção Configurações. A sincronização inicial leva mais tempo para ser executada do que as sincronizações subsequentes, que ocorrem aproximadamente a cada 40 minutos, enquanto o serviço de provisionamento do Microsoft Entra estiver em execução. Você pode usar a seção Detalhes da Sincronização para monitorar o progresso e seguir os links para o relatório de atividade de provisionamento, que descreve todas as ações executadas pelo serviço de provisionamento do Microsoft Entra no Bonusly.

Para obter mais informações sobre como ler os logs de provisionamento do Microsoft Entra, consulte Relatórios sobre provisionamento automático de conta de usuário.

Recursos adicionais

Próximos passos