名前空間: microsoft.graph.security
注:
Microsoft 脅威インテリジェンス API は、Microsoft Defender XDR または Microsoft Sentinel ライセンスをお持ちのすべてのお客様が利用できます。 これらの API にアクセスするために、個別のライセンスは必要ありません。
Web サイトとそのユーザー間の安全で暗号化された通信を可能にし、機密情報を保護するデジタル証明書である SSL 証明書を表します。 Web サイトの ID を検証し、データを暗号化してプライバシーを確保し、ユーザーの信頼を構築します。 Microsoft Defender 脅威インテリジェンスが Web サイトをクロールすると、ユーザーが検索できるように SSL 証明書のインデックスが作成されます。 悪意のある攻撃者は、不正な証明書を使用して不正な Web サイトを作成したり、正当な証明書を侵害して暗号化された通信を傍受したりすることで、SSL 証明書を悪用する可能性があります。
成果物から継承します。
メソッド
| メソッド | 戻り値の種類 | 説明 |
|---|---|---|
| List | microsoft.graph.security.sslCertificate コレクション | sslCertificate オブジェクトとそのプロパティの一覧を取得します。 |
| Get | microsoft.graph.security.sslCertificate | sslCertificate オブジェクトのプロパティとリレーションシップを取得します。 |
| 関連するホストをリスト表示する | Microsoft.Graph.Security.Host コレクション | sslCertificate に関連付けられている関連ホスト リソースの一覧を取得します。 |
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
| expirationDateTime | DateTimeOffset | 証明書の有効期限が切れる日時。 タイムスタンプの種類は、ISO 8601 形式を使用して、常に UTC 形式の日付と時刻情報を表します。 たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z です。 |
| フィンガープリント | 文字列 | データと署名に基づいて計算された証明書のハッシュ。 |
| firstSeenDateTime | DateTimeOffset | この sslCertificate が最初に確認された日時。 タイムスタンプの種類は、ISO 8601 形式を使用して、常に UTC 形式の日付と時刻情報を表します。 たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z です。 |
| id | 文字列 | この sslCertificate のシステム生成 ID。 成果物から継承されます。 |
| issueDateTime | DateTimeOffset | 証明書が発行された日時。 タイムスタンプの種類は、ISO 8601 形式を使用して、常に UTC 形式の日付と時刻情報を表します。 たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z です。 |
| 発行者 | microsoft.graph.security.sslCertificateEntity | この証明書を付与するエンティティ。 |
| lastSeenDateTime | DateTimeOffset | この sslCertificate が確認された最新の日時。 タイムスタンプの種類は、ISO 8601 形式を使用して、常に UTC 形式の日付と時刻情報を表します。 たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z です。 |
| シリアル番号 | 文字列 | SSL 証明書に関連付けられたシリアル番号。 |
| SHA1 | 文字列 | 証明書の SHA-1 ハッシュ。 メモ: これは署名ではありません。 |
| subject | microsoft.graph.security.sslCertificateEntity | この証明書の対象となるユーザー、サイト、コンピューターなど。 |
リレーションシップ
| リレーションシップ | 型 | 説明 |
|---|---|---|
| relatedHosts | Microsoft.Graph.Security.Host コレクション | この sslCertificate に関連付けられているホスト リソース。 |
JSON 表記
次の JSON 表現は、リソースの種類を示しています。
{
"@odata.type": "#microsoft.graph.security.sslCertificate",
"expirationDateTime": "String (timestamp)",
"fingerprint": "String",
"firstSeenDateTime": "String (timestamp)",
"id": "String (identifier)",
"issueDateTime": "String (timestamp)",
"issuer": {"@odata.type": "microsoft.graph.security.sslCertificateEntity"},
"lastSeenDateTime": "String (timestamp)",
"serialNumber": "String",
"sha1": "String",
"subject": {"@odata.type": "microsoft.graph.security.sslCertificateEntity"}
}