Linear
Linear統合の構成
Ostorlabは、Ostorlabチケットを使用して脆弱性を簡単に管理し、Linearとシームレスに同期する機能を提供します。
Linearの構成は組織レベルで行われます。接続すると、Ostorlabチケットは一方向または双方向でLinearに同期されます。
Linearの構成：
Linear統合を有効にするには、組織がエンタープライズサブスクリプションを持っている必要があります。
Ostorlabは個人APIキーを使用してLinearに接続します。ユーザー名やワークスペースURLを別途構成する必要はありません。
Linear APIキーの作成：
- Linear APIの設定にアクセスします。
- 個人APIキーを作成します。
- 生成されたキーをコピーします。
Linear統合の接続：
Linear統合メニュー Library -> Integrations -> Linear -> Configuration に移動します。
- Ostorlabのメインメニューを開きます。
- "Library" をクリックします。
- "Integrations" をクリックします。
- Linear統合を選択します。
- トグルをオンにしてLinear統合を有効にします。
- Linear APIキーを追加します。
- チケットを同期するLinearチームを選択します。有効なAPIキーが入力されると、チームのリストがLinearからリアルタイムで取得されます。
構成を保存し、Linearへの接続をテストできます。すべてのテストに合格する必要があります。
注： Linearインスタンスと通信するOstorlab Linearクライアントをホワイトリストに登録したい場合は、サポートチームにお問い合わせください。
Ostorlabチケットから自動的にLinearチケットを作成する：
Linear統合の接続 の手順が完了しており、接続確認が成功していることを確認してください。
Linearチケットの自動作成を有効にするには、"Automatically create Ticket" トグルをオンにします。
以下も選択できます：
- OstorlabからLinearへの更新の同期。
- LinearからOstorlabへの更新の同期。
同期モードを構成したら、以下を選択する必要があります：
- チケットに使用するLinearチーム（上記の
Linear統合の接続を参照）。 - 既存のチケットの子チケットとしてチケットを作成したい場合は、使用する親チケットIDを設定できます。このフィールドは任意です。
- 同期するフィールド：Linearはチケットの
titleとdescriptionの自動同期のみをサポートしています。それ以外はフィールドマッピングが必要です（以下を参照）。 - Linearに同期するチケットのリスク評価。
- Save をクリックします。
テストボタンをクリックして、統合がLinearチームにチケットを書き込めるかどうかを確認できます。
フィールドマッピングの種類
OstorlabとLinearの間でフィールドマッピングを構成する際、3種類の異なるマッピングタイプを使用できます：
- Field Mapping（フィールドマッピング）：Ostorlabのフィールドを直接Linearのフィールドにマッピングします（例：タイトル、説明、優先度、状態、担当者、ラベル、期日）
- Value Mapping（値マッピング）：Linearのフィールドに静的な値を設定します
- Template Mapping（テンプレートマッピング）：Ostorlabのチケット変数を使用してLinearのフィールド用のカスタムテンプレートを提供します
テンプレートマッピング
テンプレートマッピングを使用すると、Ostorlabのチケット変数を使用してカスタムフィールド値を作成できます。二重中括弧を使用してチケット変数を参照します：{{variable_name}}
利用可能な変数：
- {{title}}: チケットのタイトル
- {{description}}: チケットの説明
- {{risk_rating}}: チケットのリスク評価
- {{status}}: チケットのステータス
- {{assigned}}: 割り当てられたユーザーのユーザー名
- {{due_date}}: チケットの期日
- {{target}}: チケットのスキャン対象
- {{tags.<tag_name>}}: <tag_name> という名前のチケットタグの値
テンプレートの例：
Assigned to {{assigned}}