AnalysisType: rule
Filename: aws_console_login_without_mfa.py
RuleID: "AWS.Console.LoginWithoutMFA"
DisplayName: "Logins Without MFA"
Enabled: true
LogTypes:
- AWS.CloudTrail
Tags:
- AWS
- Identity & Access Management
- Authentication
- Initial Access:Valid Accounts
Reports:
CIS:
- 3.2
MITRE ATT&CK:
- TA0001:T1078
Stratus Red Team:
- aws.initial-access.console-login-without-mfa
Severity: High
Description: A console login was made without multi-factor authentication.
Runbook: https://docs.runpanther.io/alert-runbooks/built-in-rules/aws-console-login-without-mfa
Reference: https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_mfa.html
SummaryAttributes:
- userAgent
- sourceIpAddress
- recipientAccountId
- p_any_aws_arns
Tests:
- Name: No MFA Login - IAM User
ExpectedResult: true
Mocks:
- objectName: check_account_age
returnValue: "False"
Log:
{
"eventVersion": "1.05",
"userIdentity":
{
"type": "IAMUser",
"principalId": "1111",
"arn": "arn:aws:iam::123456789012:user/tester",
"accountId": "123456789012",
"userName": "tester",
},
"eventTime": "2019-01-01T00:00:00Z",
"eventSource": "signin.amazonaws.com",
"eventName": "ConsoleLogin",
"awsRegion": "us-east-1",
"sourceIPAddress": "111.111.111.111",
"userAgent": "Mozilla",
"requestParameters": null,
"responseElements": { "ConsoleLogin": "Success" },
"additionalEventData":
{
"LoginTo": "https://console.aws.amazon.com/console/",
"MobileVersion": "No",
"MFAUsed": "No",
},
"eventID": "1",
"eventType": "AwsConsoleSignIn",
"recipientAccountId": "123456789012",
"p_log_type": "AWS.CloudTrail",
}
- Name: No MFA Login - IAM User Unknown Account
ExpectedResult: true
Mocks:
- objectName: check_account_age
returnValue: "False"
Log:
{
"eventVersion": "1.05",
"userIdentity":
{
"type": "IAMUser",
"principalId": "1111",
"arn": "arn:aws:iam::123456789013:user/tester",
"accountId": "123456789013",
"userName": "tester",
},
"eventTime": "2019-01-01T00:00:00Z",
"eventSource": "signin.amazonaws.com",
"eventName": "ConsoleLogin",
"awsRegion": "us-east-1",
"sourceIPAddress": "111.111.111.111",
"userAgent": "Mozilla",
"requestParameters": null,
"responseElements": { "ConsoleLogin": "Success" },
"additionalEventData":
{
"LoginTo": "https://console.aws.amazon.com/console/",
"MobileVersion": "No",
"MFAUsed": "No",
},
"eventID": "1",
"eventType": "AwsConsoleSignIn",
"recipientAccountId": "123456789013",
"p_log_type": "AWS.CloudTrail",
}
- Name: No MFA Login - Root User
ExpectedResult: true
Mocks:
- objectName: check_account_age
returnValue: "False"
Log:
{
"eventVersion": "1.05",
"userIdentity":
{
"accessKeyId": "",
"accountId": "123456789012",
"arn": "arn:aws:iam::123456789012:root",
"principalId": "123456789012",
"type": "Root",
},
"eventTime": "2019-01-01T00:00:00Z",
"eventSource": "signin.amazonaws.com",
"eventName": "ConsoleLogin",
"awsRegion": "us-east-1",
"sourceIPAddress": "111.111.111.111",
"userAgent": "Mozilla",
"requestParameters": null,
"responseElements": { "ConsoleLogin": "Success" },
"additionalEventData":
{
"LoginTo": "https://console.aws.amazon.com/console/",
"MobileVersion": "No",
"MFAUsed": "No",
},
"eventID": "1",
"eventType": "AwsConsoleSignIn",
"recipientAccountId": "123456789012",
"p_log_type": "AWS.CloudTrail",
}
- Name: MFA Login - SAML
ExpectedResult: false
Mocks:
- objectName: check_account_age
returnValue: "False"
Log:
{
"additionalEventData":
{
"LoginTo": "https://console.aws.amazon.com/console/home",
"MobileVersion": "No",
"MFAUsed": "No",
"SamlProviderArn": "arn:aws:iam::123456789012:saml-provider/Okta",
},
"eventVersion": "1.05",
"userIdentity":
{
"type": "IAMUser",
"principalId": "1111",
"arn": "arn:aws:iam::123456789012:user/tester",
"accountId": "123456789012",
"userName": "tester",
},
"eventTime": "2019-01-01T00:00:00Z",
"eventSource": "signin.amazonaws.com",
"eventName": "ConsoleLogin",
"awsRegion": "us-east-1",
"sourceIPAddress": "111.111.111.111",
"userAgent": "Mozilla",
"requestParameters": null,
"responseElements": { "ConsoleLogin": "Success" },
"eventID": "1",
"eventType": "AwsConsoleSignIn",
"recipientAccountId": "123456789012",
"p_log_type": "AWS.CloudTrail",
}
- Name: MFA Login
ExpectedResult: false
Mocks:
- objectName: check_account_age
returnValue: "False"
Log:
{
"eventVersion": "1.05",
"userIdentity":
{
"type": "IAMUser",
"principalId": "1111",
"arn": "arn:aws:iam::123456789012:user/tester",
"accountId": "123456789012",
"userName": "tester",
},
"eventTime": "2019-01-01T00:00:00Z",
"eventSource": "signin.amazonaws.com",
"eventName": "ConsoleLogin",
"awsRegion": "us-east-1",
"sourceIPAddress": "111.111.111.111",
"userAgent": "Mozilla",
"requestParameters": null,
"responseElements": { "ConsoleLogin": "Success" },
"additionalEventData":
{
"LoginTo": "https://console.aws.amazon.com/console/",
"MobileVersion": "No",
"MFAUsed": "Yes",
},
"eventID": "1",
"eventType": "AwsConsoleSignIn",
"recipientAccountId": "123456789012",
"p_log_type": "AWS.CloudTrail",
}
- Name: No MFA - Login Failed
ExpectedResult: false
Mocks:
- objectName: check_account_age
returnValue: "False"
Log:
{
"eventVersion": "1.05",
"userIdentity":
{
"type": "IAMUser",
"principalId": "1111",
"arn": "arn:aws:iam::123456789012:user/tester",
"accountId": "123456789012",
"userName": "tester",
},
"eventTime": "2019-01-01T00:00:00Z",
"eventSource": "signin.amazonaws.com",
"eventName": "ConsoleLogin",
"awsRegion": "us-east-1",
"sourceIPAddress": "111.111.111.111",
"userAgent": "Mozilla",
"requestParameters": null,
"responseElements": { "ConsoleLogin": "Failure" },
"additionalEventData":
{
"LoginTo": "https://console.aws.amazon.com/console/",
"MobileVersion": "No",
"MFAUsed": "Yes",
},
"eventID": "1",
"eventType": "AwsConsoleSignIn",
"recipientAccountId": "123456789012",
"p_log_type": "AWS.CloudTrail",
}
- Name: No MFA - authenticated from session with MFA
ExpectedResult: false
Mocks:
- objectName: check_account_age
returnValue: "False"
Log:
{
"p_event_time": "2019-01-01 00:20:04.000Z",
"eventSource": "signin.amazonaws.com",
"eventName": "ConsoleLogin",
"userIdentity":
{
"accountId": "123456789012",
"arn": "arn:aws:sts::123456789012:assumed-role/testrole_34c15ddd84cb4648/tester@example.com",
"principalId": "AROAXXXXXXXXXXXXXXXXX:tester@example.com",
"sessionContext":
{
"attributes":
{
"creationDate": "2019-09-01T21:20:03Z",
"mfaAuthenticated": "true",
},
"sessionIssuer":
{
"accountId": "123456789012",
"arn": "arn:aws:iam::123456789012:role/aws-reserved/sso.amazonaws.com/us-east-1/testrole_34c15ddd84cb4648",
"principalId": "AROAXXXXXXXXXXXXXXXXX",
"type": "Role",
"userName": "testrole_34c15ddd84cb4648",
},
"webIdFederationData": {},
},
"type": "AssumedRole",
},
"p_log_type": "AWS.CloudTrail",
}
- Name: No MFA Login - New User
ExpectedResult: false
Mocks:
- objectName: check_account_age
returnValue: "True"
Log:
{
"eventVersion": "1.05",
"userIdentity":
{
"type": "IAMUser",
"principalId": "1111",
"arn": "arn:aws:iam::123456789012:user/tester",
"accountId": "123456789012",
"userName": "tester",
},
"eventTime": "2019-01-01T00:00:00Z",
"eventSource": "signin.amazonaws.com",
"eventName": "ConsoleLogin",
"awsRegion": "us-east-1",
"sourceIPAddress": "111.111.111.111",
"userAgent": "Mozilla",
"requestParameters": null,
"responseElements": { "ConsoleLogin": "Success" },
"additionalEventData":
{
"LoginTo": "https://console.aws.amazon.com/console/",
"MobileVersion": "No",
"MFAUsed": "No",
},
"eventID": "1",
"eventType": "AwsConsoleSignIn",
"recipientAccountId": "123456789012",
"p_log_type": "AWS.CloudTrail",
}
- Name: AWS SSOv2 Login
ExpectedResult: false
Mocks:
- objectName: check_account_age
returnValue: "False"
Log:
{
"additionalEventData": { "MFAUsed": "No", "MobileVersion": "No" },
"awsRegion": "us-east-2",
"eventID": "1111111111",
"eventName": "ConsoleLogin",
"eventSource": "signin.amazonaws.com",
"eventTime": "2022-03-16 19:17:41",
"eventType": "AwsConsoleSignIn",
"eventVersion": "1.08",
"managementEvent": true,
"readOnly": false,
"recipientAccountId": "xxx",
"responseElements": { "ConsoleLogin": "Success" },
"sourceIPAddress": "1.2.3.4",
"userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/99.0.4844.51 Safari/537.36",
"userIdentity":
{
"accountId": "xxx",
"arn": "arn:aws:sts::xxx:assumed-role/AWSReservedSSO_developer_admin_asdf/foo@bar.com",
"principalId": "xxx:foo@bar.com",
"sessionContext":
{
"attributes":
{
"creationDate": "2022-03-16T19:17:41Z",
"mfaAuthenticated": "false",
},
"sessionIssuer":
{
"accountId": "xxx",
"arn": "arn:aws:iam::xxx:role/aws-reserved/sso.amazonaws.com/us-east-2/AWSReservedSSO_developer_admin_asdf",
"principalId": "xxx",
"type": "Role",
"userName": "AWSReservedSSO_developer_admin_asdf",
},
"webIdFederationData": {},
},
"type": "AssumedRole",
},
"p_log_type": "AWS.CloudTrail",
}
- Name: AssumeRole from MFA User Session
ExpectedResult: false
Mocks:
- objectName: check_account_age
returnValue: "False"
Log:
{
"additionalEventData": { "MFAUsed": "No", "MobileVersion": "No" },
"awsRegion": "us-east-1",
"eventID": "sdsdsdsd",
"eventName": "ConsoleLogin",
"eventSource": "signin.amazonaws.com",
"eventTime": "2022-03-29 17:16:36.000000000",
"eventType": "AwsConsoleSignIn",
"eventVersion": "1.08",
"managementEvent": true,
"readOnly": false,
"recipientAccountId": "111111111111111",
"responseElements": { "ConsoleLogin": "Success" },
"sourceIPAddress": "1.1.1.1",
"userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/99.0.4844.83 Safari/537.36",
"userIdentity":
{
"accountId": "11111",
"sessionContext":
{
"attributes":
{
"creationDate": "2022-03-29T17:16:35Z",
"mfaAuthenticated": "true",
},
"sessionIssuer":
{ "accountId": "2222", "type": "Role", "userName": "asdsda" },
"webIdFederationData": {},
},
"type": "AssumedRole",
},
"p_log_type": "AWS.CloudTrail",
}
- Name: No MFA - IAM Role and External IDP
ExpectedResult: false
Mocks:
- objectName: ROLES_VIA_EXTERNAL_IDP
returnValue: True
Log:
{
"eventVersion": "1.05",
"userIdentity":
{
"accountId": "123456789012",
"arn": "arn:aws:sts::123456789012:assumed-role/SomeRole/1641313043312360000",
"principalId": "AROAXXXXXXXXXXXXXXXXX:1641313043312360000",
"sessionContext":
{
"attributes":
{
"creationDate": "2022-01-04T16:17:27Z",
"mfaAuthenticated": "false",
},
"sessionIssuer":
{
"accountId": "123456789012",
"arn": "arn:aws:iam::123456789012:role/SomeRole",
"principalId": "AROAXXXXXXXXXXXXXXXXX",
"type": "Role",
"userName": "SomeRole",
},
},
"type": "AssumedRole",
},
"eventTime": "2019-01-01T00:00:00Z",
"eventSource": "signin.amazonaws.com",
"eventName": "ConsoleLogin",
"awsRegion": "us-east-1",
"sourceIPAddress": "111.111.111.111",
"userAgent": "Mozilla",
"requestParameters": null,
"responseElements": { "ConsoleLogin": "Success" },
"additionalEventData":
{
"LoginTo": "https://console.aws.amazon.com/console/",
"MobileVersion": "No",
"MFAUsed": "No",
},
"eventID": "1",
"eventType": "AwsConsoleSignIn",
"recipientAccountId": "123456789013",
"p_row_id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"p_log_type": "AWS.CloudTrail",
}
# ------ paired body: aws_console_login_without_mfa.py ------
import logging
from panther_aws_helpers import aws_rule_context
from panther_detection_helpers.caching import check_account_age
# Set to True for environments that permit direct role assumption via external IDP
ROLES_VIA_EXTERNAL_IDP = False
# pylint: disable=R0911,R0912,R1260
def rule(event):
if event.get("eventName") != "ConsoleLogin":
return False
# Extract some nested JSON structure
additional_event_data = event.get("additionalEventData", {})
response_elements = event.get("responseElements", {})
user_identity_type = event.deep_get("userIdentity", "type", default="")
# When there is an external IdP setup and users directly assume roles
# the additionalData.MFAUsed attribute will be set to "no"
# AND the userIdentity.sessionContext.mfaAuthenticated attribute will be "false"
#
# This will create a lack of visibility into the condition where
# users are allowed to directly AssumeRole outside of the IdP and without MFA
#
# To date we have not identified data inside the log events that clearly
# delinates AssumeRole backed by an external IdP vs not backed by external IdP
if ROLES_VIA_EXTERNAL_IDP and user_identity_type == "AssumedRole":
return False
# If using AWS SSOv2 or other SAML provider return False
if (
"AWSReservedSSO" in event.deep_get("userIdentity", "arn", default=" ")
or additional_event_data.get("SamlProviderArn") is not None
):
return False
# If Account is less than 3 days old do not alert
# This functionality is not enabled by default, in order to start logging new user creations
# Enable indicator_creation_rules/new_account_logging to start logging new users
new_user_string = (
event.deep_get("userIdentity", "userName", default="<MISSING_USER_NAME>")
+ "-"
+ event.udm("actor_user")
)
is_new_user = check_account_age(new_user_string)
if isinstance(is_new_user, str):
logging.debug("check_account_age is a mocked string for unit testing")
if is_new_user == "False":
is_new_user = False
if is_new_user == "True":
is_new_user = True
if is_new_user:
return False
new_account_string = "new_account - " + str(event.get("recipientAccountId"))
is_new_account = check_account_age(new_account_string)
if isinstance(is_new_account, str):
logging.debug("check_account_age is a mocked string for unit testing")
if is_new_account == "False":
is_new_account = False
if is_new_account == "True":
is_new_account = True
if is_new_account:
return False
if response_elements.get("ConsoleLogin") == "Success":
# This logic is inverted because at times the second condition is None.
# It is not recommended to remove this 'double negative"
if (
additional_event_data.get("MFAUsed") != "Yes"
and event.deep_get("userIdentity", "sessionContext", "attributes", "mfaAuthenticated")
!= "true"
):
return True
return False
def title(event):
if event.deep_get("userIdentity", "type") == "Root":
user_string = "the root user"
else:
user = event.deep_get("userIdentity", "userName") or event.deep_get(
"userIdentity", "sessionContext", "sessionIssuer", "userName"
)
type_ = event.deep_get(
"userIdentity", "sessionContext", "sessionIssuer", "type", default="user"
).lower()
user_string = f"{type_} {user}"
account_id = event.get("recipientAccountId")
return f"AWS login detected without MFA for [{user_string}] in [{account_id}]"
def alert_context(event):
return aws_rule_context(event)