riskyServicePrincipal リソースの種類

[アーティクル]
10/19/2023

名前空間: microsoft.graph

危険にさらMicrosoft Entraサービスプリンシパルを表します。 Microsoft Entra ID は、さまざまなシグナルと機械学習に基づいてサービスプリンシパルのリスクを継続的に評価します。この API は、Microsoft Entra テナント内のすべての危険なサービスプリンシパルへのプログラムによるアクセスを提供します。

エンティティから継承します。

メモ： riskyServicePrincipal API を使用するには、ワークロード ID Premium ライセンスが必要です。

メソッド

メソッド	戻り値の種類	説明
riskyServicePrincipals を一覧表示する	riskyServicePrincipal コレクション	危険なサービスプリンシパルとそのリスクプロパティを一覧表示します。
riskyServicePrincipal を取得する	riskyServicePrincipal	特定の危険なサービスプリンシパルとそのリスクプロパティを取得します。
却下	なし	危険なサービスプリンシパルのリスクを無視します。
confirmCompromised	なし	危険なサービスプリンシパルが侵害されていることを確認します。
リストの履歴	riskyServicePrincipalHistoryItem コレクション	Microsoft Entra サービスプリンシパルのリスク履歴を取得します。

プロパティ

プロパティ	型	説明
appId	String	関連付けられているアプリケーション ( appId プロパティ) のグローバル一意識別子 (存在する場合)。
displayName	String	サービスプリンシパルの表示名。
id	String	危険にさらされているサービスプリンシパルに割り当てられた一意の識別子。エンティティから継承されます。
isEnabled	ブール値	`true`サービスプリンシパルのアカウントが有効な場合。それ以外の場合は `false`。
isProcessing	ブール型	Microsoft Entra ID が現在サービスプリンシパルの危険な状態を処理しているかどうかを示します。
riskDetail	riskDetail	検出されたリスクの詳細。メモ：このプロパティの詳細は、ワークロード ID Premium のお客様のみが使用できます。このライセンスのないテナントのイベントが返されます `hidden`。使用可能な値: `none`、`hidden`、`unknownFutureValue`、`adminConfirmedServicePrincipalCompromised`、`adminDismissedAllRiskForServicePrincipal`。要求ヘッダーを`Prefer: include-unknown-enum-members`使用して、この進化可能な列挙型で次の値を取得する必要があることに注意してください。 `adminConfirmedServicePrincipalCompromisedadminDismissedAllRiskForServicePrincipal`
riskLastUpdatedDateTime	DateTimeOffset	リスク状態が最後に更新された日時。 DateTimeOffset 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、常に UTC 時間です。たとえば、2021 年 1 月 1 日の午前 0 時 (UTC) はです `2021-01-01T00:00:00Z`。 `$filter` (`eq`)をサポートしています。
riskLevel	riskLevel	検出された危険なワークロード ID のレベル。使用可能な値: `low`、`medium`、`high`、`hidden`、`none`、`unknownFutureValue`。 `$filter` (`eq`)をサポートしています。
riskState	riskState	サービスプリンシパルのリスクの状態。使用可能な値: `none`、`confirmedSafe`、`remediated`、`dismissed`、`atRisk`、`confirmedCompromised`、`unknownFutureValue`。
servicePrincipalType	String	サービスプリンシパルが、またはレガシアプリケーション (`socialIdp`) を表`ApplicationManagedIdentity`すかどうかを識別します。これは、Microsoft Entra ID によって内部的に設定され、servicePrincipal から継承されます。

リレーションシップ

リレーションシップ	型	説明
歴史	riskyServicePrincipalHistoryItem コレクション	Microsoft Entra サービスプリンシパルのリスク履歴を表します。

JSON 表記

リソースの JSON 表記を次に示します。

{
  "@odata.type": "#microsoft.graph.riskyServicePrincipal",
  "id": "String (identifier)",
  "isEnabled": "Boolean",
  "isProcessing": "Boolean",
  "riskLastUpdatedDateTime": "String (timestamp)",
  "riskLevel": "String",
  "riskState": "String",
  "riskDetail": "String",
  "displayName": "String",
  "appId": "String",
  "servicePrincipalType": "String"
}