Configure Xledger para provisionamento automático de utilizadores com o Microsoft Entra ID

Este artigo descreve os passos que precisa de executar tanto no Xledger como no Microsoft Entra ID para configurar o provisionamento automático do utilizador. Quando configurado, Microsoft Entra ID provisiona e desprovisiona automaticamente utilizadores e grupos para Xledger usando o serviço de provisionamento Microsoft Entra. Para detalhes importantes sobre o que este serviço faz, como funciona e perguntas mais frequentes, consulte Automatizar o provisionamento e desprovisionamento de utilizadores para aplicações SaaS com Microsoft Entra ID.

Capacidades suportadas

  • Crie usuários no Xledger.
  • Remova os usuários no Xledger quando eles não precisarem mais de acesso.
  • Mantenha os atributos do utilizador sincronizados entre o Microsoft Entra ID e o Xledger.
  • Provisionar grupos e membros de grupos no Xledger.
  • Logon único ao Xledger (recomendado).

Pré-requisitos

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

Etapa 1: Planear a implementação de provisionamento

  1. Saiba como funciona o serviço de aprovisionamento.
  2. Determine quem está incluído no escopo de para o provisionamento de.
  3. Determine quais dados deve mapear entre Microsoft Entra ID e Xledger.

Passo 2: Configure o Xledger para suportar o provisionamento com Microsoft Entra ID

  1. Inicie sessão em Xledger com a função de Administrador de Domínio (ou similar) e navegue para Administração > Acesso ao Sistema > Tokens de Acesso à API.

  2. Gere um Token Secreto e tome nota dele

    Captura de tela de tokens de acesso à API (novo token).

  3. Anote o URL do locatário

    Captura de ecrã do token de acesso da API (api url).

Esses valores são usados na guia Provisionamento do seu aplicativo Xledger. (Passo 5)

Adicione o Xledger da galeria de aplicações Microsoft Entra para começar a gerir o provisionamento para o Xledger. Se você configurou anteriormente o Xledger 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 uma aplicação a partir da galeria aqui.

Etapa 4: Definir quem está no escopo do provisionamento

O serviço de provisionamento Microsoft Entra permite-lhe definir quem é provisionado com base na atribuição à aplicação, ou com base nos atributos do utilizador 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 âmbito do aprovisionamento está definido para os utilizadores e os grupos atribuídos, pode controlar isto ao atribuir um ou dois utilizadores ou grupos à aplicação. Quando o âmbito está definido para todos os utilizadores e grupos, pode especificar um filtro de âmbito baseado em atributos.

  • 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 o Xledger

Esta secção orienta-o pelos passos para configurar o serviço de provisionamento Microsoft Entra para criar, atualizar e desativar utilizadores e/ou grupos no TestApp com base nas atribuições de utilizadores e/ou grupos no Microsoft Entra ID.

Configurar o provisionamento automático de utilizadores para o Xledger no Microsoft Entra ID

  1. Inicie sessão no centro de administração Microsoft Entra pelo menos como Cloud Application Administrator.

  2. Navegue para Entra ID>aplicações empresariais

    Captura de ecrã do painel de Aplicações Empresariais.

  3. Na lista de aplicativos, selecione Xledger.

    Captura de tela do link Xledger na lista Aplicativos.

  4. Selecione o separador Aprovisionamento.

    Captura de tela da guia Provisionamento.

  5. Selecione + Nova configuração.

    Captura de ecrã da nova configuração.

  6. No campo URL do Inquilino , introduza o URL do Tenant do Xledger e o Token Secreto. Selecione Test Connection para garantir que Microsoft Entra ID pode ligar-se ao Xledger. Se a ligação falhar, certifique-se de que a sua conta Xledger 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 ícone Editar para editar as propriedades. Ative os emails de notificação e forneça um email para receber notificações de quarentena. Ativar a prevenção de eliminações acidentais. Selecione Aplicar para salvar as alterações.

    Captura de ecrã das propriedades de provisionamento.

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

  11. Revise os atributos do utilizador que estão sincronizados de Microsoft Entra ID para Xledger na secção Attribute-Mapping. Os atributos selecionados como Correspondência propriedades são usados para corresponder às contas de usuário no Xledger para operações de atualização. Se você optar por alterar o atributo de destino correspondente , precisará garantir que a API do Xledger 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 Exigido pelo Xledger
    nome de utilizador Cordão ✓ ✓
    ativo booleano
    nome de exibição Cordão
    emails[tipo = "trabalho"].valor Cordão
    númerosDeTelefone[tipo igual "trabalho"].valor Cordão
    urn:ietf:params:scim:schemas:extension:xledger:2.0:User:accessFromDate Data e Hora
    urn:ietf:params:scim:schemas:extension:xledger:2.0:User:accessToDate Data e Hora

  12. Selecione Grupos.

  13. Revise os atributos do grupo que estão sincronizados de Microsoft Entra ID para Xledger na secção Attribute-Maping. Os atributos selecionados como propriedades de correspondência são usados para atualizar os grupos no Xledger em operações de correção. Selecione o botão Salvar para confirmar as alterações.

    Atributo Tipo Suportado para filtragem Exigido pelo Xledger
    nome de exibição Cordão ✓ ✓
    Membros Referência

  14. Para configurar os filtros de escopo, consulte as instruções fornecidas no artigo sobre filtros de alcance.

  15. 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.

  16. 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

Conteúdo relacionado

  • Última atualização a