scripts/Search-IdentityNowIdentities.ps1
|
function Search-IdentityNowIdentities { <# .SYNOPSIS Search IdentityNow Identitie(s) using Elasticsearch queries. .DESCRIPTION Search IdentityNow Identitie(s) using Elasticsearch queries. .PARAMETER filter (required - JSON) filter Elasticsearch Query Filter e.g '{"query":{"query":"@access(type:ENTITLEMENT AND name:*FILE SHARE*)"},"includeNested":true}' See https://community.sailpoint.com/t5/Admin-Help/How-do-I-use-Search-in-IdentityNow/ta-p/76960 .PARAMETER searchLimit (optional - default 2500) number of results to return .EXAMPLE $queryFilter = '{"query":{"query":"@access(type:ENTITLEMENT AND name:*FILE SHARE*)"},"includeNested":true}' Search-IdentityNowIdentities -filter $queryFilter .EXAMPLE Search-IdentityNowIdentities -filter $queryFilter -searchLimit 50 Search-IdentityNowIdentities -filter $queryFilter -searchLimit 5001 .LINK http://darrenjrobinson.com/sailpoint-identitynow #> [cmdletbinding()] param( [Parameter(Mandatory = $true, ValueFromPipeline = $true)] [string]$filter, [Parameter(Mandatory = $false, ValueFromPipeline = $true)] [string]$searchLimit = 2500 ) # IdentityNow Admin User $adminUSR = [string]$IdentityNowConfiguration.AdminCredential.UserName.ToLower() $adminPWDClear = [System.Runtime.InteropServices.marshal]::PtrToStringAuto([System.Runtime.InteropServices.marshal]::SecureStringToBSTR($IdentityNowConfiguration.AdminCredential.Password)) # Generate the account hash $hashUser = Get-HashString $adminUSR.ToLower() $adminPWD = Get-HashString "$($adminPWDClear)$($hashUser)" $clientSecretv3 = [System.Runtime.InteropServices.marshal]::PtrToStringAuto([System.Runtime.InteropServices.marshal]::SecureStringToBSTR($IdentityNowConfiguration.v3.Password)) # Basic Auth $Bytesv3 = [System.Text.Encoding]::utf8.GetBytes("$($IdentityNowConfiguration.v3.UserName):$($clientSecretv3)") $encodedAuthv3 = [Convert]::ToBase64String($Bytesv3) $Headersv3 = @{Authorization = "Basic $($encodedAuthv3)" } # Get v3 oAuth Token # oAuth URI $oAuthURI = "https://$($IdentityNowConfiguration.orgName).api.identitynow.com/oauth/token" $v3Token = Invoke-RestMethod -Method Post -Uri "$($oAuthURI)?grant_type=password&username=$($adminUSR)&password=$($adminPWD)" -Headers $Headersv3 if ($v3Token.access_token) { try { $sourceObjects = @() if ($searchLimit -gt 2500) { $iterations = $searchLimit / 2500 $offset = 2500 } if ($searchLimit -gt 2500) { $limit = 2500 } else { $limit = $searchLimit } $searchURLBase = "https://$($IdentityNowConfiguration.orgName).api.identitynow.com/beta/search/identities?limit=$($limit)" $loop = 0 if ($iterations -gt 1) { # Get First $results = Invoke-RestMethod -Method Post -Uri $searchURLBase -Headers @{Authorization = "Bearer $($v3Token.access_token)"; "Content-Type" = "application/json" } -Body $filter $loop++ if ($results) { $sourceObjects += $results } # Get Rest do { if (($searchLimit - $offset) -gt 2500) { $results = Invoke-RestMethod -Method Post -Uri "$($searchURLBase)&start=$($offset)" -Headers @{Authorization = "Bearer $($v3Token.access_token)"; "Content-Type" = "application/json" } -Body $filter $loop++ $offset += $results.count if ($results) { $sourceObjects += $results } else { break } } else { $limitCount = ($searchLimit - $sourceObjects.count) $searchURL = $searchURLBase.Replace("limit=2500", "limit=$($limitCount)") $results = Invoke-RestMethod -Method Post -Uri "$($searchURL)&start=$($offset)" -Headers @{Authorization = "Bearer $($v3Token.access_token)"; "Content-Type" = "application/json" } -Body $filter if ($results) { $sourceObjects += $results } else { break } $loop++ } } until (($loop -gt $iterations)) } else { # Get full set (<2500) $results = Invoke-RestMethod -Method Post -Uri $searchURLBase -Headers @{Authorization = "Bearer $($v3Token.access_token)"; "Content-Type" = "application/json" } -Body $filter $loop++ if ($results) { $sourceObjects += $results } } return $sourceObjects } catch { Write-Error "Check your Elasticsearch Query syntax. $($_)" } } } |