日本語

ClickUp

この_ワークスペースごと_の一度限りのセットアップにより、Aikido組織内の全員がClickUpで直接課題を作成できるようになります。

以下のユースケースがサポートされています：

  • 自動チケット作成：指定したClickUpプロジェクトにチケットを自動的に作成・送信し、セキュリティ課題をシームレスに追跡します。
  • 手動チケット追加：セキュリティ課題のチケットをClickUpに手動で追加し、重大な脆弱性に的を絞って対応できるようにします。

AikidoアプリをClickUpに接続する

  1. Aikidoアプリ内の連携設定に移動します。

  2. 「Task Trackers」セクションで「ClickUp」を選択します

  3. ClickUpの認可を求めるプロンプトが表示されます。
    ​

    課題追跡のためのClickUp認可プロンプト。ユーザーは現在未認可。

  4. ClickUpアカウントにログインします

  5. AikidoにClickUpワークスペースへのアクセス権限を付与します

    Aikido Securityとの連携のためのClickUpワークスペース選択画面。

  6. 認可されると、AikidoはClickUpに正常に接続され、タスク管理機能が強化されます 🚀

リポジトリをClickUpプロジェクトにマッピングし、Aikidoでタスクの自動作成を有効化。

​Aikido経由でClickUpにタスクを作成する方法

AikidoからClickUpに新しいタスクを作成するには、2つの方法があります。

  1. Aikidoのインターフェースから手動でタスクを作成する
  2. Aikidoの自動作成機能を使って新しいタスクを自動的に作成する

1. 手動でのタスク作成

  1. フィード内の任意の課題にカーソルを合わせ、担当者列の + をクリックします。
    ​

    タスクの割り当てを追加・管理するオプションを備えた担当者セクション。

    または、最後の列にある三点アイコンをクリックしてアクションメニューを開くこともできます。課題をグループ化している場合は、各サブ課題で三点アクションメニューを利用できます。
    ​

    タスク作成、スヌーズ、無視、リンクのコピー、重大度の調整のオプションを備えたアクションメニュー。

  2. ポップアップモーダルで必要な詳細を入力します。
    ​

    重大度の高いXSS脆弱性の検出結果を報告するためのClickUpタスク作成フォーム。

  3. ClickUpで新しく作成されたタスクは、Aikidoの課題詳細の「Tasks」タブ（サイドパネル）にリンクされます。

エスケープされていない入力による高リスクのXSS攻撃に関する警告タスク。オープンとしてラベル付け。

2. 自動でのタスク作成

Aikido は1時間ごとに一括でタスクを自動作成します。現時点では、これを手動でトリガーするオプションはありません。

  1. ClickUp連携の設定に移動します
  2. トグルをオンにして、「Autocreation」を有効にしてください。
  3. タスクを自動作成する条件を定義します。

これらの設定はすべて自動作成モーダルで構成できます。

  • オン/オフ： 自動作成を有効または無効にします。オフの場合、しきい値は実質的に None に設定されます。
  • 重大度のしきい値： Critical、High、Medium、または Low 以上の課題に対してチケットを作成します。たとえば、High を選択すると、High と Critical のチケットが作成されます。
  • 課題タイプ： すべての課題タイプに対してチケットを作成するか、SCA、SAST、Secrets、Cloud、IaC、Malware、License などの特定のタイプに限定します。
  • 1日あたりの上限： 1日に作成されるチケットの最大数を設定します。デフォルトは 25 です。一部のプランではより高い上限がサポートされています。
  • チケット作成モード： 課題グループごとに1つのチケットを作成するか、ロケーションまたはスコープごとに個別のチケットを作成します。ロケーションごとのモードでは、より多くのチケットが作成される場合があります。
  • スコープ： ロケーションごとのモードでのみ使用できます。すべてのリポジトリまたはクラウド、マッピングされたリポジトリまたはチームのみ、または包含リストと除外リストを使用して特定のリポジトリまたはクラウドを対象にします。
  1. Aikidoはこれらの設定に基づいてClickUpチケットを自律的に生成します 🚀

Aikidoのデータをカスタムフィールドにマッピングする

Aikidoは、作成するすべてのタスクでClickUpのカスタムフィールドに値を入力できます。これを利用して、重大度、SLA期日、リンク、その他のAikidoデータをClickUpのフィールドに直接送信できます。

サポートされているフィールドタイプ

ClickUpのフィールドタイプ値の例
テキストSeverity: $SEVERITY
テキストエリア（長文テキスト）$TLDR
ウェブサイト$AIKIDO_LINK
数値$SEVERITY_SCORE
ドロップダウン$SEVERITY
ラベルlabel 2, label 3
日付$SLA_DATE
チェックボックスtrue

ドロップダウンおよびラベルフィールドでは、オプション名をClickUpに表示されているとおりに正確に入力してください。オプションIDは不要です。

フィールドマッピングを設定する

  1. Integrations → ClickUp → Field Mappingに移動し、Add Fieldをクリックします。
  2. Custom Fieldに、ClickUpのカスタムフィールド名をClickUpに表示されているとおりに正確に入力します。
  3. Aikido Valueに、Aikidoのショートコード（例：$SEVERITY）または固定のテキスト値を入力します。
  4. Save Changesをクリックします。

Preview列には、AikidoがClickUpに送信する値が表示されます。

固定値とショートコード

固定値： プレーンテキストを入力すると、すべてのタスクに同じ値が設定されます。たとえば、Securityと入力すると、Aikidoが作成するすべてのタスクでそのフィールドに「Security」が入力されます。

ショートコード： Aikidoはタスクを作成する際、ショートコードを課題のデータに置き換えます。Issue: $TLDRやDetected on $FIRST_DETECTED_DATEのように、固定テキストと組み合わせることもできます。ショートコードの一覧については、AikidoのデータをJiraのカスタムフィールドにマッピングするを参照してください。同じショートコードがClickUpでも使用できます。

ClickUpの日付フィールドには、YYYY-MM-DD形式（例：2024-10-23）、または$SLA_DATEなどの_DATEショートコードを使用してください。