Slack

​

前提条件

• Corgeaの管理者アクセス
• Slackワークスペース内でワークフローを作成する権限

​

Slackワークフロービルダーの設定

{
  "event_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
  "event_type": "scan.completed",
  "timestamp": "2025-01-15T15:45:00.000Z",
  "message": "Scan completed for My Project (PR #42): 5 true-positive findings. View: https://app.corgea.app/project/proj-uuid-9012/?scan_id=scan-uuid-7890",
  "scan_id": "scan-uuid-7890",
  "scan_url": "https://app.corgea.app/project/proj-uuid-9012/?scan_id=scan-uuid-7890",
  "scan_type": "full",
  "pull_request_id": "42",
  "true_positive_count": 5,
  "status": "completed",
  "branch": "feature/auth",
  "project_name": "My Project",
  "company": "comp-uuid-1234",
  "run_id": "run-abc",
  "engine": "corgea"
}

​

Webhookテストで想定される結果

{
  "event_id": "...",
  "event_type": "webhook.test",
  "timestamp": "2025-01-15T15:45:00.000Z",
  "message": "This is a test webhook from Corgea",
  "test": true,
  "webhook_name": "My Slack Hook",
  "company": "comp-uuid-1234",
  "company_id": "comp-uuid-1234",
  "scan_id": "00000000-0000-0000-0000-000000000000",
  "scan_url": "https://app.corgea.app/project/example/?scan_id=00000000-0000-0000-0000-000000000000",
  "scan_type": "full",
  "pull_request_id": "123",
  "true_positive_count": 2,
  "status": "completed",
  "branch": "main",
  "project_name": "Example Project",
  "run_id": "test-run",
  "engine": "corgea"
}

• SlackからHTTP 2xxが返される（400 invalid_workflow_inputではない）
• トップレベルのmessage変数をマッピングすると、空でないSlackメッセージが届く
• 本番スキャンイベントと同じ変数名を使用できる（テスト時にプルリクエスト番号、スキャンリンク、誤検知でない検出結果の件数をマッピング可能）

​

通知内容

​

互換性に関する注意事項

• Zapier / その他: は依然として入れ子状のエンベロープ(event_id、 event_type、 timestamp、 data)を受け取ります。これには data.message、 data.summary、および dataの下にある新しいトリアージフィールドが含まれます。
• ネストされたdata.*をマッピングしている既存のSlack Workflow Builder設定は動作しません。data.messageではなくmessageなど、トップレベルのキーに再マッピングします。
• Corgeaの配信履歴には、SlackがフラットなHTTPボディを受信する場合でも、ネストされたエンベロープが保存されます。
• Slack Workflow BuilderのWebhookでは、スキャン以外のイベントはフラット化されません。利用可能なSlack変数が必要な場合は、Zapier、Other、またはCustom Bodyを使用してください。

​

Incoming WebhooksとWorkflow Builderの比較

• 推奨：Workflow BuilderのURL（hooks.slack.com/triggers/...）とSend a messageステップを使用します。CorgeaはType = Slackに対してscan.*とwebhook.testをフラット化します。
• Incoming Webhooks（hooks.slack.com/services/...）:レンダリング後のJSONに、トップレベルで空でない文字列のtextフィールドが含まれるCustom Bodyを追加しない限り、保存時に拒否されます。Slackのフォールバックテキストとしてtextが必要で、任意でblocksも併用できます。{"text": "{{message}}"}が機能するのは、Webhookをscan.started、scan.completed、scan.failed、scheduled_scan.daily_reportに限定した場合だけです（その他のイベントでは{{message}}が空になります）。有効なボディがないと配信に失敗し、Webhookが自動停止する可能性があります。

​

既存のSlack統合管理

​

カスタマイズオプション

• メッセージを重大度やプロジェクトごとに異なるチャネルにルーティングする
• リマインダーやフォローアップの手順を追加する
• スキャン結果を中心に条件付き論理を構築する(例: true_positive_count が0より大きい時のみ通知)
• 同じペイロード変数を複数のアクションで再利用する

​

追加リソース

• Slack ワークフロービルダーガイド
• ワークフロービルダーの JSON をフラット化する
• Corgea Webhook