Trello

Trello Integration Guide

Introduction

Trello is a web-based project management and collaboration tool that allows individuals and teams to organize tasks and projects using a system of boards, lists, and cards. This guide will walk you through the steps required to integrate Trello with Perimeters.

Available Features

• Misconfiguration Rules

• Identity Rules

• User Inventory

• Devices Inventory

• Third Party Application Rules

• Third Party Application Inventory

Prerequisites

A Trello account user with the following required privileges or workspace super admin and an API Key and Token for Trello workspace must be created by this account user.

Note : While Perimeters can detect issues with Trello Free and Standard subscription, Trello Instance Administrators can only mitigate these issues with Premium or higher subscription.

Follow these steps to generate the API Key :

1. Login using the account that was assigned with the required privileges.

2. Go to https://trello.com/power-ups/admin.

3. Under "Power-Ups and Integrations" click "New".

4. Add a label in "Perimeters Power-Up or Integration" field.

5. Under "Workspace" select your workspace from the drop-down.

6. Under "Email" add the privileged user's email.

7. Under "Support Email" add the privileged user's email.

8. Under "Author Name" add the user's name.

9. Hit "Create".

10. Under "API key" hit "Generate a new API key" -> hit "Generate API key".

11. Copy the API Key.

Follow these steps to generate the API Token :

1. Login using the account that was assigned with the required privileges.

2. Go to https://trello.com/power-ups/admin.

3. Select the previously created Power Up.

4. In the side bar click "API key".

5. On the right side of "API key" hit "Token".

6. Scroll down and hit "Allow".

7. Copy the API Token.

Required Privileges

Scope	Use
read	Read Trello workspace information [MetaData]
account	Read account information

Onboarding Trello in your Perimeters account

1. Go to "Integrations" -> Select "Bitbucket" -> Click "+ Add" -> Click "+ Start Integration".

2. "Namespace" - Fill in the workspace slug for your Trello instance. For example, if your Trello workspace url is "https://trello.com/w/perimeters" you would enter "perimeters" in this field. To find the workspace url for your trello workspace, login into trello and on the top navigation bar hover over "workspaces" and click on your workspace and copy the url. (e.g. https://trello.com/w/perimeters)

3. “API Key” - Copy the API key you previously created from your Trello power ups page and paste it here.

4. “API Token” - Copy the API token you previously created from your Trello power ups Profile page and paste it here.

5. Click "Connect" to complete the onboarding process.

Once you have completed these steps, Trello should be successfully integrated with your Perimeters account.