Loading
Produtos
AI Platform
FUNÇÕES
Tipo de empresa
Equipes
Setores
Casos de uso
APRENDER
SUPORTE
SERVIÇOS
Centro de ajuda
search-icon

Tópicos

Não foram encontrados artigos sobre este tópico.

Provisionamento e desprovisionamento de usuários usando SCIM

Neste artigo

Quem pode usar esta funcionalidade?
EnterpriseEnterprise+legacy Enterprise

Visite a nossa página de preços para obter mais informações.

Nota iconNota

Todos os dados de atributos sincronizados com a Asana via SCIM estão disponíveis para todas as funcionalidades subsequentes da Asana, incluindo as funcionalidades de IA, como a IA Asana (Dash). Se você não quiser que um atributo específico apareça nessas funcionalidades, remova-o ou desvincule-o da sua configuração SCIM no seu provedor de identidade, como Okta ou Microsoft Entra ID, antes que ele seja sincronizado com a Asana.

Configurar uma conta de serviço da Asana para SCIM

Todas as integrações SCIM — independentemente do provedor de identidade — são autenticadas usando um token de conta de serviço da Asana. Configure isso uma vez antes de seguir qualquer uma das etapas específicas do IdP abaixo.

  1. Inicie sessão na Asana com uma conta de administrador e abra o painel do administrador a partir da sua foto de perfil na barra superior.
  2. Acesse a guia Aplicativos e selecione Contas de serviço.
  3. Selecione Adicionar conta de serviço.
  4. Em Escopos de permissão, selecione Permissões com escopo e ative o Provisionamento de usuários (SCIM). Se você não quiser que o seu provedor de identidade crie, renomeie ou modifique equipes da Asana, deixe os escopos relacionados à equipe desmarcados.
  5. Salve as alterações e copie o token de API gerado. Você o colará na configuração SCIM do seu provedor de identidade nas etapas abaixo.
Nota iconNota

Mantenha este token em segurança. Qualquer pessoa com o token pode provisionar e desprovisionar membros na sua organização.

 

Okta

Funcionalidades

Os superadministradores podem adicionar e remover usuários na Asana com facilidade a partir do Okta. A integração se baseia no protocolo SCIM e oferece suporte para:

  • Criar membros: os membros atribuídos ao aplicativo Asana no Okta são automaticamente adicionados à sua organização na Asana.
  • Atualizar os atributos do perfil: atributos como nome, cargo e departamento são sincronizados com a Asana a partir do perfil de um membro no Okta.
  • Importar membros: os membros criados na Asana podem ser importados para o Okta, tanto como correspondentes a usuários Okta já existentes quanto criados como novos usuários Okta.
  • Importar grupos: as equipes da Asana podem ser importadas como grupos do Okta. O Okta não permite que você administre os participantes dos grupos importados.
  • Transferir grupos: os grupos do Okta e seus respectivos membros podem ser transferidos para a Asana como equipes e membros de equipes.
  • Interligar grupos: as equipes já existentes na Asana podem ser interligadas a grupos no Okta após a importação das equipes a partir da Asana.
  • Desativar membros: os membros são desativados (excluídos) na Asana se a sua atribuição for cancelada no aplicativo do Okta.

Não é possível atualmente: reativar membros e excluir equipes da Asana no Okta.

Requisitos

  • Você deve ser um superadministrador de uma organização na Asana em um plano Enterprise, Enterprise+ ou Legacy Enterprise. [VERIFICAR antes de publicar — uma fonte interna indica “administrador” apenas no “plano Enterprise”, em vez de superadministrador em todos os três planos. Confirme o requisito correto com a equipe de engenharia/suporte; consulte a questão em aberto nº 5 na proposta de reorganização.]
  • Você tem um plano do Okta que oferece suporte ao provisionamento da Gestão do ciclo de vida.
  • Você concluiu a etapa Configurar uma conta de serviço da Asana para o SCIM acima.

Antes de ativar a desativação, leia o seguinte: desativar um membro no Okta não apenas pausa o acesso dele à Asana, mas também exclui a conta dele na Asana, da mesma forma que removê-lo da interface de usuário da Asana. Não existe um estado separado de “desativado, mas recuperável”. Da mesma forma, substituir o nome de usuário de um membro pelo aplicativo Okta excluirá a conta da Asana vinculada ao seu nome de usuário anterior, se essa conta estiver ativa. Lembre-se disso antes de ativar a opção Desativar usuários no Passo 3 abaixo ou de aplicar uma substituição de nome de usuário.

Etapas

Etapa 1: adicione o aplicativo da integração entre Asana e Okta à sua conta Okta.

Inicie a sessão no Okta e adicione o aplicativo da integração da Asana à sua organização a partir do Catálogo de integrações de aplicativos, em Aplicativos.

asana okta integration
asana okta integration2
Para adicionar a Asana:
  1. Clique em Colaboração e Produtividade.
  2. Clique em Asana.

add asana


Etapa 2: vincule a sua conta Asana à sua conta Okta

Na Asana: gere um token de conta de serviço conforme descrito acima e copie-o.

No Okta:

  1. Em Aplicativos, abra o aplicativo Asana e clique na aba Provisionamento.
  2. Em Configurações, clique em Integração e depois em Configurar integração da API.
  3. Marque Enable API Integration (Ativar integração da API), cole o token da sua conta de serviço no campo do token API e clique em Test API Credentials (Testar credenciais da API) para confirmar a conexão.
  4. Clique em Salvar.

Etapa 3: configure as opções de provisionamento para a Asana no Okta

  1. Na aba Provisionamento do aplicativo Asana, clique em Para o aplicativo e, em seguida, em Editar.
  2. Habilite as opções de provisionamento que você quiser. Recomendamos a ativação das opções Criar usuários, Atualizar atributos do usuário e Desativar usuários.
  3. Clique em Salvar.
  4. Use a guia Importar para fazer a correspondência entre os membros detectados na Asana e o seu diretório Okta, e a guia Atribuições para gerenciar quem está provisionado. Os membros atribuídos permanecerão automaticamente sincronizados com a sua lista de membros da Asana daqui para frente.

 

okta provisioning options
Para configurar as opções de provisionamento:
  1. Na barra lateral Configurações, clique em Para o aplicativo.
  2. Clique em Editar na parte superior direita
  3. Ative as opções de provisionamento de usuários para o aplicativo Asana e clique em Salvar para aplicar as configurações da integração
Nota iconNota
Recomendamos a ativação das opções Create Users (Criar usuários), Update User Attributes (Atualizar atributos do usuário) e Deactivate Users (Desativar usuários).
import tab


assignments tab

Etapa 4: distribua os usuários provisionados em equipes na Asana

É possível transferir novos grupos do Okta para a Asana como equipes ou vincular os grupos do Okta às equipes existentes na Asana.

  1. No aplicativo Asana no Okta, clique em Refresh App Groups (Atualizar os grupos do aplicativo) para importar quaisquer alterações recentes da Asana.
  2. Acesse a aba Push Groups (Enviar grupos) e procure o grupo pelo nome.
  3. Nos resultados de correspondência, escolha Vincular grupo para mapear para uma equipe existente na Asana ou Criar grupo para criar um novo.
  4. Clique em Salvar.

Não é possível excluir uma equipe na Asana a partir do Okta. Use, em vez disso, a guia Equipes no painel do administrador da Asana.

 
push groups

    Etapa 5: configure o mapeamento dos atributos com a Asana

    Na guia Provisionamento do aplicativo Asana, em Mapeamento de atributos da Asana, escolha Criar ou Criar e atualizar para cada atributo que deseja sincronizar. Atributos suportados:

    Atributo

    Tipo

    Notas

    userName

    String

    Obrigatório. Deve ser um endereço de e-mail exclusivo que corresponda ao domínio da sua organização Asana.

    name.formatted

    String

    O nome completo do membro. Use isto — name.givenName e name.familyName não são suportados individualmente. Se o formato não corresponder ao que está definido para o nome/sobrenome, o formato tem precedência e pode substituir silenciosamente esses campos.

    emails.value

    String

    Endereço de e-mail do membro.

    emails.primary

    Booleano

    Marca o e-mail principal. Somente um e-mail pode ser marcado como principal.

    título

    String

    O cargo do membro.

    departamento

    String

    O departamento do membro.

    preferredLanguage

    String

    Aplicado apenas quando o membro é criado pela primeira vez. As atualizações posteriores feitas a este campo no Okta não causam alterações para os membros já existentes.

    ativos(as)

    Booleano

    Se a conta do membro está ativa na Asana.

    Se quiser interromper a sincronização de um atributo específico, remova-o ou cancele o mapeamento dele no Okta. A Asana não oferece um controle de exclusão separado. A remoção de um mapeamento interrompe as sincronizações futuras, mas não exclui os dados que já foram sincronizados.

    Etapa 6: atualizar uma integração Asana–Okta já existente

    Para obter novos atributos ou recursos em uma integração que você já tem em execução:

    1. Na página “Integration” (integração), em “Provisioning” (provisionamento), clique em “Edit” (editar).
    2. Desmarque a opção Enable API Integration (Ativar integração da API) e clique em Save (Salvar).
    3. Clique em Edit (editar) novamente, marque novamente Enable API Integration (habilitar integração de API), insira novamente seu token de API e clique em Save (salvar).
    4. Reative os recursos de provisionamento que quiser.
    update integration

      Outras coisas a saber

      • Emojis nos nomes impedirão as importações. O Okta só suporta caracteres codificados com 3 bytes ou menos, portanto, os nomes de membros ou grupos que contenham emojis não poderão ser importados.
      • Os e-mails dos membros provisionados devem corresponder ao domínio da sua organização Asana. Os convidados continuarão a ser provisionados e administrados somente na guia Membros do Painel do administrador.
      • Consulte o aviso de desativação e substituição do nome de usuário acima se você pulou para esta seção — ele se aplica independentemente de quando você ativou essas configurações.

      Microsoft Entra ID

      A integração da Asana com o Microsoft Entra ID é configurada principalmente por meio do próprio tutorial de provisionamento da Microsoft, já que a configuração ocorre inteiramente no centro de administração do Entra. Conclua primeiro estas etapas específicas da Asana e, em seguida, siga o passo a passo da Microsoft para a configuração no lado do Entra.

      Requisitos

      • Uma organização Asana com um plano Enterprise ou superior, com uma conta de membro que tenha permissões de administrador.
      • Uma conta do Microsoft Entra com a função de administrador de aplicativos, administrador de aplicativos na nuvem ou proprietário de aplicativos.
      • Você concluiu as etapas de Configuração de uma conta de serviço da Asana para o SCIM acima e tem o seu token pronto.

      Etapas

      1. Adicione o Asana na galeria de aplicativos do Microsoft Entra (durante os testes, recomenda-se usar um aplicativo separado de qualquer integração de SSO existente).
      2. Siga o tutorial da Microsoft: Configurar a Asana para provisionamento automático de contas com o Microsoft Entra ID para:
        • Inserir o URL do locatário da Asana e o token da Conta de serviço que você gerou acima em Provisionamento > URL do locatário e testar a conexão.
        • Definir quem está no escopo do provisionamento (por atribuição ou por filtro de escopo baseado em atributos).
        • Revisar e confirmar o mapeamento dos atributos para usuários e grupos.
        • Iniciar o provisionamento e monitorar o status por meio dos registros de provisionamento da Microsoft.

      Como esta configuração ocorre no centro de administração do Entra, consulte o tutorial da Microsoft para obter capturas de tela e orientações de navegação atualizadas. Os requisitos da Asana relacionados ao mapeamento de atributos e à conta de serviço mencionados acima permanecem os mesmos, independentemente das alterações na interface do usuário da Microsoft.

      Google Workspace

      Se você usa o Google Workspace como provedor de identidade e deseja configurar o provisionamento SCIM com a Asana, entre em contato com o seu executivo de contas ou com o Suporte da Asana para obter as orientações de configuração mais recentes.

      OneLogin

      A integração do OneLogin com a Asana é configurada diretamente no OneLogin. Siga o guia de configuração do provisionamento SCIM do OneLogin para a Asana para obter instruções passo a passo.

      Se você estiver configurando o SCIM com um provedor de identidade que não esteja nativamente integrado à Asana, consulte a documentação para desenvolvedores da Asana sobre atributos SCIM suportados para ver a lista completa de atributos aceitos.

      personalização do desprovisionamento SCIM

      Quando um membro é desprovisionado da Asana via SCIM ou API usando um token de conta de serviço, a Asana cria automaticamente um projeto “Tarefas anteriormente atribuídas” contendo as tarefas públicas dele. Você pode configurar quem é o responsável por esse projeto:

      1. No painel do administrador, acesse a guia Segurança e abra as Configurações de remoção de membros.
      2. Ative a configuração para atribuir a um superadministrador (ou a Todos os superadministradores) a propriedade do projeto “Tarefas anteriormente atribuídas”.
      3. Opcionalmente, escolha se deseja incluir tarefas concluídas.

      Esta personalização só se aplica quando um membro é removido via SCIM ou API com um token de conta de serviço — não quando é removido manualmente pela interface de usuário da Asana. Para saber mais sobre o que acontece quando um membro é removido, consulte Desprovisionamento de usuários.

      Note iconNota

      Este artigo foi traduzido por IA.

      Dar feedback sobre a tradução.

      Artigos relacionados

      Carregando
      SCIM da Asana: automatize o provisionamento de usuários | Centro de ajuda