Azure Active Directory PowerShell Sign-in

Identifies a sign-in using the Azure Active Directory PowerShell module. PowerShell for Azure Active Directory allows for managing settings from the command line, which is intended for users who are members of an admin role.

Elastic rule (View on GitHub)

  1[metadata]
  2creation_date = "2020/12/14"
  3integration = ["azure"]
  4maturity = "production"
  5updated_date = "2024/05/21"
  6
  7[rule]
  8author = ["Elastic"]
  9description = """
 10Identifies a sign-in using the Azure Active Directory PowerShell module. PowerShell for Azure Active Directory allows
 11for managing settings from the command line, which is intended for users who are members of an admin role.
 12"""
 13false_positives = [
 14    """
 15    Sign-ins using PowerShell may be done by a system or network administrator. Verify whether the username, hostname,
 16    and/or resource name should be signing into your environment. Sign-ins from unfamiliar users or hosts should be
 17    investigated. If known behavior is causing false positives, it can be exempted from the rule.
 18    """,
 19]
 20from = "now-25m"
 21index = ["filebeat-*", "logs-azure*"]
 22language = "kuery"
 23license = "Elastic License v2"
 24name = "Azure Active Directory PowerShell Sign-in"
 25note = """## Triage and analysis
 26
 27### Investigating Azure Active Directory PowerShell Sign-in
 28
 29Azure Active Directory PowerShell for Graph (Azure AD PowerShell) is a module IT professionals commonly use to manage their Azure Active Directory. The cmdlets in the Azure AD PowerShell module enable you to retrieve data from the directory, create new objects in the directory, update existing objects, remove objects, as well as configure the directory and its features.
 30
 31This rule identifies sign-ins that use the Azure Active Directory PowerShell module, which can indicate unauthorized access if done outside of IT or engineering.
 32
 33#### Possible investigation steps
 34
 35- Identify the user account that performed the action and whether it should perform this kind of action.
 36- Evaluate whether the user needs to access Azure AD using PowerShell to complete its tasks.
 37- Investigate other alerts associated with the user account during the past 48 hours.
 38- Consider the source IP address and geolocation for the involved user account. Do they look normal?
 39- Contact the account owner and confirm whether they are aware of this activity.
 40- Investigate suspicious actions taken by the user using the module, for example, modifications in security settings that weakens the security policy, persistence-related tasks, and data access.
 41- If you suspect the account has been compromised, scope potentially compromised assets by tracking servers, services, and data accessed by the account in the last 24 hours.
 42
 43### False positive analysis
 44
 45- If this activity is expected and noisy in your environment, consider adding IT, Engineering, and other authorized users as exceptions — preferably with a combination of user and device conditions.
 46
 47### Response and remediation
 48
 49- Initiate the incident response process based on the outcome of the triage.
 50- Disable or limit the account during the investigation and response.
 51- Identify the possible impact of the incident and prioritize accordingly; the following actions can help you gain context:
 52    - Identify the account role in the cloud environment.
 53    - Assess the criticality of affected services and servers.
 54    - Work with your IT team to identify and minimize the impact on users.
 55    - Identify if the attacker is moving laterally and compromising other accounts, servers, or services.
 56    - Identify any regulatory or legal ramifications related to this activity.
 57- Investigate credential exposure on systems compromised or used by the attacker to ensure all compromised accounts are identified. Reset passwords or delete API keys as needed to revoke the attacker's access to the environment. Work with your IT teams to minimize the impact on business operations during these actions.
 58- Check if unauthorized new users were created, remove unauthorized new accounts, and request password resets for other IAM users.
 59- Consider enabling multi-factor authentication for users.
 60- Follow security best practices [outlined](https://docs.microsoft.com/en-us/azure/security/fundamentals/identity-management-best-practices) by Microsoft.
 61- Determine the initial vector abused by the attacker and take action to prevent reinfection via the same vector.
 62- Using the incident response data, update logging and audit policies to improve the mean time to detect (MTTD) and the mean time to respond (MTTR).
 63
 64## Setup
 65
 66The Azure Fleet integration, Filebeat module, or similarly structured data is required to be compatible with this rule."""
 67references = [
 68    "https://msrc-blog.microsoft.com/2020/12/13/customer-guidance-on-recent-nation-state-cyber-attacks/",
 69    "https://docs.microsoft.com/en-us/microsoft-365/enterprise/connect-to-microsoft-365-powershell?view=o365-worldwide",
 70]
 71risk_score = 21
 72rule_id = "a605c51a-73ad-406d-bf3a-f24cc41d5c97"
 73severity = "low"
 74tags = [
 75    "Domain: Cloud",
 76    "Data Source: Azure",
 77    "Use Case: Identity and Access Audit",
 78    "Resources: Investigation Guide",
 79    "Tactic: Initial Access",
 80]
 81timestamp_override = "event.ingested"
 82type = "query"
 83
 84query = '''
 85event.dataset:azure.signinlogs and
 86  azure.signinlogs.properties.app_display_name:"Azure Active Directory PowerShell" and
 87  azure.signinlogs.properties.token_issuer_type:AzureAD and event.outcome:(success or Success)
 88'''
 89
 90
 91[[rule.threat]]
 92framework = "MITRE ATT&CK"
 93[[rule.threat.technique]]
 94id = "T1078"
 95name = "Valid Accounts"
 96reference = "https://attack.mitre.org/techniques/T1078/"
 97[[rule.threat.technique.subtechnique]]
 98id = "T1078.004"
 99name = "Cloud Accounts"
100reference = "https://attack.mitre.org/techniques/T1078/004/"
101
102
103
104[rule.threat.tactic]
105id = "TA0001"
106name = "Initial Access"
107reference = "https://attack.mitre.org/tactics/TA0001/"

Triage and analysis

Investigating Azure Active Directory PowerShell Sign-in

Azure Active Directory PowerShell for Graph (Azure AD PowerShell) is a module IT professionals commonly use to manage their Azure Active Directory. The cmdlets in the Azure AD PowerShell module enable you to retrieve data from the directory, create new objects in the directory, update existing objects, remove objects, as well as configure the directory and its features.

This rule identifies sign-ins that use the Azure Active Directory PowerShell module, which can indicate unauthorized access if done outside of IT or engineering.

Possible investigation steps

  • Identify the user account that performed the action and whether it should perform this kind of action.
  • Evaluate whether the user needs to access Azure AD using PowerShell to complete its tasks.
  • Investigate other alerts associated with the user account during the past 48 hours.
  • Consider the source IP address and geolocation for the involved user account. Do they look normal?
  • Contact the account owner and confirm whether they are aware of this activity.
  • Investigate suspicious actions taken by the user using the module, for example, modifications in security settings that weakens the security policy, persistence-related tasks, and data access.
  • If you suspect the account has been compromised, scope potentially compromised assets by tracking servers, services, and data accessed by the account in the last 24 hours.

False positive analysis

  • If this activity is expected and noisy in your environment, consider adding IT, Engineering, and other authorized users as exceptions — preferably with a combination of user and device conditions.

Response and remediation

  • Initiate the incident response process based on the outcome of the triage.
  • Disable or limit the account during the investigation and response.
  • Identify the possible impact of the incident and prioritize accordingly; the following actions can help you gain context:
    • Identify the account role in the cloud environment.
    • Assess the criticality of affected services and servers.
    • Work with your IT team to identify and minimize the impact on users.
    • Identify if the attacker is moving laterally and compromising other accounts, servers, or services.
    • Identify any regulatory or legal ramifications related to this activity.
  • Investigate credential exposure on systems compromised or used by the attacker to ensure all compromised accounts are identified. Reset passwords or delete API keys as needed to revoke the attacker's access to the environment. Work with your IT teams to minimize the impact on business operations during these actions.
  • Check if unauthorized new users were created, remove unauthorized new accounts, and request password resets for other IAM users.
  • Consider enabling multi-factor authentication for users.
  • Follow security best practices outlined by Microsoft.
  • Determine the initial vector abused by the attacker and take action to prevent reinfection via the same vector.
  • Using the incident response data, update logging and audit policies to improve the mean time to detect (MTTD) and the mean time to respond (MTTR).

Setup

The Azure Fleet integration, Filebeat module, or similarly structured data is required to be compatible with this rule.

References

Related rules

to-top