> ## Documentation Index
> Fetch the complete documentation index at: https://docs.iru.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Trello
> Power-Up の API キーとユーザートークンを使用して Trello を Iru Compliance に接続し、ボード、リスト、カード、ワークスペースメンバーシップのエビデンスに読み取り専用でアクセスします。
### Trello について
Trello の REST API では、リクエストに **`key`** (**Power-Ups admin** のアプリケーション ID) と **`token`** (ユーザーが承認したもの) が必要です (例: **`GET /1/members/me/boards?key=…&token=…`**)。**key** は共有可能ですが、**token** は秘密情報であり、承認したユーザーが参照できる範囲にアクセスを限定します。
### 仕組み
Iru は、**Power-Up API キー**と**ユーザートークン**を使用して Trello の REST API に認証します。これらは各リクエストで **`key`** および **`token`** クエリパラメーターとして渡されます (例: **`GET https://api.trello.com/1/members/me/boards?key=…&token=…`**)。
| 詳細 | 値 |
| - | - |
| **カテゴリ** | プロジェクト管理 |
| **認証** | API キー + トークン (クエリパラメーター) |
**`https://trello.com/power-ups/admin`** で **Power-Up** を作成するか開き、**API key** タブを開いてキーを**生成**します。次に、**`scope=read`** とキーを指定して Trello の**承認** URL にアクセスし、**トークン**を発行します。
公式リファレンス: [Authorization](https://developer.atlassian.com/cloud/trello/guides/rest-api/authorization/)、[API introduction](https://developer.atlassian.com/cloud/trello/guides/rest-api/api-introduction/)、[Power-Up admin](https://trello.com/power-ups/admin)。
### 前提条件
* 監査に必要な**ボード**と**ワークスペース**にアクセスできる Trello ユーザー。
### Trello を Iru に接続する
Compliance でソースを接続する前に、このタブの手順を完了してください。
[Trello](https://trello.com) を開き、Iru が読み取る**ボード**と**ワークスペース**にアクセスできるユーザーでサインインします。
アカウントの **`https://trello.com/power-ups/admin`** (Trello Power-Up の管理画面) に移動します。
Iru 用の API 認証情報の発行にのみ使用する新しい Power-Up を作成します (または既存の Power-Up を開きます)。わかりやすい名前を付けてください (例: **Iru Compliance**)。
その Power-Up の **API key** タブを開き、API **キー** (`key`) を**生成**します。キーの値をコピーします。これは Iru で **`key`** パラメーターとして入力します。
Power-Ups 用に文書化されている Trello の**承認** URL を、**`expiration`**、**`scope=read`**、**`response_type=token`**、**`key=YOUR_API_KEY`** を含めて開きます。Trello にプロンプトが表示されたら、アクセスを承認します。
**許可** を選択すると、Trello から**トークン**文字列が返されます。すぐにコピーしてください。これは Iru で **`key`** と組み合わせて使用します。
[**Iru Compliance**](#iru-compliance) タブに進みます。
先に [**Trello**](#trello) タブの手順を完了してください。
Iru Compliance の左側のナビゲーションバーで **コンプライアンス** を展開し、**ソース** を選択します。
**Trello** を見つけます (**カテゴリ** または **名前または説明で検索** を使用します)。そのカードで**トグル**をオンにします。コネクタウィザード用のブラウザタブまたはウィンドウが開く場合があります。
ウィザードの表示に従って (1 つの画面または個別のフィールドで)、**`key`** と **`token`** を入力します。
**APIキーを送信** を選択します。接続に成功すると、ウィザードに **接続が構成されました** と表示されます。
**Iru が外部サービスへのアクセスをリクエストしています** のブラウザタブを閉じてから **コンプライアンス** → **ソース** に戻り、**Trello** カードが **有効** であることを確認します。
### トラブルシューティング
Iru サイトの**ポップアップブロッカー**設定を確認して、もう一度お試しください。
トークンを再生成し、キーがまだ有効であることを確認してください。
レート制限です。再試行により、同期に時間がかかる場合があります。
トークンのユーザーが、該当するボード/ワークスペースに**参加**している必要があります。
### 関連記事
すべての Compliance ソースを参照および管理します。
フレームワーク、アクション、**アーティファクト**。
Endpoint、Compliance、Identity がどのように連携するか。
ソースとアクションから得たエビデンスをアップロード、確認、整理します。