Compartilhar via

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

  • Artigo

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

Observação

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 ele funciona e perguntas frequentes, confira 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á possui o seguinte:

  • Um locatário do Microsoft Entra
  • Um locatário do Bonusly
  • Uma conta de usuário no Bonusly com permissões de administrador

Observação

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

Para configurar o Bonusly para o provisionamento automático de usuários com o Microsoft Entra ID, é necessário adicionar o Bonusly da galeria de aplicativos do Microsoft Entra à sua lista de aplicativos SaaS gerenciados.

Para adicionar o Bonusly usando a galeria de aplicativos do Microsoft Entra, execute as seguintes etapas:

  1. Entre no Centro de administração do Microsoft Entra como pelo menos Administrador de Aplicativo de nuvem.

  2. Navegue até Identidade>Aplicativos>Aplicativos empresariais>Novo aplicativo.

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

    Bonusly na lista de resultados

Atribuindo usuários ao Bonusly

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

Para configurar e habilitar o provisionamento automático de usuário, decida quais usuários e/ou grupos no Microsoft Entra ID precisam de acesso ao Bonusly. Depois de decidir, é possível atribuir esses usuários e/ou grupos ao Bonusly seguindo estas instruções:

Dicas importantes para atribuir usuários ao Bonusly

  • Recomendamos que somente um usuário do Microsoft Entra seja atribuído ao Bonusly para testar a configuração de provisionamento automático de usuários. Outros usuários e/ou grupos podem ser atribuídos mais tarde.

  • Ao atribuir um usuário ao Bonusly, é necessário selecionar qualquer função específica ao aplicativo válida (se disponível) na caixa de diálogo de atribuição. Usuários com a função Acesso padrão são excluídos do provisionamento.

Configurando o provisionamento automático de usuário no Bonusly

Esta seção descreve as etapas de configuração do serviço de provisionamento do Microsoft Entra para criar, atualizar e desabilitar usuários e/ou grupos no Bonusly com base em atribuições de usuário e/ou de grupo no Microsoft Entra ID.

Dica

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

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

  1. Entre no Centro de administração do Microsoft Entra como pelo menos Administrador de Aplicativo de nuvem.

  2. Navegue até Identidade>Aplicativos>Aplicativos empresariais>Bonusly.

    Folha de aplicativos empresariais

  3. Na lista de aplicativos, escolha o Bonusly.

    O link do Bonusly na lista de Aplicativos

  4. Selecione a guia Provisionamento.

    Captura de tela do Bonusly – guia Provisionamento. Em Gerenciar, o Provisionamento é realçado.

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

    Captura de tela mostrando uma caixa de listagem Modo de Provisionamento, com Automático selecionado e realçado.

  6. Na seção Credenciais de administrador, insira o Token secreto da sua conta Bonusly conforme descrito na etapa 6.

    Captura de tela da seção Credenciais de administrador. A caixa Token secreto está vazia, mas realçada.

  7. O Token Secreto da sua conta Bonusly está localizado em Administrador > Empresa > Integrações. Na seção Se desejar codificar, clique em API > Criar novo token de acesso de API para criar um novo token secreto.

    Captura de tela do menu do Bonusly. Em Administrador, a opção Empresa está realçada. Em Empresa, a opção Integrações está realçada.

    Captura de tela da seção Se você deseja codificar do site do Bonusly, com a opção A P I realçada.

    Captura de tela do site do Bonusly. A guia Serviços está aberta. Em Seus tokens de acesso de A P I, a opção Criar token de acesso de A P I está realçada.

  8. Na tela seguinte, digite um nome para o token de acesso na caixa de texto fornecida e pressione Criar chave de Api. O novo token de acesso será exibido durante alguns segundos em uma pop-up.

    Captura de tela da página Novo token de acesso do site do Bonusly. Uma caixa sem rótulo contém Meu Token, e o botão Criar chave de A P I está realçado.

    Captura de tela do site do Bonusly. Uma notificação está visível e mostra o token de acesso criado, seguido por um token indecifrável.

  9. Ao preencher os campos mostrados na Etapa 5, clique em Testar Conectividade para verificar se o Microsoft Entra ID pode se conectar ao Bonusly. Se a conexão falhar, verifique se sua conta Bonusly tem permissões de administrador e tente novamente.

    Captura de tela da seção “Credenciais de administrador”. O botão “Testar conexão” está realçado.

  10. No campo Notificação por Email, insira o endereço de email de uma pessoa ou grupo que deverá receber as notificações de erro de provisionamento e selecione a caixa de seleção Enviar uma notificação por email quando ocorrer uma falha.

    Captura de tela mostrando uma caixa de notificação por email vazia. Uma opção está visível e tem o rótulo Enviar uma notificação por email quando ocorrer uma falha.

  11. Clique em Save (Salvar).

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

    Captura de tela da seção Mapeamentos. Em Nome, Sincronizar usuários do Microsoft Entra com o Bonusly está destacado.

  13. Examine os atributos de usuário que serão sincronizados do Microsoft Entra ID com o Bonusly na seção Mapeamento de atributos. Os atributos selecionados como propriedades Correspondentes são usados para fazer a correspondência entre as contas de usuário no Bonusly para operações de atualização. Selecione o botão Salvar para confirmar as alterações.

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

  14. Para configurar filtros de escopo, consulte as seguintes instruções fornecidas no tutorial do Filtro de Escopo.

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

    Captura de tela da seção Configurações. O botão Status do provisionamento está definido como Desativado.

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

    Captura de tela mostrando a caixa de listagem Escopo. A opção Sincronizar somente usuários e grupos atribuídos está selecionada.

  17. Quando estiver pronto para provisionar, clique em Salvar.

    Captura de tela da página Bonusly – Provisionamento, com o botão Salvar realçado.

Essa operação inicia a sincronização inicial de todos os usuários e/ou grupos definidos no Escopo na seção Configurações. Observe que a sincronização inicial levará mais tempo do que as sincronizações subsequentes, que ocorrem aproximadamente a cada 40 minutos, desde que o serviço de provisionamento do Microsoft Entra esteja em execução. Use a seção Detalhes de Sincronização para monitorar o progresso e siga os links para o relatório de atividades 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, confira Relatórios sobre o provisionamento automático de contas de usuário.

Recursos adicionais

Próximas etapas