Skip to main content

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 キーと組み合わせて使用します。
このコネクタは、コンプライアンスのエビデンスのための読み取り操作に重点を置いています。このソースの一部として、Iru がカスタムメトリクスやログを Datadog に送信することはありません。 ドキュメント: API キーとアプリケーションキー、認証、レート制限。

前提条件

  • Datadog でキーを作成するための 組織管理者(または同等)のアクセス権。
  • お客様の Datadog サイト(datadoghq.com、datadoghq.eu、FedRAMP のバリエーションなど)を把握していること。

Datadog を Iru に接続する

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 キーの文字列を確認してください。テナントが想定している同じ組織とサイトのキーを使用していることを確認してください。
一部のエンドポイントでは、API キーとアプリケーションキーの両方が必要です。求められた場合は両方を入力してください。
間隔を空けて再試行してください。大規模なアカウントでは、同期の時間枠を広げる必要がある場合があります。失敗した呼び出しの Datadog のレート制限ヘッダーを確認してください。
エンドポイントをお客様の Datadog サイト(US、EU、その他)に合わせてください。

考慮事項

API キーは自動的に期限切れにならないため、独自の…

API キーは自動的に期限切れになりません。独自のスケジュールでローテーションし、ローテーションしたら Iru を更新してください。

レート制限はエンドポイントによって異なり、初回のバックフィルには…

レート制限はエンドポイントによって異なります。利用の多い組織では、初回のバックフィルに時間がかかる場合があります。

エビデンスには、キーがアクセスできる API が…

エビデンスには、キーがアクセスできる API の内容が反映されます。最小権限のキーでは、意図的に範囲の狭いデータが返される場合があります。

関連記事

Sources の管理

すべての Compliance ソースを参照・管理します。

Compliance の利用を開始する

フレームワーク、アクション、アーティファクト。

Iru の概要

Endpoint、Compliance、Identity がどのように連携するか。

Artifacts の管理

ソースやアクションから得たエビデンスをアップロード、確認、整理します。