サインイン リソースの種類signIn resource type

重要

Microsoft Graph の/betaバージョンの api は変更される可能性があります。APIs under the /beta version in Microsoft Graph are subject to change. 実稼働アプリケーションでは、これらの API の使用はサポートされていません。Use of these APIs in production applications is not supported.

ディレクトリでのユーザーやアプリケーションのサインイン アクティビティについて詳しく説明します。Provides details about user or application sign-in activity in your directory.

メソッドMethods

メソッドMethod 戻り値の型Return Type 説明Description
サインインを一覧表示するList signIn サインインsignIn サインイン オブジェクトのプロパティとリレーションシップを読み取ります。Read properties and relationships of signIn objects.
サインインを取得するGet signIn サインインsignIn サインイン オブジェクトのプロパティとリレーションシップを読み取ります。Read properties and relationships of a signIn object.

プロパティProperties

プロパティProperty Type 説明Description
appDisplayNameappDisplayName StringString Azure ポータルで表示されるアプリケーション名を参照します。Refers to the application name displayed in the Azure Portal.
appIdappId StringString Azure Active Directory でのアプリケーション ID を表す一意の GUID を参照します。Refers to the Unique GUID representing Application Id in the Azure Active Directory.
clientAppUsedclientAppUsed StringString サインインに使用するレガシ クライアントを示します。例:Provides the legacy client used for sign-in activty.E.g. ブラウザー、Exchange Active Sync、先進認証クライアント、IMAP、MAPI、SMTP、POP が含まれます。includes Browser, Exchange Active Sync,Modern clients, IMAP, MAPI, SMTP, POP.
appliedConditionalAccessPoliciesappliedConditionalAccessPolicies conditionalAccessPolicy コレクションconditionalAccessPolicy collection 対応するサインイン アクティビティでトリガーされる条件付きアクセス ポリシーの一覧を示します。Provides a list of conditional access policies that are triggered by the corresponding sign-in activity.
conditionalAccessStatusconditionalAccessStatus stringstring トリガーされる条件付きアクセス ポリシーの状態を示します。Provides the status of the conditional access policy triggered. 使用可能な値は、successfailurenotAppliedunknownFutureValue です。Possible values are: success, failure, notApplied, unknownFutureValue.
originalRequestIdoriginalRequestId StringString 認証シーケンスで最初の要求の要求 ID です。The request id of the first request in the authentication sequence.
isInteractiveisInteractive BooleanBoolean サインインが対話型かどうかを示します。Indicates if a signIn is interactive or not.
tokenIssuerNametokenIssuerName StringString ID プロバイダーの名前 (例: sts.microsoft.com) Name of the identity Provider (e.g. sts.microsoft.com)
tokenIssuerTypetokenIssuerType StringString identityProvider の種類を示します。Provides the type of identityProvider. 使用可能な値は、AzureADADFederationServicesUnknownFutureValue です。Possible values are AzureAD, ADFederationServices, UnknownFutureValue.
correlationIdcorrelationId StringString サインインが開始されるときに、クライアントから送信される ID を参照します。Refers to the ID that's sent from the client when the sign-in is initiated. これは、ヘルプデスクまたはサポートに問い合わせをするときに、対応するサインイン アクティビティのトラブルシューティングに使用されます。This is used for troubleshooting the corresponding sign-in activity when calling helpdesk or support.
createdDateTimecreatedDateTime DateTimeOffsetDateTimeOffset サインインが開始された日付を示します。Provides the date and time the sign-in was initiated. Timestamp 型は、常に UTC 時間です。The Timestamp type is always in UTC time. たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、次のようになります。'2014-01-01T00:00:00Z'For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'
deviceDetaildeviceDetail deviceDetaildeviceDetail サインインが発生した場所からデバイスの情報を提供します。Provides the device information from where the sign-in occurred. これは、deviceId、OS、ブラウザーなどの情報が含まれます。It inclules information like deviceId, OS, browser.
idid StringString サインイン アクティビティを表す一意の ID を示します。Indicates unique ID representing the sign-in activity.
ipAddressipAddress StringString サインインが発生した場所から、クライアントの IP アドレスを提供します。Provides the IP address of the client from where the sign-in occurred.
locationlocation signInLocationsignInLocation サインインが発生した場所から市区町村、都道府県、2 文字の国コードを示します。Provides the city, state and 2 letter country code from where the sign-in occurred.
processingTimeInMillisecondsprocessingTimeInMilliseconds IntInt 要求処理時間を AD STS のミリ秒単位で示します。Provides the request processing time in milliseconds in AD STS
riskDetailriskDetail riskDetail リスクの高いユーザー、サインイン、リスク イベントのいずれかの特定の状態の背後にある「理由」について示します。Provides the 'reason' behind a specific state of a risky user, sign-in or a risk event. 使用可能な値: noneadminGeneratedTemporaryPassworduserPerformedSecuredPasswordChangeuserPerformedSecuredPasswordResetadminConfirmedSigninSafeaiConfirmedSigninSafeuserPassedMFADrivenByRiskBasedPolicyadminDismissedAllRiskForUseradminConfirmedSigninCompromisedunknownFutureValueThe possible values are: none, adminGeneratedTemporaryPassword, userPerformedSecuredPasswordChange, userPerformedSecuredPasswordReset, adminConfirmedSigninSafe, aiConfirmedSigninSafe, userPassedMFADrivenByRiskBasedPolicy, adminDismissedAllRiskForUser, adminConfirmedSigninCompromised, unknownFutureValue. none は、ユーザーについて実行されたアクションまたはサインインが今のところないことを意味しています。The value none means that no action has been performed on the user or sign-in so far. 注: このプロパティの詳細は、Azure AD Premium P2 のお客様のみ利用可能です。Note: Details for this property are only available for Azure AD Premium P2 customers. その他のお客様には hidden が返されます。All other customers will be returned hidden.
riskLevelAggregatedriskLevelAggregated riskLevel 集計されたリスク レベルを示します。Provides the aggregated risk level. 使用可能な値: nonelowmediumhighhiddenunknownFutureValueThe possible values are: none, low, medium, high, hidden, and unknownFutureValue. hidden は、ユーザーまたはサインインが Azure AD Identity Protection で有効になっていないことを意味します。The value hidden means the user or sign-in was not enabled for Azure AD Identity Protection. 注: このプロパティの詳細は、Azure AD Premium P2 のお客様のみ利用可能です。Note: Details for this property are only available for Azure AD Premium P2 customers. その他のお客様には hidden が返されます。All other customers will be returned hidden.
riskLevelDuringSignInriskLevelDuringSignIn riskLevel サインイン時のリスク レベルを示します。Provides the risk level during sign-in. 使用可能な値: nonelowmediumhighhiddenunknownFutureValueThe possible values are: none, low, medium, high, hidden, and unknownFutureValue. hidden は、ユーザーまたはサインインが Azure AD Identity Protection で有効になっていないことを意味します。The value hidden means the user or sign-in was not enabled for Azure AD Identity Protection. 注: このプロパティの詳細は、Azure AD Premium P2 のお客様のみ利用可能です。Note: Details for this property are only available for Azure AD Premium P2 customers. その他のお客様には hidden が返されます。All other customers will be returned hidden.
riskEventTypesriskEventTypes riskEventType コレクションriskEventType collection サインインに関連付けられているリスク イベントの種類の一覧を示します。Provides the list of risk event types associated with the sign-in. 使用可能な値: unlikelyTravelanonymizedIPAddressmaliciousIPAddressunfamiliarFeaturesmalwareInfectedIPAddresssuspiciousIPAddressleakedCredentialsinvestigationsThreatIntelligencegenericunknownFutureValueThe possible values are: unlikelyTravel, anonymizedIPAddress, maliciousIPAddress, unfamiliarFeatures, malwareInfectedIPAddress, suspiciousIPAddress, leakedCredentials, investigationsThreatIntelligence, generic, and unknownFutureValue.
riskStateriskState riskState リスクの高いユーザー、サインイン、リスク イベントの「リスクの状態」について示します。Provides the 'risk state' of a risky user, sign-in or a risk event. 使用可能な値: noneconfirmedSaferemediateddismissedatRiskconfirmedCompromisedunknownFutureValueThe possible values are: none, confirmedSafe, remediated, dismissed, atRisk, confirmedCompromised, unknownFutureValue.
mfaDetailmfaDetail mfaDetailmfaDetail MFA が必要か、対応するサインインの MFA の状態など MFA 関連の情報を提供します。Provides the MFA related information like MFA Required, MFA Status for the corresponding sign-in.
networkLocationDetailsnetworkLocationDetails networkLocationDetail コレクションnetworkLocationDetail collection ネットワーク上の場所について詳細を示します。Provides details about the network location.
statusstatus signInStatussignInStatus サインイン状態について示します。Provides the sign-in status. 使用可能な値は、SuccessFailure です。Possible values include Success and Failure.
userDisplayNameuserDisplayName StringString ユーザーの表示名を示します。Indicates the display Name of the User.
userIduserId StringString ユーザーのユーザー ID を示します。Indicates the userId of the user.
userPrincipalNameuserPrincipalName StringString ユーザーの UPN を示します。Indicates the UPN of the user.
resourceDisplayNameresourceDisplayName StringString ユーザーがサインインしているリソースの名前を示します。Indicates the name of the resource that the user signed into
resourceIdresourceId StringString ユーザーがサインインしているリソースの ID を示します。Indicates the Id of the resource that the user signed into.
authenticationMethodsUsedauthenticationMethodsUsed StringString 使用される認証方法の一覧を示しますIndicates the list of Authentication methods used

関係Relationships

なしNone

JSON 表記JSON representation

以下は、リソースの JSON 表記です。Here is a JSON representation of the resource.

{
  "id": "String (identifier)",
  "createdDateTime": "String (timestamp)",
  "userDisplayName": "String",
  "userPrincipalName": "String",
  "userId": "String",
  "appDisplayName": "String",
  "appId": "String",
  "ipAddress": "String",
  "clientAppUsed": "String",
  "mfaDetail": {"@odata.type": "microsoft.graph.mfaDetail"},
  "correlationId": "String",
  "conditionalAccessStatus": "string",
  "appliedConditionalAccessPolicies": [{"@odata.type": "microsoft.graph.appliedConditionalAccessPolicy"}],
  "originalRequestId": "String",
  "isInteractive": "String",
  "tokenIssuerName": "String",
  "tokenIssuerType": "String",
  "deviceDetail": {"@odata.type": "microsoft.graph.deviceDetail"},
  "location": {"@odata.type": "microsoft.graph.signInLocation"},
  "riskDetail": "string",
  "riskLevelAggregated": "string",
  "riskLevelDuringSignIn": "string",
  "riskState": "string",
  "riskEventTypes": ["String"],
  "resourceDisplayName": "string",
  "resourceId": "string",
  "authenticationMethodsUsed": "string",
  "status": {"@odata.type": "microsoft.graph.signInStatus"},
  "processingTimeInMilliseconds": 12356,
  "networkLocationDetails": [{"@odata.type": "microsoft.graph.networkLocationDetail"}]
}