# 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 ""
        }        
    }
}