k9-ownership-byod-setup について
セキュリティ上の指摘があるクラウドリソースの所有者を Ownership Agent が判定する方法を設定する、Datadog参照テーブルの作成スキルです。CSVの準備、登録方法、動作確認、設定の挙動を案内します。
主な機能
- 013種類の所有権設定の案内
- 0212列のCSV作成
- 03UI、クラウドストレージ、Terraform、APIでの設定
- 04設定の挙動と検証ルールの説明
- 05アップロード後の確認手順
活用シーン
- 01クラウドリソースのタグを所有者に対応付け
- 02ボットや共有アカウントを所有者から除外
- 03組織固有の所有者判定ガイダンスを追加
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/k9-ownership-byod-setupを入力して読み込まれたか確認します。
同梱ファイルassets/example.csvreferences/schema.md
詳細
BYOD 設定のリファレンステーブルのセットアップ
お客様が k9_ownership_preferences リファレンステーブルを作成してアップロードし、Ownership Agent がリソースの所有者を判定する方法をカスタマイズできるよう支援します。
最初にお読みください
references/schema.md— スキーマ全体、各列の詳細、検証ルール、タイプごとの例assets/example.csv— 3 種類すべての設定タイプを含む、動作する CSV の完全版
概要
Ownership Agent は、セキュリティ上の検出結果があるクラウドリソースの所有者を推定します。所有権設定を使用すると、Datadog のリファレンステーブルにルールを登録して、この動作をカスタマイズできます。エージェントは設定を自動的に読み取ります。
設定を使用すると、次のことができます。
- タグを所有者に割り当てる：特定のタグ値を持つリソースを、特定のチームや個人の所有にできます
- アカウントを除外する：ボットアカウントや共有インフラストラクチャが所有者として表示されないようにできます
- カスタムガイダンスを指定する：AI エンジンに組織固有のコンテキストを伝えられます
リファレンステーブルの詳細
- テーブル名：
k9_ownership_preferences（正確な名前を指定する必要があります） - 反映までの時間：アップロード後 24 時間以内に変更が反映されます
- スキーマ：12 列、すべて STRING — 詳細は
references/schema.mdを参照してください
ワークフロー
ステップ 1：ニーズを確認する
お客様に次のことを確認します。
- タグの割り当て：「クラウドリソースに、所有者を示すタグはありますか？（例：
cost-center、team、project）」 - 除外対象：「所有者として表示しないボットアカウント、サービスアカウント、共有アカウントはありますか？」
- プロンプトテキスト：「所有者の判定に役立つ、組織固有のコンテキストはありますか？（例：命名規則、チーム構成）」
ステップ 2：CSV を生成する
列の仕様全体については references/schema.md を、動作するテンプレートについては assets/example.csv を確認します。12 個すべての列ヘッダーを含む CSV を作成します。各行には一意で連続した id を割り当て、preference_type に関連する列に値を入力し、それ以外の列は空欄にします。
ステップ 3：アップロード手順
オプション A — CSV のアップロード（UI）：
- Datadog で Integrations > Reference Tables に移動します
- New Reference Table をクリックします
- CSV をアップロードします
- テーブル名に
k9_ownership_preferencesを設定します - プライマリキーに
preference_type, tag_key, tag_value, handleを選択します - 保存します
手動アップロードでは、最大 4 MB のファイルをサポートしています。
オプション B — クラウドストレージとの同期（S3、Azure Blob、GCS）： 自動で定期的に更新する場合に最適です。CSV をクラウドストレージのバケットに保存すると、Datadog が定期的にインポートします。
- CSV を S3／Azure Blob／GCS にアップロードします
- Datadog で Integrations > Reference Tables に移動します
- New Reference Table をクリックし、ソースとして Cloud Storage を選択します
- ストレージのパスと認証情報を入力します
- テーブル名に
k9_ownership_preferencesを設定します - Datadog がファイルを定期的に再インポートします
クラウドストレージからのアップロードでは、最大 200 MB のファイルをサポートしています。
オプション C — Terraform：
Datadog Terraform プロバイダーの datadog_reference_table リソースを使用すると、テーブルをインフラストラクチャ・アズ・コードとして管理できます。
オプション D — API： Reference Tables API を使って、プログラムからリファレンステーブルを管理できます。利用可能なエンドポイントについては、API ドキュメントを参照してください。該当する場合は、API ドメインをお使いの Datadog サイトの URL に置き換えてください。
ステップ 4：確認する
変更は 24 時間以内に反映されます。次の手順で確認します。
- タグの割り当てのいずれかに一致するリソースを特定します
- 24 時間後に、Datadog UI でそのリソースの所有者候補を確認します
- 提案される所有者が、設定した割り当てを反映していることを確認します
主な動作
- 大文字と小文字を区別しない照合：タグキー、タグ値、ハンドル、除外タイプ、リソースタイプはすべて、大文字と小文字を区別せずに照合されます
- AND 論理による除外：空でない除外フィールドはすべて一致する必要があります。空のフィールドはワイルドカードとして扱われます
- タグマッピングは補完であり、上書きではありません：直接的な所有権インジケーター（
team:やservice:タグなど）が優先されます。タグマッピングは補完であり、置き換えではありません - 正常な縮退動作：テーブルが存在しないか空の場合、設定がなくても通常どおり所有権を検出できます
- 空のテーブルは設定を消去します：すべての行を削除するかテーブルを削除すると、キャッシュされた設定の有効期限が切れ、空になります
- 全件検証：検証に失敗すると、そのサイクルの設定セット全体が拒否されます
トラブルシューティング
| 問題 | 考えられる原因 | 対処方法 |
|---|---|---|
| 24 時間経っても設定が反映されない | テーブル名が誤っている | 正確に k9_ownership_preferences にする必要があります |
| 24 時間経っても設定が反映されない | 列ヘッダーが不足している | CSV ヘッダーとして 12 列すべてが必要です |
| 24 時間経っても設定が反映されない | 組織で機能が有効になっていない | 所有権設定を有効にするには、サポートにお問い合わせください |
| すべての設定が拒否される | 無効な文字が含まれている | references/schema.md の使用可能な文字を参照してください。山括弧、中括弧、パイプは使用できません |
| すべての設定が拒否される | 必須フィールドが不足している | references/schema.md で各設定タイプの必須フィールドを確認してください |
| すべての設定が拒否される | 重複行または競合する行がある | references/schema.md の重複検出を参照してください |
| すべての設定が拒否される | サイズ制限を超えている | タグマッピングは 50 件、除外は 20 件、プロンプトテキストは 3 件までです。フィールドあたり 1024 バイト、プロンプトあたり 4096 バイトです |
| タグマッピングが一致しない | スペルが一致していない | 大文字と小文字を区別せずに照合されますが、リソース上のタグキーと値が正確に一致していることを確認してください |
| 除外が適用されない | 範囲が狭すぎる | 空でないフィールドはすべて一致する必要があります（AND）。幅広い除外を行うには、フィルターを空のままにしてください |
| 設定が予期せず消去された | テーブルが空になったか、削除された | どちらの場合もキャッシュされた設定の有効期限が切れます。有効な CSV をアップロードして復元してください |