# Asana

![Asana](https://www.manageengine.com/active-directory-360/marketplace/images/logos/marketplace-asana-logo-24.png)

## Automatize a gestão de usuários do Asana com a integração do ADManager Plus

**Categoria:** Provisionamento de identidade

O Asana é uma plataforma de gestão de trabalho móvel e na Web projetada para ajudar as equipes a organizar, monitorar e gerenciar seu trabalho. Conecte o ADManager Plus ao Asana para automatizar as mudanças da gestão de acesso dos usuários do AD, garantindo que as contas dos usuários estejam sempre atualizadas com as informações mais recentes dos funcionários.

Além disso, com o ADManager Plus, as empresas podem automatizar workflows, aplicar políticas de segurança e aderir a medidas de conformidade, garantindo que os direitos de acesso estejam sempre alinhados aos projetos atuais e às estruturas de equipe.

### Automatize o provisionamento de usuários

Sincronize instantaneamente a criação, as atualizações e o desprovisionamento de usuários no Asana com base em modificações em tempo real de grupos de segurança e atributos de usuários em seu diretório corporativo e em outras aplicações empresariais.

### Segurança e controle de acesso aprimorados

Assegure-se de que os direitos de acesso no Asana estejam sempre em sincronia com a função e as responsabilidades atuais de um funcionário, aumentando a segurança.

## Como integrar o ADManager Plus e o Asana

### Pré-requisitos

O Asana usa o OAuth 2.0 para autorizar solicitações de API. Certifique-se de fornecer o `client_id` e o `client_secret` com permissões para recuperar as informações desejadas e executar tarefas no Asana. Consulte as [referências de API do Asana](https://developers.asana.com/docs/oauth#register-an-application) para obter mais detalhes.

### Privilégios

1. **Para importar usuários (ação de entrada):** Certifique-se de que a conta usada para autorização tenha permissão para ler todas as contas de usuário.
2. **Para executar qualquer ação ou consulta no Asana (ação de saída):** Certifique-se de que a conta usada para autorização tenha permissão para executar a ação desejada.

**Observação:** O ADManager Plus vem com um conjunto pré-configurado de APIs que ajuda a executar ações básicas com a integração. Se a ação que você deseja não estiver disponível, obtenha os detalhes necessários da API na documentação de API do Asana para configurar webhooks de entrada/saída para executar as ações necessárias.

## Configuração de autorização

1. Efetue login no ADManager Plus e navegue até a aba **Automation**.
2. No painel esquerdo, em *Configuration*, clique em **Application Integrations**.
3. Em *Enterprise Applications*, clique em **Asana**.
4. Ative o botão **Enable Asana Integration**.
5. Na página *Asana Configuration*, clique em **Authorization**.
6. Execute as [etapas para gerar o client_id e client_secret do Asana](https://developers.asana.com/docs/oauth#register-an-application) e cole-os nos respectivos campos de valor.
7. Clique em **Configure**.

## Configuração do webhook de entrada

O webhook de entrada permite que você busque dados de usuário do Asana para o ADManager Plus e execute a ação desejada disponível no recurso Automation. O mapeamento de atributos configurado nesta seção pode ser selecionado como a fonte de dados durante a [configuração da automação](https://www.manageengine.com/products/ad-manager/help/automation/configuring-automation.html) para executar a ação desejada na lista de usuários recebida da resposta da API.

### Para configurar um webhook de entrada para o Asana

1. Em *Inbound Webhook*, clique em **Asana Endpoint Configuration**.
2. Na aba **Endpoint Configuration**, um endpoint chamado **Asana USERS ENDPOINT** vem pré-configurado com os campos **Endpoint URL**, **API Method**, **Headers** e **Parameters** para buscar contas de usuários do Asana.

   - Se você quiser usar esse endpoint pré-configurado, substitua **team_gid** pelo **team_id** de sua instância do Asana no campo Endpoint URL.
   - Se desejar usar um novo endpoint para importar usuários, configure um usando o botão **+ Add API endpoint** e preencha os campos necessários de acordo com as [referências de API do Asana](https://developers.asana.com/reference/getusersforteam).
   - Clique [aqui](https://www.manageengine.com/products/ad-manager/help/admin-settings/third-party-integrations/hrms.html) para saber como configurar.

**Observações:**

- O par de valores de chave de API é pré-configurado como um cabeçalho para autenticar solicitações de API, conforme definido durante a **configuração de autorização**.
- Você pode adicionar macros à configuração de seu endpoint para alterá-lo dinamicamente conforme suas necessidades usando o componente de seleção de macros.
- Consulte as [referências de API do Asana](https://developers.asana.com/reference/getusersforteam) e configure cabeçalhos e parâmetros adicionais, se necessário.

3. Quando terminar, clique em **Test & Save**. Uma janela de resposta exibirá todos os parâmetros solicitados que podem ser obtidos usando a chamada de API. Clique em **Proceed**.

**Observações adicionais:**

- Consulte as [referências de API do Asana](https://developers.asana.com/reference/getusersforteam) para identificar os **Parameters** necessários para buscar apenas parâmetros específicos.
- Você pode configurar vários endpoints para o Asana usando o botão **+ Add API endpoint**. Clique [aqui](https://www.manageengine.com/products/ad-manager/help/admin-settings/third-party-integrations/hrms.html) para saber como.

4. Clique em **Data Source - LDAP Attribute Mapping** para corresponder endpoints e mapear os atributos LDAP do AD com os respectivos atributos no Asana.
5. Clique em **+ Add New Configuration** e faça o seguinte:

   1. Digite o **Configuration Name** e a **Description** e selecione a **Automation Category** no menu suspenso.
   2. No campo **Select Endpoint field**, selecione o endpoint desejado e uma **Primary Key** que seja exclusiva de um usuário (por exemplo, `employeeIdentifier`).

      **Observação:** Quando vários endpoints são configurados, esse atributo deve ter o mesmo valor em todos os endpoints.

   3. No campo **Attribute Mapping**, selecione o atributo no menu suspenso **LDAP Attribute Name** e mapeie-o com a respectiva coluna no Asana.
   4. Se você quiser criar um novo formato personalizado para isso, clique em **Mapping Attribute**.
   5. Clique em **Save**.