Skip to content

xploitnik/ACEVision

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

331 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ACEVision

Active Directory control relationship auditing and ACL visibility framework.

ACEVision reveals the exact ACE granting control in Active Directory and explains what that control means.

Instead of only displaying attack paths, ACEVision parses live LDAP security descriptors to identify:

  • Principal Identity
  • Principal Object Type
  • Principal Distinguished Name (DN)
  • Object Type
  • Trigger Right
  • Effective Permissions
  • Recommended DACL Modifications
  • Recommended Abuse Paths
  • Potential Outcomes
  • Suggested Attack Flows

ACEVision supports SID-centric Active Directory analysis by allowing operators to investigate control relationships without first compromising every account in the attack chain.


Example Output

Principal Object Detection

ACEVision enriches SID-based findings through LDAP resolution, allowing operators to immediately identify the controlling object and its object type.


ACEVision Advisor

ACEVision Advisor transforms raw ACL data into actionable Active Directory context.

Given an ACE, ACEVision can:

  • Detect the target object type
  • Identify the escalation-triggering permission
  • Recommend the next DACL modification
  • Recommend an abuse path
  • Estimate impact and confidence
  • Explain the expected attack flow

Advisor Workflow

Principal Object Detection

Rather than reducing privilege escalation to graph edges and attack paths, ACEVision helps operators, defenders, and students understand why a relationship exists by exposing the underlying ACEs, SIDs, ownership relationships, and effective rights that grant control over Active Directory objects.


Validation Framework

ACEVision Advisor recommendations have been validated against real Active Directory privilege escalation paths.

Currently Validated

Right Object Type Status
WriteOwner User
WriteOwner Group
GenericAll User
GenericWrite User
ForceChangePassword User
DCSync Domain
WriteDACL Domain

Validation screenshots are available under:

docs/validation/

BloodHound Comparisons

BloodHound and ACEVision serve different purposes.

BloodHound

Answers:

  • What relationship exists?
  • Which object controls another object?
  • Which attack path is possible?

ACEVision

Answers:

  • Why does this relationship matter?
  • What should happen next?
  • Which DACL modification is recommended?
  • Which abuse path is available?
  • What is the expected outcome?

BloodHound shows the relationship.

ACEVision explains the relationship.

Comparison screenshots are available under:

docs/comparisons/

Documentation

Guides

Research

Validation

Comparisons


Quick Start

Clone the repository and install the dependencies:

git clone https://github.com/xploitnik/ACEVision.git

cd ACEVision

pip install .

Example:

acevision \
    --auth ntlm \
    -u ryan \
    -p 'Password123!' \
    -d sequel.htb \
    --dc-ip 10.129.242.173 \
    --resolve-sids \
    --filter-sid S-1-5-21-...

Bulk SID Analysis

ACEVision can evaluate multiple SIDs during a single run.

acevision \
    --auth ntlm \
    -u ryan \
    -p 'Password123!' \
    -d sequel.htb \
    --dc-ip 10.129.242.173 \
    --resolve-sids \
    --sid-file users.txt

Example SID file:

backup,S-1-5-21-...-1118
svc-admin,S-1-5-21-...-1114

Features

  • Enumerate LDAP security descriptors
  • Parse DACL ACE entries
  • Resolve SIDs to identities
  • LDAP-enriched Principal Resolution
  • Principal Object Type Detection
  • Principal DN Resolution
  • Bulk SID Analysis (--sid-file)
  • Object Type Detection
  • Trigger Right Detection
  • ACEVision Advisor
  • Recommended DACL Generation
  • Abuse Path Recommendations
  • Confidence Assessment
  • Impact Assessment
  • Suggested Attack Flows
  • Effective Control Analysis
  • BloodHound Relationship Validation
  • NTLM Authentication
  • Kerberos Authentication
  • AD CS ACL Analysis

Philosophy

Modern Active Directory tooling often prioritizes attack paths.

ACEVision focuses on understanding the permissions that create those paths.

The goal is to answer questions such as:

  • Who actually controls this object?
  • Which ACE grants that control?
  • Why does BloodHound show this edge?
  • Which permission is responsible?
  • What is the next logical escalation step?

ACEVision encourages a SID-centric investigation workflow that allows operators to analyze control relationships throughout Active Directory without first compromising every account in the chain.


License

Released under the MIT License.

About

Active Directory control relationship auditing and ACL visibility framework.

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages