Update Invoke-FingerPrintShare.ps1

Added notes.
This commit is contained in:
Scott Sutherland 2024-11-04 08:20:31 -06:00 committed by GitHub
parent 8b101683c4
commit 001c7d6781
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194

View File

@ -1,10 +1,21 @@
<#
GENERAL NOTES
Testing of these functions was limited to the versions below:
o PowerShell Version: 5.1
o LLM Version: Azure LLM API; GPT 4o & GPT 4o mini
TODO
o Add optional threading for LLM requests.
o Add ability to generate images with text + image requests.
#>
# Function for generic LLM requests # Function for generic LLM requests
# Author: Scott Sutherland (@_nullbind), NetSPI 2024 # Author: Scott Sutherland (@_nullbind), NetSPI 2024
# v.01 # v.01
function Invoke-LLMRequest { function Invoke-LLMRequest {
<# <#
.SYNOPSIS .SYNOPSIS
This function sends text or an image to a specified API endpoint using the provided API key. This function sends text or an image to a specified Azure LLM API endpoint using the provided API key.
It requires the 'apikey', 'endpoint', and 'text' parameters to be specified. It requires the 'apikey', 'endpoint', and 'text' parameters to be specified.
This was tested on GPT 4o and 4o-mini. This was tested on GPT 4o and 4o-mini.
.PARAMETER apikey .PARAMETER apikey
@ -139,8 +150,8 @@ function Invoke-LLMRequest {
function Invoke-FingerPrintShare { function Invoke-FingerPrintShare {
<# <#
.SYNOPSIS .SYNOPSIS
This function sends a share name and file list to the LLM for fingerprinting. This function sends a share name and file list to the Azure LLM API endpoint for fingerprinting.
It requires the 'apikey', 'endpoint', and 'text'. This was tested on GPT 4o and 4o-mini. It requires the 'apikey', 'endpoint', and 'text'. This was tested on GPT 4o and GPT 4o-mini.
.PARAMETER apikey .PARAMETER apikey
The API key required to access the endpoint. The API key required to access the endpoint.
.PARAMETER endpoint .PARAMETER endpoint
@ -449,6 +460,7 @@ $FileListFormatted
Invoke-LLMRequest -SimpleOutput -apikey "your_api_key" -endpoint "https://[yourapiname].openai.azure.com/openai/deployments/[yourapiname]/chat/completions?api-version=[configuredversion]" -text "What is 2+2?" Invoke-LLMRequest -SimpleOutput -apikey "your_api_key" -endpoint "https://[yourapiname].openai.azure.com/openai/deployments/[yourapiname]/chat/completions?api-version=[configuredversion]" -text "What is 2+2?"
# Simple output from text query with image upload # Simple output from text query with image upload
# Note: Image response did not appear to be supported
Invoke-LLMRequest -SimpleOutput -apikey "your_api_key" -endpoint "https://[yourapiname].openai.azure.com/openai/deployments/[yourapiname]/chat/completions?api-version=[configuredversion]" -text "What is this an image of?" -ImagePath "c:\temp\apple.png" Invoke-LLMRequest -SimpleOutput -apikey "your_api_key" -endpoint "https://[yourapiname].openai.azure.com/openai/deployments/[yourapiname]/chat/completions?api-version=[configuredversion]" -text "What is this an image of?" -ImagePath "c:\temp\apple.png"
# Full output with all response meta data # Full output with all response meta data