Checks/check-CC103.ps1

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
using module "..\MCCA.psm1"

class CC103 : MCCACheck {
    <#
     
 
    #>


    CC103() {
        $this.Control = "CC-103"
        $this.ParentArea = "Insider Risk"
        $this.Area = "Communication Compliance"
        $this.Name = "Remediate Corporate Policy Violation"
        $this.PassText = "Your organization currently has no corporate policy violations"
        $this.FailRecommendation = "Your organization needs to remediate corporate policy violations"
        $this.Importance = "Your organization should use communication compliance to scan internal and external communications for policy matches so they can be examined by designated reviewers. Reviewers can investigate scanned communications and take appropriate remediation actions."
        $this.ExpandResults = $True
        $this.ItemName = "Communication Compliance Remediation"
        $this.DataType = "Items pending Review"
        $this.Links = @{
            "Communication compliance in Microsoft 365"     = "https://go.microsoft.com/fwlink/?linkid=2107258"
            "Compliance Center - Communication Compliance" = "https://compliance.microsoft.com/supervisoryreview"
            "Compliance Manager - CC Actions" = "https://compliance.microsoft.com/compliancescore?filter=%7B%22Solution%22:%5B%22Communication%20compliance%22%5D,%22Status%22:%5B%22None%22,%22NotAssessed%22,%22Passed%22,%22FailedLowRisk%22,%22FailedMediumRisk%22,%22FailedHighRisk%22,%22OutOfscope%22,%22ToBeDetermined%22,%22CouldNotBeDetermined%22,%22PartiallyTested%22,%22Select%22%5D%7D&viewid=ImprovementActions"
        }
    
    }

    <#
     
        RESULTS CC Admin, CC Analyst, CC Investigator and CC Viewer
    #>


    GetResults($Config) {         
        if (($Config["GetSupervisoryReviewOverallProgressReport"] -eq "Error") -or ($Config["GetSupervisoryReviewPolicyV2"] -eq "Error")) {
            $this.Completed = $false
        }     
        else {
            $ConfigObjectList = @() 
            $SupervisoryReviewOverallProgressReport = $Config["GetSupervisoryReviewOverallProgressReport"]
            if ( $null -eq $SupervisoryReviewOverallProgressReport) {
                $ConfigObject = [MCCACheckConfig]::new()
                $ConfigObject.ConfigItem = "Communication Compliance Policy Matches"

                $supervisory = $Config["GetSupervisoryReviewPolicyV2"]

                if ($($supervisory.count) -eq 0) {
                    $ConfigObject.ConfigData = "No communication Policy defined"
                }
                else {
                    $ConfigObject.ConfigData = "User does not have access to policy review"
                }
                $ConfigObject.SetResult([MCCAConfigLevel]::Ok, "Fail")    
                $ConfigObjectList += $ConfigObject      
                $this.AddConfig($ConfigObject)

            }
            elseif ($($SupervisoryReviewOverallProgressReport.Pending) -eq 0) {
                $ConfigObject = [MCCACheckConfig]::new()
                $ConfigObject.ConfigItem = "Communication Compliance Policy Matches"
                $ConfigObject.ConfigData = "None"
                $ConfigObject.SetResult([MCCAConfigLevel]::Ok, "Pass")  
                $ConfigObjectList += $ConfigObject
                $this.AddConfig($ConfigObject)

            }
        
            else {
                $ConfigObject = [MCCACheckConfig]::new()
                $ConfigObject.ConfigItem = "Communication Compliance Policy Matches"
                $ConfigObject.ConfigData = "$($SupervisoryReviewOverallProgressReport.Pending)"
                $ConfigObject.SetResult([MCCAConfigLevel]::Ok, "Fail")  
                $ConfigObjectList += $ConfigObject
                $this.AddConfig($ConfigObject)

            }
        
            $hasRemediation = $this.Config | Where-Object { $_.RemediationAction -ne ''}
            if ($($hasremediation.count) -gt 0)
            {
                $this.MCCARemediationInfo = New-Object -TypeName MCCARemediationInfo -Property @{
                    RemediationAvailable = $True
                    RemediationText      = "You need to connect to Security & Compliance Center PowerShell to execute the below commands. Please follow steps defined in <a href = 'https://docs.microsoft.com/en-us/powershell/exchange/connect-to-scc-powershell?view=exchange-ps'> Connect to Security & Compliance Center PowerShell</a>."
                }
            }
            $this.Completed = $True
        }
    }

}