> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devin.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Devin Security の接続

> Devin Security の各接続のうち、検出結果をインポートするものと、トリアージ（却下、完了、再オープン、priority）を連携元のツールに書き戻すものについて、それぞれの制限事項とあわせて説明します。

## サポートされている接続

**Read** は、検出結果が Devin Security のボードにインポートされることを示します。**Write** は、Devin でのトリアージ (却下、完了、再オープン、priority) によってソース内の対応するレコードが更新されることを示します。4 つすべてが書き込まれない場合は、書き込まれるアクションを Notes に記載しています。**Create** は、Devin 自身のスキャンによる検出結果がソースに新しいレコードとして作成されることを示します。

| 接続 | Read | Write | Create | Notes |
| - | - | - | - | - |
| **Linear** | はい | はい | はい | ワークフローの状態と priority を同期します。新しい issue は接続先の Team に作成されます。 |
| **Jira** | はい | はい | はい | Jira Cloud のみ。issue をプロジェクトのワークフローに沿って遷移させ、プロジェクトのスキームに基づいて priority を設定します。新しい issue は接続先のプロジェクトに作成されます。ワークフローに Done への遷移が 1 つしかない場合、却下と完了は同じ遷移を使用します。一致する遷移がないワークフローでは、issue は変更されません。 |
| **Snyk** | はい | はい | いいえ | 却下すると `wont-fix` の ignore が追加され、再オープンすると削除されます。完了時は何も書き込まれません (Snyk は再スキャン時に issue をクローズします) 。重大度は書き込まれません。 |
| **Socket** | はい | はい | いいえ | 却下 / 完了でアラートの resolution が作成され、再オープンで削除されます。Socket 組織全体の該当パッケージバージョンに適用されます。重大度は書き込まれません。 |
| **ArmorCode** | はい | はい | いいえ | 却下 → risk accepted、完了 → mitigated、再オープン、priority → 重大度。 |
| **Wiz** | はい | はい | いいえ | 却下 → `REJECTED`、完了 → `RESOLVED`、再オープン → `OPEN`。Wiz が `RESOLVED` を受け付けるのは Threat Detection Issues のみです。重大度は書き込まれません。[Wiz](#wiz) に記載のスコープを持つサービスアカウントが必要です。 |
| **GitHub Advanced Security** | はい | 未対応 | 未対応 | コードスキャン、シークレットスキャン、Dependabot のアラート。 |
| **SonarQube** | 未対応 | 未対応 | いいえ | Issues と Security Hotspots。 |
| **Veracode** | はい | はい | いいえ | 1 つのアプリケーションの Static、Dynamic、Manual、SCA の検出結果。却下すると `ACCEPTRISK` の mitigation が提案されますが、承認には引き続き Veracode 上での Mitigation Approver による操作が必要です。再オープンするとその提案が拒否されます (Veracode 上で直接行われた mitigation はそのまま残ります) 。完了時は何も書き込まれません (Veracode は再スキャン時に flaw をクローズします) 。重大度は書き込まれません。SCA の検出結果はインポートのみです。 |
| **Vanta** | はい | いいえ | 未対応 | |
| **JFrog** | はい | いいえ | いいえ | Xray のウォッチで検出された違反。 |
| **Black Duck** | はい | はい | いいえ | 1 つのプロジェクトバージョンの脆弱なコンポーネント。却下 → `IGNORED`、完了 → `REMEDIATION_COMPLETE`、再オープン → `NEW` (remediation status) 。重大度は書き込まれません。 |
| **Zafran** | はい | いいえ | いいえ | |
| **CSV** | はい | いいえ | いいえ | 1回限りのインポート。 |
| **Custom** | はい | いいえ | いいえ | Devin があなたの指示に従い、任意の API から検出結果を取得します。 |

## Wiz

Devin は、テナントの GraphQL API に対して OAuth クライアント認証情報を使用し、サービスアカウントとして Wiz に接続します。Wiz の **Settings → Service Accounts** でサービスアカウントを作成し、接続に次の情報を指定します。

* **GraphQL エンドポイント**: **Settings → Tenant** で確認できるテナントの API エンドポイント (例: `https://api.us1.app.wiz.io/graphql`) 。Devin はこの値からトークンエンドポイントを自動的に判別します。
* **クライアント ID** と **クライアントシークレット**: サービスアカウントの認証情報。それぞれ組織シークレットとして保存します。

### スコープ

サービスアカウントに次のスコープを付与します。

| 用途 | スコープ |
| - | - |
| Issue のインポート | `read:issues`, `read:threat_issues` |
| トリアージ結果の書き戻し | `write:issue_status`, `write:threat_issue_status`, `write:issue_ignore` |

Wiz は、Issue が却下されるときには `write:issue_ignore` を、Threat Detection Issue が完了するときには `write:threat_issue_status` をチェックします。`write:issue_status` だけでは、どちらの操作も許可されません。読み取りスコープのみを持つサービスアカウントでも検出結果のインポートは可能ですが、書き込みはすべて拒否されます。

### 書き込まれる内容

| Devin での操作 | Wiz での結果 |
| - | - |
| 却下 | ステータス `REJECTED`、解決理由 `WONT_FIX` |
| 完了 | ステータス `RESOLVED`、解決理由 `ISSUE_FIXED` |
| 再オープン | ステータス `OPEN` |

却下または完了を行うと、対応する Devin チケット名を記載したメモも Issue に残されます。

### 制限事項

* Wiz が `RESOLVED` を受け付けるのは Threat Detection Issue のみです。その他の種類の Issue は、再スキャンで問題が検出されなくなった時点で Wiz 自身が解決するため、Devin で完了にしても Wiz 上では未対応のまま残ります。
* 重大度は書き込まれません。Wiz の Issue の重大度は、対応する Control によって決まります。
* スコープ不足などにより Wiz が書き込みを拒否した場合、Devin は試行した変更内容と Wiz が返したエラーを含むセッションを開始します。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.