Files
fortra-impacket/examples/GetADComputers.py
Gabriel Gonzalez ae0ec300f8 Techdebt examples bootstrapping v2 (#1928)
* Standardized examples logger init method

* Fixing missing import

* Standardized examples init_ldap_session function #1

* Calling new shared function _ldap3_kerberos_login from example addcomputer

* Removed considering -debug in each example. Now it's handled in utils.

* Standardized EMPTY_LM_HASH in impacket.examples.utils

* Unify parse_identity function (phase 1)

* Standardized parse_identity

* Renamed "_ldap3_kerberos_login" to "ldap3_kerberos_login" (as it is called from outside)

* Standardize "logger" init in regsecrets.py

* Standardized LDAP login into a single function in utils.py:ldap_login
2025-03-26 22:58:39 -03:00

238 lines
12 KiB
Python

#!/usr/bin/env python
# Impacket - Collection of Python classes for working with network protocols.
#
# Copyright Fortra, LLC and its affiliated companies
#
# All rights reserved.
#
# This software is provided under a slightly modified version
# of the Apache Software License. See the accompanying LICENSE file
# for more information.
#
# Description:
# This script is inspired from Alberto Solino's -> imacket-GetAdUsers.
# This script will make a LDAP query to DC and gather information about all the COMPUTERS present in DC.
# Also, has the capablity of resolving the IP addresses of the idenitifed hosts by making a DNS query of A record to the DC.
#
# Inspired from author:
# Alberto Solino (@agsolino)
#
# Author:
# Fowz Masood (https://www.linkedin.com/in/f-masood/)
# Please let me know of any improvements / suggestions or bugs.
#
#
# Reference for:
# LDAP
#
from __future__ import division
from __future__ import print_function
from __future__ import unicode_literals
import argparse
import logging
import sys
import dns.resolver
from datetime import datetime
from impacket import version
from impacket.dcerpc.v5.samr import UF_ACCOUNTDISABLE
from impacket.examples import logger
from impacket.examples.utils import parse_identity, ldap_login
from impacket.ldap import ldap, ldapasn1
class GetADComputers:
def __init__(self, username, password, domain, cmdLineOptions):
self.options = cmdLineOptions
self.__username = username
self.__password = password
self.__domain = domain
self.__target = None
self.__lmhash = ''
self.__nthash = ''
self.__aesKey = cmdLineOptions.aesKey
self.__doKerberos = cmdLineOptions.k
#[!] in this script the value of -dc-ip option is self.__kdcIP and the value of -dc-host option is self.__kdcHost
self.__kdcIP = cmdLineOptions.dc_ip
self.__kdcHost = cmdLineOptions.dc_host
self.__requestUser = cmdLineOptions.user
self.__resolveIP = cmdLineOptions.resolveIP
if cmdLineOptions.hashes is not None:
self.__lmhash, self.__nthash = cmdLineOptions.hashes.split(':')
# Create the baseDN
domainParts = self.__domain.split('.')
self.baseDN = ''
for i in domainParts:
self.baseDN += 'dc=%s,' % i
# Remove last ','
self.baseDN = self.baseDN[:-1]
# Let's calculate the header and format
if self.__resolveIP : #resolveIP flag is used, we will try to resolve the IP address
self.__header = ["SAM AcctName", "DNS Hostname", "OS Version", "OS", "IPAddress"]
# Since we won't process all rows at once, this will be fixed lengths
self.__colLen = [15, 35, 15, 35, 20]
self.__outputFormat = ' '.join(['{%d:%ds} ' % (num, width) for num, width in enumerate(self.__colLen)])
else:
self.__header = ["SAM AcctName", "DNS Hostname", "OS Version", "OS"]
# Since we won't process all rows at once, this will be fixed lengths
self.__colLen = [15, 35, 15, 20]
self.__outputFormat = ' '.join(['{%d:%ds} ' % (num, width) for num, width in enumerate(self.__colLen)])
@staticmethod
def getUnixTime(t):
t -= 116444736000000000
t /= 10000000
return t
def processRecord(self, item):
if isinstance(item, ldapasn1.SearchResultEntry) is not True:
return
sAMAccountName = ''
dNSHostName = ''
operatingSystem = ''
operatingSystemVersion = ''
try:
if(self.__resolveIP): #will resolve the IP address
resolvedIPAddress=''
resolveIP = dns.resolver.Resolver()
dns.resolver.default_resolver = dns.resolver.Resolver(configure=False) #Dont want to use the default DNS in /etc/resolv.conf
dns.resolver.default_resolver.nameservers = [self.__kdcIP] #converting DCIP from STRING to LIST
for attribute in item['attributes']:
if str(attribute['type']) == 'sAMAccountName':
if attribute['vals'][0].asOctets().decode('utf-8').endswith('$') is True:
# sAMAccountName
sAMAccountName = attribute['vals'][0].asOctets().decode('utf-8')
if str(attribute['type']) == 'dNSHostName':
if attribute['vals'][0].asOctets().decode('utf-8').endswith('$') is False:
# dNSHostName + IP resolve
dNSHostName = attribute['vals'][0].asOctets().decode('utf-8')
try:
answers=dns.resolver.resolve(attribute['vals'][0].asOctets().decode('utf-8'),'A',tcp=True)
for rdata in answers:
resolvedIPAddress = rdata.address
except:
resolvedIPAddress = '<unable to resolve>'
if str(attribute['type']) == 'operatingSystem':
if attribute['vals'][0].asOctets().decode('utf-8').endswith('$') is False:
# operatingSystem
operatingSystem = attribute['vals'][0].asOctets().decode('utf-8')
if str(attribute['type']) == 'operatingSystemVersion':
if attribute['vals'][0].asOctets().decode('utf-8').endswith('$') is False:
# operatingSystemVersion
operatingSystemVersion = attribute['vals'][0].asOctets().decode('utf-8')
print((self.__outputFormat.format(*[sAMAccountName, dNSHostName, operatingSystemVersion,operatingSystem,resolvedIPAddress])))
else: #won't resolve the IP address
for attribute in item['attributes']:
if str(attribute['type']) == 'sAMAccountName':
if attribute['vals'][0].asOctets().decode('utf-8').endswith('$') is True:
# sAMAccountName
sAMAccountName = attribute['vals'][0].asOctets().decode('utf-8')
if str(attribute['type']) == 'dNSHostName':
if attribute['vals'][0].asOctets().decode('utf-8').endswith('$') is False:
# dNSHostName
dNSHostName = attribute['vals'][0].asOctets().decode('utf-8')
if str(attribute['type']) == 'operatingSystem':
if attribute['vals'][0].asOctets().decode('utf-8').endswith('$') is False:
# operatingSystem
operatingSystem = attribute['vals'][0].asOctets().decode('utf-8')
if str(attribute['type']) == 'operatingSystemVersion':
if attribute['vals'][0].asOctets().decode('utf-8').endswith('$') is False:
# operatingSystemVersion
operatingSystemVersion = attribute['vals'][0].asOctets().decode('utf-8')
print((self.__outputFormat.format(*[sAMAccountName, dNSHostName, operatingSystemVersion,operatingSystem])))
except Exception as e:
logging.debug("Exception", exc_info=True)
logging.error('Skipping item, cannot process due to error %s' % str(e))
pass
def run(self):
# Connect to LDAP
ldapConnection = ldap_login(self.__target, self.baseDN, self.__kdcIP, self.__kdcHost, self.__doKerberos, self.__username, self.__password, self.__domain, self.__lmhash, self.__nthash, self.__aesKey)
# updating "self.__target" as it may have changed in the ldap_login processing
self.__target = ldapConnection._dstHost
logging.info('Querying %s for information about domain.' % self.__target)
# Print header
print((self.__outputFormat.format(*self.__header)))
print((' '.join(['-' * itemLen for itemLen in self.__colLen])))
# Building the search filter
#searchFilter = '(objectCategory=computer)'
searchFilter = '(&(objectCategory=computer)(objectClass=computer))'
try:
logging.debug('Search Filter=%s' % searchFilter)
sc = ldap.SimplePagedResultsControl(size=100)
ldapConnection.search(searchFilter=searchFilter,attributes=['sAMAccountName','dNSHostName','operatingSystem','operatingSystemVersion'],sizeLimit=0, searchControls = [sc], perRecordCallback=self.processRecord)
except ldap.LDAPSearchError:
raise
ldapConnection.close()
# Process command-line arguments.
if __name__ == '__main__':
print((version.BANNER))
parser = argparse.ArgumentParser(add_help = True, description = "Queries target domain for computer data")
parser.add_argument('target', action='store', help='domain[/username[:password]]')
parser.add_argument('-user', action='store', metavar='username', help='Requests data for specific user ')
parser.add_argument('-ts', action='store_true', help='Adds timestamp to every logging output')
parser.add_argument('-debug', action='store_true', help='Turn DEBUG output ON')
parser.add_argument('-resolveIP', action='store_true', help='Tries to resolve the IP address of computer objects, by performing the nslookup on the DC.')
group = parser.add_argument_group('authentication')
group.add_argument('-hashes', action="store", metavar = "LMHASH:NTHASH", help='NTLM hashes, format is LMHASH:NTHASH')
group.add_argument('-no-pass', action="store_true", help='don\'t ask for password (useful for -k)')
group.add_argument('-k', action="store_true", help='Use Kerberos authentication. Grabs credentials from ccache file '
'(KRB5CCNAME) based on target parameters. If valid credentials '
'cannot be found, it will use the ones specified in the command '
'line')
group.add_argument('-aesKey', action="store", metavar = "hex key", help='AES key to use for Kerberos Authentication '
'(128 or 256 bits)')
group = parser.add_argument_group('connection')
group.add_argument('-dc-ip', action='store', metavar='ip address', help='IP Address of the domain controller. If '
'ommited it use the domain part (FQDN) '
'specified in the target parameter')
group.add_argument('-dc-host', action='store', metavar='hostname', help='Hostname of the domain controller to use. '
'If ommited, the domain part (FQDN) '
'specified in the account parameter will be used')
if len(sys.argv)==1:
parser.print_help()
sys.exit(1)
options = parser.parse_args()
# Init the example's logger theme
logger.init(options.ts, options.debug)
domain, username, password, _, _, options.k = parse_identity(options.target, options.hashes, options.no_pass, options.aesKey, options.k)
if domain == '':
logging.critical('Domain should be specified!')
sys.exit(1)
try:
executer = GetADComputers(username, password, domain, options)
executer.run()
except Exception as e:
if logging.getLogger().level == logging.DEBUG:
import traceback
traceback.print_exc()
logging.error(str(e))