Microsoft.Graph.Authentication

2.30.0

custom/common/Permissions.ps1

                                # ------------------------------------------------------------------------------

#  Copyright (c) Microsoft Corporation.  All Rights Reserved.  Licensed under the MIT License.  See License in the project root for license information.

# ------------------------------------------------------------------------------

Set-StrictMode -Version 2

$Permissions_msGraphApplicationId = '00000003-0000-0000-c000-000000000000'

# Entry point to the state of the Permissions 'class'

$_permissions = $null

# These '_'-prefixed functions are provided for tests to simulate the initial state of the class

# as well as providing visibility into its state for deeper validations

function _Permissions_Initialize {

    # Testing note: Pester alters runtime behavior so that variables defined at script

    # scope do not actually show up at script scope via 'script:' at runtime (!), so

    # we'll just use the Get-Variable command to explicitly obtain the variable object for it

    $permissionsVariable = Get-Variable _permissions

    # This structure models the state of the permissions class

    $permissionsVariable.Value = [PSCustomObject] @{

        msGraphPermissionsRequestUri = "https://graph.microsoft.com/v1.0/servicePrincipals?`$filter=appId eq '$Permissions_msGraphApplicationId'"

        msGraphServicePrincipal      = $null

        isFromInvokeMgGraphRequest   = $false

    }

}

function _Permissions_State {

    $_permissions

}

function Permissions_GetPermissionsData([bool] $online) {

    # Make a REST request to MS Graph to get the permissions data from the Microsoft Graph service principal

    if ( $online -or ! $_permissions.msGraphServicePrincipal -or ! $_permissions.isFromInvokeMgGraphRequest ) {

        try {

            # Get-MgContext is used to get the current context for the request to MS Graph

            # From the context, we can get the current environment and use it to get the permissions request URI

            # If the context is not available, then we will use the default permissions request URI

            $context = Get-MgContext

            $uri = $_permissions.msGraphPermissionsRequestUri

            if($context){

                $currentEnv = $context.Environment

                $allEnv = Get-MgEnvironment

                $env = $allEnv | Where-Object { $_.Name -eq $currentEnv }

                $uri = $env.GraphEndpoint + "/v1.0/servicePrincipals?`$filter=appId eq '$Permissions_msGraphApplicationId'"

            }

            $restResult = Invoke-MgGraphRequest -method GET -OutputType PSObject $uri

            if ( $restResult ) {

                $_permissions.msGraphServicePrincipal = $restResult | Select-Object -ExpandProperty value

                $_permissions.isFromInvokeMgGraphRequest = $true

            }

        }

        catch [System.Management.Automation.ValidationMetadataException], [System.Net.Http.HttpRequestException], [Microsoft.Graph.PowerShell.AuthenticationException] {

            if ( $online ) {

                throw

            }

            # We can't get the data from MS Graph, so just use a local static (possibly stale) copy

            $_permissions.msGraphServicePrincipal = Get-Content $PSScriptRoot/MSGraphServicePrincipalPermissions.json | Out-String | ConvertFrom-Json

        }

    }

    # Filter out the unwanted fields and leave only the appRoleAssignments and

    # oauth2PermissionScope objects

    $_permissions.msGraphServicePrincipal | Select-Object oauth2PermissionScopes, appRoles

}

function Permissions_GetOauthData( [PSCustomObject] $permissionsData ) {

    foreach ( $oauth2grant in $permissionsData.oauth2PermissionScopes ) {

        $description = If ($oauth2grant.type -eq 'Admin') {

            $oauth2grant.adminConsentDescription

        }

        elseif ($oauth2grant.type -eq 'User') {

            $oauth2grant.userConsentDescription

        }

        $entry = [ordered] @{

            Id             = $oauth2grant.id

            PermissionType = 'Delegated'

            Consent        = $oauth2grant.type

            Name           = $oauth2grant.value

            Description    = $description

        }

        $permissions = [PSCustomObject] $entry

        $permissions.PSTypeNames.Insert(0, 'Microsoft.Graph.Custom.Permission')

        $permissions

    }

}

function Permissions_GetAppRolesData( [PSCustomObject] $permissionsData ) {

    foreach ( $appRole in $permissionsData.appRoles ) {

        $consent = if ($appRole.origin -eq 'Application') {

            'Admin'

        }

        elseif ($appRole.origin -eq 'Delegated') {

            'User'

        }

        $entry = [ordered] @{

            Id             = $appRole.id

            PermissionType = 'Application'

            Consent        = $consent

            Name           = $appRole.value

            Description    = $appRole.description

        }

        $permissions = [PSCustomObject] $entry

        $permissions.PSTypeNames.Insert(0, 'Microsoft.Graph.Custom.Permission')

        $permissions

    }

}

_Permissions_Initialize

# SIG # Begin signature block

# MIIoOAYJKoZIhvcNAQcCoIIoKTCCKCUCAQExDzANBglghkgBZQMEAgEFADB5Bgor

# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG

# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCATJ1ZXhUe8h8Qa

# ugg9zEC0s5E7M9PCiolNrdi6RbvUNKCCDYUwggYDMIID66ADAgECAhMzAAAEA73V

# lV0POxitAAAAAAQDMA0GCSqGSIb3DQEBCwUAMH4xCzAJBgNVBAYTAlVTMRMwEQYD

# VQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNy

# b3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNpZ25p

# bmcgUENBIDIwMTEwHhcNMjQwOTEyMjAxMTEzWhcNMjUwOTExMjAxMTEzWjB0MQsw

# CQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9u

# ZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMR4wHAYDVQQDExVNaWNy

# b3NvZnQgQ29ycG9yYXRpb24wggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIB

# AQCfdGddwIOnbRYUyg03O3iz19XXZPmuhEmW/5uyEN+8mgxl+HJGeLGBR8YButGV

# LVK38RxcVcPYyFGQXcKcxgih4w4y4zJi3GvawLYHlsNExQwz+v0jgY/aejBS2EJY

# oUhLVE+UzRihV8ooxoftsmKLb2xb7BoFS6UAo3Zz4afnOdqI7FGoi7g4vx/0MIdi

# kwTn5N56TdIv3mwfkZCFmrsKpN0zR8HD8WYsvH3xKkG7u/xdqmhPPqMmnI2jOFw/

# /n2aL8W7i1Pasja8PnRXH/QaVH0M1nanL+LI9TsMb/enWfXOW65Gne5cqMN9Uofv

# ENtdwwEmJ3bZrcI9u4LZAkujAgMBAAGjggGCMIIBfjAfBgNVHSUEGDAWBgorBgEE

# AYI3TAgBBggrBgEFBQcDAzAdBgNVHQ4EFgQU6m4qAkpz4641iK2irF8eWsSBcBkw

# VAYDVR0RBE0wS6RJMEcxLTArBgNVBAsTJE1pY3Jvc29mdCBJcmVsYW5kIE9wZXJh

# dGlvbnMgTGltaXRlZDEWMBQGA1UEBRMNMjMwMDEyKzUwMjkyNjAfBgNVHSMEGDAW

# gBRIbmTlUAXTgqoXNzcitW2oynUClTBUBgNVHR8ETTBLMEmgR6BFhkNodHRwOi8v

# d3d3Lm1pY3Jvc29mdC5jb20vcGtpb3BzL2NybC9NaWNDb2RTaWdQQ0EyMDExXzIw

# MTEtMDctMDguY3JsMGEGCCsGAQUFBwEBBFUwUzBRBggrBgEFBQcwAoZFaHR0cDov

# L3d3dy5taWNyb3NvZnQuY29tL3BraW9wcy9jZXJ0cy9NaWNDb2RTaWdQQ0EyMDEx

# XzIwMTEtMDctMDguY3J0MAwGA1UdEwEB/wQCMAAwDQYJKoZIhvcNAQELBQADggIB

# AFFo/6E4LX51IqFuoKvUsi80QytGI5ASQ9zsPpBa0z78hutiJd6w154JkcIx/f7r

# EBK4NhD4DIFNfRiVdI7EacEs7OAS6QHF7Nt+eFRNOTtgHb9PExRy4EI/jnMwzQJV

# NokTxu2WgHr/fBsWs6G9AcIgvHjWNN3qRSrhsgEdqHc0bRDUf8UILAdEZOMBvKLC

# rmf+kJPEvPldgK7hFO/L9kmcVe67BnKejDKO73Sa56AJOhM7CkeATrJFxO9GLXos

# oKvrwBvynxAg18W+pagTAkJefzneuWSmniTurPCUE2JnvW7DalvONDOtG01sIVAB

# +ahO2wcUPa2Zm9AiDVBWTMz9XUoKMcvngi2oqbsDLhbK+pYrRUgRpNt0y1sxZsXO

# raGRF8lM2cWvtEkV5UL+TQM1ppv5unDHkW8JS+QnfPbB8dZVRyRmMQ4aY/tx5x5+

# sX6semJ//FbiclSMxSI+zINu1jYerdUwuCi+P6p7SmQmClhDM+6Q+btE2FtpsU0W

# +r6RdYFf/P+nK6j2otl9Nvr3tWLu+WXmz8MGM+18ynJ+lYbSmFWcAj7SYziAfT0s

# IwlQRFkyC71tsIZUhBHtxPliGUu362lIO0Lpe0DOrg8lspnEWOkHnCT5JEnWCbzu

# iVt8RX1IV07uIveNZuOBWLVCzWJjEGa+HhaEtavjy6i7MIIHejCCBWKgAwIBAgIK

# 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/Xmfwb1tbWrJUnMTDXpQzTGCGgkwghoFAgEBMIGVMH4x

# CzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRt

# b25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01p

# Y3Jvc29mdCBDb2RlIFNpZ25pbmcgUENBIDIwMTECEzMAAAQDvdWVXQ87GK0AAAAA

# BAMwDQYJYIZIAWUDBAIBBQCgga4wGQYJKoZIhvcNAQkDMQwGCisGAQQBgjcCAQQw

# HAYKKwYBBAGCNwIBCzEOMAwGCisGAQQBgjcCARUwLwYJKoZIhvcNAQkEMSIEIOAd

# 4ZCFDK0cuK9dwnK15xSLRchs7j55u8C27aRTtIX8MEIGCisGAQQBgjcCAQwxNDAy

# oBSAEgBNAGkAYwByAG8AcwBvAGYAdKEagBhodHRwOi8vd3d3Lm1pY3Jvc29mdC5j

# b20wDQYJKoZIhvcNAQEBBQAEggEACeSQdtGZHfJ9dlbWtpL8GwryjjD1njspCeur

# 1p8jTA4+RWQyrKi5iO4mRFM7sAo+kHSIfWSSs4fcvxtEbDkE7oebnPoGq8zLRfnV

# I8O/ifCJuQHa/pE+Z6zsqqHsYZ3gr3Z5sia5IpcgiZxi8B5zxISY6ST+UPNxXpr4

# ordBQelmsMIIZZiAzZZXue/6/IenZdN50SfwtsH/q15b68F+lbv/hG4R2bDYOMRS

# 4WHbvF9RW+bFmp0m0Yr8v8MlkaxiAgrvp1SBC1XKlu61wvwf5FXnRX5u9xXpedtc

# DeAHiKVVWjy3+agIeAe5lsh3k4d9HJv5QuCNOSQ7f2bpKhBb8aGCF5MwghePBgor

# BgEEAYI3AwMBMYIXfzCCF3sGCSqGSIb3DQEHAqCCF2wwghdoAgEDMQ8wDQYJYIZI

# AWUDBAIBBQAwggFRBgsqhkiG9w0BCRABBKCCAUAEggE8MIIBOAIBAQYKKwYBBAGE

# WQoDATAxMA0GCWCGSAFlAwQCAQUABCDoA8uQjuxB0GmxGrgWTP5hFvJ71v/8s5fM

# Dhq4l23yuQIGaBjD36UCGBIyMDI1MDUwOTEyMTUyOC43MVowBIACAfSggdGkgc4w

# gcsxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdS

# ZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJTAjBgNVBAsT

# HE1pY3Jvc29mdCBBbWVyaWNhIE9wZXJhdGlvbnMxJzAlBgNVBAsTHm5TaGllbGQg

# VFNTIEVTTjpGMDAyLTA1RTAtRDk0NzElMCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUt

# U3RhbXAgU2VydmljZaCCEeowggcgMIIFCKADAgECAhMzAAACBTx1bIJEh83+AAEA

# AAIFMA0GCSqGSIb3DQEBCwUAMHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNo

# aW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29y

# cG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEw

# MB4XDTI1MDEzMDE5NDI0OVoXDTI2MDQyMjE5NDI0OVowgcsxCzAJBgNVBAYTAlVT

# MRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQK

# ExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJTAjBgNVBAsTHE1pY3Jvc29mdCBBbWVy

# aWNhIE9wZXJhdGlvbnMxJzAlBgNVBAsTHm5TaGllbGQgVFNTIEVTTjpGMDAyLTA1

# RTAtRDk0NzElMCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUtU3RhbXAgU2VydmljZTCC

# AiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAJKS8t93uAXWvbAZ3LzkIVhc

# dQLzLATIPgtEu/RZgRd55nS7li4runZxdXNCZk84dM3xNaobZI+VRv7s+V3MUMMC

# VHe9TymI6OaG72sdbjczZ1uiv2OX2CW6HPBR3ZJyJUZrt/23ru0zcoUpFIxcW0co

# XcrAEHtpWj5vWrLmn0NaWjY3kUasGocwRWU3LOt4digMsv6bx9Kyoy7+JhSrHMrk

# XhLshjk16YAHwH4DdCDBUiLrgokh94plR6JYoJN/ih1SA/cBCKXGHjw/rPsBPggD

# R0wS0qFgsWzhb8o0MyxivsqlA8pUJwLkTy4Md0p7C5vLN6eRPHLh9/U3eDzKGjk+

# L0F+NHRXK2uSakN96nwk/BxvgE04hc6jWl90dnwS+dHskVkVCKqkxkWU7kIC5Ngf

# y6Nzk9QeVowAnw0Rr1MUlM5IGsHs9GB6H/o0nbG73LE+H+RU30Eayz3cwLpSOmjF

# 4zjHvRvBvCIrxI0cg7wPxyqXtVJ69RhuM3g2iAUXCEEKWGh0T/N4Y+rrLqLEPjPr

# kgdjfPAVBsFVf/D4v9Uc2f8EwazY8YeeVGM78qTw0ik3iyGQVCoDV8zTx+usNI0R

# j1UoO2mxSkAXnVjWhDq0mFYzV3ed4JeHpv/o35d4c5ELCdjzcr6kUwyGDyKxdBvo

# pGXrmSDxdgF3gnCRsqhVAgMBAAGjggFJMIIBRTAdBgNVHQ4EFgQUdHpauzbtvr7I

# ndsRn2jk10vVsvAwHwYDVR0jBBgwFoAUn6cVXQBeYl2D9OXSZacbUzUZ6XIwXwYD

# VR0fBFgwVjBUoFKgUIZOaHR0cDovL3d3dy5taWNyb3NvZnQuY29tL3BraW9wcy9j

# cmwvTWljcm9zb2Z0JTIwVGltZS1TdGFtcCUyMFBDQSUyMDIwMTAoMSkuY3JsMGwG

# CCsGAQUFBwEBBGAwXjBcBggrBgEFBQcwAoZQaHR0cDovL3d3dy5taWNyb3NvZnQu

# Y29tL3BraW9wcy9jZXJ0cy9NaWNyb3NvZnQlMjBUaW1lLVN0YW1wJTIwUENBJTIw

# MjAxMCgxKS5jcnQwDAYDVR0TAQH/BAIwADAWBgNVHSUBAf8EDDAKBggrBgEFBQcD

# CDAOBgNVHQ8BAf8EBAMCB4AwDQYJKoZIhvcNAQELBQADggIBAA67GTjtvWLvlXzV

# PHrGjXTE0ivjNnFhV+QXlMWraSd08eDNXIueyzD8cqQRlEKBlWmQoQnpjiO8bm26

# AyL5aO3uFQxKKmT5GkHmAVC+HXGYAQvZ+V6DNNYSyePTCsRKmUjlne+B/Z4ZcCv9

# FyoaNKmi4dsPYdj1jcXQ6XoVEMJX8cQYpEfOfYzmtCkUZKNpxPgOSpViZ6b8Cs59

# K9WiOcoQhb3XhTEa26ElKv2M6jlGpNfsYipu283vOFaV36LdfF2F01x+VDP1iGgW

# pB7EF6eghGAA8C3AfrzFzOv0swLeX0AsSmey87RGIo9cXiXbb859wV99qmGeX9MP

# CSIl/E7IAx9QXfEj37eLNPVZfYIWzZFo4Crd1yiHInD7FEbQTzCQIeqRXnsFtQET

# Mtfwv2UYnUOjFg2mgNfuJDMn1B2TKmLl+/vvcTcKHwD62jF4WnoWJ9BnIJzwhwgG

# UfJqToxtPphNVA2BD+HwUX5Lk6o/sIQIW8gfYq3Y/QaU670LQF9qyGdOOh2a1kVm

# ym1S+KuT/Yc4suMGIyMPAmxAAUDMm7Phm1PKiuu8RHXQaX+ZuZWIeqG80AJ9PM+I

# t+MODK+n2zv9se78JqUqZ6IlQsaOH+XACPnfX2mCCwYmpuEngVsVz6hTnN99ub+s

# qNVnyTE0PeKbXRCnjWfa3+qnI/oRMIIHcTCCBVmgAwIBAgITMwAAABXF52ueAptJ

# mQAAAAAAFTANBgkqhkiG9w0BAQsFADCBiDELMAkGA1UEBhMCVVMxEzARBgNVBAgT

# Cldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29m

# dCBDb3Jwb3JhdGlvbjEyMDAGA1UEAxMpTWljcm9zb2Z0IFJvb3QgQ2VydGlmaWNh

# dGUgQXV0aG9yaXR5IDIwMTAwHhcNMjEwOTMwMTgyMjI1WhcNMzAwOTMwMTgzMjI1

# WjB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMH

# UmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQD

# Ex1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMDCCAiIwDQYJKoZIhvcNAQEB

# BQADggIPADCCAgoCggIBAOThpkzntHIhC3miy9ckeb0O1YLT/e6cBwfSqWxOdcjK

# NVf2AX9sSuDivbk+F2Az/1xPx2b3lVNxWuJ+Slr+uDZnhUYjDLWNE893MsAQGOhg

# fWpSg0S3po5GawcU88V29YZQ3MFEyHFcUTE3oAo4bo3t1w/YJlN8OWECesSq/XJp

# rx2rrPY2vjUmZNqYO7oaezOtgFt+jBAcnVL+tuhiJdxqD89d9P6OU8/W7IVWTe/d

# vI2k45GPsjksUZzpcGkNyjYtcI4xyDUoveO0hyTD4MmPfrVUj9z6BVWYbWg7mka9

# 7aSueik3rMvrg0XnRm7KMtXAhjBcTyziYrLNueKNiOSWrAFKu75xqRdbZ2De+JKR

# Hh09/SDPc31BmkZ1zcRfNN0Sidb9pSB9fvzZnkXftnIv231fgLrbqn427DZM9itu

# qBJR6L8FA6PRc6ZNN3SUHDSCD/AQ8rdHGO2n6Jl8P0zbr17C89XYcz1DTsEzOUyO

# ArxCaC4Q6oRRRuLRvWoYWmEBc8pnol7XKHYC4jMYctenIPDC+hIK12NvDMk2ZItb

# oKaDIV1fMHSRlJTYuVD5C4lh8zYGNRiER9vcG9H9stQcxWv2XFJRXRLbJbqvUAV6

# bMURHXLvjflSxIUXk8A8FdsaN8cIFRg/eKtFtvUeh17aj54WcmnGrnu3tz5q4i6t

# AgMBAAGjggHdMIIB2TASBgkrBgEEAYI3FQEEBQIDAQABMCMGCSsGAQQBgjcVAgQW

# BBQqp1L+ZMSavoKRPEY1Kc8Q/y8E7jAdBgNVHQ4EFgQUn6cVXQBeYl2D9OXSZacb

# UzUZ6XIwXAYDVR0gBFUwUzBRBgwrBgEEAYI3TIN9AQEwQTA/BggrBgEFBQcCARYz

# aHR0cDovL3d3dy5taWNyb3NvZnQuY29tL3BraW9wcy9Eb2NzL1JlcG9zaXRvcnku

# aHRtMBMGA1UdJQQMMAoGCCsGAQUFBwMIMBkGCSsGAQQBgjcUAgQMHgoAUwB1AGIA

# QwBBMAsGA1UdDwQEAwIBhjAPBgNVHRMBAf8EBTADAQH/MB8GA1UdIwQYMBaAFNX2

# VsuP6KJcYmjRPZSQW9fOmhjEMFYGA1UdHwRPME0wS6BJoEeGRWh0dHA6Ly9jcmwu

# bWljcm9zb2Z0LmNvbS9wa2kvY3JsL3Byb2R1Y3RzL01pY1Jvb0NlckF1dF8yMDEw

# LTA2LTIzLmNybDBaBggrBgEFBQcBAQROMEwwSgYIKwYBBQUHMAKGPmh0dHA6Ly93

# d3cubWljcm9zb2Z0LmNvbS9wa2kvY2VydHMvTWljUm9vQ2VyQXV0XzIwMTAtMDYt

# MjMuY3J0MA0GCSqGSIb3DQEBCwUAA4ICAQCdVX38Kq3hLB9nATEkW+Geckv8qW/q

# XBS2Pk5HZHixBpOXPTEztTnXwnE2P9pkbHzQdTltuw8x5MKP+2zRoZQYIu7pZmc6

# U03dmLq2HnjYNi6cqYJWAAOwBb6J6Gngugnue99qb74py27YP0h1AdkY3m2CDPVt

# I1TkeFN1JFe53Z/zjj3G82jfZfakVqr3lbYoVSfQJL1AoL8ZthISEV09J+BAljis

# 9/kpicO8F7BUhUKz/AyeixmJ5/ALaoHCgRlCGVJ1ijbCHcNhcy4sa3tuPywJeBTp

# kbKpW99Jo3QMvOyRgNI95ko+ZjtPu4b6MhrZlvSP9pEB9s7GdP32THJvEKt1MMU0

# sHrYUP4KWN1APMdUbZ1jdEgssU5HLcEUBHG/ZPkkvnNtyo4JvbMBV0lUZNlz138e

# W0QBjloZkWsNn6Qo3GcZKCS6OEuabvshVGtqRRFHqfG3rsjoiV5PndLQTHa1V1QJ

# sWkBRH58oWFsc/4Ku+xBZj1p/cvBQUl+fpO+y/g75LcVv7TOPqUxUYS8vwLBgqJ7

# Fx0ViY1w/ue10CgaiQuPNtq6TPmb/wrpNPgkNWcr4A245oyZ1uEi6vAnQj0llOZ0

# dFtq0Z4+7X6gMTN9vMvpe784cETRkPHIqzqKOghif9lwY1NNje6CbaUFEMFxBmoQ

# tB1VM1izoXBm8qGCA00wggI1AgEBMIH5oYHRpIHOMIHLMQswCQYDVQQGEwJVUzET

# MBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMV

# TWljcm9zb2Z0IENvcnBvcmF0aW9uMSUwIwYDVQQLExxNaWNyb3NvZnQgQW1lcmlj

# YSBPcGVyYXRpb25zMScwJQYDVQQLEx5uU2hpZWxkIFRTUyBFU046RjAwMi0wNUUw

# LUQ5NDcxJTAjBgNVBAMTHE1pY3Jvc29mdCBUaW1lLVN0YW1wIFNlcnZpY2WiIwoB

# ATAHBgUrDgMCGgMVANWwf2nW0mf6SvAIy+o6FW9ett60oIGDMIGApH4wfDELMAkG

# A1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQx

# HjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UEAxMdTWljcm9z

# b2Z0IFRpbWUtU3RhbXAgUENBIDIwMTAwDQYJKoZIhvcNAQELBQACBQDrx99NMCIY

# DzIwMjUwNTA5MDE1NjI5WhgPMjAyNTA1MTAwMTU2MjlaMHQwOgYKKwYBBAGEWQoE

# ATEsMCowCgIFAOvH300CAQAwBwIBAAICQaswBwIBAAICEtYwCgIFAOvJMM0CAQAw

# NgYKKwYBBAGEWQoEAjEoMCYwDAYKKwYBBAGEWQoDAqAKMAgCAQACAwehIKEKMAgC

# AQACAwGGoDANBgkqhkiG9w0BAQsFAAOCAQEAhbtHFEtU1AXbLv7oHdBoRDKJYJFd

# OFJtDayIzodLa6I/UFdhCM9ebXiPS/TnTksRbcekhTLYcEb0yMEjwodG2RMOIHvk

# 4+EWd0UWB++6Fju/x+gWjpfrIRwlk2LFui2noYF/v+hccf5B0GTBtAxugBp/ti+Z

# C0UEE6aSN7QUxvzV0mOs9BBUDfu4t/9+U1mLJoXq3qsSy1b7iaHxG6QC4DueqGjr

# a32lBVzRqnKvlbUznut1NCtf5Y1tio+JooO1mdSV4yXL3NajY4Iq+FRUxDgs5bI6

# KViFj2ArSZZNX4Z3ZBEDb7hJ0C9RQ3UT0/R6HpkPK7xn+pjqBRQFahgHojGCBA0w

# ggQJAgEBMIGTMHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAw

# DgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24x

# JjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwAhMzAAACBTx1

# bIJEh83+AAEAAAIFMA0GCWCGSAFlAwQCAQUAoIIBSjAaBgkqhkiG9w0BCQMxDQYL

# KoZIhvcNAQkQAQQwLwYJKoZIhvcNAQkEMSIEIOCNFbWjsSAtHM5fKNtIoqEmjV3K

# tOPT7NpwFzpDOHr0MIH6BgsqhkiG9w0BCRACLzGB6jCB5zCB5DCBvQQggA0DPdx5

# jS6aF1YtHawmmrQ4+q0kNMBhGaMdWTARb0gwgZgwgYCkfjB8MQswCQYDVQQGEwJV

# UzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UE

# ChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQgVGlt

# ZS1TdGFtcCBQQ0EgMjAxMAITMwAAAgU8dWyCRIfN/gABAAACBTAiBCDfj63twh3g

# ek+Mf7/JtVRArfa4o/qcAJ5SMLSDqSNQ1jANBgkqhkiG9w0BAQsFAASCAgBfuyR+

# suYmqlsNzPF3xKA/kKtsg+GvUPib6M/Ye+xgNpVvEfXaGb+cAUYtQVJMNUkk2hCK

# NVlIQRJ32NHq6gEE9mOjvzg8L39TO8+veahe5t72eLkcX0upVnyATdHKGX/a42cU

# MBMroI04T/8A2d5PrJO40PyicbaHNyrrp/c+1E0x0+3Ny3oIeP2Yc6mv2alS72yU

# NJqThVNePLePEkfcCBKCmCGjpYy5kfAMzH3DfWLMNE+w2XrJ0+Tk/4mp7SqQpkUQ

# chjzizTHMrskX2+hzTY6jb5HFBrUA5fC2QNu8QRrtiM0t92GubcWTjI6nNiuaZJ3

# XmYB5aqzITRUiJgsvB9R9z4SrpmWC1hrBzx8+Hcp4XPmnE2ISdHI+lNfXXYi5BNp

# Y9IsZtrVixJwjqSLmBN4RAkidSCLpPQW3edaN00JTRI2gbf32u2i//lj70KTl4gX

# UDaS4bKXBkJLMpG5IyDUv0vELHAzShIWRE7X3EGjf+0PxGdiZPzkA3RIuBru02XE

# ex3yVFYWKzzMKRIq1QXKbwhatc2ph610kd5XD2R2biq8ppeTXHIBYbqjhZhI5Oto

# 7OddiRxur6hdpgoOhmhqT7G6fLAvb/0k608ik1idlsSp+2Doa5eNuWBYJWx6Gdbe

# OckuooiUQB7dLcNlyZA1IlV2AwaQSZhOEppwuw==

# SIG # End signature block