signIn 资源类型

命名空间：microsoft.graph

详细说明租户 (目录) 的用户和应用程序登录活动。 必须具有 Microsoft Entra ID P1 或 P2 许可证才能使用 Microsoft 图形 API下载登录日志。

Microsoft Entra数据保留策略控制登录日志的可用性。

方法

方法	返回类型	说明
列出 signIn	signIn	读取 signIn 对象的属性和关系。
获取 signIn	signIn	读取 signIn 对象的属性和关系。

属性

属性	类型	说明
appDisplayName	String	Microsoft Entra 管理中心中显示的应用名称。 支持 $filter（eq、startsWith）。
appId	String	表示Microsoft Entra ID中的应用 ID 的唯一 GUID。 支持 $filter（eq）。
appliedConditionalAccessPolicies	appliedConditionalAccessPolicy 集合	提供相应的登录活动触发的条件访问策略列表。 应用需要更多条件访问相关权限才能读取此属性的详细信息。 有关详细信息，请参阅 在登录中查看应用的条件访问 (CA) 策略。
clientAppUsed	String	标识用于登录活动的客户端。 新式身份验证客户端包括 Browser、 modern clients。 旧式身份验证客户端包括 Exchange ActiveSync、、IMAP、MAPISMTP、 POP和 other clients。 支持 $filter（eq）。
conditionalAccessStatus	conditionalAccessStatus	报告已激活的条件访问策略的状态。 可能的值为： success、 failure、 notApplied和 unknownFutureValue。 支持 $filter（eq）。
correlationId	String	启动登录时从客户端发送的请求 ID。 用于排查登录活动问题。 支持 $filter（eq）。
createdDateTime	DateTimeOffset	启动登录) UTC (日期和时间。 示例：2014 年 1 月 1 日午夜报告为 2014-01-01T00:00:00Z。 支持 $orderby、 $filter (eq、 le和 ge) 。
deviceDetail	deviceDetail	登录发生位置的设备信息;包括设备 ID、操作系统和浏览器。 支持$filter对eq浏览器和 operatingSytem 属性 (、 startsWith) 。
id	String	表示登录活动的唯一 ID。 支持 $filter（eq）。
ipAddress	String	用于登录的客户端的 IP 地址。 支持 $filter（eq、startsWith）。
isInteractive	Boolean	指示登录是否为交互式登录。
location	signInLocation	提供登录的来源城市、州/地区和国家/地区代码。 支持 $filter (eq、 startsWith) 城市、 州和国家 /地区OrRegion 属性。
resourceDisplayName	String	用户登录的资源的名称。 支持 $filter（eq）。
resourceId	String	用户登录的资源的 ID。 支持 $filter（eq）。
riskDetail	riskDetail	风险用户、登录或风险事件的特定状态背后的原因。 可能的值为 none、、userPerformedSecuredPasswordChangeadminGeneratedTemporaryPassword、m365DAdminDismissedDetectionuserPassedMFADrivenByRiskBasedPolicyaiConfirmedSigninSafeadminDismissedAllRiskForUseradminConfirmedSigninSafeadminConfirmedSigninCompromisedadminConfirmedServicePrincipalCompromisedadminConfirmedUserCompromisedhiddenuserPerformedSecuredPasswordResetadminDismissedAllRiskForServicePrincipaluserChangedPasswordOnPremisesunknownFutureValue、adminDismissedRiskForSignIn、 。 adminConfirmedAccountSafe 必须使用Prefer: include-unknown-enum-members请求标头来获取此可演变枚举中的以下值：adminConfirmedServicePrincipalCompromised、、adminDismissedAllRiskForServicePrincipal、m365DAdminDismissedDetection、userChangedPasswordOnPremises、adminDismissedRiskForSignIn。 adminConfirmedAccountSafe该值none意味着Microsoft Entra风险检测到目前为止未将用户或登录标记为有风险的事件。 支持 $filter（eq）。 注意：此属性的详细信息仅适用于Microsoft Entra ID P2 客户。 将返回 hidden所有其他客户。
riskEventTypes_v2	字符串集合	与登录关联的风险事件类型列表。 可能的值：unlikelyTravel、、anonymizedIPAddress、maliciousIPAddress、unfamiliarFeaturesleakedCredentialssuspiciousIPAddressinvestigationsThreatIntelligencemalwareInfectedIPAddress、、 generic或 。unknownFutureValue 支持 $filter（eq、startsWith）。
riskLevelAggregated	riskLevel	聚合风险级别。 可取值为：none、low、medium、high、hidden 和 unknownFutureValue。 该值hidden表示未为Microsoft Entra ID 保护启用用户或登录。 支持 $filter（eq）。 注意：此属性的详细信息仅适用于Microsoft Entra ID P2 客户。 将返回 hidden所有其他客户。
riskLevelDuringSignIn	riskLevel	登录期间的风险级别。 可取值为：none、low、medium、high、hidden 和 unknownFutureValue。 该值hidden表示未为Microsoft Entra ID 保护启用用户或登录。 支持 $filter（eq）。 注意：此属性的详细信息仅适用于Microsoft Entra ID P2 客户。 将返回 hidden所有其他客户。
riskState	riskState	报告风险用户、登录或风险事件的状态。 可取值包括：none、confirmedSafe、remediated、dismissed、atRisk、confirmedCompromised、unknownFutureValue。 支持 $filter（eq）。
status	signInStatus	登录状态。 包括错误代码和错误说明， (如果) 登录失败。 支持 $filter 对 eqerrorCode 属性 () 。
userDisplayName	String	启动登录的用户的显示名称。 支持 $filter（eq、startsWith）。
userId	String	启动登录的用户的 ID。 支持 $filter（eq）。
userPrincipalName	String	发起登录的用户的用户主体名称。 支持 $filter（eq、startsWith）。

关系

无。

JSON 表示形式

以下 JSON 表示形式显示了资源类型。

{
  "id": "String (identifier)",
  "createdDateTime": "String (timestamp)",
  "appDisplayName": "String",
  "appId": "String",
  "ipAddress": "String",
  "clientAppUsed": "String",
  "correlationId": "String",
  "conditionalAccessStatus": "string",
  "appliedConditionalAccessPolicy": [{"@odata.type": "microsoft.graph.appliedConditionalAccessPolicy"}],
  "isInteractive": true,
  "deviceDetail": {"@odata.type": "microsoft.graph.deviceDetail"},
  "location": {"@odata.type": "microsoft.graph.signInLocation"},
  "riskDetail": "string",
  "riskLevelAggregated": "string",
  "riskLevelDuringSignIn": "string",
  "riskState": "string",
  "riskEventTypes": ["string"],
  "riskEventTypes_v2": ["String"],
  "resourceDisplayName": "string",
  "resourceId": "string",
  "status": {"@odata.type": "microsoft.graph.signInStatus"},
  "userDisplayName": "string",
  "userId": "string",
  "userPrincipalName": "string"
}