Compartilhar via


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

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. Usuários e grupos adicionais podem ser atribuídos mais tarde.

  • 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

Para configurar o StarLeaf para o provisionamento automático de usuários com o Microsoft Entra ID, você precisará configurar o provisionamento do SCIM no StarLeaf:

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

    Screenshot of the StarLeaf Admin Console with the Integrations and Add integration options called out.

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

    Screenshot of the Add integration dialog box with the Type and Name text boxes called out.

  3. Os valores URL base do SCIM e Token de acesso serão exibidos. Esses valores serão inseridos nos campos URL do Locatário e Token Secreto na guia Provisionamento do seu aplicativo StarLeaf.

    Screenshot of the Edit integration dialog box with the Type, Name, and SCIM base URL text boxes called out.

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. StarLeaf in the results list

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

    Enterprise applications blade

  3. Na lista de aplicativos, selecione StarLeaf.

    The StarLeaf link in the Applications list

  4. Selecione a guia Provisionamento.

    Screenshot of the Manage options with the Provisioning option called out.

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

    Screenshot of the Provisioning Mode dropdown list with the Automatic option called out.

  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.

    Tenant URL + 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.

    Notification Email

  8. Clique em Save (Salvar).

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

    Screenshot of the Mappings section showing the Synchronize Microsoft Entra users to StarLeaf option.

  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.

    Screenshot of the Attribute Mappings section showing nine mappings displayed.

  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.

    Provisioning Status Toggled On

  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.

    Provisioning Scope

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

    Saving Provisioning Configuration

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.

Recursos adicionais

Próximas etapas