Como integrar o ADManager Plus e o Trello

Pré-requisitos

Requer uma chave de API e um token de API para autorizar solicitações de API

Privilégios

• Para importar usuários do Trello (ações de entrada): Certifique-se de que a conta usada para autorização tenha permissões para ler todas as contas de usuário.
• Para executar qualquer ação ou consulta no Trello (ações de saída): Certifique-se de que a conta usada para autorização tenha permissões para executar as ações desejadas.

Configuração de autorização

• Efetue login no ADManager Plus e navegue até a aba Automation.
• No painel esquerdo, em Configuration, clique em Application Integrations.
• Em Enterprise Applications, clique em Trello.
• Ative o botão Enable Trello Integration.
• Clique em Authorization.
• Digite o token da API no campo Value.
• Clique em Configure.

Configuração do webhook de entrada

Um webhook de entrada permite transferir dados de usuários do Trello para o ADManager Plus. O mapeamento de atributos configurado nesta seção pode ser selecionado como a fonte de dados durante a configuração da automação para executar a ação desejada na lista de usuários recebida da resposta da API. Para configurar um webhook de entrada para o Trello:

• Em Inbound Webhook, clique em Trello Endpoint Configuration.
• Nessa seção, um endpoint, Trello USERS ENDPOINT, vem pré-configurado com os campos Endpoint URL, Method, Headers e Parameters preenchidos para buscar contas de usuários do Trello. Se você quiser usar esse endpoint pré-configurado, substitua {API Key} pela chave de API de sua instância do Trello no campo Endpoint URL. No entanto, se quiser usar um novo endpoint para importar usuários, você pode configurá-lo clicando no botão + Add API Endpoint e preenchendo os campos necessários de acordo com as referências de API do Trello.

Observação:

• O par de valores de chave de API é pré-configurado como um cabeçalho para autenticar solicitações de API, conforme configurado durante a Configuração de autorização.
• Você pode adicionar macros à configuração de seu endpoint para mudá-lo dinamicamente conforme seus requisitos usando o botão macro chooser button ().
• Consulte as referências de API do Trello para configurar cabeçalhos e parâmetros adicionais, se necessário.
• 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. Depois de verificar se os parâmetros solicitados buscaram os valores corretos, clique em Proceed.

Observação:

• Consulte as referências de API do Trello para saber os Parameters que devem ser configurados para buscar apenas parâmetros específicos.
• Você pode configurar vários endpoints para o Trello usando o botão + Add API Endpoint . Clique aqui para saber como.
• Clique em Data Source - LDAP Attribute Mapping para corresponder endpoints e mapear os atributos LDAP do AD com os respectivos atributos no Trello.
• Clique em + Add New Configuration e faça o seguinte:
  • Digite o Configuration Name e a Description e selecione a Automation Category no menu suspenso.
  • No campo Select endpoint, 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.
  • No campo Attribute Mapping, selecione o atributo no menu suspenso LDAP Attribute Name e mapeie-o com o respectivo atributo no Trello.
  • Se você quiser criar um novo formato personalizado para isso, clique em Add New Format.
  • Clique em Save.

Configuração do webhook de saída

Um webhook de saída permite que você envie as mudanças feitas no AD usando o ADManager Plus para o Trello e execute tarefas no Trello - tudo a partir do ADManager Plus. Os webhooks configurados nesta seção podem ser incluídos nos Modelos de orquestração, que, por sua vez, podem ser usados em automações programadas e orientadas por eventos. Eles também podem ser aplicados diretamente nos usuários desejados para executar uma sequência de ações neles (em Management > Advanced Management > Orchestration).

Para configurar um webhook de saída para o Trello:

• Em Outbound Webhook, clique em Trello Webhook Configuration.
• Clique em + Add Webhook.
• Digite um nome e uma descrição para esse webhook.
• Decida a ação que deve ser executada e consulte as referências de API do Trello para obter os detalhes da API, como URL, cabeçalhos, parâmetros e outros requisitos.
• Selecione o método HTTP que permitirá que você execute a ação desejada no endpoint no menu suspenso.
• Digite o URL do endpoint.
• Configure Headers, Parameters e Message Type no formato apropriado com base na chamada de API que você gostaria de executar.
• Clique em Test and Save.
• Uma janela pop-up exibirá uma lista de usuários e grupos do AD para testar a chamada de API configurada. Selecione o usuário ou grupo desejado sobre o qual essa solicitação de API deve ser testada e clique em OK. Isso fará uma chamada em tempo real para o URL do endpoint, e os objetos selecionados serão modificados de acordo com a configuração.
• A resposta do webhook e os detalhes da solicitação serão exibidos. Verifique se eles correspondem ao comportamento esperado da API e clique em Save.