https://github.com/anthonyg-1/pstcpip

This PowerShell module contains functions that faciliate testing network connectivity, TLS/SSL and other network tasks
https://github.com/anthonyg-1/pstcpip

dns http httpresponse https powershell ssl tcpip tls

Last synced: 10 days ago
JSON representation

This PowerShell module contains functions that faciliate testing network connectivity, TLS/SSL and other network tasks

• Host: GitHub
• URL: https://github.com/anthonyg-1/pstcpip
• Owner: anthonyg-1
• License: mit
• Created: 2020-11-19T21:58:02.000Z (almost 4 years ago)
• Default Branch: main
• Last Pushed: 2024-09-04T16:20:26.000Z (2 months ago)
• Last Synced: 2024-09-06T21:35:31.879Z (2 months ago)
• Topics: dns, http, httpresponse, https, powershell, ssl, tcpip, tls
• Language: PowerShell
• Homepage:
• Size: 564 KB
• Stars: 25
• Watchers: 3
• Forks: 2
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# ReadMe

## PSTcpIp

This PowerShell module contains functions that provide TCP connectivity testing as well as TLS certificate retrieval, TLS endpoint security posture, DNS record enumeration, and HTTP response header assessment.

### Tested on

:desktop_computer: `Windows 10/11`

:penguin: `Linux`

:apple: `MacOS`

### Requirements

Requires PowerShell 7.4.2 or above.

### Installation

```powershell

Install-Module PSTcpIp -Repository PSGallery -Scope CurrentUser

```

### TCP connection test examples

```powershell

# Tests HTTP connectivity on the server 'myserver'

Test-TcpConnection -DNSHostName 'myserver' -Port 80

# Tests LDAP connectivity on the server 'mydomaincontroller' using the parameter alias ComputerName with a boolean return value

Test-TcpConnection -ComputerName 'mydomaincontroller' -Port 389 -Quiet

# Scans the 192.168.1.0 subnet for any nodes listening on port 80 (HTTP)

New-IPAddressList -IPV4Subnet 192.168.1.0 | Test-TcpConnection -Port 80 -ShowConnectedOnly

# Tests SSL connectivity on the server 'mywebserver' twelve times as opposed to the default four attempts

Test-TcpConnection -DNSHostName 'mywebserver' -Port 443 -Count 12

# Tests HTTP connectivity to a host with an IPV4 address of 134.170.184.133

Test-TcpConnection -IPAddress 134.170.184.133 -Port 80

# Scans 'mywebserver' for TCP ports 80 through 445, and 5000 through 6000 with a 100 millisecond timeout

@((80..445), (5000..6000)) | % { $ports += $_ }

Test-TcpConnection -ComputerName 'mywebserver' -Port $ports -Count 1 -Timeout 100

# Determine the listening TCP ports on mywebsite.org

Test-TcpConnection -HostName mywebsite.org -ShowConnectedOnly

# Test connectivity to www.mysite1.com, www.mysite2.com over ports 80 and 443 using the aliased version of Test-TcpConnection

ttc -h www.mysite1.com, www.mysite2.com -p 80, 443

```

### TLS/SSL certificate retrieval examples

```powershell

# Gets an SSL certificate from www.mysite.com over port 443 (default)

Get-TlsCertificate -HostName www.mysite.com

# Gets an SSL certificate from www.mysite.com over port 8181

Get-TlsCertificate -HostName www.mysite.com -Port 8181

# Gets an SSL certificate from www.mysite.com over port 443, selects three properties (Thumprint, Subject, NotAfter) and formats the output as a list

Get-TlsCertificate -HostName www.mysite.com -Port 443 | Select Thumbprint, Subject, NotAfter | Format-List

# Gets an SSL certificate from https://www.mysite.com, selects three properties (Thumprint, Subject, NotAfter) and formats the output as a list

Get-TlsCertificate -Uri "https://www.mysite.com" | Select Thumbprint, Subject, NotAfter | Format-List

# Gets an SSL certificate from https://www.mysite.com including the full certificate chain and writes the full chain's thumbprint, and expiration as a list to the console

Get-TlsCertificate -HostName www.mysite.com -IncludeChain | Select Subject, Thumbprint, NotAfter | Format-List

# Generate an SSL certificate expiration report from a list of target host names

$targetHostNames = "microsoft.com", "linkedin.com", "powershellgallery.com", "github.com", "kubernetes.io", "gitlab.com"

$targetHostNames | ForEach-Object {

    $targetHost = $_

    try {

        $tlsCertInfo = Get-TlsInformation -HostName $targetHost

        [PSCustomObject]@{

            HostName             = $tlsCertInfo.HostName

            Subject              = $tlsCertInfo.Subject

            Expiration           = $tlsCertInfo.ValidTo

            CertificateIsExpired = $tlsCertInfo.CertificateIsExpired

        }

    }

    catch {

        Write-Warning -Message ("Unable to retrieve SSL certificate from the following host: {0}" -f $targetHost)

    }

} | Sort Expiration

# Attempts to connect to an array of hostnames on TCP port 443 and if the target host is listening obtain the TLS certificate, select the subject and expiration, and output the results as a list.

$targets = "www.mywebsite1.com", "www.mywebsite2.com", "www.mywebsite3.com", "www.mywebsite4.com"

$targets | Test-TcpConnection -Port 443 -WhereConnected | Get-TlsCertificate | Select Subject, NotAfter | Format-List

# Gets an SSL certificate from www.mysite.com over port 443 using the aliased version of Get-TlsCertificate

gtls -h www.mysite.com

# Get full certificate chain, convert certificate objects into PEM strings, and output to a file

#requires -Module PSJsonWebToken

$targetServerName = "powershell.org"

$outputFilePath = "chain.crt"

Get-TlsCertificate -HostName $targetServerName -IncludeChain | Convert-X509CertificateToBase64 | Out-File $outputFilePath -Encoding ascii

```

### TLS/SSL information retrieval examples

```powershell

# Obtains TLS status on mysite.com against TCP port 443

Get-TlsInformation -HostName mysite.com -Port 443

# Gets TLS status on "https://www.mysite.com" 

Get-TlsInformation -Uri "https://www.mysite.com"

# Attempts to connect to an array of hostnames on TCP port 443 and if the target host is listening and obtain TLS information for the target

$targets = "www.mywebsite1.com", "www.mywebsite2.com", "www.mywebsite3.com", "www.mywebsite4.com"

$targets | Test-TcpConnection -Port 443 -WhereConnected | Get-TlsInformation

# Obtain a list of SANs (Subject Alternative Names) from ww.mysite.com.

Get-TlsInformation -HostName www.mysite.com | Select -Expand SubjectAlternativeNames

# Gets TLS security information from https://mysite.com using the aliased version of Get-TlsInformation

gtls -u "https://mysite.com/"

```

### DNS record enumeration examples

```powershell

# Enumerates DNS record data from the mydomain.org DNS domain

Invoke-DnsEnumeration -Domain mydomain.org

# Enumerates DNS record data from the mydomain.org DNS domain using the subdomains.txt text file as input

Invoke-DnsEnumeration -Domain mydomain.org -WordListPath subdomains.txt

# Enumerates DNS record data from the mydomain.org DNS domain, tests TCP connectivity, and returns only the hosts that are listening on ports 80 and 443

Invoke-DnsEnumeration -Domain mydomain.org | Test-TcpConnection -Port 80,443 -ShowConnectedOnly

# Enumerates DNS record data from the mydomain.org DNS domain, tests connectivity to TCP port 443, and obtains to obtain TLS information about the endpoint

Invoke-DnsEnumeration -Domain mydomain.org | Test-TcpConnection -Port 443 -WhereConnected | Get-TlsInformation

# Enumerates DNS record data from the mydomain.org DNS domain, tests connectivity to TCP port 443, obtains to obtain TLS information about the endpoint, and generates an export report as a CSV file

Invoke-DnsEnumeration -Domain mydomain.com | Test-TcpConnection -Port 443 -WhereConnected | Get-TlsInformation | 

    Select HostName, IPAddress, Subject, Issuer, CertificateIsExpired, ValidFrom, ValidTo | 

        Export-Csv TlsCertificateExpirationReport.csv

```

### Active Directory server security testing

```powershell

#requires -Module ActiveDirectory

# Get all Server 2019 instances from Active Directory and determine which ones are listening on port 443

Get-ADComputer -Filter {OperatingSystem -like "*2019*"} | Test-TcpConnection -Port 443 -Timeout 100 -ShowConnectedOnly

# Get an expiration report of LDAPS certificates from Active Directory domain controllers

Get-ADDomainController -Filter * | % { Test-TcpConnection -HostName $_.HostName -Port 636 -WhereConnected | Get-TlsCertificate | Select Subject, NotAfter }

```

### HTTP response header retrieval

```powershell

# Retrieves the HTTP response headers from the specified web endpoint

Get-HttpResponseHeader -Uri "https://mysite.com/"

# Retrieves the HTTP response headers with the results as a Hashtable from the specified web endpoint:

Get-HttpResponseHeader -Uri "https://mysite.com/" -AsHashtable

# Retrieves the HTTP response headers from the specified web endpoint with a hostname of example.com

Get-HttpResponseHeader -HostName "example.com"

```

### Get IP address information

```powershell

# Obtains IP address geolocation data for 13.107.213.36

#requires -Module Microsoft.PowerShell.SecretManagement

$secretName = 'whatismyip_api_key'

$key = Get-Secret -Name $secretName -AsPlainText

$targetIPAddress = "13.107.213.36"

Get-IPInformation -IPAddress $targetIPAddress -ApiKey $key

# Define default value for ApiKey param to be stored in the users profile defined in $PROFILE and obtains IP address geolocation data for 13.107.213.36

#requires -Module Microsoft.PowerShell.SecretManagement

$PSDefaultParameterValues = @{

    "Get-IPInformation:ApiKey"=(Get-Secret -Name 'whatismyip_api_key'-AsPlainText)

}

$targetIPAddress = "13.107.213.36"

Get-IPInformation -IPAddress $targetIPAddress

```

### Web Crawling

```powershell

# Starts a web crawl from "https://example.com" and traverses links up to a depth of 3

Invoke-WebCrawl -BaseUri "https://example.com" -Depth 3

# Starts a web crawl from "https://example.com", traverses links up to a depth of 3, and excludes links to "unwanted.com"

Invoke-WebCrawl -BaseUri "https://example.com" -Depth 3 -ExcludeHosts "unwanted.com"

# Starts a web crawl from "https://example.com", traverses links up to a depth of 2, and includes only links to "example.com" and "sub.example.com"

Invoke-WebCrawl -BaseUri "https://example.com" -IncludeHosts "example.com", "sub.example.com"

# Starts a web crawl from "https://example.com", traverses links up to a depth of 3, and returns results that do not have a server response header of AkamaiNetStorage

Invoke-WebCrawl -BaseUri "https://example.com" -Depth 3 | Where ResponseHeaders -NotMatch "Server=AkamaiNetStorage"

# Starts a web crawl from "https://example.com", traverses links up to a default depth of 2, and returns results that have a server response header indicating a server of nginx

Invoke-WebCrawl -BaseUri "https://example.com" | Where ResponseHeaders -Match "Server=nginx"

# Starts a web crawl from "https://example.com" and traverses links up to a depth of 3 using the webcrawl alias for Invoke-WebCrawl

webcrawl -u "https://example.com" -d 3

# Starts a web crawl from "https://example.com" and traverses links up to a depth of 3 using the iwc alias for Invoke-WebCrawl

iwc -u "https://example.com" -d 3

# Define a list of common authentication and credential keywords, crawl the target site, determine if any of the keywords exist in the content for each crawled page, and return the URI and keyword

$keywords = @(

    "access_token",

    "api_key",

    "apikey",

    "auth",

    "auth_code",

    "bearer",

    "cert",

    "certificate",

    "credential",

    "id_token",

    "jwt",

    "key",

    "login",

    "oauth",

    "password",

    "secret",

    "session",

    "sso",

    "token",

    "username"

)

$crawlResults = Invoke-WebCrawl -BaseUri "https://example.com" -IncludeContent

foreach ($word in $keywords) {

    $Keyword = @{n = "Keyword"; e = { $word } }

    $regExMatch = '\b{0}\b' -f $word

    $crawlResults | Where Content -match $regExMatch | Select Uri, $Keyword

}

```

### DNS WHOIS

```powershell

# Retrieves the WHOIS information for the domain "example.com"

if ($IsLinux) {

    Get-Whois -Domain "example.com"

}

# Retrieves WHOIS information for "example.com" and selects only the domain name and expiration date from the output

if ($IsLinux) {

    Get-Whois -Domain "example.com" | Select-Object Domain, ExpirationDate

}

```