Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
In this article
Applies to: ✅ Azure Data Explorer ✅ Azure Monitor ✅ Microsoft Sentinel
Returns details of the principal running the query.
current_principal_details()
Learn more about syntax conventions.
The details of the current principal as a dynamic. The following table describes the returned fields.
Field | Description |
---|---|
UserPrincipalName | The sign-in identifier for users. For more information, see UPN. |
IdentityProvider | The source that validates the identity of the principal. |
Authority | The Microsoft Entra tenant ID. |
Mfa | Indicates the use of multifactor authentication. For more information, see Access token claims reference. |
Type | The category of the principal: aaduser , aadapp , or aadgroup . |
DisplayName | The user-friendly name for the principal that is displayed in the UI. |
ObjectId | The Microsoft Entra object ID for the principal. |
FQN | The Fully Qualified Name (FQN) of the principal. Valuable for security role management commands. For more information, see Referencing security principals. |
Country | The user's country or region. This property is returned if the information is present. The value is a standard two-letter country or region code, for example, FR, JP, and SZ. |
TenantCountry | The resource tenant's country or region, set at a tenant level by an admin. This property is returned if the information is present. The value is a standard two-letter country or region code, for example, FR, JP, and SZ. |
TenantRegion | The region of the resource tenant. This property is returned if the information is present. The value is a standard two-letter country or region code, for example, FR, JP, and SZ. |
print details=current_principal_details()
Example output
details |
---|
{ "Country": "DE", "TenantCountry": "US", "TenantRegion": "WW", "UserPrincipalName": "user@fabrikam.com", "IdentityProvider": "https://sts.chinacloudapi.cn", "Authority": "aaaabbbb-0000-cccc-1111-dddd2222eeee", "Mfa": "True", "Type": "AadUser", "DisplayName": "James Smith (upn: user@fabrikam.com)", "ObjectId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb", "FQN": null, "Notes": null } |