# Trello

## 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
* Shadow Application Rules
* Shadow Application Inventory

## Prerequisites

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

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

<details>

<summary><strong>Follow these steps to generate the API Key :</strong> </summary>

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".&#x20;
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.

</details>

<details>

<summary><strong>Follow these steps to generate the API Token :</strong> </summary>

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.

</details>

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://support.perimeters.io/perimeters-documentation/connecting-perimeters/integrations-for-security-insights/saas-applications/trello.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.