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

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

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á tem os seguintes pré-requisitos:

• Um locatário do Microsoft Entra
• Um locatário do Looop
• Uma conta de usuário em um Looop com permissões de administrador.

Atribuir usuários ao Looop

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.

Antes de configurar e habilitar o provisionamento automático de usuários, você deve decidir quais usuários e/ou grupos no Microsoft Entra ID precisam acessar o Looop. Depois de decidir, é possível atribuir esses usuários e/ou grupos ao Looop seguindo estas instruções:

• Atribuir um usuário ou um grupo a um aplicativo empresarial

Dicas importantes para atribuir usuários ao Looop

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

• Quando você atribui um usuário ao Looop, é 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.

Configurar o Looop para provisionamento

Antes de configurar o Looop para o provisionamento automático de usuário com o Microsoft Entra ID, será necessário recuperar algumas informações de provisionamento do Looop.

1. Entre em seu Console de Administração do Looop e selecione Conta. Em Configurações da conta, selecione Autenticação.

   

2. Gere um novo token clicando em Redefinir Token em Integração do SCIM.

   

3. Copie o Ponto de Extremidade do SCIM e o Token. Esses valores serão inseridos nos campos URL do Locatário e Token Secreto na guia Provisionamento do seu aplicativo Looop.

   

Adicionar Looop da galeria

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

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 da galeria, digite Looop e selecione Looop no painel de resultados.

   

4. Selecione o botão Inscrever-se no Looop, que redirecionará você à página de logon do Looop.

   

5. Como o Looop é um aplicativo OpenIDConnect, opte por fazer logon no Looop usando sua conta corporativa da Microsoft.

   

6. Após uma autenticação bem-sucedida, aceite a solicitação de consentimento da página de consentimento. O aplicativo será automaticamente adicionado ao seu locatário e você será redirecionado à sua conta do Looop.

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

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 Looop com base em atribuições de usuário e/ou grupo no Microsoft Entra ID.

Para configurar o provisionamento automático de usuário para o Looop 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

   

3. Na lista de aplicativos, selecione Looop.

   

4. Selecione a guia Provisionamento.

   

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

   

6. Na seção Credenciais de Administrador, insira https://<organisation_domain>.looop.co/scim/v2 em URL do Locatário. Por exemplo, https://demo.looop.co/scim/v2. Insira o valor que você recuperou e salvou anteriormente do Looop no Token Secreto. Clique em Testar conexão para garantir que o Microsoft Entra ID possa se conectar ao Looop. Se a conexão falhar, verifique se a sua conta do Looop tem permissões de administrador e tente novamente.

   

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

   

8. Clique em Save (Salvar).

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

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

    Atributo	Type	Com suporte para filtragem
    userName	String	✓
    ativo	Boolean
    emails[type eq "work"].value	String
    name.givenName	String
    name.familyName	String
    externalId	String
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:department	String
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:employeeNumber	String
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:manager	String
    urn:ietf:params:scim:schemas:extension:Looop:2.0:User:area	String
    urn:ietf:params:scim:schemas:extension:Looop:2.0:User:custom_1	String
    urn:ietf:params:scim:schemas:extension:Looop:2.0:User:custom_2	String
    urn:ietf:params:scim:schemas:extension:Looop:2.0:User:custom_3	String
    urn:ietf:params:scim:schemas:extension:Looop:2.0:User:location	String
    urn:ietf:params:scim:schemas:extension:Looop:2.0:User:position	String
    urn:ietf:params:scim:schemas:extension:Looop:2.0:User:startAt	String

11. Na seção Mapeamentos, selecione Sincronizar grupos do Microsoft Entra com o Meta Networks Connector.

12. Examine os atributos de grupo que serão sincronizados do Microsoft Entra ID com o Meta Networks Connector na seção Mapeamento de atributos. Os atributos selecionados como propriedades Correspondentes são usados para fazer a correspondência dos grupos no Meta Networks Connector em operações de atualização. Selecione o botão Salvar para confirmar as alterações.

    Atributo	Type	Com suporte para filtragem
    displayName	String	✓
    membros	Referência
    externalId	String

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

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

    

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

    

16. 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. A sincronização inicial leva mais tempo para ser executada do que as sincronizações seguintes, que ocorrem aproximadamente a cada 40 minutos, desde que o serviço de provisionamento do Microsoft Entra esteja em execução. Você pode usar a seção Detalhes da sincronização para monitorar o progresso e seguir 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 Looop.

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.

Log de alterações

• 07/15/2021 – Os atributos de usuário de extensão do Enterprise urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:department, urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:employeeNumber e urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:manager foram adicionados.
• 07/15/2021 – Os atributos de usuário de extensão personalizados urn:ietf:params:scim:schemas:extension:Looop:2.0:User:department e urn:ietf:params:scim:schemas:extension:Looop:2.0:User:employee_id foram removidos.

Mais recursos

• 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