名前空間: microsoft.graph.security
注:
Microsoft 脅威インテリジェンス API は、Microsoft Defender XDR または Microsoft Sentinel ライセンスをお持ちのすべてのお客様が利用できます。 これらの API にアクセスするために、個別のライセンスは必要ありません。
親ホスト経由で子ホストに到達できる親子ホストのペアを表します。 たとえば、contoso.com が microsoft.com にリダイレクトする場合、contoso.com は親ホストを表し、子ホスト microsoft.com を表します。
以前の時点で共有されていたホスト ペア関係、または現在 Microsoft クロールから観察された接続を共有している関係。 親ホストは、単純なトップレベル リダイレクト (HTTP 302) または iframe やスクリプト ソース参照などのより複雑なものを介して、子ホストにつながります。 他のインスタンスでは、Web クロールによって、IP アドレスとドメイン/ホスト間のホスト ペア関係が DNS 標準に反する奇妙な動作が明らかになる場合があります。
linkKind プロパティは、ホストを親子ペアとして識別する理由を示します。 この例は redirectかもしれません。
ホスト ペアの詳細については、データ セットの Microsoft Defender 脅威インテリジェンスに関するドキュメントを参照してください。
メソッド
| メソッド | 戻り値の種類 | 説明 |
|---|---|---|
| Get | microsoft.graph.security.hostPair | hostPair オブジェクトのプロパティと関係を読み取ります。 |
| ホストの一覧 | microsoft.graph.security.hostPair コレクション | 指定したホストに関連付けられている hostPair オブジェクトのリストを取得します (ホストは親 または 子のいずれかです)。 |
| ホストを子として一覧表示する | microsoft.graph.security.hostPair コレクション | ホストに関連付けられている hostPair オブジェクトのリストを取得します。このホストは 子 ホストであり、 親と入力ペアリングがあります。 |
| ホストを親として一覧表示する | microsoft.graph.security.hostPair コレクション | ホストに関連付けられている hostPair オブジェクトのリストを取得します。このホストは 親 であり、 子と発信ペアリングがあります。 |
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
| firstSeenDateTime | DateTimeOffset | Microsoft Defender 脅威インテリジェンスが最初に hostPair を観測した日時。 タイムスタンプの種類は、ISO 8601 形式を使用して、常に UTC 形式の日付と時刻情報を表します。 たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z です。 |
| id | 文字列 | hostPair のシステム生成 ID。 |
| lastSeenDateTime | DateTimeOffset | Microsoft Defender 脅威インテリジェンスが hostPair を最後に観測した日時。 タイムスタンプの種類は、ISO 8601 形式を使用して、常に UTC 形式の日付と時刻情報を表します。 たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z です。 |
| linkKind | 文字列 | 2 つのホストが hostPair として識別される理由。 |
リレーションシップ
| リレーションシップ | 型 | 説明 |
|---|---|---|
| childHost | microsoft.graph.security.host | parentHost 経由でホストに到達。 |
| parentHost | microsoft.graph.security.host | childHost に到達するために使用されたホスト。 |
JSON 表記
次の JSON 表現は、リソースの種類を示しています。
{
"@odata.type": "#microsoft.graph.security.hostPair",
"firstSeenDateTime": "String (timestamp)",
"id": "String (identifier)",
"lastSeenDateTime": "String (timestamp)",
"linkKind": "String"
}