Compartilhar via

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

  • Artigo

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

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. 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 StarLeaf.
  • Uma conta de usuário no StarLeaf com permissões de Administrador.

Atribuir usuários ao StarLeaf

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ários, 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, você deverá decidir quais usuários e grupos do Microsoft Entra ID precisam acessar o StarLeaf. Em seguida, você pode atribuir os usuários e grupos ao StarLeaf seguindo estas instruções.

Dicas importantes para atribuir usuários ao StarLeaf

  • Recomendamos que somente um usuário do Microsoft Entra seja atribuído ao StarLeaf para testar a configuração de provisionamento automático de usuários. Mais usuários e grupos poderão ser atribuídos posteriormente.

  • Ao atribuir um usuário ao StarLeaf, 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 StarLeaf para provisionamento

Antes de configurar o StarLeaf para provisionamento automático de usuário com o Microsoft Entra ID, você precisa configurar o provisionamento SCIM no StarLeaf:

  1. Entre no Console de Administração do StarLeaf. Navegue até Integrações>Adicionar integração.

    Captura de tela do Console de Administração do StarLeaf com as opções Integração e Adicionar integração destacadas.

  2. Selecione o Tipo como Microsoft Entra ID. Insira um nome adequado em Nome. Clique em Aplicar.

    Captura de tela da caixa de diálogo Adicionar integração com as caixas de texto Tipo e Nome destacadas.

  3. Os valores da URL base do SCIM e do Token de acesso são exibidos. Esses valores são inseridos nos campos URL do Locatário e Token de segurança na guia Provisionamento do aplicativo StarLeaf.

    Captura de tela da caixa de diálogo Editar integração com as caixas de texto Tipo, Nome e URL base do SCIM destacadas.

Para configurar o StarLeaf para o provisionamento automático de usuários com o Microsoft Entra ID, é necessário adicioná-lo por meio da galeria de aplicativos do Microsoft Entra à sua lista de aplicativos SaaS gerenciados.

Para adicionar o StarLeaf 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 seção Adicionar por meio da galeria, digite StarLeaf e selecione StarLeaf no painel de resultados. Captura de tela do StarLeaf na lista de resultados.

Configurar o provisionamento automático de usuário para o StarLeaf

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 StarLeaf com base em atribuições de usuário e/ou grupo 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

    Captura de tela da folha de aplicativos empresariais.

  3. Na lista de aplicativos, selecione StarLeaf.

    Captura de tela do link do StarLeaf na lista Aplicativos.

  4. Selecione a guia Provisionamento.

    Captura de tela das opções Gerenciar com a opção Provisionamento destacada.

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

    Captura de tela da lista suspensa Modo de Provisionamento com a opção Automático destacada.

  6. Na seção Credenciais de Administrador, insira os valores URL Base do SCIM e Token de Acesso recuperados anteriormente em URL do Locatário e Token Secreto, respectivamente. Selecione Testar Conectividade para verificar se o Microsoft Entra ID pode se conectar ao StarLeaf. Se a conexão falhar, verifique se a sua conta do StarLeaf tem permissões de Administrador e tente novamente.

    Captura de tela da URL do Locatário + Token.

  7. 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 Enviar uma notificação por email quando ocorrer uma falha.

    Captura de tela do Email de Notificação.

  8. Clique em Save (Salvar).

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

  10. Examine os atributos de usuário que serão sincronizados do Microsoft Entra ID com o StarLeaf 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 StarLeaf em operações de atualização. Selecione o botão Salvar para confirmar as alterações.

    Captura de tela da seção Mapeamentos de Atributos mostrando nove mapeamentos.

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

  12. Para habilitar o serviço de provisionamento do Microsoft Entra no StarLeaf, altere o Status de Provisionamento para Ativado na seção Configurações.

    Captura de tela do Status de Provisionamento ativado.

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

    Captura de tela do escopo de provisionamento.

  14. Quando você estiver pronto para provisionar, clique em Salvar.

    Captura de tela de como salvar a Configuração de Provisionamento.

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 StarLeaf.

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

Limitações do conector

  • No momento, o StarLeaf não dá suporte ao provisionamento de grupo.
  • O StarLeaf requer que os valores emails e userName tenham o mesmo valor de origem.

Mais recursos

Próximas etapas