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
  • Autenticação com token portador de longa duração suportada.

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