Tutorial: Configurar o Reward Gateway para o provisionamento automático de usuário
O objetivo deste tutorial é demonstrar as etapas a serem executadas no Reward Gateway e no Microsoft Entra ID para configurar o Microsoft Entra ID a fim de provisionar e desprovisionar usuários e/ou grupos automaticamente no Reward Gateway.
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.
Atualmente, esse conector está em versão prévia pública. Para obter mais informações, consulte Termos de Licença Universal para Serviços Online.
Pré-requisitos
O cenário descrito neste tutorial pressupõe que você já tem os seguintes pré-requisitos:
- Um locatário do Microsoft Entra.
- Um locatário do Reward Gateway.
- Uma conta de usuário no Reward Gateway com permissões de Administrador.
Atribuir usuários ao Reward Gateway
O Microsoft Entra ID usa um conceito chamado atribuições para determinar quais usuários 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 Reward Gateway. Depois de decidir isso, você poderá atribuir esses usuários e/ou grupos ao Reward Gateway seguindo as instruções em Atribuir um usuário ou grupo a um aplicativo empresarial.
Dicas importantes para atribuir usuários ao Reward Gateway
Recomendamos que somente um usuário do Microsoft Entra seja atribuído ao Reward Gateway 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 Reward Gateway, selecione qualquer função válida específica do aplicativo (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.
Configurar o Reward Gateway para provisionamento
Antes de configurar o Reward Gateway para o provisionamento automático de usuário com o Microsoft Entra ID, você precisará habilitar o provisionamento do SCIM no Reward Gateway.
Entre no Console de Administração do Reward Gateway. Clique em Integrações.
Selecione Minha Integração.
Copie os valores de URL do SCIM (v2) e Token de Portador OAuth. Estes valores serão inseridos nos campos “URL do locatário” e “Token do segredo” da guia “Provisionamento” do aplicativo Reward Gateway.
Adicionar o Reward Gateway da Galeria
Para configurar o Reward Gateway para o provisionamento automático de usuários com o Microsoft Entra ID, é necessário adicionar o Reward Gateway por meio da galeria de aplicativos do Microsoft Entra à lista de aplicativos SaaS gerenciados.
Para adicionar o Reward Gateway usando a galeria de aplicativos do Microsoft Entra, execute as seguintes etapas:
- Entre no Centro de administração do Microsoft Entra como pelo menos Administrador de Aplicativo de nuvem.
- Navegue até Identidade>Aplicativos>Aplicativos empresariais>Novo aplicativo.
- Na seção Adicionar da galeria, digite Reward Gateway e selecione Reward Gateway na caixa de pesquisa.
- Selecione Reward Gateway no painel de resultados e adicione o aplicativo. Aguarde alguns segundos enquanto o aplicativo é adicionado ao seu locatário.
Configurar o provisionamento automático de usuário no Reward Gateway
Essa 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 no Reward Gateway com base em atribuições de usuário e/ou grupo no Microsoft Entra ID.
Dica
Você também pode optar por habilitar o logon único baseado em SAML para o Reward Gateway seguindo as instruções fornecidas no tutorial de logon único do Reward Gateway. 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 Reward Gateway no Microsoft Entra ID:
Entre no Centro de administração do Microsoft Entra como pelo menos Administrador de Aplicativo de nuvem.
Navegue até Identidade>Aplicativos>Aplicativos empresariais
Na lista de aplicativos, selecione Reward Gateway.
Selecione a guia Provisionamento.
Defina o Modo de Provisionamento como Automático.
Na seção Credenciais de Administrador, insira os valores URL do SCIM (v2) e Token de Portador OAuth recuperados anteriormente em URL do Locatário e Token Secreto, respectivamente. Selecione Testar Conexão para verificar se o Microsoft Entra ID pode se conectar ao Reward Gateway. Se a conexão falhar, verifique se a sua conta do Reward Gateway tem permissões de Administrador e tente novamente.
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.
Clique em Save (Salvar).
Na seção Mapeamentos, selecione Sincronizar usuários do Microsoft Entra com o Reward Gateway.
Revise os atributos de usuário que serão sincronizados do Microsoft Entra ID com o Reward Gateway na seção Mapeamento de Atributos. Os atributos selecionados como propriedades Correspondentes são usados para fazer a correspondência das contas de usuário no Reward Gateway em operações de atualização. Selecione o botão Salvar para confirmar as alterações.
Para configurar filtros de escopo, consulte as seguintes instruções fornecidas no tutorial do Filtro de Escopo.
Para habilitar o serviço de provisionamento do Microsoft Entra no Reward Gateway, altere o Status de Provisionamento para Ativado na seção Configurações.
Defina os usuários e/ou os grupos que deseja provisionar no Reward Gateway escolhendo os valores desejados em Escopo na seção Configurações.
Quando estiver pronto para provisionar, clique em Salvar.
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 Reward Gateway.
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.
Limitações do conector
O Reward Gateway não dá suporte ao provisionamento de grupo no momento.
Recursos adicionais
- Gerenciamento do provisionamento de conta de usuário para Aplicativos Empresariais
- O que é o acesso a aplicativos e logon único com o Microsoft Entra ID?
Próximas etapas
Saiba como fazer revisão de logs e obter relatórios sobre atividade de provisionamento