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

Este artigo descreve as etapas que você precisa executar no Astro e no Microsoft Entra ID para configurar usuários automáticos e provisionamento de grupo. Quando configurado, o Microsoft Entra ID provisiona e desprovisiona automaticamente os usuários para o Astro 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 Astro.
  • Remova os usuários no Astro quando eles não precisarem mais de acesso.
  • Mantenha os atributos do usuário sincronizados entre o Microsoft Entra ID e o Astro.
  • Provisão de grupos e membros de grupos no Astro.
  • Início de sessão único no Astro (recomendado).

Pré-requisitos

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

Etapa 1: Planear o seu processo de provisionamento

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

Entre em contato com o suporte do Astro para configurar o Astro para oferecer suporte ao provisionamento com o Microsoft Entra ID.

Adicione o Astro da galeria de aplicativos do Microsoft Entra para começar a gerenciar o provisionamento no Astro. Se você já configurou o Astro 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 um aplicativo da galeria aqui.

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 â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 escopo é definido para todos os usuários e grupos, você pode especificar um filtro de escopo baseado em atributo.

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

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

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 grupos no Astro com base nas atribuições de usuário no Microsoft Entra ID.

Para configurar o provisionamento automático de usuários para o Astro 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é Entra ID>aplicações empresariais

    Captura de ecrã do painel de aplicações empresariais.

  3. Na lista de aplicativos, selecione Astro.

    Captura de tela do link Astro na lista Aplicativos.

  4. Selecione a guia Provisionamento .

    Captura de ecrã do separador Aprovisionamento.

  5. Selecione + Nova configuração.

    Captura de ecrã do separador Aprovisionamento automático.

  6. No campo URL do Inquilino , introduza o seu URL do Inquilino Astro e o Token Secreto. Selecione Testar conexão para garantir que o Microsoft Entra ID possa se conectar ao Astro. Se a ligação falhar, certifique-se de que a sua conta Astro 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ã das propriedades de provisionamento.

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

  2. Analise os atributos de usuário sincronizados do ID do Microsoft Entra para o Astro na seção Mapeamento de Atributos . Os atributos selecionados como propriedades correspondentes são usados para corresponder às contas de usuário no Astro para operações de atualização. Se você optar por alterar o atributo de destino correspondente, precisará garantir que a API do Astro 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 por Astro
    nome de utilizador Cordão ✓ ✓
    ativo booleano ✓
    nome de exibição Cordão ✓

Selecione Grupos.

  1. Analise os atributos de grupo que são sincronizados do ID do Microsoft Entra para o Astro na seção Mapeamento de Atributos . Os atributos selecionados como propriedades correspondentes são usados para corresponder aos grupos no Astro para operações de atualização. Selecione o botão Salvar para confirmar as alterações.

    Atributo Tipo Suportado para filtragem Exigido por Astro
    nome de exibição Cordão ✓ ✓
    Id externo Cordão ✓

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

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

  4. 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 o estado de quarentena de provisionamento de aplicações no artigo Status de quarentena de provisionamento de aplicações.

Mais recursos

Conteúdo relacionado

  • Last updated on