InforcerCommunity

0.1.0

Public/Get-InforcerSupportedEventType.ps1

# Internal: returns audit event type names from the API.
# Used by Get-InforcerAuditEvent when -EventType is omitted (resolve "all types").
# Tab completion for -EventType uses the static list in Get-InforcerAuditEvent.ps1 so it always works.
# Uses global cache for API response so "all types" resolution is consistent.

if (-not $global:InforcerCachedEventTypes) {
    $global:InforcerCachedEventTypes = @(
        'alertRuleCreate', 'alertRuleDelete', 'alertRuleUpdate',
        'apiKeyCreate', 'apiKeyDelete', 'apiKeyUsage',
        'authentication',
        'clientAdminUpdated', 'clientCreated', 'clientLicenseUpdate', 'clientStatusChanged',
        'copilotAssessmentFailure', 'copilotAssessmentRun', 'copilotAssessmentSuccess',
        'failedAuthentication',
        'policiesDelete', 'policiesDeployment', 'policiesRename', 'policiesRestore',
        'reportQueued',
        'salesAdminUpdated',
        'scheduleCreate', 'scheduleDelete', 'scheduleUpdate',
        'sharedBaselinesManaged',
        'supportAccessInvoke',
        'tenantAssessmentFailure', 'tenantAssessmentRun', 'tenantAssessmentSuccess',
        'tenantDelete', 'tenantGroupCreate', 'tenantGroupMembershipsModified', 'tenantGroupUpdate', 'tenantGroupsDeployment',
        'tenantLicenseUpdate', 'tenantOnboard', 'tenantRefresh',
        'tenantUserCreate', 'tenantUserGroupMembershipModified', 'tenantUserLicensesModified',
        'tenantUserOffboardingQueued', 'tenantUserResetMfa', 'tenantUserResetPassword',
        'tenantUserRevokedSessions', 'tenantUserUpdate',
        'userAutoProvision', 'userCreate', 'userDelete',
        'userGroupCreate', 'userGroupDelete', 'userGroupMembershipModified', 'userGroupUpdate',
        'userResetMfa', 'userResetPassword', 'userToggleEnable', 'userToggleSso'
    )
}

function Get-InforcerSupportedEventType {
    <#
    .SYNOPSIS
    Returns a list of available audit event types from the Inforcer API.

    .DESCRIPTION
    Retrieves the valid event type names that can be used with Get-InforcerAuditEvent.
    This function is primarily used for tab completion of the -EventType parameter in Get-InforcerAuditEvent.
    Requires an active Inforcer session (use Connect-Inforcer to establish one).

    .OUTPUTS
    System.String
    Returns a list of audit event type names as strings.

    .EXAMPLE
    Get-InforcerSupportedEventType
    Returns all available audit event type names for use with Get-InforcerAuditEvent.

    .LINK
    https://github.com/royklo/InforcerCommunity/blob/main/docs/Get-InforcerSupportedEventType.md
    #>
    [CmdletBinding()]
    [OutputType([string])]
    param()

    if (-not (Test-InforcerSession)) {
        if ($global:InforcerCachedEventTypes -and $global:InforcerCachedEventTypes.Count -gt 0) {
            $global:InforcerCachedEventTypes | ForEach-Object { $_ }
            return
        }
        Write-Error -Message 'Not connected yet. Please run Connect-Inforcer first.' -ErrorId 'NotConnected' -Category ConnectionError
        return
    }

    try {
        $response = Invoke-InforcerApiRequest -Endpoint '/beta/auditEvents/eventTypes' -Method GET -OutputType PowerShellObject
        if ($null -eq $response) {
            if ($global:InforcerCachedEventTypes -and $global:InforcerCachedEventTypes.Count -gt 0) {
                $global:InforcerCachedEventTypes | ForEach-Object { $_ }
            }
            return
        }

        function GetEventTypeName($o) {
            if ($o -is [PSObject]) {
                $n = $o.PSObject.Properties['name'].Value
                if (-not $n) { $n = $o.PSObject.Properties['Name'].Value }
                return $n?.ToString()
            }
            return $o?.ToString()
        }

        function ResolveEventTypes($typesObj) {
            if ($null -eq $typesObj) { return @() }
            if ($typesObj -is [array]) {
                return @($typesObj | ForEach-Object { GetEventTypeName $_ } | Where-Object { -not [string]::IsNullOrWhiteSpace($_) } | ForEach-Object { $_.Trim() })
            }
            if ($typesObj -is [PSObject]) {
                foreach ($propName in 'eventTypes', 'EventTypes', 'data', 'Data', 'items', 'Items') {
                    $prop = $typesObj.PSObject.Properties[$propName].Value
                    if ($prop -is [object[]]) {
                        return @($prop | ForEach-Object { GetEventTypeName $_ } | Where-Object { -not [string]::IsNullOrWhiteSpace($_) } | ForEach-Object { $_.Trim() })
                    }
                }
            }
            return @()
        }

        $types = ResolveEventTypes $response
        if ($types -and $types.Count -gt 0) {
            $global:InforcerCachedEventTypes = @($types)
        }
        foreach ($t in $types) {
            $t
        }
    } catch {
        if ($global:InforcerCachedEventTypes -and $global:InforcerCachedEventTypes.Count -gt 0) {
            $global:InforcerCachedEventTypes | ForEach-Object { $_ }
            return
        }
        Write-Error -Message $_.Exception.Message -ErrorId 'GetAuditEventTypeFailed' -Category ConnectionError
    }
}