Skip to content

Commit 25cfad4

Browse files
authored
Merge pull request #26145 from microsoftgraph/signInEventTypesNote
signInEventTypes limitation note
2 parents 9b36334 + 8ec817f commit 25cfad4

File tree

2 files changed

+6
-6
lines changed

2 files changed

+6
-6
lines changed

api-reference/beta/api/signin-list.md

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ description: "Get a list of the user sign-ins in a Microsoft Entra tenant."
55
ms.localizationpriority: medium
66
author: "egreenberg14"
77
ms.subservice: "entra-monitoring-health"
8-
ms.date: 11/08/2024
8+
ms.date: 01/23/2025
99
---
1010

1111
# List signIns
@@ -44,6 +44,9 @@ This method supports the `$top`, `$skiptoken`, and `$filter` OData query paramet
4444

4545
To avoid having the request time out, apply the `$filter` parameter with a time range for which to get all sign-ins, as shown in [Example 1](signin-list.md#example-1-list-all-sign-ins-during-a-specific-time-period).
4646

47+
> [!NOTE]
48+
> This API returns only interactive sign-ins unless you set an explicit filter. For example, the filter for getting non-interactive sign-ins is `https://graph.microsoft.com/beta/auditLogs/signIns?&$filter=signInEventTypes/any(t: t eq 'nonInteractiveUser')`.
49+
4750
## Request headers
4851

4952
| Name |Description|

api-reference/beta/resources/signin.md

Lines changed: 2 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ description: "Provides details about user or application sign-in activity in you
55
author: "egreenberg14"
66
ms.localizationpriority: medium
77
ms.subservice: "entra-monitoring-health"
8-
ms.date: 11/14/2024
8+
ms.date: 01/23/2025
99
---
1010

1111

@@ -19,9 +19,6 @@ Provides details about user or application sign-in activity in your directory. Y
1919

2020
The [Microsoft Entra data retention policies](/azure/active-directory/reports-monitoring/reference-reports-data-retention#how-long-does-azure-ad-store-the-data) govern the availability of sign-in logs.
2121

22-
> [!NOTE]
23-
> This API returns only interactive sign-ins unless you set an explicit filter. For example, the filter for getting non-interactive sign-ins is `https://graph.microsoft.com/beta/auditLogs/signIns?&$filter=signInEventTypes/any(t: t eq 'nonInteractiveUser')`.
24-
2522
## Methods
2623

2724
| Method | Return Type |Description|
@@ -91,7 +88,7 @@ The [Microsoft Entra data retention policies](/azure/active-directory/reports-mo
9188
|servicePrincipalId|String|The application identifier used for sign-in. This field is populated when you're signing in using an application. <br/><br/> Supports `$filter` (`eq`, `startsWith`).|
9289
|servicePrincipalName|String|The application name used for sign-in. This field is populated when you're signing in using an application. <br/><br/> Supports `$filter` (`eq`, `startsWith`).|
9390
|sessionLifetimePolicies|[sessionLifetimePolicy](sessionlifetimepolicy.md) collection|Any conditional access session management policies that were applied during the sign-in event.|
94-
|signInEventTypes|String collection|Indicates the category of sign in that the event represents. For user sign ins, the category can be `interactiveUser` or `nonInteractiveUser` and corresponds to the value for the **isInteractive** property on the signin resource. For managed identity sign ins, the category is `managedIdentity`. For service principal sign-ins, the category is **servicePrincipal**. Possible values are: `interactiveUser`, `nonInteractiveUser`, `servicePrincipal`, `managedIdentity`, `unknownFutureValue`. <br/><br/> Supports `$filter` (`eq`, `ne`).|
91+
|signInEventTypes|String collection|Indicates the category of sign in that the event represents. For user sign ins, the category can be `interactiveUser` or `nonInteractiveUser` and corresponds to the value for the **isInteractive** property on the signin resource. For managed identity sign ins, the category is `managedIdentity`. For service principal sign-ins, the category is **servicePrincipal**. Possible values are: `interactiveUser`, `nonInteractiveUser`, `servicePrincipal`, `managedIdentity`, `unknownFutureValue`. <br/><br/> Supports `$filter` (`eq`, `ne`). <br/><br/>**NOTE:** Only interactive sign-ins are returned unless you set an explicit filter. For example, the filter for getting non-interactive sign-ins is `https://graph.microsoft.com/beta/auditLogs/signIns?&$filter=signInEventTypes/any(t: t eq 'nonInteractiveUser')`.|
9592
|sessionId|String|Identifier of the session that was generated during the sign-in.|
9693
|signInIdentifier|String|The identification that the user provided to sign in. It can be the userPrincipalName, but is also populated when a user signs in using other identifiers.|
9794
|signInIdentifierType|signInIdentifierType|The type of sign in identifier. Possible values are: `userPrincipalName`, `phoneNumber`, `proxyAddress`, `qrCode`, `onPremisesUserPrincipalName`, `unknownFutureValue`.|

0 commit comments

Comments
 (0)