Carbon Black Admin Role Granted

AnalysisType: rule
RuleID: "CarbonBlack.Audit.Admin.Grant"
LogTypes:
  - CarbonBlack.Audit
Description: "Detects when a user is granted Admin or Super Admin permissions."
DisplayName: "Carbon Black Admin Role Granted"
Enabled: true
Filename: cb_audit_admin_grant.py
Severity: High
Tags:
  - Privilege Escalation
  - Account Manipulation
Reports:
  MITRE ATT&CK:
    - TA0004:T1098
Reference: https://docs.vmware.com/en/VMware-Carbon-Black-Cloud/services/carbon-black-cloud-user-guide/GUID-CF5ACD2C-A534-46C8-AE06-E1884DB37B58.html
Threshold: 1
DedupPeriodMinutes: 60
Tests:
  - Name: Super Admin granted
    ExpectedResult: true
    Log:
      {
        "clientIp": "12.34.56.78",
        "description": "Created grant: psc:cnn:A1234567:BC1234567890 with role Super Admin",
        "eventId": "66443924833011eeac3cb393f3d07f9f",
        "eventTime": "2023-11-14 20:57:19.186000000",
        "flagged": false,
        "loginName": "bob.ross@acme.com",
        "orgName": "acme.com",
        "requestUrl": "/access/v2/orgs/A1234567/grants",
        "verbose": false,
      }
  - Name: Admin granted
    ExpectedResult: true
    Log:
      {
        "clientIp": "12.34.56.78",
        "description": "Created grant: psc:cnn:A1234567:BC1234567890 with role Administrator",
        "eventId": "66443924833011eeac3cb393f3d07f9f",
        "eventTime": "2023-11-14 20:57:19.186000000",
        "flagged": false,
        "loginName": "bob.ross@acme.com",
        "orgName": "acme.com",
        "requestUrl": "/access/v2/orgs/A1234567/grants",
        "verbose": false,
      }
  - Name: Other role granted
    ExpectedResult: false
    Log:
      {
        "clientIp": "12.34.56.78",
        "description": "Created grant: psc:cnn:A1234567:BC1234567890 with role Read Only",
        "eventId": "66443924833011eeac3cb393f3d07f9f",
        "eventTime": "2023-11-14 20:57:19.186000000",
        "flagged": false,
        "loginName": "bob.ross@acme.com",
        "orgName": "acme.com",
        "requestUrl": "/access/v2/orgs/A1234567/grants",
        "verbose": false,
      }


# ------ paired body: cb_audit_admin_grant.py ------

PREFIXES = ("Updated grant: ", "Created grant: ")


def rule(event):
    desc = event.get("description", "")
    return all(
        [
            event.get("requestUrl", "").startswith("/access/"),
            any(desc.startswith(prefix) for prefix in PREFIXES),
            "Admin" in desc,
        ]
    )


def title(event):
    user = event.get("loginName", "<NO_USERNAME_FOUND>")
    ip_addr = event.get("clientIp", "<NO_IP_FOUND>")
    desc = event.get("description", "<NO_DESCRIPTION_FOUND>")
    return f"{user} [{ip_addr}] {desc}"


def severity(event):
    if "Super Admin" in event.get("description", ""):
        return "CRITICAL"
    return "HIGH"