Datadog について
Datadog コネクタは、アカウントの設定とセキュリティ関連のデータ(モニター、ユーザーとチーム、インテグレーションの状態、および関連する設定)を読み取ります。このエビデンスは Iru Compliance のコントロールに添付できます。通信には、お客様の API キー(DD-API-KEY)を使用した Datadog の HTTP API を使用します。一部の読み取りパスではアプリケーションキー(DD-APPLICATION-KEY)も必要になる場合があります。製品内のウィザードには、お客様のテナントで Iru が必要とする内容が反映されます。
仕組み
Datadog では、キーが用途ごとに分かれています。- API キーは、
DD-API-KEYを介してデータプレーンのトラフィックと多くの設定の読み取りを認証します。 - アプリケーションキーは、特定の設定 API で
DD-APPLICATION-KEYを介して API キーと組み合わせて使用します。
ドキュメント: API キーとアプリケーションキー、認証、レート制限。
前提条件
- Datadog でキーを作成するための 組織管理者(または同等)のアクセス権。
- お客様の Datadog サイト(
datadoghq.com、datadoghq.eu、FedRAMP のバリエーションなど)を把握していること。
Datadog を Iru に接続する
- Datadog
- Iru Compliance
Compliance でソースを接続する前に、このタブを完了してください。
1
正しい Datadog サイトにサインインする
組織の Datadog URL(例:
app.datadoghq.com、app.datadoghq.eu、または FedRAMP / Gov のホスト)を開きます。組織設定 を管理できるロールでサインインします。2
組織設定 を開く
左側のナビゲーションまたはアバターメニューから 組織設定 を選択します(レイアウトによっては アクセス または Administration の下にあります)。
3
APIキー を開く
APIキー を選択します。既存のキーと新しいキーを作成するためのコントロールが表示されます(パスは 組織設定 → APIキー のようになります)。
4
新しい API キーを作成する
New Key を選択します。Iru Compliance などの名前を入力してキーを作成します。
Datadog では組織あたりの API キーの数に上限があります(通常は 50)。上限に近い場合は、使用していないキーを削除してください。
5
API キーを安全な場所にコピーする
キーの値をすぐにコピーし、Iru Compliance に貼り付けるまでパスワードと同様に保管します。Datadog では、完全な値が作成時にしか表示されない場合があります。
Iru Compliance タブに進みます。
トラブルシューティング
ソースをオンにしても何も開かない
ソースをオンにしても何も開かない
Iru サイトのポップアップブロッカーの設定を確認してから、もう一度お試しください。
データが不完全
データが不完全
一部のエンドポイントでは、API キーとアプリケーションキーの両方が必要です。求められた場合は両方を入力してください。
429 レート制限
429 レート制限
間隔を空けて再試行してください。大規模なアカウントでは、同期の時間枠を広げる必要がある場合があります。失敗した呼び出しの Datadog のレート制限ヘッダーを確認してください。
リージョンが間違っている
リージョンが間違っている
エンドポイントをお客様の Datadog サイト(US、EU、その他)に合わせてください。
考慮事項
API キーは自動的に期限切れにならないため、独自の…
API キーは自動的に期限切れになりません。独自のスケジュールでローテーションし、ローテーションしたら Iru を更新してください。
レート制限はエンドポイントによって異なり、初回のバックフィルには…
レート制限はエンドポイントによって異なります。利用の多い組織では、初回のバックフィルに時間がかかる場合があります。
エビデンスには、キーがアクセスできる API が…
エビデンスには、キーがアクセスできる API の内容が反映されます。最小権限のキーでは、意図的に範囲の狭いデータが返される場合があります。
関連記事
Sources の管理
すべての Compliance ソースを参照・管理します。
Compliance の利用を開始する
フレームワーク、アクション、アーティファクト。
Iru の概要
Endpoint、Compliance、Identity がどのように連携するか。
Artifacts の管理
ソースやアクションから得たエビデンスをアップロード、確認、整理します。
