Partilhar via

Tutorial: Configurar o ClearView Trade para provisionamento automático de usuários

  • Artigo

Este tutorial descreve as etapas que você precisa executar no ClearView Trade e 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 o ClearView Trade usando o serviço de provisionamento do Microsoft Entra. Para obter detalhes importantes sobre o que esse serviço faz, como funciona e perguntas frequentes, consulte Automatizar o provisionamento e o desprovisionamento de usuários para aplicativos SaaS com o Microsoft Entra ID.

Capacidades suportadas

  • Crie usuários no ClearView Trade.
  • Remova os usuários no ClearView Trade quando eles não precisarem mais de acesso.
  • Mantenha os atributos do usuário sincronizados entre o Microsoft Entra ID e o ClearView Trade.
  • Logon único no ClearView Trade (recomendado).

Pré-requisitos

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

Etapa 1: Planejar a implantação do provisionamento

Adicione o ClearView Trade da galeria de aplicativos do Microsoft Entra para começar a gerenciar o provisionamento no ClearView Trade. Se você configurou anteriormente o ClearView Trade para SSO, você pode 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 uma aplicação a partir da galeria aqui.

Etapa 3: Definir quem estará no escopo do provisionamento

O serviço de provisionamento do Microsoft Entra permite definir o escopo de quem será provisionado com base na atribuição ao aplicativo e/ou com base nos atributos do usuário. Se você optar por definir o escopo de quem será provisionado para seu aplicativo com base na atribuição, poderá usar as etapas a seguir para atribuir usuários ao aplicativo. Se você optar por definir o escopo de quem será provisionado com base apenas nos atributos do usuário, poderá usar um filtro de escopo conforme descrito aqui.

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

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

Etapa 4: Configurar o provisionamento automático de usuários para o ClearView Trade

Esta seção orienta você pelas etapas para configurar o serviço de provisionamento do Microsoft Entra para criar, atualizar e desabilitar usuários no ClearView Trade com base nas atribuições de usuário no Microsoft Entra ID.

Para configurar o provisionamento automático de usuários para o ClearView Trade no Microsoft Entra ID:

  1. Entre no centro de administração do Microsoft Entra como pelo menos um administrador de aplicativos na nuvem.

  2. Navegue até Aplicativos de identidade>>Aplicativos corporativos

    Captura de ecrã da folha Aplicações empresariais.

  3. Na lista de aplicativos, selecione ClearView Trade.

    Captura de tela do link ClearView Trade na lista Aplicativos.

  4. Selecione o separador Aprovisionamento.

    Captura de ecrã do separador Aprovisionamento.

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

    Captura de ecrã do separador Aprovisionamento automático.

  6. Na seção Credenciais de administrador, insira a URL do locatário e clique em Autorizar, certifique-se de inserir as credenciais de administrador da sua conta ClearView Trade. Clique em Testar conexão para garantir que o Microsoft Entra ID possa se conectar ao ClearView Trade. Se a conexão falhar, verifique se sua conta ClearView Trade tem permissões de administrador e tente novamente.

    Captura de tela do Token.

  7. No campo Email de notificação, digite o endereço de e-mail de uma pessoa que deve receber as notificações de erro de provisionamento e marque a caixa de seleção Enviar uma notificação por e-mail quando ocorrer uma falha.

    Captura de ecrã do e-mail de notificação.

  8. Selecione Guardar.

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

  10. Analise os atributos de usuário sincronizados do ID do Microsoft Entra para o ClearView Trade na seção Mapeamento de Atributos . Os atributos selecionados como propriedades correspondentes são usados para corresponder às contas de usuário no ClearView Trade para operações de atualização. Se você optar por alterar o atributo de destino correspondente, precisará garantir que a API ClearView Trade ofereça suporte à filtragem de usuários com base nesse atributo. Selecione o botão Salvar para confirmar as alterações.

    Atributo Type Suportado para filtragem Exigido pela ClearView Trade
    nome de utilizador String ✓ ✓
    active Boolean ✓
    emails[type eq "work"].value String
    name.givenName String ✓
    name.familyName String ✓
    endereços[tipo eq "trabalho"].country String
    phoneNumbers[type eq "work"].value String
    externalId String ✓

  11. Para configurar filtros de âmbito, veja as instruções seguintes disponibilizadas no Tutorial de filtro de âmbito.

  12. Para habilitar o serviço de provisionamento do Microsoft Entra para o ClearView Trade, 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 que você gostaria de provisionar para o ClearView Trade escolhendo os valores desejados em Escopo na seção Configurações .

    Captura de tela do escopo de provisionamento.

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

    Captura de tela de Salvando a configuração de provisionamento.

Esta operação inicia o ciclo de sincronização inicial de todos os usuários definidos em 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, enquanto o serviço de provisionamento do Microsoft Entra estiver em execução.

Etapa 5: Monitorar sua implantação

Depois de configurar o aprovisionamento, utilize os seguintes recursos para monitorizar a sua implementação:

  • Utilize os registos de aprovisionamento para determinar quais os utilizadores que foram aprovisionados com ou sem êxito
  • Verifique a barra de progresso para ver o status do ciclo de provisionamento e quão perto ele está de ser concluído
  • 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 aqui.

Mais recursos

Próximos passos