AzSKStaging.ADO

1.12.0

Framework/Models/SVT/SVTEvent.ps1

                                Set-StrictMode -Version Latest

class SVTEvent

{

    #First level event

    #Command level event

    static [string] $CommandStarted = "AzSK.SVT.Command.Started"; #Initialize listeners #Function execution started

    static [string] $CommandCompleted = "AzSK.SVT.Command.Completed"; #Cleanup listeners #Function execution completed

    static [string] $CommandError = "AzSK.SVT.Command.Error";

    #Second level event for every resource

    static [string] $EvaluationStarted = "AzSK.SVT.Evaluation.Started"; #Individual Resource execution started

    static [string] $EvaluationCompleted = "AzSK.SVT.Evaluation.Completed"; #Individual Resource execution completed

    static [string] $EvaluationError = "AzSK.SVT.Evaluation.Error";

    #Control level events

    static [string] $ControlStarted = "AzSK.SVT.Control.Started"; #Individual control execution started

    static [string] $ControlCompleted = "AzSK.SVT.Control.Completed"; #Individual control execution completed

    static [string] $ControlError = "AzSK.SVT.Control.Error"; #Error while control execution

    static [string] $ControlDisabled = "AzSK.SVT.Control.Disabled"; #Event if control is in disabled mode

    #Resource and Control Level event

    static [string] $WriteInventory = "AzSK.SVT.WriteInventory"; #Custom event to write resource inventory

    static [string] $PostCredHygiene = "AzSK.SVT.Control.PostCredHygiene";

}

#Class for resource details 

class ResourceContext

{

    [string] $ResourceId =""

    [string] $ResourceGroupName = ""

    [string] $ResourceName = ""

    [string] $ResourceType = ""

    [hashtable] $ResourceMetadata = @{}

    [string] $ResourceTypeName = ""

    [hashtable] $ResourceGroupTags = @{}

    [PSObject] $ResourceDetails

    [psobject] $ResourceGroupDetails

}

class ControlResult

{

    [string] $ChildResourceName = "";

    [VerificationResult] $VerificationResult = [VerificationResult]::Manual;

    [VerificationResult] $ActualVerificationResult = [VerificationResult]::Manual;

    [SessionContext] $CurrentSessionContext = [SessionContext]::new();

    [AttestationStatus] $AttestationStatus = [AttestationStatus]::None;

    [StateManagement] $StateManagement = [StateManagement]::new();

    hidden [PSObject] $FixControlParameters = $null;

    [PSObject] $BackupControlState = @();

    hidden [bool] $EnableFixControl = $false;

    [bool] $IsControlInGrace;

    [DateTime] $FirstFailedOn = [Constants]::AzSKDefaultDateTime;

    [DateTime] $FirstScannedOn = [Constants]::AzSKDefaultDateTime;

    [int] $MaximumAllowedGraceDays=0;

    [String] $UserComments    

    [MessageData[]] $Messages = @();

    [int] $TimeTakenInMs    

    [DateTime] $ScanStartDateTime

    [DateTime] $ScanEndDateTime

    [String[]] $AdditionalInfo

    [bool] $IsResourceActive = $true;

    # If there is no usage history for resource or if it is Org/Project/User control then default value is set to -1.

    [int] $InactiveFromDays = -1;

    [String[]] $Exception = ""

    [string] $AdditionalInfoInCSV

    [void] LogException([System.Management.Automation.ErrorRecord] $exception)

    {

        $this.Exception = "Reason: " +$exception[0].ToString() +"`n StackTrace: "+ $exception[0].InvocationInfo.PositionMessage

    }

    [void] AddMessage([MessageData] $messageData)

    {

        if((-not [string]::IsNullOrEmpty($messageData.Message)) -or ($null -ne $messageData.DataObject))

        {

            $this.Messages += $messageData;

        }

    }

    [void] AddMessage([VerificationResult] $result, [MessageData] $messageData)

    {

        $this.VerificationResult = $result;

        $this.AddMessage($messageData);

    }

    [void] AddMessage([VerificationResult] $result, [string] $message, [PSObject] $dataObject)

    {

        $this.VerificationResult = $result;

        $this.AddMessage([MessageData]::new($message, $dataObject));

    }

    [void] AddMessage([string] $message, [PSObject] $dataObject)

    {

        $this.AddMessage([MessageData]::new($message, $dataObject));

    }

    [void] AddMessage([PSObject] $dataObject)

    {

        $this.AddMessage([MessageData]::new($dataObject));

    }

    [void] AddMessage([string] $message)

    {

        $this.AddMessage([MessageData]::new($message));

    }

    [void] AddError([System.Management.Automation.ErrorRecord] $exception)

    {

        $this.AddMessage([MessageData]::new($exception, [MessageType]::Error));

    }

    [void] SetStateData([string] $message, [PSObject] $dataObject)

    {

        # We will convert state data to b64 here itself and use it in the same format throughout the framework for comparison with attested state data read from repo.

        $stateData = $dataObject | ConvertTo-Json -Depth 10

        $encodedStateData =[Convert]::ToBase64String([System.Text.Encoding]::Unicode.GetBytes($stateData))

        $this.StateManagement.CurrentStateData = [StateData]::new($message, $encodedStateData);

    }

}

class SessionContext

{

    [UserPermissions] $Permissions = [UserPermissions]::new();

    [bool] $IsLatestPSModule

}

class UserPermissions

{

    [bool] $HasAttestationWritePermissions = $false

    [bool] $HasAttestationReadPermissions = $false

    [bool] $HasRequiredAccess = $true;

}

class StateManagement

{

    [StateData] $AttestedStateData;

    [StateData] $CurrentStateData;

}

class Metadata

{

    [string] $Reference = ""

}

class StateData: MessageDataBase

{

    [string] $Justification = "";

    [string] $AttestedBy =""

    [DateTime] $AttestedDate

    [string] $ExpiryDate =""

    [string] $ApprovedExceptionID =""

    StateData()

    {

    }

    StateData([string] $message, [PSObject] $dataObject) :

        Base($message, $dataObject)

    {

    }

}

class SVTEventContext: AzSKRootEventArgument

{

    [string] $FeatureName = ""

    [Metadata] $Metadata

    [string] $PartialScanIdentifier;

    [ResourceContext] $ResourceContext;

    [ControlItem] $ControlItem;

    [ControlResult[]] $ControlResults = @();

    [bool] IsResource()

    {

        if($this.ResourceContext)

        {

            return $true;

        }

        else

        {

            return $false;

        }

    }

    [string] GetUniqueId()

    {

        $uniqueId = "";

        if($this.IsResource())

        {

            $uniqueId = $this.ResourceContext.ResourceId;

        }

        else

        {

            $uniqueId = $this.OrganizationContext.Scope;

        }

        # Unique Id validation

        if([string]::IsNullOrWhiteSpace($uniqueId))

        {

            throw "Error while evaluating Unique Id. The parameter 'ResourceContext.ResourceId' OR 'OrganizationContext.Scope' is null or empty."

        }

        return $uniqueId;

    }

}

#Keeping here temporarily (Aug2020) to remove dependency of AzSK (Azure) PS1 files (e.g., SubscriptionCore)

#Get rid/move to another place if still needed.

class TelemetryRBAC

{

    [string] $OrganizationName="";

    [string] $Scope="";

    [string] $DisplayName="";

    [string] $MemberType="";

    [string] $ObjectId="";

    [string] $ObjectType="";

    [string] $RoleAssignmentId="";

    [string] $RoleDefinitionId="";

    [string] $RoleDefinitionName="";

    [bool] $IsPIMEnabled;

}

# SIG # Begin signature block

# MIIjlgYJKoZIhvcNAQcCoIIjhzCCI4MCAQExDzANBglghkgBZQMEAgEFADB5Bgor

# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG

# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCDAJh81K+g/31aI

# 8CAxz1j8ATuNgSU6SlJvt1mH7as6XaCCDYUwggYDMIID66ADAgECAhMzAAAB4HFz

# JMpcmPgZAAAAAAHgMA0GCSqGSIb3DQEBCwUAMH4xCzAJBgNVBAYTAlVTMRMwEQYD

# VQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNy

# b3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNpZ25p

# bmcgUENBIDIwMTEwHhcNMjAxMjE1MjEzMTQ2WhcNMjExMjAyMjEzMTQ2WjB0MQsw

# CQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9u

# ZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMR4wHAYDVQQDExVNaWNy

# b3NvZnQgQ29ycG9yYXRpb24wggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIB

# AQDRXpc9eiGRI/2BlmU7OMiQPTKpNlluodjT2rltPO/Gk47bH4gBShPMD4BX/4sg

# NvvBun6ZOG2dxUW30myWoUJJ0iRbTAv2JFzjSpVQvPE+D5vtmdu6WlOR2ahF4leF

# 5Vvk4lPg2ZFrqg5LNwT9gjwuYgmih+G2KwT8NMWusBhO649F4Ku6B6QgA+vZld5S

# G2XWIdvS0pmpmn/HFrV4eYTsl9HYgjn/bPsAlfWolLlEXYTaCljK7q7bQHDBrzlR

# ukyyryFpPOR9Wx1cxFJ6KBqg2jlJpzxjN3udNJPOqarnQIVgB8DUm3I5g2v5xTHK

# Ovz9ucN21467cYcIxjPC4UkDAgMBAAGjggGCMIIBfjAfBgNVHSUEGDAWBgorBgEE

# AYI3TAgBBggrBgEFBQcDAzAdBgNVHQ4EFgQUVBWIZHrG4UIX3uX4142l+8GsPXAw

# VAYDVR0RBE0wS6RJMEcxLTArBgNVBAsTJE1pY3Jvc29mdCBJcmVsYW5kIE9wZXJh

# dGlvbnMgTGltaXRlZDEWMBQGA1UEBRMNMjMwMDEyKzQ2MzAxMDAfBgNVHSMEGDAW

# gBRIbmTlUAXTgqoXNzcitW2oynUClTBUBgNVHR8ETTBLMEmgR6BFhkNodHRwOi8v

# d3d3Lm1pY3Jvc29mdC5jb20vcGtpb3BzL2NybC9NaWNDb2RTaWdQQ0EyMDExXzIw

# MTEtMDctMDguY3JsMGEGCCsGAQUFBwEBBFUwUzBRBggrBgEFBQcwAoZFaHR0cDov

# L3d3dy5taWNyb3NvZnQuY29tL3BraW9wcy9jZXJ0cy9NaWNDb2RTaWdQQ0EyMDEx

# XzIwMTEtMDctMDguY3J0MAwGA1UdEwEB/wQCMAAwDQYJKoZIhvcNAQELBQADggIB

# AE5msNzmYzYbNgpnhya6YsrM+CIC8CXDu10nwzZtkgQciPOOqAYmFcWJCwD5VZzs

# qFwad8XIOrfCylWf4hzn09mD87yuazpuCstLSqfDLNd3740+254vEZqdGxOglAGU

# ih2IiF8S0GDwucpLGzt/OLXPFr/d4MWxPuX0L+HB5lA3Y/CJE673dHGQW2DELdqt

# ohtkhp+oWFn1hNDDZ3LP++HEZvA7sI/o/981Sh4kaGayOp6oEiQuGeCXyfrIC9KX

# eew0UlYX/NHVDqr4ykKkqpHtzbUbuo7qovUHPbYKcRGWrrEtBS5SPLFPumqsRtzb

# LgU9HqfRAN36bMsd2qynGyWBVFOM7NMs2lTCGM85Z/Fdzv/8tnYT36Cmbue+IM+6

# kS86j6Ztmx0VIFWbOvNsASPT6yrmYiecJiP6H0TrYXQK5B3jE8s53l+t61ab0Eul

# 7DAxNWX3lAiUlzKs3qZYQEK1LFvgbdTXtBRnHgBdABALK3RPrieIYqPln9sAmg3/

# zJZi4C/c2cWGF6WwK/w1Nzw08pj7jaaZZVBpCeDe+y7oM26QIXxracot7zJ21/TL

# 70biK36YybSUDkjhQPP/uxT0yebLNBKk7g8V98Wna2MsHWwk0sgqpkjIp02TrkVz

# 26tcF2rml2THRSDrwpBa4x9c8rM8Qomiyeh2tEJnsx2LMIIHejCCBWKgAwIBAgIK

# YQ6Q0gAAAAAAAzANBgkqhkiG9w0BAQsFADCBiDELMAkGA1UEBhMCVVMxEzARBgNV

# BAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jv

# c29mdCBDb3Jwb3JhdGlvbjEyMDAGA1UEAxMpTWljcm9zb2Z0IFJvb3QgQ2VydGlm

# aWNhdGUgQXV0aG9yaXR5IDIwMTEwHhcNMTEwNzA4MjA1OTA5WhcNMjYwNzA4MjEw

# OTA5WjB+MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UE

# BxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSgwJgYD

# VQQDEx9NaWNyb3NvZnQgQ29kZSBTaWduaW5nIFBDQSAyMDExMIICIjANBgkqhkiG

# 9w0BAQEFAAOCAg8AMIICCgKCAgEAq/D6chAcLq3YbqqCEE00uvK2WCGfQhsqa+la

# UKq4BjgaBEm6f8MMHt03a8YS2AvwOMKZBrDIOdUBFDFC04kNeWSHfpRgJGyvnkmc

# 6Whe0t+bU7IKLMOv2akrrnoJr9eWWcpgGgXpZnboMlImEi/nqwhQz7NEt13YxC4D

# dato88tt8zpcoRb0RrrgOGSsbmQ1eKagYw8t00CT+OPeBw3VXHmlSSnnDb6gE3e+

# lD3v++MrWhAfTVYoonpy4BI6t0le2O3tQ5GD2Xuye4Yb2T6xjF3oiU+EGvKhL1nk

# kDstrjNYxbc+/jLTswM9sbKvkjh+0p2ALPVOVpEhNSXDOW5kf1O6nA+tGSOEy/S6

# A4aN91/w0FK/jJSHvMAhdCVfGCi2zCcoOCWYOUo2z3yxkq4cI6epZuxhH2rhKEmd

# X4jiJV3TIUs+UsS1Vz8kA/DRelsv1SPjcF0PUUZ3s/gA4bysAoJf28AVs70b1FVL

# 5zmhD+kjSbwYuER8ReTBw3J64HLnJN+/RpnF78IcV9uDjexNSTCnq47f7Fufr/zd

# sGbiwZeBe+3W7UvnSSmnEyimp31ngOaKYnhfsi+E11ecXL93KCjx7W3DKI8sj0A3

# T8HhhUSJxAlMxdSlQy90lfdu+HggWCwTXWCVmj5PM4TasIgX3p5O9JawvEagbJjS

# 4NaIjAsCAwEAAaOCAe0wggHpMBAGCSsGAQQBgjcVAQQDAgEAMB0GA1UdDgQWBBRI

# bmTlUAXTgqoXNzcitW2oynUClTAZBgkrBgEEAYI3FAIEDB4KAFMAdQBiAEMAQTAL

# BgNVHQ8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB/zAfBgNVHSMEGDAWgBRyLToCMZBD

# uRQFTuHqp8cx0SOJNDBaBgNVHR8EUzBRME+gTaBLhklodHRwOi8vY3JsLm1pY3Jv

# c29mdC5jb20vcGtpL2NybC9wcm9kdWN0cy9NaWNSb29DZXJBdXQyMDExXzIwMTFf

# MDNfMjIuY3JsMF4GCCsGAQUFBwEBBFIwUDBOBggrBgEFBQcwAoZCaHR0cDovL3d3

# dy5taWNyb3NvZnQuY29tL3BraS9jZXJ0cy9NaWNSb29DZXJBdXQyMDExXzIwMTFf

# MDNfMjIuY3J0MIGfBgNVHSAEgZcwgZQwgZEGCSsGAQQBgjcuAzCBgzA/BggrBgEF

# BQcCARYzaHR0cDovL3d3dy5taWNyb3NvZnQuY29tL3BraW9wcy9kb2NzL3ByaW1h

# cnljcHMuaHRtMEAGCCsGAQUFBwICMDQeMiAdAEwAZQBnAGEAbABfAHAAbwBsAGkA

# YwB5AF8AcwB0AGEAdABlAG0AZQBuAHQALiAdMA0GCSqGSIb3DQEBCwUAA4ICAQBn

# 8oalmOBUeRou09h0ZyKbC5YR4WOSmUKWfdJ5DJDBZV8uLD74w3LRbYP+vj/oCso7

# v0epo/Np22O/IjWll11lhJB9i0ZQVdgMknzSGksc8zxCi1LQsP1r4z4HLimb5j0b

# pdS1HXeUOeLpZMlEPXh6I/MTfaaQdION9MsmAkYqwooQu6SpBQyb7Wj6aC6VoCo/

# KmtYSWMfCWluWpiW5IP0wI/zRive/DvQvTXvbiWu5a8n7dDd8w6vmSiXmE0OPQvy

# CInWH8MyGOLwxS3OW560STkKxgrCxq2u5bLZ2xWIUUVYODJxJxp/sfQn+N4sOiBp

# mLJZiWhub6e3dMNABQamASooPoI/E01mC8CzTfXhj38cbxV9Rad25UAqZaPDXVJi

# hsMdYzaXht/a8/jyFqGaJ+HNpZfQ7l1jQeNbB5yHPgZ3BtEGsXUfFL5hYbXw3MYb

# BL7fQccOKO7eZS/sl/ahXJbYANahRr1Z85elCUtIEJmAH9AAKcWxm6U/RXceNcbS

# oqKfenoi+kiVH6v7RyOA9Z74v2u3S5fi63V4GuzqN5l5GEv/1rMjaHXmr/r8i+sL

# gOppO6/8MO0ETI7f33VtY5E90Z1WTk+/gFcioXgRMiF670EKsT/7qMykXcGhiJtX

# cVZOSEXAQsmbdlsKgEhr/Xmfwb1tbWrJUnMTDXpQzTGCFWcwghVjAgEBMIGVMH4x

# CzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRt

# b25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01p

# Y3Jvc29mdCBDb2RlIFNpZ25pbmcgUENBIDIwMTECEzMAAAHgcXMkylyY+BkAAAAA

# AeAwDQYJYIZIAWUDBAIBBQCggbAwGQYJKoZIhvcNAQkDMQwGCisGAQQBgjcCAQQw

# HAYKKwYBBAGCNwIBCzEOMAwGCisGAQQBgjcCARUwLwYJKoZIhvcNAQkEMSIEIGnY

# K4ViJsPeFh+KqQUDwn8MO1n9sgAHBpkxnc2MR1liMEQGCisGAQQBgjcCAQwxNjA0

# oBSAEgBNAGkAYwByAG8AcwBvAGYAdKEcgBpodHRwczovL3d3dy5taWNyb3NvZnQu

# Y29tIDANBgkqhkiG9w0BAQEFAASCAQBsna/dU+VHOXBOCaFPvFxYcTZKceEtboQW

# dzloX748v3VcRVzLIumWrqxRwb/oANt3AtI8D6XXCMIWACxsTaJKVmI2TQWEmHSQ

# 8gLOvuJhTjBNM2yOUiTWtEi8NJXngiazxdAZPaprr9whixTsPb2X483mUCgbrtob

# xA4lvjueuy09kicWGwHkS30Z+OK1+KtgB44fBuwJaq2DqZwZvqVZxFZX8X6+G+dr

# UCFIw6C8rtb0gs7NTrscUzCcJWdVCvzNaNv0LTZ8dc5Qi83k5dyGtwiYpMZWIc8I

# iIC3FJjcyRxpLQGJfI4X05mqAggb/YvDkfoXcnoo4sE77/bucgw2oYIS7zCCEusG

# CisGAQQBgjcDAwExghLbMIIS1wYJKoZIhvcNAQcCoIISyDCCEsQCAQMxDzANBglg

# hkgBZQMEAgEFADCCAVMGCyqGSIb3DQEJEAEEoIIBQgSCAT4wggE6AgEBBgorBgEE

# AYRZCgMBMDEwDQYJYIZIAWUDBAIBBQAEIF0/HJ8kexS/NeJp+tsPLfBMKKtIr0Rm

# GOlnBOFUbTgzAgZhRNNSdLUYETIwMjEwOTI0MTM0NjA1LjlaMASAAgH0oIHUpIHR

# MIHOMQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMH

# UmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSkwJwYDVQQL

# EyBNaWNyb3NvZnQgT3BlcmF0aW9ucyBQdWVydG8gUmljbzEmMCQGA1UECxMdVGhh

# bGVzIFRTUyBFU046NjBCQy1FMzgzLTI2MzUxJTAjBgNVBAMTHE1pY3Jvc29mdCBU

# aW1lLVN0YW1wIFNlcnZpY2Wggg5EMIIE9TCCA92gAwIBAgITMwAAAVosuW5ENMtv

# KAAAAAABWjANBgkqhkiG9w0BAQsFADB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMK

# V2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0

# IENvcnBvcmF0aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0Eg

# MjAxMDAeFw0yMTAxMTQxOTAyMTZaFw0yMjA0MTExOTAyMTZaMIHOMQswCQYDVQQG

# EwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwG

# A1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSkwJwYDVQQLEyBNaWNyb3NvZnQg

# T3BlcmF0aW9ucyBQdWVydG8gUmljbzEmMCQGA1UECxMdVGhhbGVzIFRTUyBFU046

# NjBCQy1FMzgzLTI2MzUxJTAjBgNVBAMTHE1pY3Jvc29mdCBUaW1lLVN0YW1wIFNl

# cnZpY2UwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQCwvVwcVw2tJwiu

# 9B3/hooejcUZdZgIcxSXaJPG7N8aSfO0zNvKxHh5GQGhPim/RovVL06UN86xFslk

# qSEJMsb/1n9HCIQNZiTqsrttEzd5femb4M2K8zv60JT72ylu/aADuPmBbHpEAra8

# zPYUKEuQWBsD4fUM+ugbksR/UMHssDQULI5FaIpKQcZEvhF0iM6W2tmn750TF+yy

# 3tnq8nPj5T15k0jnx9VjcpHNubvc6OmV9IAHeI1KQc3TC5xwrROtmy9jztNHJgCb

# IraoGqL/t5Ra33dLDwAsExjvYsppSZW9rGr8I6kp4+UcxuEcRuq1Nou3rW50E6M0

# e9zhzBjlAgMBAAGjggEbMIIBFzAdBgNVHQ4EFgQUZHMlP/Ucj5J+0AaF2Tk0PMDe

# MWcwHwYDVR0jBBgwFoAU1WM6XIoxkPNDe3xGG8UzaFqFbVUwVgYDVR0fBE8wTTBL

# oEmgR4ZFaHR0cDovL2NybC5taWNyb3NvZnQuY29tL3BraS9jcmwvcHJvZHVjdHMv

# TWljVGltU3RhUENBXzIwMTAtMDctMDEuY3JsMFoGCCsGAQUFBwEBBE4wTDBKBggr

# BgEFBQcwAoY+aHR0cDovL3d3dy5taWNyb3NvZnQuY29tL3BraS9jZXJ0cy9NaWNU

# aW1TdGFQQ0FfMjAxMC0wNy0wMS5jcnQwDAYDVR0TAQH/BAIwADATBgNVHSUEDDAK

# BggrBgEFBQcDCDANBgkqhkiG9w0BAQsFAAOCAQEAAABt7HxYG1IsOIFjFfFTsZWy

# BvwiDEonIg7SGZzy/ODjDeJSXleS3ia/h2AXKMea7lmZuPStvYgZib+lYlzLT/Na

# WGdRBTO99OmPsyyIf7Uue+D3lrB7zw9EDsUOBzjNhjT7xQHVL6PM+aYFf+RPpT7u

# tblAiAUwxEohzvje62oKm9zBEz6kSjyzQCXCjw3GpSs55hj5Z82Oj9c6Kf+2vdFX

# AR0SikP4U75//AvGOm/jL5OZGCYeuyjW1VXLrgVshUjGUxxnpx57h1YPbLx+/pZv

# 1f8CG2VCiiSTtB0JsqHckng/ySwuzTbA2EaRTftvXS0bcdHlsmaLCZk/KimwSDCC

# BnEwggRZoAMCAQICCmEJgSoAAAAAAAIwDQYJKoZIhvcNAQELBQAwgYgxCzAJBgNV

# BAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4w

# HAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xMjAwBgNVBAMTKU1pY3Jvc29m

# dCBSb290IENlcnRpZmljYXRlIEF1dGhvcml0eSAyMDEwMB4XDTEwMDcwMTIxMzY1

# NVoXDTI1MDcwMTIxNDY1NVowfDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hp

# bmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jw

# b3JhdGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIwMTAw

# ggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQCpHQ28dxGKOiDs/BOX9fp/

# aZRrdFQQ1aUKAIKF++18aEssX8XD5WHCdrc+Zitb8BVTJwQxH0EbGpUdzgkTjnxh

# MFmxMEQP8WCIhFRDDNdNuDgIs0Ldk6zWczBXJoKjRQ3Q6vVHgc2/JGAyWGBG8lhH

# hjKEHnRhZ5FfgVSxz5NMksHEpl3RYRNuKMYa+YaAu99h/EbBJx0kZxJyGiGKr0tk

# iVBisV39dx898Fd1rL2KQk1AUdEPnAY+Z3/1ZsADlkR+79BL/W7lmsqxqPJ6Kgox

# 8NpOBpG2iAg16HgcsOmZzTznL0S6p/TcZL2kAcEgCZN4zfy8wMlEXV4WnAEFTyJN

# AgMBAAGjggHmMIIB4jAQBgkrBgEEAYI3FQEEAwIBADAdBgNVHQ4EFgQU1WM6XIox

# kPNDe3xGG8UzaFqFbVUwGQYJKwYBBAGCNxQCBAweCgBTAHUAYgBDAEEwCwYDVR0P

# BAQDAgGGMA8GA1UdEwEB/wQFMAMBAf8wHwYDVR0jBBgwFoAU1fZWy4/oolxiaNE9

# lJBb186aGMQwVgYDVR0fBE8wTTBLoEmgR4ZFaHR0cDovL2NybC5taWNyb3NvZnQu

# Y29tL3BraS9jcmwvcHJvZHVjdHMvTWljUm9vQ2VyQXV0XzIwMTAtMDYtMjMuY3Js

# MFoGCCsGAQUFBwEBBE4wTDBKBggrBgEFBQcwAoY+aHR0cDovL3d3dy5taWNyb3Nv

# ZnQuY29tL3BraS9jZXJ0cy9NaWNSb29DZXJBdXRfMjAxMC0wNi0yMy5jcnQwgaAG

# A1UdIAEB/wSBlTCBkjCBjwYJKwYBBAGCNy4DMIGBMD0GCCsGAQUFBwIBFjFodHRw

# Oi8vd3d3Lm1pY3Jvc29mdC5jb20vUEtJL2RvY3MvQ1BTL2RlZmF1bHQuaHRtMEAG

# CCsGAQUFBwICMDQeMiAdAEwAZQBnAGEAbABfAFAAbwBsAGkAYwB5AF8AUwB0AGEA

# dABlAG0AZQBuAHQALiAdMA0GCSqGSIb3DQEBCwUAA4ICAQAH5ohRDeLG4Jg/gXED

# PZ2joSFvs+umzPUxvs8F4qn++ldtGTCzwsVmyWrf9efweL3HqJ4l4/m87WtUVwgr

# UYJEEvu5U4zM9GASinbMQEBBm9xcF/9c+V4XNZgkVkt070IQyK+/f8Z/8jd9Wj8c

# 8pl5SpFSAK84Dxf1L3mBZdmptWvkx872ynoAb0swRCQiPM/tA6WWj1kpvLb9BOFw

# nzJKJ/1Vry/+tuWOM7tiX5rbV0Dp8c6ZZpCM/2pif93FSguRJuI57BlKcWOdeyFt

# w5yjojz6f32WapB4pm3S4Zz5Hfw42JT0xqUKloakvZ4argRCg7i1gJsiOCC1JeVk

# 7Pf0v35jWSUPei45V3aicaoGig+JFrphpxHLmtgOR5qAxdDNp9DvfYPw4TtxCd9d

# dJgiCGHasFAeb73x4QDf5zEHpJM692VHeOj4qEir995yfmFrb3epgcunCaw5u+zG

# y9iCtHLNHfS4hQEegPsbiSpUObJb2sgNVZl6h3M7COaYLeqN4DMuEin1wC9UJyH3

# yKxO2ii4sanblrKnQqLJzxlBTeCG+SqaoxFmMNO7dDJL32N79ZmKLxvHIa9Zta7c

# RDyXUHHXodLFVeNp3lfB0d4wwP3M5k37Db9dT+mdHhk4L7zPWAUu7w2gUDXa7wkn

# HNWzfjUeCLraNtvTX4/edIhJEqGCAtIwggI7AgEBMIH8oYHUpIHRMIHOMQswCQYD

# VQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEe

# MBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSkwJwYDVQQLEyBNaWNyb3Nv

# ZnQgT3BlcmF0aW9ucyBQdWVydG8gUmljbzEmMCQGA1UECxMdVGhhbGVzIFRTUyBF

# U046NjBCQy1FMzgzLTI2MzUxJTAjBgNVBAMTHE1pY3Jvc29mdCBUaW1lLVN0YW1w

# IFNlcnZpY2WiIwoBATAHBgUrDgMCGgMVAMyABZi9xhx1nACWIt4WhsJaZRouoIGD

# MIGApH4wfDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNV

# BAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQG

# A1UEAxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIwMTAwDQYJKoZIhvcNAQEF

# BQACBQDk9+NGMCIYDzIwMjEwOTI0MDk0MDIyWhgPMjAyMTA5MjUwOTQwMjJaMHcw

# PQYKKwYBBAGEWQoEATEvMC0wCgIFAOT340YCAQAwCgIBAAICHPICAf8wBwIBAAIC

# EPMwCgIFAOT5NMYCAQAwNgYKKwYBBAGEWQoEAjEoMCYwDAYKKwYBBAGEWQoDAqAK

# MAgCAQACAwehIKEKMAgCAQACAwGGoDANBgkqhkiG9w0BAQUFAAOBgQAQQ2XqQoRl

# UFWqsCGJsuUcUnSplbHYApdeFFXwbVgp5KF9xvwT1kmn92rIA1L5yIv4PmkTUuIH

# s/br2ntzs2EYZZrDh9hylhPQVJpzkdgMSufujBN42RODib4muf1OROAPMAHHd1CP

# 5Z0B6hl5E6sxqPi6oDtY4bsYTeKhyO8EYjGCAw0wggMJAgEBMIGTMHwxCzAJBgNV

# BAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4w

# HAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29m

# dCBUaW1lLVN0YW1wIFBDQSAyMDEwAhMzAAABWiy5bkQ0y28oAAAAAAFaMA0GCWCG

# SAFlAwQCAQUAoIIBSjAaBgkqhkiG9w0BCQMxDQYLKoZIhvcNAQkQAQQwLwYJKoZI

# hvcNAQkEMSIEIAteDajJkMYf2kSSyN9Psuu2OVRDYs5PqV1gTWIZw3I4MIH6Bgsq

# hkiG9w0BCRACLzGB6jCB5zCB5DCBvQQgk/yoJnTEsuRdMMOCGq/XJn+SLN6TNIVL

# iCJy+W2xf7AwgZgwgYCkfjB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGlu

# Z3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBv

# cmF0aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMAIT

# MwAAAVosuW5ENMtvKAAAAAABWjAiBCAyrJbsxAaxwoYeJjFyIzKzAMP/TVmSJK0v

# Dj0gDpSAvDANBgkqhkiG9w0BAQsFAASCAQAi7W1bphs+qJJH91eXlqoXEKVTHxF5

# 1ZbR9ruwk3aNauEIBi9yDT9WDZfHAHvU7NFm37i6Cq7ZiWFFy8JABihHUtpZCEN5

# 0psZxD91Fxk1oH8qg7J37flBvhDuhE1224IIykFJ3reQE68qdI9ZDxmP5i/gviYa

# l7i0BSPrKfjwJOEBmE67nlgCqD7sBzGcaGDZ6nxralSnG+lGDpCRr81JJKdcIpf2

# EcADsfFzfpSrcN702C16A9yZDl3GNOjZU0zCs7pfKm7Rfwf1n2K6KWD9pX7yexT8

# vkkbBSiAku6rLpVz+2YCFMwVBbH9652OFZZxdOuycl3yOVqVrS0qyd2a

# SIG # End signature block