Get-DomainObjectAcl - Empire Module
This page contains detailed information about how to use the powershell/situational_awareness/network/powerview/get_object_acl Empire module. For list of all Empire modules, visit the Empire Module Library.
Module Overview
Name: Get-DomainObjectAcl
Module: powershell/situational_awareness/network/powerview/get_object_acl
Source code [1]: empire/server/modules/powershell/situational_awareness/network/powerview/get_object_acl.yaml
Source code [2]: empire/server/data/module_source/situational_awareness/network/powerview.ps1
MITRE ATT&CK:
T1003, S0194
Language: PowerShell
Needs admin: No
OPSEC safe: Yes
Background: Yes
The get_object_acl module returns the ACLs associated with a specific active directory object. Part of PowerView. WARNING: specify a specific object, otherwise a huge amount of data will be returned.
This module runs in a foreground and is OPSEC unsafe as it writes on the disk and therefore could be detected by AV/EDR running on the target system.
Note that the get_object_acl module does not need administrative privileges to work properly which means that a normal user can run this module.
Required Module Options
This is a list of options that are required by the get_object_acl module:
Agent
Agent to run module on.
Additional Module Options
This is a list of additional options that are supported by the get_object_acl module:
Domain
The domain to use for the query, defaults to the current domain.
Identity
A SamAccountName, DistinguishedName, SID, GUID, or a dns host name, wildcards accepted.
LDAPFilter
A customized ldap filter string to use, e.g. "(description=*admin*).
OutputFunction
PowerShell's output function to use ("Out-String", "ConvertTo-Json", "ConvertTo-Csv", "ConvertTo-Html", "ConvertTo-Xml").
Default value: Out-String.
Suggested values: Out-String, ConvertTo-Json, ConvertTo-Csv, ConvertTo-Html, ConvertTo-Xml.
ResolveGUIDs
Switch. Resolve GUIDs to their display names.
Default value: True.
ResultPageSize
Specifies the PageSize to set for the LDAP searcher object.
RightsFilter
Only return results with the associated rights, "All", "ResetPassword","ChangePassword","WriteMembers.
Sacl
Switch. Return the SACL instead of the DACL for the object (default behavior).
SearchBase
The LDAP source to search through, e.g. "LDAP://OU=secret,DC=testlab,DC=local" Useful for OU queries.
SearchScope
Specifies the scope to search under, Base/OneLevel/Subtree (default of Subtree).
Server
Active Directory server (domain controller) to reflect LDAP queries through.
ServerTimeLimit
Specifies the maximum amount of time the server spends searching. Default of 120 seconds.
Tombstone
Switch. Specifies that the search should also return deleted/tombstoned objects.
Get_object_acl Example Usage
Here's an example of how to use the get_object_acl module in the Empire client console:
[+] New agent Y4LHEV83 checked in
[*] Sending agent (stage 2) to Y4LHEV83 at 192.168.204.135
(empire usestager/windows/ducky) > usemodule powershell/situational_awareness/network/powerview/get_object_acl
Author @harmj0y
@pyrotek3
Background True
Comments https://github.com/PowerShellMafia/PowerSploit/blob/dev/Recon/
Description Returns the ACLs associated with a specific active directory object.
Part of PowerView. WARNING: specify a specific object, otherwise a
huge amount of data will be returned.
Language powershell
Name powershell/situational_awareness/network/powerview/get_object_acl
NeedsAdmin False
OpsecSafe True
Software http://attack.mitre.org/software/S0194
Techniques http://attack.mitre.org/techniques/T1003
,Record Options---,------------,----------,-------------------------------------,
| Name | Value | Required | Description |
|-----------------|------------|----------|-------------------------------------|
| Agent | | True | Agent to run module on. |
|-----------------|------------|----------|-------------------------------------|
| Domain | | False | The domain to use for the query, |
| | | | defaults to the current domain. |
|-----------------|------------|----------|-------------------------------------|
| Identity | | False | A SamAccountName, |
| | | | DistinguishedName, SID, GUID, or a |
| | | | dns host name, wildcards accepted. |
|-----------------|------------|----------|-------------------------------------|
| LDAPFilter | | False | A customized ldap filter string to |
| | | | use, e.g. "(description=*admin*)" |
|-----------------|------------|----------|-------------------------------------|
| OutputFunction | Out-String | False | PowerShell's output function to use |
| | | | ("Out-String", "ConvertTo-Json", |
| | | | "ConvertTo-Csv", "ConvertTo-Html", |
| | | | "ConvertTo-Xml"). |
|-----------------|------------|----------|-------------------------------------|
| ResolveGUIDs | True | False | Switch. Resolve GUIDs to their |
| | | | display names. |
|-----------------|------------|----------|-------------------------------------|
| ResultPageSize | | False | Specifies the PageSize to set for |
| | | | the LDAP searcher object. |
|-----------------|------------|----------|-------------------------------------|
| RightsFilter | | False | Only return results with the |
| | | | associated rights, "All", "ResetPas |
| | | | sword","ChangePassword","WriteMembe |
| | | | rs" |
|-----------------|------------|----------|-------------------------------------|
| Sacl | | False | Switch. Return the SACL instead of |
| | | | the DACL for the object (default |
| | | | behavior). |
|-----------------|------------|----------|-------------------------------------|
| SearchBase | | False | The LDAP source to search through, |
| | | | e.g. "LDAP://OU=secret,DC=testlab,D |
| | | | C=local" Useful for OU queries. |
|-----------------|------------|----------|-------------------------------------|
| SearchScope | | False | Specifies the scope to search |
| | | | under, Base/OneLevel/Subtree |
| | | | (default of Subtree) |
|-----------------|------------|----------|-------------------------------------|
| Server | | False | Active Directory server (domain |
| | | | controller) to reflect LDAP queries |
| | | | through. |
|-----------------|------------|----------|-------------------------------------|
| ServerTimeLimit | | False | Specifies the maximum amount of |
| | | | time the server spends searching. |
| | | | Default of 120 seconds. |
|-----------------|------------|----------|-------------------------------------|
| Tombstone | | False | Switch. Specifies that the search |
| | | | should also return |
| | | | deleted/tombstoned objects. |
'-----------------'------------'----------'-------------------------------------'
(Empire: usemodule/powershell/situational_awareness/network/powerview/get_object_acl) > set Agent Y4LHEV83
[*] Set Agent to Y4LHEV83
(Empire: usemodule/powershell/situational_awareness/network/powerview/get_object_acl) > execute
[*] Tasked Y4LHEV83 to run Task 1
...
Now wait for the results to come.
Authors
References
- https://github.com/BC-SECURITY/Empire/tree/master/empire/server/modules/powershell/situational_awareness/network/powerview/get_object_acl.yaml
- https://github.com/BC-SECURITY/Empire/tree/master/empire/server/data/module_source/situational_awareness/network/powerview.ps1
- https://github.com/PowerShellMafia/PowerSploit/blob/dev/Recon/
- http://attack.mitre.org/software/S0194
- http://attack.mitre.org/techniques/T1003
See Also
Check also the following modules related to this module:
- powershell/situational_awareness/network/powerview/get_loggedon
- powershell/situational_awareness/network/powerview/get_cached_rdpconnection
- powershell/situational_awareness/network/powerview/get_subnet
- powershell/situational_awareness/network/powerview/get_ou
- powershell/situational_awareness/network/powerview/get_subnet_ranges
- powershell/situational_awareness/network/powerview/get_gpo_computer
- powershell/situational_awareness/network/powerview/get_forest
- powershell/situational_awareness/network/powerview/get_domain_controller
- powershell/situational_awareness/network/powerview/get_group
- powershell/situational_awareness/network/powerview/get_session
- powershell/situational_awareness/network/powerview/get_computer
- powershell/situational_awareness/network/powerview/get_domain_policy
- powershell/situational_awareness/network/powerview/get_gpo
- powershell/situational_awareness/network/powerview/get_domain_trust
- powershell/situational_awareness/network/powerview/get_forest_domain
- powershell/situational_awareness/network/powerview/get_fileserver
- powershell/situational_awareness/network/powerview/get_site
- powershell/situational_awareness/network/powerview/get_rdp_session
- powershell/situational_awareness/network/powerview/get_localgroup
- powershell/situational_awareness/network/powerview/get_group_member
- powershell/situational_awareness/network/powerview/get_user
- powershell/situational_awareness/network/powerview/get_dfs_share
- powershell/situational_awareness/network/get_sql_server_info
- powershell/situational_awareness/network/get_kerberos_service_ticket
- powershell/situational_awareness/network/get_sql_instance_domain
- powershell/situational_awareness/network/get_spn
- powershell/situational_awareness/network/powermad/get_adidns_zone
- powershell/situational_awareness/network/powermad/get_adidns_permission
- powershell/situational_awareness/host/get_uaclevel
- powershell/situational_awareness/host/get_pathacl
- powershell/situational_awareness/network/powerview/set_ad_object
Version
This page has been created based on Empire version 4.1.3 (BC Security Fork).
Visit Empire Module Library for more modules.
