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

Este artigo descreve as etapas que você precisa executar na Asana 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 a Asana 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 na Asana.
  • Remova os usuários na Asana quando eles não precisarem mais de acesso.
  • Mantenha os atributos do usuário sincronizados entre o Microsoft Entra ID e a Asana.
  • Provisionar grupos e membros de grupos na Asana.
  • Logon único na Asana (recomendado).

Pré-requisitos

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

  • Um cliente Asana com um plano Enterprise ou superior ativado
  • Uma conta de usuário na Asana com permissões de administrador

Observação

A integração de provisionamento do Microsoft Entra depende da API da Asana, que está disponível para a Asana.

Etapa 1: Planear a implementação de provisionamento

  1. Saiba mais sobre como funciona o serviço de provisionamento.
  2. Determine quem está no escopo de provisionamento.
  3. Determine quais dados mapear entre o Microsoft Entra ID e a Asana.

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

Sugestão

Para habilitar o logon único baseado em SAML para a Asana, siga as instruções fornecidas. O logon único pode ser configurado independentemente do provisionamento automático, embora esses dois recursos se complementem.

Gerar token de conta de serviço na Asana

  1. Inicie sessão na Asana utilizando a sua conta de administrador.

  2. Selecione a foto do perfil na barra superior e selecione Admin Console.

  3. Selecione o separador Aplicativos na sua consola de administração.

  4. Selecione Contas de serviço.

  5. Selecione Adicionar Conta de Serviço e execute as etapas a seguir.

    Captura de ecrã do Token de Conta de Serviço.

    1. Atualize o Nome e a Descrição conforme necessário.
    2. Na seção Escopos de permissão, selecione Permissões com escopo e Provisionamento de usuário (SCIM). Verifique se os seguintes escopos de permissão estão selecionados:
      • Utilizadores: Ler
      • Usuários: Criar e modificar
      • Equipas: Ler
      • Equipas: Criar e modificar
    3. Selecione Salvar alterações.

  6. Copie o token.

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

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 na Asana 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 Asana 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 Enterprise

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

  3. Na lista de aplicativos, selecione Asana.

    Captura de tela do link Asana 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 URL do Inquilino Asana e o Token Secreto fornecido pela Asana. Selecione Testar Conexão para garantir que o Microsoft Entra ID possa se conectar à Asana. Se a conexão falhar, entre em contato com a Asana para verificar a configuração da sua conta.

    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. Revise os atributos de utilizador que são sincronizados do Microsoft Entra ID para Asana na seção Mapeamento de Atributos . Os atributos selecionados como propriedades de correspondência são usados para associação com as contas de utilizador na Asana para operações de atualização. Se você optar por alterar o atributo de destino correspondente, precisará garantir que a API da Asana 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 pela Asana
    nome de utilizador fio ✓ ✓
    ativo booleano
    nome formatado fio
    título fio
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:departamento fio
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:Utilizador:gestor Referência
    endereços[tipo eq "trabalho"].país fio
    endereços[tipo eq "trabalho"].região fio
    endereços[tipo igual a "trabalho"].localidade fio
    númerosDeTelefone[tipo eq "trabalho"].valor fio
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:númeroDeFuncionário fio
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:centroDeCustos fio
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:organização fio
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:Utilizador:divisão fio

  3. Selecione Grupos.

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

    Atributo Tipo Suportado para filtragem Exigido pela Asana
    nome de exibição fio ✓ ✓
    Membros Referência

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

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

  7. 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 do provisionamento de aplicações no artigo Status de quarentena do provisionamento de aplicativos.

Registo de alterações

  • 11/06/2021 - Caiu o suporte para externalId, name.givenName e name.familyName. Adicionado suporte para linguagem preferida, título e urn:ietf:params:scim:schemas:extension:enterprise:2.0:Utilizador:department. Habilitado o Provisionamento de Grupo.
  • 23/05/2023 - Suporte retirado para preferredLanguage. Adicionado suporte para urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:manager.
  • 09/07/2023 - Adicionado suporte para endereços[type eq "work"].locality, addresses[type eq "work"].region, addresses[type eq "work"].country, phoneNumbers[type eq "work"].value, urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:employeeNumber, urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:costCenter, urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:organization e urn: ietf:params:scim:schemas:extension:enterprise:2.0:User:division.

Mais recursos

Conteúdo relacionado

  • Last updated on