サインイン リソースの種類

名前空間: microsoft.graph

重要

Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。

ディレクトリでのユーザーやアプリケーションのサインイン アクティビティについて詳しく説明します。 Microsoft Graph APIを使用してサインイン ログをダウンロードするには、Microsoft Entra ID P1 または P2 ライセンスが必要です。

Microsoft Entra データ保持ポリシーは、サインイン ログの可用性を制御します。

注:

この API は、明示的なフィルターを設定しない限り、対話型サインインのみを返します。 たとえば、非対話型サインインを取得するためのフィルターは https://graph.microsoft.com/beta/auditLogs/signIns?&$filter=signInEventTypes/any(t: t eq 'nonInteractiveUser')。

メソッド

メソッド	戻り値の型	説明
List	サインイン	サインイン オブジェクトのプロパティとリレーションシップを読み取ります。
Get	サインイン	サインイン オブジェクトのプロパティとリレーションシップを読み取ります。
侵害ありと確認する	なし	Microsoft Entraサインイン ログのイベントを危険としてマークします。
安全を確認する	なし	サインイン ログのイベントMicrosoft Entra安全としてマークします。

プロパティ

プロパティ	型	説明
appDisplayName	String	Microsoft Entra 管理センターに表示されるアプリケーション名。 $filter (eq、startsWith) をサポートします。
appId	String	Microsoft Entra IDのアプリケーション識別子。 $filter (eq)をサポートしています。
appliedConditionalAccessPolicies	appliedConditionalAccessPolicy コレクション	対応するサインイン アクティビティによってトリガーされる条件付きアクセス ポリシーの一覧。 アプリでは、このプロパティの詳細を読み取るために、より多くの条件付きアクセス関連の特権が必要です。 詳細については、「 サインインで適用された条件付きアクセス (CA) ポリシーを表示するためのアクセス許可」を参照してください。
appliedEventListeners	appliedAuthenticationEventListener コレクション	Azure Logic Apps や Azure Functions などのリスナーに関する詳細情報。サインイン イベントの対応するイベントがトリガーされます。
appTokenProtectionStatus	tokenProtectionStatus	トークン保護により、トークンと発行先のデバイスとの間に暗号化されたセキュリティで保護された結び付きが作成されます。 このフィールドは、アプリ トークンがデバイスにバインドされたかどうかを示します。
authenticationAppDeviceDetails	authenticationAppDeviceDetails	Microsoft Entra認証手順で使用されるアプリとデバイスの詳細を提供します。
authenticationAppPolicyEvaluationDetails	authenticationAppPolicyDetails コレクション	認証手順中にユーザーとクライアントの認証アプリに適用されるMicrosoft Entra ポリシーの詳細を提供します。
authenticationContextClassReferences	authenticationContext コレクション	サインインに適用される条件付きアクセス認証コンテキストを表す値のコレクションを格納します。
authenticationDetails	authenticationDetail コレクション	認証試行の結果と、認証方法の詳細。
authenticationMethodsUsed	String collection	使用される認証方法。 使用可能な値: SMS、 Authenticator App、 App Verification code、 Password、 FIDO、 PTA、または PHS。
authenticationProcessingDetails	keyvalue コレクション	PTA と PHS のエージェント名、フェデレーション認証のサーバーまたはファーム名など、認証処理の詳細。
authenticationProtocol	protocolType	認証で使用されるプロトコルの種類または許可の種類をListsします。 使用可能な値は、 none、 oAuth2、 ropc、 wsFederation、 saml20、 deviceCode、 unknownFutureValue、 authenticationTransfer、 nativeAuthです。 noneは、その一覧に特定の値がないすべての認証に使用します。 この進化可能な列挙型で次の値を取得するには、Prefer: include-unknown-enum-members要求ヘッダーを使用する必要があります:authenticationTransfer、nativeAuth。
authenticationRequirement	String	これにより、サインインを成功させるために、すべてのサインイン手順で必要な最高レベルの認証が保持されます。 $filter (eq、startsWith) をサポートします。
authenticationRequirementPolicies	authenticationRequirementPolicy コレクション	条件付きアクセス、ユーザーごとの MFA、ID 保護、セキュリティの既定値など、認証要件のソース。
autonomousSystemNumber	Int32	アクターによって使用されるネットワークの自律システム番号 (ASN)。
azureResourceId	String	サインイン中にアクセスされた Azure リソースの完全修飾 Azure Resource Manager ID が含まれます。
clientAppUsed	String	サインイン アクティビティに使用されるレガシ クライアント。 たとえば、 Browser、 Exchange ActiveSync、 Modern clients、 IMAP、 MAPI、 SMTP、 POPなどです。 $filter (eq)をサポートしています。
clientCredentialType	clientCredentialType	ユーザー クライアントまたはサービス プリンシパルが自身を認証するためにMicrosoft Entra IDするために指定した資格情報の種類について説明します。 このプロパティを確認して、安全性の低い資格情報の種類を追跡して排除したり、異常な資格情報の種類を使用してクライアントとサービス プリンシパルのwatchしたりできます。 使用可能な値: none、clientSecret、clientAssertion、federatedIdentityCredential、managedIdentity、certificate、unknownFutureValue。
conditionalAccessAudiences	String	サインイン イベント中に条件付きアクセスが評価された対象ユーザーを示すリスト。 $filter (eq)をサポートしています。
conditionalAccessStatus	conditionalAccessStatus	トリガーされた条件付きアクセス ポリシーの状態。 使用可能な値: success、 failure、 notApplied、または unknownFutureValue。 $filter (eq)をサポートしています。
correlationId	String	サインインが開始されたときにクライアントが送信する識別子。 このプロパティは、サポートを呼び出すときに対応するサインイン アクティビティのトラブルシューティングに使用されます。 $filter (eq)をサポートしています。
createdDateTime	DateTimeOffset	サインインが開始された日時。 Timestamp 型は、常に UTC 時間です。 たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z です。 $orderby、$filter (eq、le、ge) をサポートします。
crossTenantAccessType	signInAccessType	アクターがリソースにアクセスするために使用するテナント間アクセスの種類について説明します。 可能な値は、none、b2bCollaboration、b2bDirectConnect、microsoftSupport、serviceProvider、unknownFutureValue、passthrough です。 また、 Prefer: include-unknown-enum-members 要求ヘッダーを使用して、この 進化可能な列挙型で次の値または値を取得する必要があります: passthrough。 サインインがテナントの境界を越えていなかった場合、値は none。
deviceDetail	deviceDetail	サインインが発生した場所のデバイス情報。 deviceId、OS、ブラウザーなどの情報が含まれます。 ブラウザーおよび operatingSystem プロパティで$filter (eq、startsWith) をサポートします。
federatedCredentialId	String	フェデレーション ID 資格情報がサインインに使用された場合は、アプリケーションのフェデレーション ID 資格情報の識別子が含まれます。
flaggedForReview	ブール型	サインインに失敗した場合、ユーザーはAzure portalのボタンを選択して、テナント管理者の失敗したイベントをマークできます。 ユーザーがボタンを選択して、失敗したサインインにフラグを設定した場合、この値は true。
globalSecureAccessIpAddress	String	サインインが開始されたグローバル セキュリティで保護されたアクセス IP アドレス。
homeTenantId	String	サインインを開始するユーザーのテナント識別子。 マネージド ID またはサービス プリンシパルのサインインでは適用されません。
homeTenantName	String	ユーザー サインインの場合、ユーザーがメンバーであるテナントの識別子。 ホーム テナントがテナントのコンテンツを表示するためにMicrosoft Entra IDに肯定的な同意を提供する場合にのみ設定されます。
id	String	サインイン アクティビティを表す識別子。 エンティティから継承 されます。 $filter (eq)をサポートしています。
incomingTokenType	incomingTokenType	サインインでアクターを認証するためにMicrosoft Entra IDに提示されたトークンの種類を示します。 使用可能な値: none、primaryRefreshToken、saml11、saml20、unknownFutureValue、remoteDesktopToken、refreshToken。 注 Microsoft Entra IDでは、アクターを認証するために、この列挙型に記載されていないトークン型も使用されている可能性があります。 一覧表示されている型の 1 つでない場合は、トークンの不足を推測しないでください。 また、 Prefer: include-unknown-enum-members 要求ヘッダーを使用して、この 進化可能な列挙型の次の値 ( remoteDesktopToken、 refreshToken) を取得する必要があります。
ipAddress	String	サインインが発生したクライアントの IP アドレス。 $filter (eq、startsWith) をサポートします。
ipAddressFromResourceProvider	String	一部のポリシーの条件付きアクセスコンプライアンスを決定するために使用される、リソース プロバイダーに到達するために使用されるユーザーの IP アドレス。 たとえば、ユーザーがExchange Onlineと対話するときに、Microsoft Exchange がユーザーから受け取る IP アドレスをここに記録できます。 多くの場合、この値は nullされます。
isInteractive	Boolean	ユーザーのサインインが対話型かどうかを示します。 対話型サインインでは、ユーザーはMicrosoft Entra IDする認証要素を提供します。 これらの要因には、パスワード、MFA チャレンジへの応答、生体認証要素、またはユーザーがMicrosoft Entra IDまたは関連するアプリに提供する QR コードが含まれます。 非対話型サインインでは、ユーザーは認証要素を提供しません。 代わりに、クライアント アプリはトークンまたはコードを使用して、ユーザーの代わりにリソースを認証またはアクセスします。 非対話型サインインは、通常、クライアントがユーザーに対して透過的なプロセスでユーザーの代わりにサインインするために使用されます。
isTenantRestricted	ブール型	サインイン イベントがテナント制限ポリシー Microsoft Entra適用されたかどうかを示します。
isThroughGlobalSecureAccess	ブール型	ユーザーがグローバル セキュリティで保護されたアクセス サービスを使用したかどうかを示します。
location	signInLocation	サインインが行われた場所の市区町村、州、2 文字の国番号。 都市、州、および countryOrRegion プロパティの$filter (eq、startsWith) をサポートします。
managedServiceIdentity	managedIdentity	サインインに使用されるマネージド ID に関する情報 (その種類、関連付けられた Azure Resource Manager (ARM) リソース ID、フェデレーション トークン情報など) が含まれます。
networkLocationDetails	networkLocationDetail コレクション	使用されるネットワークの種類とその名前など、ネットワークの場所の詳細。
originalRequestId	String	認証シーケンス内の最初の要求の要求識別子。 $filter (eq)をサポートしています。
originalTransferMethod	originalTransferMethods	後続のすべての要求を通じてセッションを開始するために使用される転送メソッド。 使用可能な値: none、deviceCodeFlow、authenticationTransfer、unknownFutureValue。
privateLinkDetails	privateLinkDetails	サインイン イベントに関連付けられているMicrosoft Entra Private Link ポリシーに関する情報が含まれます。
processingTimeInMilliseconds	Int	AD STS の要求処理時間 (ミリ秒単位)。
resourceDisplayName	String	ユーザーがサインインしたリソースの名前。 $filter (eq)をサポートしています。
resourceId	String	ユーザーがサインインしたリソースの識別子。 $filter (eq)をサポートしています。
resourceServicePrincipalId	String	サインイン イベントで対象リソースを表すサービス プリンシパルの識別子。
resourceTenantId	String	サインインで参照されるリソースのテナント識別子。
riskDetail	riskDetail	危険なユーザー、サインイン、またはリスク イベントの特定の状態の背後にある理由。 使用できる値は、 none、 adminGeneratedTemporaryPassword、 userPerformedSecuredPasswordChange、 userPerformedSecuredPasswordReset、 adminConfirmedSigninSafe、 aiConfirmedSigninSafe、 userPassedMFADrivenByRiskBasedPolicy、 adminDismissedAllRiskForUser、 adminConfirmedSigninCompromisedhidden、 adminConfirmedUserCompromised、 unknownFutureValue、 adminConfirmedServicePrincipalCompromised、 adminDismissedAllRiskForServicePrincipal、 m365DAdminDismissedDetection、 userChangedPasswordOnPremises、 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	String collection	サインインに関連付けられているリスク イベントの種類の一覧。 使用可能な値: unlikelyTravel、 anonymizedIPAddress、 maliciousIPAddress、 unfamiliarFeatures、 malwareInfectedIPAddress、 suspiciousIPAddress、 leakedCredentials、 investigationsThreatIntelligence、 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)をサポートしています。
servicePrincipalCredentialKeyId	String	認証にサービス プリンシパルによって使用されるキー資格情報の一意識別子。
servicePrincipalCredentialThumbprint	String	サービス プリンシパルが認証に使用する証明書の証明書拇印。
servicePrincipalId	String	サインインに使用されるアプリケーション識別子。 このフィールドは、アプリケーションを使用してサインインするときに設定されます。 $filter (eq、startsWith) をサポートします。
servicePrincipalName	String	サインインに使用されるアプリケーション名。 このフィールドは、アプリケーションを使用してサインインするときに設定されます。 $filter (eq、startsWith) をサポートします。
sessionLifetimePolicies	sessionLifetimePolicy コレクション	サインイン イベント中に適用された条件付きアクセス セッション管理ポリシー。
signInEventTypes	String collection	イベントが表すサインインのカテゴリを示します。 ユーザー サインインの場合、カテゴリは interactiveUser または nonInteractiveUser でき、サインイン リソースの isInteractive プロパティの値に対応します。 マネージド ID サインインの場合、カテゴリは managedIdentity。 サービス プリンシパル サインインの場合、カテゴリは servicePrincipal です。 可能な値は、interactiveUser、nonInteractiveUser、servicePrincipal、managedIdentity、unknownFutureValue です。 $filter (eq、ne) をサポートします。
sessionId	String	サインイン中に生成されたセッションの識別子。
signInIdentifier	String	ユーザーがサインインするために指定した識別。 userPrincipalName を指定できますが、ユーザーが他の識別子を使用してサインインするときにも設定されます。
signInIdentifierType	signInIdentifierType	サインイン識別子の種類。 使用可能な値: userPrincipalName、phoneNumber、proxyAddress、qrCode、onPremisesUserPrincipalName、unknownFutureValue。
signInTokenProtectionStatus	tokenProtectionStatus	トークン保護により、トークンと発行先のデバイスとの間に暗号化されたセキュリティで保護された結び付きが作成されます。 このフィールドは、サインイン トークンがデバイスにバインドされたかどうかを示します。 使用可能な値: none、bound、unbound、unknownFutureValue。
status	signInStatus	サインインの状態。 エラー コードとエラーの説明が含まれます (サインインエラーの場合)。 errorCode プロパティの$filter (eq) をサポートします。
tokenIssuerName	String	ID プロバイダーの名前。 たとえば、「 sts.microsoft.com 」のように入力します。 $filter (eq)をサポートしています。
tokenIssuerType	tokenIssuerType	ID プロバイダーの種類。 使用可能な値: AzureAD、ADFederationServices、UnknownFutureValue、AzureADBackupAuth、ADFederationServicesMFAAdapter、NPSExtension。 Prefer: include-unknown-enum-members要求ヘッダーを使用して、この進化可能な列挙型で次の値を取得する必要があります。AzureADBackupAuth、ADFederationServicesMFAAdapter、NPSExtension。
uniqueTokenIdentifier	String	リソース プロバイダーで引き換えられたMicrosoft Entra IDによって発行されたトークンを追跡するために使用される、一意の base64 でエンコードされた要求識別子。
userAgent	String	サインインに関連するユーザー エージェント情報。 $filter (eq、startsWith) をサポートします。
userDisplayName	String	ユーザーの表示名。 $filter (eq、startsWith) をサポートします。
userId	String	ユーザーの識別子。 $filter (eq)をサポートしています。
userPrincipalName	String	サインインを開始したユーザーのユーザー プリンシパル名。 この値は常に小文字です。 通常、ユーザー オブジェクトの値にドメイン 部分の前に #EXT# が含まれるゲスト ユーザーの場合、このプロパティは値を小文字と "true" の両方の形式で格納します。 たとえば、ユーザー オブジェクトは AdeleVance_fabrikam.com#EXT#@contoso.comを格納しますが、サインイン ログには adelevance@fabrikam.comが格納されます。 $filter (eq、startsWith) をサポートします。
userType	signInUserType	ユーザーがテナントのメンバーかゲストかを識別します。 可能な値は member、guest、unknownFutureValue です。
mfaDetail (非推奨)	mfaDetail	このプロパティは推奨されていません。

リレーションシップ

なし

JSON 表記

次の JSON 表現は、リソースの種類を示しています。

{
  "@odata.type": "#microsoft.graph.signIn",
  "appDisplayName": "String",
  "appId": "String",
  "authenticationContextClassReferences": [{"@odata.type": "microsoft.graph.authenticationContext"}],
  "appliedConditionalAccessPolicies": [
    {
      "@odata.type": "microsoft.graph.appliedConditionalAccessPolicy"
    }
  ],
  "appliedEventListeners": [
    {
      "@odata.type": "microsoft.graph.appliedAuthenticationEventListener"
    }
  ],
  "appTokenProtectionStatus": {
      "@odata.type": "microsoft.graph.tokenProtectionStatus"
  },
  "authenticationAppDeviceDetails": {
      "@odata.type": "microsoft.graph.authenticationAppDeviceDetails"
  },
  "authenticationAppPolicyEvaluationDetails": [
    {
      "@odata.type": "microsoft.graph.authenticationAppPolicyDetails"
    }
  ],
  "authenticationDetails": [
    {
      "@odata.type": "microsoft.graph.authenticationDetail"
    }
  ],
  "authenticationMethodsUsed": [
    "String"
  ],
  "authenticationProcessingDetails": [
    {
      "@odata.type": "microsoft.graph.keyValue"
    }
  ],
  "authenticationRequirement": "String",
  "authenticationRequirementPolicies": [
    {
      "@odata.type": "microsoft.graph.authenticationRequirementPolicy"
    }
  ],
  "autonomousSystemNumber": "Integer",
  "azureResourceId": "String",
  "clientAppUsed": "String",
  "conditionalAccessStatus": "String",
  "correlationId": "String",
  "createdDateTime": "String (timestamp)",
  "crossTenantAccessType": "String",
  "deviceDetail": {
    "@odata.type": "microsoft.graph.deviceDetail"
  },
  "federatedCredentialId": "String",
  "flaggedForReview": "Boolean",
  "id": "String (identifier)",
  "homeTenantId": "String",
  "homeTenantName": "String",
  "isInteractive": "Boolean",
  "isTenantRestricted": "Boolean",
  "ipAddress": "String",
  "ipAddressFromResourceProvider": "String",
  "location": {
    "@odata.type": "microsoft.graph.signInLocation"
  },
  "mfaDetail": {
    "@odata.type": "microsoft.graph.mfaDetail"
  },
  "networkLocationDetails": [
    {
      "@odata.type": "microsoft.graph.networkLocationDetail"
    }
  ],
  "originalRequestId": "String",
  "originalTransferMethod": "String",
  "privateLinkDetails": {
    "@odata.type": "microsoft.graph.privateLinkDetails"
  },
  "processingTimeInMilliseconds": "Integer",
  "riskDetail": "String",
  "riskEventTypes_v2": [
    "String"
  ],
  "riskLevelAggregated": "String",
  "riskLevelDuringSignIn": "String",
  "riskState": "String",
  "resourceDisplayName": "String",
  "resourceId": "String",
  "resourceTenantId": "String",
  "servicePrincipalCredentialKeyId": "String",
  "servicePrincipalCredentialThumbprint": "String",
  "servicePrincipalId": "String",
  "servicePrincipalName": "String",
  "sessionId": "String",
  "sessionLifetimePolicies": [{"@odata.type": "microsoft.graph.sessionLifetimePolicy"}],
  "signInEventTypes": [
    "String"
  ],
  "signInIdentifier": "String",
  "signInIdentifierType": "String",
  "signInTokenProtectionStatus": "String",
  "status": {
    "@odata.type": "microsoft.graph.signInStatus"
  },
  "tokenIssuerName": "String",
  "tokenIssuerType": "String",
  "userAgent": "String",
  "userDisplayName": "String",
  "userId": "String",
  "userPrincipalName": "String",
  "userType": "String"
}