Configurar o Preciate para provisionamento automático de usuários com o Microsoft Entra ID

Este artigo descreve as etapas que você precisa executar no Preciate e no Microsoft Entra ID para configurar o provisionamento automático de usuários. Quando configurado, o Microsoft Entra ID provisiona e desprovisiona automaticamente usuários e grupos para Preciate 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

  • Criar usuários no Preciate
  • Remover usuários no Preciate quando eles não precisarem mais de acesso
  • Mantenha os atributos do usuário sincronizados entre o Microsoft Entra ID e o Preciate

Pré-requisitos

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

  • Um inquilino Preciate.
  • Uma conta de usuário no Preciate com permissões de administrador.

Etapa 1: Planear a implementação de provisionamento

  1. Saiba como funciona o serviço de aprovisionamento.
  2. Determine quem faz parte do escopo de aprovisionamento.
  3. Determine quais dados mapear entre o Microsoft Entra ID e o Preciate.

Etapa 2: Configurar o Preciate para dar suporte ao provisionamento com o Microsoft Entra ID

  1. Entre no Preciate Admin Portal e navegue até a página Integrações .

    Captura de ecrã da página de configuração do token secreto Preciate.

  2. Selecione o botão Gerar onde diz Chave Secreta de Integração do Ative Directory.

    Captura de ecrã da página de geração de token secreto do Preciate.

  3. Uma nova Chave Secreta é exibida. Copie e salve a chave secreta . Observe também que a URL do locatário é https://preciate.com/api/v1/scim. Esses valores são inseridos no campo Token secreto e URL do locatário na guia Provisionamento do aplicativo do seu Preciate.

Observação

Toda vez que você seleciona o botão Gerar, uma nova chave secreta é criada. Isso invalida imediatamente o atual. Se uma integração já estiver usando ativamente a chave atual, gerar a nova fará com que a integração pare de funcionar até que o Token Secreto seja atualizado no aplicativo do Preciate no portal do Azure.

Adicione o Preciate na galeria de aplicativos do Microsoft Entra para começar a gerenciar o provisionamento no Preciate. Se você tiver configurado anteriormente o Preciate for Single sign-on (SSO), poderá usar o mesmo aplicativo. No entanto, recomendamos que você crie um aplicativo separado ao testar a integração inicialmente. Saiba mais sobre como adicionar um aplicativo na galeria de .

Etapa 4: Definir quem está no escopo do 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 nos atributos do usuário ou grupo. Se você optar por definir o escopo de quem é provisionado para seu aplicativo com base na atribuição, poderá usar as etapas para atribuir usuários e grupos ao aplicativo. Se você optar por definir o escopo de quem é provisionado com base apenas nos 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 para provisionamento é definido como 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 você precisar de funções extras, poderá atualizar o manifesto do aplicativo para adicionar novas funções.

Etapa 5: Configurar o provisionamento automático de usuários para Preciate

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

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

  1. Entre no centro de administração do Microsoft Entra como, no mínimo, um administrador de aplicações na nuvem.

  2. Navegue para Entra ID>Aplicações Empresariais.

    Captura de ecrã da seção de Aplicações Empresariais.

  3. Na lista de aplicativos, selecione Preciate.

    Captura de ecrã do link Preciate na lista de aplicações.

  4. Selecione o separador Aprovisionamento.

    Captura de ecrã do separador Provisionamento para configurar o provisionamento automático do utilizador.

  5. Selecione + Nova configuração.

    Captura de ecrã da aba Aprovisionamento automático.

  6. No campo Tenant URL, introduza o seu Preciate Tenant URL e o Token Secreto. Selecione Testar conexão para garantir que o Microsoft Entra ID possa se conectar ao Preciate. Se a ligação falhar, certifique-se de que a sua conta Preciate tem as permissões de administrador necessárias e tente novamente.

    Captura de ecrã da ligação de teste de provisionamento.

  7. Selecione Criar para criar a sua configuração.

  8. Selecione Propriedades na página de Visão Geral.

  9. Selecione o lápis para editar as propriedades. Habilite e-mails de notificação e forneça um e-mail para receber e-mails de quarentena. Ative a opção para evitar eliminação acidental. Selecione Aplicar para salvar as alterações.

    Captura de ecrã da página de propriedades de Provisionamento a mostrar as notificações e definições de eliminação.

  10. Selecione Mapeamento de Atributos no painel esquerdo e selecione utilizadores.

  11. Analise os atributos de utilizador sincronizados do Microsoft Entra ID para o Preciate na secção Attribute-Mapping. Os atributos selecionados como Correspondência propriedades são usados para corresponder às contas de usuário no Preciate para operações de atualização. Se você optar por alterar o atributo de destino correspondente, precisará garantir que a API Preciate ofereça suporte à filtragem de usuários com base nesse atributo. Selecione o botão Salvar para confirmar as alterações.

    Atributo Tipo Suportado para filtragem
    nome de utilizador Corda
    ativo booleano
    nome de exibição Corda
    título Corda
    nome.dado Corda
    nome.sobrenome Corda
    nome formatado Corda
    Id externo Corda
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:departamento Corda
  12. Para configurar filtros de escopo, consulte as instruções a seguir fornecidas no artigo Filtro de escopo .

  13. Use provisionamento sob demanda para validar a sincronização com um pequeno número de utilizadores antes de uma implementação mais ampla na sua organização.

  14. Quando estiver pronto para provisionar, selecione Iniciar Provisão na página de Visão Geral .

Etapa 6: Monitorar sua implantação

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

  1. Use os logs de provisionamento para determinar quais usuários são provisionados com ou sem êxito
  2. Verifique a barra de progresso para ver o status do ciclo de provisionamento e quão perto ele está de ser concluído
  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 de provisionamento no artigo de status de quarentena de aplicativo de.

Mais recursos