Panther high experimental python
AWS IAM Role Trust Relationship for GitHub Actions
This policy ensures that IAM roles used with GitHub Actions are securely configured to prevent unauthorized access to AWS resources. It validates trust relationships by checking for proper audience (aud) restrictions, ensuring it is set to sts.amazonaws.com, and subject (sub) conditions, confirming they are scoped to specific repositories or environments. Misconfigurations, such as overly permissive wildcards or missing conditions, can allow unauthorized repositories to assume roles, leading to potential data breaches or compliance violations. By enforcing these checks, the policy mitigates risks of exploitation, enhances security posture, and protects critical AWS resources from external threats.
Detection Logic
import json
from panther_base_helpers import deep_get
# Add/remove pairs as desired
ALLOWED_ORG_REPO_PAIRS = ["org/repo", "allowed-org-example/allowed-repo-example"]
def policy(resource):
# check if resource.AssumRolePolicyDocument is a string, and if so convert to json
if isinstance(resource.get("AssumeRolePolicyDocument"), str):
policy_document = json.loads(resource.get("AssumeRolePolicyDocument", {}))
else:
policy_document = resource.get("AssumeRolePolicyDocument", {})
assume_role_policy = policy_document.get("Statement", [])
for statement in assume_role_policy:
# only check for Allow sts:AssumeRoleWithWebIdentity
if (
statement.get("Effect") != "Allow"
or statement.get("Action") != "sts:AssumeRoleWithWebIdentity"
):
continue
principal = deep_get(statement, "Principal", "Federated")
audience = deep_get(
statement, "Condition", "StringEquals", "token.actions.githubusercontent.com:aud"
)
subject = deep_get(
statement,
"Condition",
"StringLike",
"token.actions.githubusercontent.com:sub",
default="",
) or deep_get(
statement,
"Condition",
"StringEquals",
"token.actions.githubusercontent.com:sub",
default="",
)
if subject.startswith("repo:"):
# repo subjects must have github as the principal and sts.amazonaws.com as the audience
if any(
[
"oidc-provider/token.actions.githubusercontent.com" not in principal,
audience != "sts.amazonaws.com",
(
"*" in subject
and not any(
subject.startswith(f"repo:{org_repo}:*")
for org_repo in ALLOWED_ORG_REPO_PAIRS
)
),
]
):
return False
else:
# non-repo subjects must not have github as the principal
if "oidc-provider/token.actions.githubusercontent.com" in principal:
return False
return True Field Validations
Loading…
Comments (0)
Loading comments...