Remote API Access

# Enter your client ID here.
$ClientId = "";

# 1. Provide the ID of the Alert to execute here.
$AlertIdToExecute = 0;

# For AU
$AU = @{
    "IdsHostname" = "identity-au.perspectiveilm.com";
    "ApiHostname" = "monitor-api-au.loomesoftware.com";
};

# For US
$US = @{
    "IdsHostname" = "identity-us.perspectiveilm.com";
    "ApiHostname" = "monitor-api-us.loomesoftware.com";
}

# Change this to your selected host respectively.
$SelectedHost = $AU;

$TokenBody = @{
    "grant_type"    = "client_credentials";
    "client_id"     = $ClientId;
    "client_secret" = $ClientId;
    "scope"         = "webApi"
};

$BaseUrl = "https://$($SelectedHost['ApiHostname'])/api/v1/";

$AccessToken = ((Invoke-WebRequest -Uri "https://$($SelectedHost['IdsHostname'])/connect/token" -Method Post -Body $TokenBody).Content | ConvertFrom-Json).access_token;
$AccessHeaders = @{"Authorization" = "bearer $AccessToken" }

<#
    .SYNOPSIS
        Returns the URL for the Monitor API, based on a provided path.
    .EXAMPLE
        $Url = Get-MonitorApiUrl "rulesets/executions/12"
#>
function Get-MonitorApiUrl ([string]$Path) {
    return $BaseUrl + $Path;
}

<#
    .SYNOPSIS
        Invokes an in Monitor, returning the created execution object.
    
    .EXAMPLE
        $AlertExecution = Invoke-MonitorAlert -AlertId $AlertId;
#>
function Invoke-MonitorAlert ([int]$AlertId) {  
    $Url = Get-MonitorApiUrl "rulesets/$AlertId/execute";
    $Res = Invoke-WebRequest -Method Post -Uri $Url -Headers $AccessHeaders -ContentType "application/json"
    return ($Res.Content | ConvertFrom-Json)
}

<#
    .SYNOPSIS
        Returns the execution object from Monitor for a particular execution ID.
#>
function Get-MonitorAlertExecution ([int]$AlertExecutionId) {
    $Url = Get-MonitorApiUrl "rulesets/executions/$AlertExecutionId";
    $Res = Invoke-WebRequest -Method Get -Uri $Url -Headers $AccessHeaders -ContentType "application/json";
    return ($Res.Content | ConvertFrom-Json)
}

<#
    .SYNOPSIS
        Returns true if the provided status is a completed status.
    .EXAMPLE
        $IsComplete = Test-StatusComplete $Execution.Status;
#>
function Test-StatusComplete ([string]$Status) {
    return ($Status -eq "Success") -or ($Status -eq "Failure") -or ($Status -eq "Cancelled");
}

<#
    .SYNOPSIS
        Watches the execution of the Monitor alert execution, only finishing when
        the alert itself has finished.

    .EXAMPLE
        Watch-MonitorAlertExecution -AlertExecutionId 27;
#>
function Watch-MonitorAlertExecution (
    [int]$AlertExecutionId,
    [int]$PollSeconds = 30) {
    $Execution = $null;
    $IsRunning = $false;

    do {
        $Execution = Get-MonitorAlertExecution -AlertExecutionId $AlertExecutionId;
        $IsRunning = (Test-StatusComplete $Execution.Status) -eq $false;
        # When the Alert is still running, wait for a specified amount of seconds and try again.
        if ($IsRunning) {
            Write-Output "Alert Execution $AlertExecutionId is '$($Execution.Status)', waiting $PollSeconds seconds before checking status again...";
            Start-Sleep -Seconds $PollSeconds;
        }
    } while ($IsRunning);

    if ($Execution.Status -ne "Success") {
        # Throw the failure as an exception so it can be used in an Integrate Powershell Core task.
        throw "Alert execution $AlertExecutionId failed with status '$($Execution.Status)' (Reason: $($Execution.Message))";
    }
    else {
        Write-Output "Alert execution $AlertExecutionId completed successfully!";
    }
}

<#
    EXAMPLE RULESET EXECUTION
#>

# 1. Kick off the execution in the Monitor API
$Execution = Invoke-MonitorAlert -AlertId $AlertIdToExecute;
Write-Output "Alert has been executed with an execution ID of $AlertIdToExecute";
# 2. Call the watch method to wait on the execution until its complete.
Watch-MonitorAlertExecution -AlertExecutionId $Execution.ruleExecutionId