Empire/data/module_source/situational_awareness/network/Get-SPN.ps1

275 lines
12 KiB
PowerShell

# Author: Scott Sutherland 2013, NetSPI
# Version: Get-SPN version 1.1
# Requirements: Powershell v.3
# Comments: The technique used to query LDAP was based on the "Get-AuditDSDisabledUserAcount"
# function found in Carols Perez's PoshSec-Mod project.#
function Get-SPN
{
<#
.SYNOPSIS
Displays Service Principal Names (SPN) for domain accounts based on SPN service name, domain account, or domain group via LDAP queries.
.DESCRIPTION
Displays Service Principal Names (SPN) for domain accounts based on SPN service name, domain
account, or domain group via LDAP queries. This information can be used to identify systems
running specific service and the domain accounts running them. For example, this script
could be used to locate domain systems where SQL Server has been installed. It can also be
used to help find systems where members of the Domain Admins group might be logged in if the
accounts where used to run services on the domain (which is very common). So this should be
handy for both system administrators and penetration testers. The script currentls supports
trusted connections and provided credentials.
.EXAMPLE
Return a list of SQL Servers that have registered SPNs in LDAP on the current user's domain.
PS C:\Get-SPN -type service -search "MSSQLSvc*"
Name : sql admin
SAMAccount : sqladmin
Description : This account is used to run SQL Server services on the domain.
UserPrincipal : sqladmin@demo.com
DN : CN=sql admin,CN=Users,DC=demo,DC=com
Created : 9/3/2010 9:42:08 PM
LastModified : 12/27/2013 6:40:35 PM
PasswordLastSet : 12/27/2013 12:40:35 PM
AccountExpires : <Never>
LastLogon : 12/27/2013 8:46:10 PM
GroupMembership : CN=Domain Admins,CN=Users,DC=demo,DC=com CN=Remote Desktop Users,CN=Builtin,DC=demo,DC=com
SPN Count : 1
ServicePrincipalNames (SPN):
MSSQLSvc/DB1.demo.com:1433
.EXAMPLE
Return a list of SQL Servers that have registered SPNs in LDAP on the current user's domain in list view. This output can be piped.
PS C:\Get-SPN -type service -search "MSSQLSvc*" -List yes | Format-Table -AutoSize
Account Server Service
------- ------ -------
sqladmin DB1.demo.com MSSQLSvc
.EXAMPLE
Using supplied credentials return a list of SQL Servers that have registered SPNs in LDAP for the default domain of a remote domain controller.
PS C:\Get-SPN -type service -search "MSSQLSvc*" -List yes -DomainController 192.168.1.100 -Credential domain\user | Format-Table -AutoSize
Account Server Service
------- ------ -------
sqladmin DB1.demo.com MSSQLSvc
.EXAMPLE
Using supplied credentials return a list of SQL Servers that have registered SPNs in LDAP for the default domain of a remote domain controller, but select one column.
PS C:\Get-SPN -type service -search "MSSQLSvc*" -List yes -DomainController 192.168.1.100 -Credential domain\user | Select Server | Format-Table -AutoSize
Account
-------
sqladmin
.EXAMPLE
Using supplied credentials to authenticate to a remote domain controller query LDAP to return a list of servers where the supplied user is registered to run services.
PS C:\Get-SPN -type user -search "*sql*" -List yes -DomainController 192.168.1.100 -Credential domain\user -list yes | Format-Table -AutoSize
Account Server Service
------- ------ -------
sqladmin DB1.demo.com MSSQLSvc
.EXAMPLE
Using supplied credentials to authenticate to a remote domain controller query LDAP to return a list of servers where the supplied group members are registered to run services.
PS C:\ Get-SPN -type group -search "Domain Admins" -List yes -DomainController 192.168.1.100 -Credential domain\user
Account Server Service
------- ------ -------
Administrator DB1.demo.com MSSQLSvc
sqladmin DB1.demo.com MSSQLSvc
svc_PoolAdmin hav3.demo.com www
.LINK
http://www.netspi.com
http://msdn.microsoft.com/en-us/library/windows/desktop/ms677949(v=vs.85).aspx
http://technet.microsoft.com/en-us/library/cc731241.aspx
http://technet.microsoft.com/en-us/library/cc978021.aspx
#>
[CmdletBinding()]
Param(
[Parameter(Mandatory=$false,
HelpMessage="Credentials to use when connecting to a Domain Controller.")]
[System.Management.Automation.PSCredential]
[System.Management.Automation.Credential()]$Credential = [System.Management.Automation.PSCredential]::Empty,
[Parameter(Mandatory=$false,
HelpMessage="Domain controller for Domain and Site that you want to query against.")]
[string]$DomainController,
[Parameter(Mandatory=$false,
HelpMessage="Maximum number of Objects to pull from AD, limit is 1,000 .")]
[int]$Limit = 1000,
[Parameter(Mandatory=$false,
HelpMessage="scope of a search as either a base, one-level, or subtree search, default is subtree.")]
[ValidateSet("Subtree","OneLevel","Base")]
[string]$SearchScope = "Subtree",
[Parameter(Mandatory=$false,
HelpMessage="Distinguished Name Path to limit search to.")]
[string]$SearchDN,
[Parameter(Mandatory=$True,
HelpMessage="Search by domain user, domain group, or SPN service name to search for.")]
[string]$Type,
[Parameter(Mandatory=$True,
HelpMessage="Define search for user, group, or SPN service name. Wildcards are accepted")]
[string]$Search,
[Parameter(Mandatory=$false,
HelpMessage="View minimal information that includes the accounts,affected systems,and registered services. Nice for getting quick list of DAs.")]
[string]$List
)
Begin
{
# Setup domain user and domain controller (if provided)
if ($DomainController -and $Credential.GetNetworkCredential().Password)
{
$ObjDomain = New-Object System.DirectoryServices.DirectoryEntry "LDAP://$($DomainController)", $Credential.UserName,$Credential.GetNetworkCredential().Password
$ObjSearcher = New-Object System.DirectoryServices.DirectorySearcher $ObjDomain
}
else
{
$ObjDomain = [ADSI]""
$ObjSearcher = New-Object System.DirectoryServices.DirectorySearcher $ObjDomain
}
}
Process
{
# Setup LDAP queries
$CurrentDomain = $ObjDomain.distinguishedName
$QueryGroup = "(&(objectCategory=user)(memberOf=CN=$Search,CN=Users,$CurrentDomain))"
$QueryUser = "(samaccountname=$Search)"
$QueryService = "(ServicePrincipalName=$Search)"
# Define the search type
if(($Type -eq "group") -or ($Type -eq "user") -or ($Type -eq "service")){
# Define query based on type
switch ($Type)
{
"group" {$MyFilter = $QueryGroup}
"user" {$MyFilter = $QueryUser}
"service" {$MyFilter = $QueryService}
default {"Invalid query type."}
}
}
# Define LDAP query options
$ObjSearcher.PageSize = $Limit
$ObjSearcher.Filter = $Myfilter
$ObjSearcher.SearchScope = $SearchScope
if ($SearchDN)
{
$ObjSearcher.SearchDN = New-Object System.DirectoryServices.DirectoryEntry("LDAP://$($SearchDN)")
}
# Get a count of the number of accounts that match the LDAP query
$Records = $ObjSearcher.FindAll()
$RecordCount = $Records.count
# Display search results if results exist
if ($RecordCount -gt 0){
# Create data table to house results
$DataTable = New-Object System.Data.DataTable
# Create and name columns in the data table
$DataTable.Columns.Add("Account") | Out-Null
$DataTable.Columns.Add("Server") | Out-Null
$DataTable.Columns.Add("Service") | Out-Null
# Display account records
$ObjSearcher.FindAll() | ForEach-Object {
# Fill hash array with results
$UserProps = [ordered]@{}
$UserProps.Add('Name', "$($_.properties.name)")
$UserProps.Add('SAMAccount', "$($_.properties.samaccountname)")
$UserProps.Add('Description', "$($_.properties.description)")
$UserProps.Add('UserPrincipal', "$($_.properties.userprincipalname)")
$UserProps.Add('DN', "$($_.properties.distinguishedname)")
$UserProps.Add('Created', [dateTime]"$($_.properties.whencreated)")
$UserProps.Add('LastModified', [dateTime]"$($_.properties.whenchanged)")
$UserProps.Add('PasswordLastSet', [dateTime]::FromFileTime("$($_.properties.pwdlastset)"))
$UserProps.Add('AccountExpires',( &{$exval = "$($_.properties.accountexpires)"
If (($exval -eq 0) -or ($exval -gt [DateTime]::MaxValue.Ticks))
{
$AcctExpires = "<Never>"
$AcctExpires
}Else{
$Date = [DateTime]$exval
$AcctExpires = $Date.AddYears(1600).ToLocalTime()
$AcctExpires
}
}))
$UserProps.Add('LastLogon', [dateTime]::FromFileTime("$($_.properties.lastlogon)"))
$UserProps.Add('GroupMembership', "$($_.properties.memberof)")
$UserProps.Add('SPN Count', "$($_.properties['ServicePrincipalName'].count)")
# Only display line for detailed view
If (!$list){
# Format array as object and display records
Write-Verbose " "
[pscustomobject]$UserProps
}
# Get number of SPNs for accounts, parse them, and add them to the data table
$SPN_Count = $_.properties['ServicePrincipalName'].count
if ($SPN_Count -gt 0)
{
# Only display line for detailed view
If (!$list){
Write-Output "ServicePrincipalNames (SPN):"
$_.properties['ServicePrincipalName']
}
# Add records to data table
foreach ($item in $_.properties['ServicePrincipalName'])
{
$SpnServer = $item.split("/")[1].split(":")[0]
$SpnService = $item.split("/")[0]
$DataTable.Rows.Add($($_.properties.samaccountname), $SpnServer, $SpnService) | Out-Null
}
}
# Only display line for detailed view
If (!$list){
Write-Verbose " "
Write-Verbose "-------------------------------------------------------------"
}
}
# Only display lines for detailed view
If (!$list){
# Display number of accounts found
Write-Verbose "Found $RecordCount accounts that matched your search."
Write-Verbose "-------------------------------------------------------------"
Write-Verbose " "
}else{
# Display results in list view that can feed into the pipeline
$DataTable | Sort-Object Account,Server,Service | select account,server,service -Unique
}
}else{
# Display fail
Write-Verbose " "
Write-Verbose "No records were found that match your search."
Write-Verbose ""
}
}
}