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=…)。
https://trello.com/power-ups/admin で Power-Up を作成するか開き、API key タブを開いてキーを生成します。次に、scope=read とキーを指定して Trello の承認 URL にアクセスし、トークンを発行します。
公式リファレンス: Authorization、API introduction、Power-Up admin。
前提条件
- 監査に必要なボードとワークスペースにアクセスできる Trello ユーザー。
Trello を Iru に接続する
- Trello
- Iru Compliance
Compliance でソースを接続する前に、このタブの手順を完了してください。
1
Trello にサインインする
Trello を開き、Iru が読み取るボードとワークスペースにアクセスできるユーザーでサインインします。
2
Power-Up admin を開く
アカウントの
https://trello.com/power-ups/admin (Trello Power-Up の管理画面) に移動します。3
Power-Up を作成または選択する
Iru 用の API 認証情報の発行にのみ使用する新しい Power-Up を作成します (または既存の Power-Up を開きます)。わかりやすい名前を付けてください (例: Iru Compliance)。
4
API キーを生成する
その Power-Up の API key タブを開き、API キー (
key) を生成します。キーの値をコピーします。これは Iru で key パラメーターとして入力します。5
読み取り専用トークンを承認する
Power-Ups 用に文書化されている Trello の承認 URL を、
expiration、scope=read、response_type=token、key=YOUR_API_KEY を含めて開きます。Trello にプロンプトが表示されたら、アクセスを承認します。6
ユーザートークンをコピーする
許可 を選択すると、Trello からトークン文字列が返されます。すぐにコピーしてください。これは Iru で
key と組み合わせて使用します。Iru Compliance タブに進みます。
トラブルシューティング
ソースをオンにしても何も開かない
ソースをオンにしても何も開かない
Iru サイトのポップアップブロッカー設定を確認して、もう一度お試しください。
401
401
トークンを再生成し、キーがまだ有効であることを確認してください。
429
429
レート制限です。再試行により、同期に時間がかかる場合があります。
ボードが表示されない
ボードが表示されない
トークンのユーザーが、該当するボード/ワークスペースに参加している必要があります。
関連記事
ソース管理
すべての Compliance ソースを参照および管理します。
Compliance の使用を開始する
フレームワーク、アクション、アーティファクト。
Iru の概要
Endpoint、Compliance、Identity がどのように連携するか。
アーティファクト管理
ソースとアクションから得たエビデンスをアップロード、確認、整理します。