M365FoundationsCISReport/source/tests/Test-ReportSecurityInTeams.ps1

function Test-ReportSecurityInTeams {
    [CmdletBinding()]
    [OutputType([CISAuditResult])]
    param (
        # Aligned
        # Parameters can be defined here if needed
    )
    begin {
        # Dot source the class script if necessary
        #. .\source\Classes\CISAuditResult.ps1
        # Initialization code, if needed
        $RecNum = "8.6.1"
        Write-Verbose "Running Test-ReportSecurityInTeams for $RecNum..."
    }
    process {
        try {
            # Test-ReportSecurityInTeams.ps1
            # 8.6.1 (L1) Ensure users can report security concerns in Teams
            # Retrieve the necessary settings for Teams and Exchange Online
            # Condition A: Ensure the 'Report a security concern' setting in the Teams admin center is set to 'On'.
            # $CsTeamsMessagingPolicy Mock Object
            <#
                $CsTeamsMessagingPolicy = [PSCustomObject]@{
                    AllowSecurityEndUserReporting           = $true
                }
            #>
            $CsTeamsMessagingPolicy = Get-CISMSTeamsOutput -Rec $RecNum
            # Condition B: Verify that 'Monitor reported messages in Microsoft Teams' is checked in the Microsoft 365 Defender portal.
            # Condition C: Ensure the 'Send reported messages to' setting in the Microsoft 365 Defender portal is set to 'My reporting mailbox only' with the correct report email addresses.
            # $ReportSubmissionPolicy Mock Object
            <#
                $ReportSubmissionPolicy = [PSCustomObject]@{
                    ReportJunkToCustomizedAddress               = $true
                    ReportNotJunkToCustomizedAddress            = $true
                    ReportPhishToCustomizedAddress              = $true
                    ReportJunkAddresses                         = @('security@example.com')
                    ReportNotJunkAddresses                      = @('security@example.com')
                    ReportPhishAddresses                        = @('security@example.com')
                    ReportChatMessageEnabled                    = $false
                    ReportChatMessageToCustomizedAddressEnabled = $false
                }
            #>
            $ReportSubmissionPolicy = Get-CISExoOutput -Rec $RecNum
            # Check if all the required settings are enabled
            $securityReportEnabled = $CsTeamsMessagingPolicy.AllowSecurityEndUserReporting -and
            $ReportSubmissionPolicy.ReportJunkToCustomizedAddress -and
            $ReportSubmissionPolicy.ReportNotJunkToCustomizedAddress -and
            $ReportSubmissionPolicy.ReportPhishToCustomizedAddress -and
            $null -ne $ReportSubmissionPolicy.ReportJunkAddresses -and
            $null -ne $ReportSubmissionPolicy.ReportNotJunkAddresses -and
            $null -ne $ReportSubmissionPolicy.ReportPhishAddresses -and
            $ReportSubmissionPolicy.ReportChatMessageToCustomizedAddressEnabled -and
            -not $ReportSubmissionPolicy.ReportChatMessageEnabled
            $detailsString = @"
The following settings are required for users to report security concerns in Teams:

MS Teams:
AllowSecurityEndUserReporting: True

EXO:
ReportJunkToCustomizedAddress: True
ReportNotJunkToCustomizedAddress: True
ReportPhishToCustomizedAddress: True
ReportJunkAddresses: <security@contoso.com>
ReportNotJunkAddresses: <security@contoso.com>
ReportPhishAddresses: <security@contoso.com>
ReportChatMessageEnabled: False
ReportChatMessageToCustomizedAddressEnabled: True
"@
            $faildetailstring = "Users cannot report security concerns in Teams due to one or more  of the found incorrect settings:`n`n" +
            "MSTeams: `nAllowSecurityEndUserReporting: $($CsTeamsMessagingPolicy.AllowSecurityEndUserReporting); `n`n" +
            "EXO: `nReportJunkToCustomizedAddress: $($ReportSubmissionPolicy.ReportJunkToCustomizedAddress); `n" +
            "ReportNotJunkToCustomizedAddress: $($ReportSubmissionPolicy.ReportNotJunkToCustomizedAddress); `n" +
            "ReportPhishToCustomizedAddress: $($ReportSubmissionPolicy.ReportPhishToCustomizedAddress); `n" +
            "ReportJunkAddresses: $($ReportSubmissionPolicy.ReportJunkAddresses -join ', '); `n" +
            "ReportNotJunkAddresses: $($ReportSubmissionPolicy.ReportNotJunkAddresses -join ', '); `n" +
            "ReportPhishAddresses: $($ReportSubmissionPolicy.ReportPhishAddresses -join ', '); `n" +
            "ReportChatMessageEnabled: $($ReportSubmissionPolicy.ReportChatMessageEnabled); `n" +
            "ReportChatMessageToCustomizedAddressEnabled: $($ReportSubmissionPolicy.ReportChatMessageToCustomizedAddressEnabled); "
            # Prepare failure reasons and details based on compliance
            $failureReasons = if (-not $securityReportEnabled) {
                $detailsString
            }
            else {
                "N/A"
            }
            $details = if ($securityReportEnabled) {
                "Users can report security concerns in Teams."
            }
            else {
                $faildetailstring
            }
            # Create and populate the CISAuditResult object
            $params = @{
                Rec           = $RecNum
                Result        = $securityReportEnabled
                Status        = if ($securityReportEnabled) { "Pass" } else { "Fail" }
                Details       = $details
                FailureReason = $failureReasons
            }
            $auditResult = Initialize-CISAuditResult @params
        }
        catch {
            $LastError = $_
            $auditResult = Get-TestError -LastError $LastError -RecNum $RecNum
        }
    }
    end {
        # Return the audit result
        return $auditResult
    }
}