mcpField
S
security-copilot-agents

security-copilot-agents

github.com/vinayaklattheセキュリティ17878 回インストール19 週間前に更新
リポジトリ

security-copilot-agents について

大量かつ反復的なワークフローに対応するため、Security Copilot の組み込みセキュリティエージェントを導入・管理するチーム向けのスキルです。エージェント ID、権限の範囲、人による監督、パイロット評価を扱います。

主な機能

  1. 01セキュリティキューに合う組み込みエージェントの選定
  2. 02Entra Agent ID と権限の設定
  3. 03操作ごとの推奨モードまたは自律モード設定
  4. 04範囲を限定したパイロットで精度を測定
  5. 05エージェント活動の追跡と ID ライフサイクル管理

活用シーン

  1. 01ユーザー報告のフィッシングメールをトリアージ
  2. 02Purview DLP や Insider Risk のアラート滞留に対応
  3. 03条件付きアクセスのポリシーや脆弱性対応キューを最適化

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/vinayaklatthe/microsoft-security-skills --skill security-copilot-agents

インストール後、Claude Code で/security-copilot-agentsを入力して読み込まれたか確認します。

詳細

Microsoft Security Copilot エージェント

Security Copilot エージェントは、Security Copilot 内で動作する、特定の用途に特化した半自律型 AI エージェントです。大量のセキュリティワークフローを担い、アナリストからのフィードバックを学習し、Microsoft Security 製品内で処理を実行します。各エージェントには独自の Entra Agent ID、スコープが設定されたアクセス許可、監督モデルがあります。

使用するタイミング

ユーザーが大量の反復的なトリアージや修復のワークフローをエージェントに任せたいと考えており、自律的に動作するワークロード ID を管理する準備ができている場合に、このスキルを使用してください。

次の場合はこのスキルを使用しないでください。

  • Security Copilot の基本的なセットアップ、SCU のプロビジョニング、プロンプトブック(security-copilot を使用してください)
  • Entra Agent ID の全般的な設計(entra-id と Entra Agent ID のガイダンスを使用してください)
  • カスタムエージェントをゼロから構築する場合(このスキルでは組み込みエージェントを使用します)

作業に適したエージェントを選ぶ

チームが対応に追われているものエージェント担当製品最初に推奨するモード
ユーザーから報告されたフィッシングのチケットPhishing TriageDefender for Office 365推奨 — 2 週間は判定を人間が承認
DLP/Insider Risk のアラートの滞留Alert Triage (Purview)Purview推奨 — 自律化の前に精度を測定
古い、または重複している条件付きアクセス ポリシーConditional Access OptimizationEntra ID推奨のみ — 本番環境では自律モードを使用しない
エンドポイントのパッチ/脆弱性対応の滞留Vulnerability RemediationIntune + Defender Vuln Mgmt推奨。既存の変更管理を通じてパッチを展開
経営陣向けの脅威情勢ブリーフィングThreat Intelligence BriefingDefender Threat Intelligence自律(読み取り専用)
SOC アナリストのオンボーディング/コンテキストの照会Conditional Access / IR partner agentsパートナーエコシステム推奨 — サードパーティのデータ経路

**経験則:**すべてのエージェントは、まず 2~4 週間 推奨モードで運用してください。エージェントの判定と人間の判定の一致率を測定します。対象キューで一致率が 90% を超えた場合にのみ、自律モードへ移行してください。

アプローチ

  1. まず容量とライセンスを確保します — 各エージェントは Security Copilot Compute Units(SCU) を消費します。組み込みエージェントの多くは、同時に実行するワークフローごとに約1~2 SCUを必要とします。SCUの契約と、対象製品のライセンス(例:Phishing TriageにはDefender for Office 365 P2が必要です)を確認してください。どちらかが不足していると、エージェントはUIに表示されても実行に失敗します。 確認方法:Security Copilot → Owner settings → Capacityで、有効にする予定のエージェントに十分なSCUが確保されていることを確認します。
  2. エージェントのIDを設定します — 各エージェントには独自のEntra Agent ID(ワークロードID)があります。特権サービスプリンシパルとして扱い、予測しやすい名前(例:sc-agent-phishingtriage-prod)を付け、所有者を文書化し、IDインベントリに登録して、サインインの監視を有効にします。 確認方法:Entra → Enterprise applicationsに、想定どおりのAPIアクセス許可が設定され、余分なアクセス許可のないエージェントIDが表示されていることを確認します。
  3. 最小権限に合わせてアクセス許可を設定します — 組み込みエージェントは、Graphや製品のアクセス許可を要求します。シナリオに不要なものはすべて確認して削除してください。たとえば、Alert Triageは、同意フローに表示されていてもMail.Sendを必要としません。 確認方法:エージェントでテストアクションが成功し、意図的に範囲外としたアクション(例:トリアージのみを想定している場合のメール送信)が失敗することを確認します。
  4. アクションごとに監督モードを設定します — 各エージェントには、影響範囲の異なるアクションがあります。エージェント単位ではなく、アクション単位でモードを設定してください。
    • Recommendation = エージェントが提案し、人間が承認します(ブロック、削除、パスワードリセット、MFAリセット、ポリシー変更では常にこのモードを使用します)
    • Autonomous = エージェントが承認なしで実行します(ラベル付け、分類、読み取り専用の情報拡充、ブリーフィングの生成であれば許容できます) 確認方法:テストデータで取り消せないアクションを実行すると、人間の承認を求めることを確認します。取り消し可能なアクションは、承認なしで実行されることを確認します。
  5. 限定範囲でパイロットを実施します — エージェントの対象を、1つのチーム、メールボックス、サイト、またはデバイスグループに絞り、2~4週間運用します。合意率、意思決定までの時間、偽陽性/偽陰性の件数、上書き率を測定します。 確認方法:対象範囲を拡大する前に、パイロットダッシュボードでエージェントと人間の合意率が90%を超えていることを確認します。
  6. SOCツールと連携します — エージェントのアクティビティログは、AuditLogsテーブルとエージェント固有のテーブルを通じてDefender XDRとSentinelに流れます。エージェントの判断と人間による上書きを追跡するワークブックを作成し、ドリフトを把握できるようにします。
  7. エージェントIDのライフサイクルを管理します — エージェント(またはワークフロー)を廃止する際は、Entra Agent IDを無効にし、APIアクセス許可を取り消して、特権IDインベントリから削除します。用途を終えた後も残り続けるエージェントIDは、将来の影響範囲を広げることになります。

ガードレール

  • 重大な影響を及ぼすアクションには、必ず人間を介在させてください。 パスワードリセット、MFAリセット、アカウントの無効化、メッセージの削除、ポリシー変更、デバイスのワイプは、自律実行させないでください。
  • エージェントIDは特権サービスプリンシパルとして管理してください。 忘れてしまいがちなサービスアカウントとは異なります。条件付きアクセスを適用し(サポートされている場合)、サインインを監視し、APIアクセス許可を四半期ごとに確認し、エージェントのシークレットをローテーションして、同意済みのアクセス許可を監査してください。
  • 自律実行に移行する前に、合意率を測定してください。 精度85%のエージェントを大量の処理に適用すると、規模の拡大に伴い15%のインシデントを生み出すことになります。しきい値には90%以上を使用してください。
  • SCUの消費量を監視してください。 インシデントが急増すると、エージェントが予想外にSCU容量を使い切ることがあります。SCUの使用率が80%を超えた場合にアラートを設定してください。
  • 複数のエージェントを同じIDに集約しないでください。 各組み込みエージェントには独自のEntra Agent IDがあります。集約はサポートされておらず、監査証跡が損なわれます。
  • エージェントのプロンプトは汚染される可能性があります。 Phishing-Triageはユーザーから送信されたメールの内容を読み取ります。エージェントへの入力は信頼できないものとして扱ってください。Microsoftには組み込みの緩和策があります。独自の未サニタイズのデータソースを追加しないでください。

よくあるアンチパターン

  • 「初日から自律モードで有効にする。」 精度の基準がなく、最初の誤検知が実際の障害につながります(幹部用メールボックスがブロックされる、VIP アカウントが無効になるなど)。
  • 「エージェントの ID にグローバル管理者を使用する。」 影響範囲が壊滅的に広がります。エージェントの既定のスコープ付きアクセス許可を使用し、さらに絞り込んでください。
  • 「エージェントを SOC アナリストとして扱う。」 エージェントは人を補強するものであり、置き換えるものではありません。人によるレビューループがなければ、エージェントの改善につながるフィードバックが得られません。
  • 「使用を終了したエージェント ID を無効にし忘れる。」 非アクティブなエージェント ID が、同意済みの Graph アクセス許可とともに Entra に残ります。サプライチェーン攻撃の格好の標的です。
  • 「パイロットを省略する。」 組織全体への展開では、2 週間のパイロットで見つけられたはずの、キュー固有の障害モードが表面化します。

プロンプトの例

  • Deploy the Phishing Triage agent in Security Copilot.
  • Which Security Copilot agent should I pilot first for my SOC?
  • How do I supervise an autonomous alert triage agent and set permissions?
  • What permissions does the Conditional Access Optimization agent need?
  • Configure agent identity for an agentic SOC.
  • Measure the accuracy of the Alert Triage agent before going autonomous.

Microsoft Learn

コメント