functions/public/Invoke-QualysTagRestCall.ps1
|
<# .Synopsis Makes a REST method call on the given relative URI for Qualys. Utilizes credentials created with New-QualysSession. .DESCRIPTION Makes a REST method call on the given relative URI for Qualys. Utilizes credentials created with New-QualysSession. .PARAMETER RelativeURI The relativeURI you wish to make a call to. Ex: asset/ip/ .PARAMETER Method Method of the REST call Ex: GET .PARAMETER XmlBody Body of the REST call as an XML string .PARAMETER Credential Optionally used for making REST calls that require Basic Authentication .EXAMPLE $Body = @{ action = 'list' echo_request = '1' } Invoke-QualysRestCall -RelativeURI asset/ip/ -Method GET -Body $Body This will return an array of all host assets (IPs) in Qualys #> function Invoke-QualysTagRestCall { [CmdletBinding(DefaultParameterSetName='Body')] param ( [Parameter(Mandatory=$true)] [String]$RelativeURI, [Parameter(Mandatory=$true)] [String]$Method, [Parameter(Mandatory=$true, ParameterSetName='XmlBody')] [String]$XmlBody, [System.Management.Automation.PSCredential]$Credential ) begin { if($null -eq $Script:Session -and $null -eq $Credential){ Write-Verbose -Message 'No Qualys session established. Please provide credentials.' New-QualysSession } } process { if ($RelativeURI.StartsWith('/')){ $RelativeURI.Substring(1) } $IVRSplat = @{ Headers = @{ 'X-Requested-With'='powershell' } Method = $Method URI = [string]::Empty } if($PSCmdlet.ParameterSetName -eq 'XmlBody'){ $IVRSplat['Body'] = $XmlBody $IVRSplat['Headers'].Add('Content-Type','application/xml') $IVRSplat['Headers'].Add('Accept','application/xml') } if($Credential){ $IVRSplat['Uri'] = "$($Script:Settings.TaggingAuthURI)$RelativeURI" $BasicAuth = ('Basic {0}' -f ([Convert]::ToBase64String([Text.Encoding]::ASCII.GetBytes(("{0}:{1}" -f $Credential.UserName,$Credential.GetNetworkCredential().Password))))) $IVRSplat['Headers'].add('Authorization',$BasicAuth) } else{ $IVRSplat['Uri'] = "$($Script:Settings.BaseURI)$RelativeURI" $IVRSplat.add('WebSession',$Script:Session) } #Retry parameters only available in Powershell 7.1+, so we use a try/catch to retry calls once to compensate for short periods where the Qualys api is unreachable try{ Invoke-RestMethod @IVRSplat $Script:APICallCount++ } catch{ Start-Sleep -Seconds 4 Invoke-RestMethod @IVRSplat $Script:APICallCount++ } } end { } } |