Configure o Funnel Leasing para provisionamento automático de usuários com o Microsoft Entra ID

Este artigo descreve as etapas que você precisa executar tanto no Funnel Leasing quanto no Microsoft Entra ID para configurar o provisionamento automático de usuários. Quando configurado, o Microsoft Entra ID provisiona e desprovisiona automaticamente os usuários para Funnel Leasing usando o serviço de provisionamento do Microsoft Entra. Para obter detalhes importantes sobre o que esse serviço faz, como ele funciona e perguntas frequentes, consulte Automatizar o provisionamento e o desprovisionamento de usuários em aplicativos SaaS com a ID do Microsoft Entra.

Capacidades suportadas

• Criar usuários no Funnel Leasing.
• Remova os usuários no Funnel Leasing quando não precisarem mais ter acesso.
• Manter os atributos de usuário sincronizados entre a ID do Microsoft Entra e o Funnel Leasing.
• Autenticação única na Funnel Leasing (recomendado).

Pré-requisitos

O cenário descrito neste artigo pressupõe que você já tenha os seguintes pré-requisitos:

• Um locatário do Microsoft Entra
• Uma das seguintes funções: Administrador de Aplicativos, Administrador de Aplicativos na Nuvem ou Proprietário do Aplicativo.
• Uma comunidade ao vivo no Funnel ou pelo menos uma confirmação de que toda a configuração necessária foi feita no lado do Funnel em preparação para uma data de ativação.

Etapa 1: planejar a implantação de provisionamento

1. Saiba mais sobre como o serviço de provisionamento funciona.
2. Determine quem está no escopo do provisionamento.
3. Determine os dados que devem ser mapeados entre a ID do Microsoft Entra e o Funnel Leasing.

Etapa 2: Configurar o Funnel Leasing para dar suporte ao provisionamento com a ID do Microsoft Entra

Entre em contato com o Gerente de contas do Funnel e informe que você deseja habilitar o provisionamento de usuário no Microsoft Entra. Ele fornecerá um token de portador de autenticação.

Etapa 3: Adicionar o Microsoft Entra por meio da galeria de aplicativos do Microsoft Entra

Adicione o Funnel Leasing por meio da galeria de aplicativos do Microsoft Entra para começar a gerenciar o provisionamento no Funnel Leasing. Se você já tiver configurado o Funnel Leasing para SSO, poderá usar o mesmo aplicativo. No entanto, é recomendável que você crie um aplicativo separado ao testar a integração inicialmente. Saiba mais sobre como adicionar um aplicativo por meio da galeria aqui.

Etapa 4: Definir quem está no escopo de provisionamento

O serviço de provisionamento do Microsoft Entra permite definir o escopo de quem é provisionado com base na atribuição ao aplicativo ou com base em atributos do usuário ou do grupo. Se você optar por determinar quem será provisionado para seu aplicativo com base em atribuições, poderá seguir as etapas para atribuir usuários e grupos ao aplicativo. Se você optar por definir o escopo de quem é provisionado com base apenas em atributos do usuário ou grupo, poderá usar um filtro de escopo.

• Comece pequeno. Teste com um pequeno conjunto de usuários e grupos antes de distribuir para todos. Quando o escopo do provisionamento é definido para usuários e grupos atribuídos, você pode controlar isso atribuindo um ou dois usuários ou grupos ao aplicativo. Quando o escopo é definido para todos os usuários e grupos, você pode especificar um filtro de escopo baseado em atributo .

• Se precisar de funções extras, você poderá atualizar o manifesto do aplicativo para adicionar novas funções.

Etapa 5: Configurar o provisionamento automático de usuário para o Funnel Leasing

Esta seção explica como conectar a ID do Microsoft Entra à API de provisionamento de contas de usuário do Funnel e como configurar o serviço de provisionamento para criar, atualizar e desabilitar contas de usuário atribuídas no Funnel com base na atribuição de usuários na ID do Microsoft Entra.

Para configurar o provisionamento automático de usuário para o Funnel Leasing na ID do Microsoft Entra:

1. Entre no Centro de administração do Microsoft Entra como pelo menos um Administrador de Aplicativos na Nuvem.

2. Navegue até Entra ID>Aplicativos empresariais

   

3. Na lista de aplicativos, selecione Funil.

   

4. Selecione a guia Provisionamento .

   

5. Defina o modo de provisionamento como Automático.

   

6. Na seção Credenciais de Administrador, insira https://nestiolistings.com/scim/v2 como a URL do Locatário e o Token Secreto recuperado anteriormente do seu Gerenciador de Contas do Funnel (o token de portador de autenticação). Selecione Testar Conexão para garantir que a ID do Microsoft Entra possa se conectar ao Funil. Se a conexão falhar, verifique se você tem um token de autenticação válido no Gerenciador de Contas do Funnel.

   

7. No campo Email de Notificação, insira o endereço de email de uma pessoa que deve 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.

   

8. Selecione Salvar.

9. Na seção Mapeamentos, selecione Sincronizar usuários do Microsoft Entra para o Funnel Leasing.

10. Revise os atributos de usuário que são sincronizados da ID do Microsoft Entra para a Funnel Leasing na seção Mapeamento de Atributos. Os atributos selecionados como propriedades Correspondentes serão usados para fazer a correspondência entre as contas de usuário no Funnel Leasing para operações de atualização. Se você optar por alterar o atributo de destino correspondente, precisará verificar se a API do Funnel Leasing é compatível com a filtragem de usuários com base nesse atributo. Selecione o botão Salvar para confirmar as alterações.

    Atributo	Tipo	Com suporte para filtragem	Exigido pela locação do Funnel Leasing
    userName	fio	✓	✓
    ativo	Booliano		✓
    título	fio
    emails[type eq "work"].value	fio		✓
    name.givenName	fio		✓
    name.familyName	fio		✓
    phoneNumbers[type eq "work"].value	fio
    phoneNumbers[type eq "mobile"].value	fio
    externalId	fio

11. Para configurar filtros de escopo, consulte as instruções a seguir fornecidas no artigo de filtro de escopo .

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

    

13. Defina os usuários que você deseja provisionar para o Funnel Leasing escolhendo os valores desejados em Escopo na seção Configurações.

    

14. Quando estiver pronto para provisionar, selecione Salvar.

    

Esta operação inicia o ciclo de sincronização inicial de todos os usuários definidos no Escopo na seção Configurações . O ciclo inicial leva mais tempo para ser executado do que os ciclos subsequentes, que ocorrem aproximadamente a cada 40 minutos, desde que o serviço de provisionamento do Microsoft Entra esteja em execução.

Etapa 6: Monitorar sua implantação

Depois de configurar o provisionamento, use os seguintes recursos para monitorar sua implantação:

1. Utilize os logs de provisionamento para determinar quais usuários foram provisionados com sucesso ou sem sucesso.
2. Verifique a barra de progresso para ver o status do ciclo de provisionamento e o quão perto está da conclusão
3. Se a configuração de provisionamento parecer estar em um estado não íntegro, o aplicativo entrará em quarentena. Saiba mais sobre os estados de quarentena no artigo Status de quarentena do provisionamento do aplicativo.

Mapeamentos de função e grupo

O Funnel usa uma funcionalidade de mapeamento personalizada para associar um usuário do Azure a uma função no Funnel ou a um usuário do Azure a um grupo de funcionários do Funnel.

• Quais campos do Azure são usados?

  Para mapeamentos de função, o Funnel examina o atributo SCIM title por padrão. Esse atributo SCIM é mapeado para o atributo de usuário jobTitle do Azure por padrão.

  Para mapeamentos de grupo, o Funnel analisa o atributo SCIM userType por padrão. Esse atributo SCIM é mapeado para o atributo de usuário department do Azure por padrão.

  Se você quiser alterar quais campos são usados, edite a seção Mapeamentos de Atributos e mapeie seus campos desejados para title e userType.

• Quais valores são usados?

  Para a configuração inicial, determine cada valor que você deseja usar para os mapeamentos de função e grupo. Forneça esses valores ao Gerenciador de Contas do Funnel para configurar a configuração no Funnel.

  Por exemplo, se você quiser definir o campo jobTitle com um valor agent, precisará informar ao Gerente de Contas do Funil em qual função do Funil esse valor deve ser mapeado.

  Se você precisar atualizar ou adicionar novos valores no futuro, será necessário notificar o Gerenciador de Contas de Funil.

• Como associar um usuário a várias funções e grupos?

  Não é possível associar um usuário a várias funções de Funil, mas é possível associar um usuário a vários grupos de funcionários do Funil.

  Para associar um usuário a vários grupos de funcionários do Funil, você precisa especificar vários valores no atributo de department usuário (ou qualquer atributo para o qual você mapeou userType). Cada valor precisará ser separado por um delimitador. Por padrão, o caractere - é usado como delimitador. Para usar outro delimitador, você precisa notificar o gerente de conta do Funil.

Mais recursos

• Gerenciando o provisionamento de conta de usuário para Aplicativos Empresariais
• O que é o acesso ao aplicativo e o logon único com a ID do Microsoft Entra?

Conteúdo relacionado

• Saiba como revisar logs e obter relatórios sobre a atividade de provisionamento