M365Documentation

3.5.0-alpha

Functions/Connect-M365Doc.ps1

                                Function Connect-M365Doc(){

<#

.SYNOPSIS

    Connects M365Documentation to Microsoft Graph and sets cloud-specific endpoints.

.DESCRIPTION

    Uses MSAL.PS to acquire a token for Microsoft Graph. Supports Commercial, USGov (GCC High),

    and USGovDoD.

.PARAMETER token  

    You can pass a token you have aquired seperately via Get-MsalToken. You have to make sure, that this token has all required scopes included.

.PARAMETER ClientID

    The ClientId of your App Registration. You can create the app registration in your tenant by using the New-M365DocAppRegistration command.

.PARAMETER ClientSecret

    The ClientSecret of your App Registration. You can create the app registration in your tenant by using the New-M365DocAppRegistration command.

.PARAMETER TenantId

    The TenantId of your Azure AD Tenant.

.PARAMETER NeverRefreshToken

    By default the token will be refreshed automatically if it is expired. If you set this switch, the token will never be refreshed automatically.

    You can still force a refresh by using the Force parameter.

.PARAMETER Force

    By default the function will check if a valid token is already available and will not request a new one. If you set this switch, a new token will be requested even if a valid token is already available.

.EXAMPLE Interactive

    Connect-M365Doc

    Displays authentication prompt and allows you to sign in. 

.EXAMPLE CustomToken

    Connect-M365Doc -token $token

    You can pass a token you have aquired seperately via Get-MsalToken. You have to make sure, that this token has all required scopes included.

.EXAMPLE PublicClient-Silent

    Connect-M365Doc -ClientId '00000000-0000-0000-0000-000000000000' -ClientSecret (ConvertTo-SecureString 'SuperSecretString' -AsPlainText -Force) -TenantId '00000000-0000-0000-0000-000000000000'

    Get token based on the submitted information. You can creat the app registration in your tenant by using the New-DocumentationAppRegistration command.

#>

  param(

    [CmdletBinding(DefaultParameterSetName = 'Interactive-Custom')]

    [parameter(Mandatory=$true, ParameterSetName='CustomToken')]

    [parameter(Mandatory=$false, ParameterSetName='PublicClient-Silent')]

    [ValidateSet('Commercial','USGov','USGovDoD')]

    [string] $CloudEnvironment = 'Commercial',

    [parameter(Mandatory=$true, ParameterSetName='CustomToken')]

    [Microsoft.Identity.Client.AuthenticationResult]$token,

    [parameter(Mandatory=$true, ParameterSetName='PublicClient-Silent')]

    [CmdletBinding(DefaultParameterSetName = 'Interactive-Custom')]

    [guid]$ClientID,

    [parameter(Mandatory=$true, ParameterSetName='PublicClient-Silent')]

    [Security.SecureString]$ClientSecret,

    [parameter(Mandatory=$true, ParameterSetName='PublicClient-Silent')]

    [CmdletBinding(DefaultParameterSetName = 'Interactive-Custom')]

    [guid]$TenantId,

    [parameter(Mandatory=$false, ParameterSetName='Interactive')]

    [parameter(Mandatory=$false, ParameterSetName='PublicClient-Silent')]

    [switch]$NeverRefreshToken,

    [parameter(Mandatory=$false, ParameterSetName='Interactive')]

    [switch]$Force

  )

  # ---------- Map environment to endpoints ----------

  switch ($CloudEnvironment) {

    'Commercial' { $AuthorityHost='https://login.microsoftonline.com'; $GraphBase='https://graph.microsoft.com/'; }

    'USGov'      { $AuthorityHost='https://login.microsoftonline.us';  $GraphBase='https://graph.microsoft.us/'; }

    'USGovDoD'   { $AuthorityHost='https://login.microsoftonline.us';  $GraphBase='https://dod-graph.microsoft.us/'; }

  }

  $GraphScope = ($GraphBase.TrimEnd('/') + '/.default')

  # Publish for the rest of the module (used by Invoke-DocGraph, etc.)

  $script:M365Doc_CloudEnvironment = $CloudEnvironment

  $script:M365Doc_GraphBase        = $GraphBase

  switch -Wildcard ($PSCmdlet.ParameterSetName) {

      "CustomToken" {

          # Verify token

          if ($token.ExpiresOn.LocalDateTime -le $(Get-Date)) {

              Write-Error "Token expired, please pass a valid and not expired token."

          } elseif($null -eq $token){

              Write-Error "No Token passed as token parameter, please pass a valid and not expired token."

          } else {

              $script:token = $token

          }

          Write-Verbose "Custom Token expires: $($script:token.ExpiresOn.LocalDateTime)"

          break

      }

      "PublicClient-Silent" {

          # Connect to Microsoft Intune PowerShell App

          $script:tokenRequest = @{

              ClientId = $ClientId

              RedirectUri = "msal37f82fa9-674e-4cae-9286-4b21eb9a6389://auth"

              TenantId = $TenantId

              Scopes = $GraphScope

              Authority = "$AuthorityHost/$TenantId"

              ClientSecret = $ClientSecret

              ForceRefresh = $True # We could be pulling a token from the MSAL Cache, ForceRefresh to ensure it's new and has the longest timeline.

          }

          if($NeverRefreshToken) { $script:tokenRequest.ForceRefresh = $False}

          $script:token = Get-MsalToken @script:tokenRequest

          # Verify token

          if (-not ($script:token -and $script:token.ExpiresOn.LocalDateTime -ge $(Get-Date))) {

              Write-Error "Connection failed."

          }

          Write-Verbose "PublicClient-Silent Token expires: $($script:token.ExpiresOn.LocalDateTime)"

          break

      }

      "Interactive" {

          # Connect to M365 App

          $script:tokenRequest = @{

              ClientId    = "37f82fa9-674e-4cae-9286-4b21eb9a6389"

              RedirectUri = "http://localhost"

              Scopes = $GraphScope

              ForceRefresh = $True # We could be pulling a token from the MSAL Cache, ForceRefresh to ensure it's new and has the longest timeline.

          }

          if($NeverRefreshToken) { $script:tokenRequest.ForceRefresh = $False}

          # Verify token

          if (-not ($script:token -and $script:token.ExpiresOn.LocalDateTime -ge $(Get-Date))) {

              $script:token = Get-MsalToken @script:tokenRequest

          } else {

              if($Force){

                  Write-Information "Force reconnection"

                  $script:token = Get-MsalToken @params

              } else {

                  Write-Information "Already connected."

              }

          }

          Write-Verbose "Interactive Token expires: $($script:token.ExpiresOn.LocalDateTime)"

          break

      }

      "Interactive-Custom" {

          # Connect to M365 App

          $script:tokenRequest = @{

              ClientId    = $ClientID

              TenantId    = $TenantID

              Scopes = $GraphScope

              Authority = "$AuthorityHost/$TenantId"

              RedirectUri = "http://localhost"

              ForceRefresh = $True # We could be pulling a token from the MSAL Cache, ForceRefresh to ensure it's new and has the longest timeline.

          }

          if($NeverRefreshToken) { $script:tokenRequest.ForceRefresh = $False}

          # Verify token

          if (-not ($script:token -and $script:token.ExpiresOn.LocalDateTime -ge $(Get-Date))) {

              $script:token = Get-MsalToken @script:tokenRequest

          } else {

              if($Force){

                  Write-Information "Force reconnection"

                  $script:token = Get-MsalToken @params

              } else {

                  Write-Information "Already connected."

              }

          }

          Write-Verbose "Interactive Token expires: $($script:token.ExpiresOn.LocalDateTime)"

          break

      }

  }

}

# SIG # Begin signature block

# MIIoaQYJKoZIhvcNAQcCoIIoWjCCKFYCAQExDzANBglghkgBZQMEAgEFADB5Bgor

# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG

# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCDsPg1vaR2OSSU+

# OXwsNPybtGpyAST/PZT1ssPRfCvMk6CCIWYwggWNMIIEdaADAgECAhAOmxiO+dAt

# 5+/bUOIIQBhaMA0GCSqGSIb3DQEBDAUAMGUxCzAJBgNVBAYTAlVTMRUwEwYDVQQK

# EwxEaWdpQ2VydCBJbmMxGTAXBgNVBAsTEHd3dy5kaWdpY2VydC5jb20xJDAiBgNV

# BAMTG0RpZ2lDZXJ0IEFzc3VyZWQgSUQgUm9vdCBDQTAeFw0yMjA4MDEwMDAwMDBa

# Fw0zMTExMDkyMzU5NTlaMGIxCzAJBgNVBAYTAlVTMRUwEwYDVQQKEwxEaWdpQ2Vy

# dCBJbmMxGTAXBgNVBAsTEHd3dy5kaWdpY2VydC5jb20xITAfBgNVBAMTGERpZ2lD

# ZXJ0IFRydXN0ZWQgUm9vdCBHNDCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoC

# ggIBAL/mkHNo3rvkXUo8MCIwaTPswqclLskhPfKK2FnC4SmnPVirdprNrnsbhA3E

# MB/zG6Q4FutWxpdtHauyefLKEdLkX9YFPFIPUh/GnhWlfr6fqVcWWVVyr2iTcMKy

# unWZanMylNEQRBAu34LzB4TmdDttceItDBvuINXJIB1jKS3O7F5OyJP4IWGbNOsF

# xl7sWxq868nPzaw0QF+xembud8hIqGZXV59UWI4MK7dPpzDZVu7Ke13jrclPXuU1

# 5zHL2pNe3I6PgNq2kZhAkHnDeMe2scS1ahg4AxCN2NQ3pC4FfYj1gj4QkXCrVYJB

# MtfbBHMqbpEBfCFM1LyuGwN1XXhm2ToxRJozQL8I11pJpMLmqaBn3aQnvKFPObUR

# WBf3JFxGj2T3wWmIdph2PVldQnaHiZdpekjw4KISG2aadMreSx7nDmOu5tTvkpI6

# nj3cAORFJYm2mkQZK37AlLTSYW3rM9nF30sEAMx9HJXDj/chsrIRt7t/8tWMcCxB

# YKqxYxhElRp2Yn72gLD76GSmM9GJB+G9t+ZDpBi4pncB4Q+UDCEdslQpJYls5Q5S

# UUd0viastkF13nqsX40/ybzTQRESW+UQUOsxxcpyFiIJ33xMdT9j7CFfxCBRa2+x

# q4aLT8LWRV+dIPyhHsXAj6KxfgommfXkaS+YHS312amyHeUbAgMBAAGjggE6MIIB

# NjAPBgNVHRMBAf8EBTADAQH/MB0GA1UdDgQWBBTs1+OC0nFdZEzfLmc/57qYrhwP

# TzAfBgNVHSMEGDAWgBRF66Kv9JLLgjEtUYunpyGd823IDzAOBgNVHQ8BAf8EBAMC

# AYYweQYIKwYBBQUHAQEEbTBrMCQGCCsGAQUFBzABhhhodHRwOi8vb2NzcC5kaWdp

# Y2VydC5jb20wQwYIKwYBBQUHMAKGN2h0dHA6Ly9jYWNlcnRzLmRpZ2ljZXJ0LmNv

# bS9EaWdpQ2VydEFzc3VyZWRJRFJvb3RDQS5jcnQwRQYDVR0fBD4wPDA6oDigNoY0

# aHR0cDovL2NybDMuZGlnaWNlcnQuY29tL0RpZ2lDZXJ0QXNzdXJlZElEUm9vdENB

# LmNybDARBgNVHSAECjAIMAYGBFUdIAAwDQYJKoZIhvcNAQEMBQADggEBAHCgv0Nc

# Vec4X6CjdBs9thbX979XB72arKGHLOyFXqkauyL4hxppVCLtpIh3bb0aFPQTSnov

# Lbc47/T/gLn4offyct4kvFIDyE7QKt76LVbP+fT3rDB6mouyXtTP0UNEm0Mh65Zy

# oUi0mcudT6cGAxN3J0TU53/oWajwvy8LpunyNDzs9wPHh6jSTEAZNUZqaVSwuKFW

# juyk1T3osdz9HNj0d1pcVIxv76FQPfx2CWiEn2/K2yCNNWAcAgPLILCsWKAOQGPF

# mCLBsln1VWvPJ6tsds5vIy30fnFqI2si/xK4VC0nftg62fC2h5b9W9FcrBjDTZ9z

# twGpn1eqXijiuZQwggawMIIEmKADAgECAhAIrUCyYNKcTJ9ezam9k67ZMA0GCSqG

# SIb3DQEBDAUAMGIxCzAJBgNVBAYTAlVTMRUwEwYDVQQKEwxEaWdpQ2VydCBJbmMx

# GTAXBgNVBAsTEHd3dy5kaWdpY2VydC5jb20xITAfBgNVBAMTGERpZ2lDZXJ0IFRy

# dXN0ZWQgUm9vdCBHNDAeFw0yMTA0MjkwMDAwMDBaFw0zNjA0MjgyMzU5NTlaMGkx

# CzAJBgNVBAYTAlVTMRcwFQYDVQQKEw5EaWdpQ2VydCwgSW5jLjFBMD8GA1UEAxM4

# RGlnaUNlcnQgVHJ1c3RlZCBHNCBDb2RlIFNpZ25pbmcgUlNBNDA5NiBTSEEzODQg

# MjAyMSBDQTEwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDVtC9C0Cit

# eLdd1TlZG7GIQvUzjOs9gZdwxbvEhSYwn6SOaNhc9es0JAfhS0/TeEP0F9ce2vnS

# 1WcaUk8OoVf8iJnBkcyBAz5NcCRks43iCH00fUyAVxJrQ5qZ8sU7H/Lvy0daE6ZM

# swEgJfMQ04uy+wjwiuCdCcBlp/qYgEk1hz1RGeiQIXhFLqGfLOEYwhrMxe6TSXBC

# Mo/7xuoc82VokaJNTIIRSFJo3hC9FFdd6BgTZcV/sk+FLEikVoQ11vkunKoAFdE3

# /hoGlMJ8yOobMubKwvSnowMOdKWvObarYBLj6Na59zHh3K3kGKDYwSNHR7OhD26j

# q22YBoMbt2pnLdK9RBqSEIGPsDsJ18ebMlrC/2pgVItJwZPt4bRc4G/rJvmM1bL5

# OBDm6s6R9b7T+2+TYTRcvJNFKIM2KmYoX7BzzosmJQayg9Rc9hUZTO1i4F4z8ujo

# 7AqnsAMrkbI2eb73rQgedaZlzLvjSFDzd5Ea/ttQokbIYViY9XwCFjyDKK05huzU

# tw1T0PhH5nUwjewwk3YUpltLXXRhTT8SkXbev1jLchApQfDVxW0mdmgRQRNYmtwm

# KwH0iU1Z23jPgUo+QEdfyYFQc4UQIyFZYIpkVMHMIRroOBl8ZhzNeDhFMJlP/2NP

# TLuqDQhTQXxYPUez+rbsjDIJAsxsPAxWEQIDAQABo4IBWTCCAVUwEgYDVR0TAQH/

# BAgwBgEB/wIBADAdBgNVHQ4EFgQUaDfg67Y7+F8Rhvv+YXsIiGX0TkIwHwYDVR0j

# BBgwFoAU7NfjgtJxXWRM3y5nP+e6mK4cD08wDgYDVR0PAQH/BAQDAgGGMBMGA1Ud

# JQQMMAoGCCsGAQUFBwMDMHcGCCsGAQUFBwEBBGswaTAkBggrBgEFBQcwAYYYaHR0

# cDovL29jc3AuZGlnaWNlcnQuY29tMEEGCCsGAQUFBzAChjVodHRwOi8vY2FjZXJ0

# cy5kaWdpY2VydC5jb20vRGlnaUNlcnRUcnVzdGVkUm9vdEc0LmNydDBDBgNVHR8E

# PDA6MDigNqA0hjJodHRwOi8vY3JsMy5kaWdpY2VydC5jb20vRGlnaUNlcnRUcnVz

# dGVkUm9vdEc0LmNybDAcBgNVHSAEFTATMAcGBWeBDAEDMAgGBmeBDAEEATANBgkq

# hkiG9w0BAQwFAAOCAgEAOiNEPY0Idu6PvDqZ01bgAhql+Eg08yy25nRm95RysQDK

# r2wwJxMSnpBEn0v9nqN8JtU3vDpdSG2V1T9J9Ce7FoFFUP2cvbaF4HZ+N3HLIvda

# qpDP9ZNq4+sg0dVQeYiaiorBtr2hSBh+3NiAGhEZGM1hmYFW9snjdufE5BtfQ/g+

# lP92OT2e1JnPSt0o618moZVYSNUa/tcnP/2Q0XaG3RywYFzzDaju4ImhvTnhOE7a

# brs2nfvlIVNaw8rpavGiPttDuDPITzgUkpn13c5UbdldAhQfQDN8A+KVssIhdXNS

# y0bYxDQcoqVLjc1vdjcshT8azibpGL6QB7BDf5WIIIJw8MzK7/0pNVwfiThV9zeK

# iwmhywvpMRr/LhlcOXHhvpynCgbWJme3kuZOX956rEnPLqR0kq3bPKSchh/jwVYb

# KyP/j7XqiHtwa+aguv06P0WmxOgWkVKLQcBIhEuWTatEQOON8BUozu3xGFYHKi8Q

# xAwIZDwzj64ojDzLj4gLDb879M4ee47vtevLt/B3E+bnKD+sEq6lLyJsQfmCXBVm

# zGwOysWGw/YmMwwHS6DTBwJqakAwSEs0qFEgu60bhQjiWQ1tygVQK+pKHJ6l/aCn

# HwZ05/LWUpD9r4VIIflXO7ScA+2GRfS0YW6/aOImYIbqyK+p/pQd52MbOoZWeE4w

# gga0MIIEnKADAgECAhANx6xXBf8hmS5AQyIMOkmGMA0GCSqGSIb3DQEBCwUAMGIx

# CzAJBgNVBAYTAlVTMRUwEwYDVQQKEwxEaWdpQ2VydCBJbmMxGTAXBgNVBAsTEHd3

# dy5kaWdpY2VydC5jb20xITAfBgNVBAMTGERpZ2lDZXJ0IFRydXN0ZWQgUm9vdCBH

# NDAeFw0yNTA1MDcwMDAwMDBaFw0zODAxMTQyMzU5NTlaMGkxCzAJBgNVBAYTAlVT

# MRcwFQYDVQQKEw5EaWdpQ2VydCwgSW5jLjFBMD8GA1UEAxM4RGlnaUNlcnQgVHJ1

# c3RlZCBHNCBUaW1lU3RhbXBpbmcgUlNBNDA5NiBTSEEyNTYgMjAyNSBDQTEwggIi

# MA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQC0eDHTCphBcr48RsAcrHXbo0Zo

# dLRRF51NrY0NlLWZloMsVO1DahGPNRcybEKq+RuwOnPhof6pvF4uGjwjqNjfEvUi

# 6wuim5bap+0lgloM2zX4kftn5B1IpYzTqpyFQ/4Bt0mAxAHeHYNnQxqXmRinvuNg

# xVBdJkf77S2uPoCj7GH8BLuxBG5AvftBdsOECS1UkxBvMgEdgkFiDNYiOTx4OtiF

# cMSkqTtF2hfQz3zQSku2Ws3IfDReb6e3mmdglTcaarps0wjUjsZvkgFkriK9tUKJ

# m/s80FiocSk1VYLZlDwFt+cVFBURJg6zMUjZa/zbCclF83bRVFLeGkuAhHiGPMvS

# GmhgaTzVyhYn4p0+8y9oHRaQT/aofEnS5xLrfxnGpTXiUOeSLsJygoLPp66bkDX1

# ZlAeSpQl92QOMeRxykvq6gbylsXQskBBBnGy3tW/AMOMCZIVNSaz7BX8VtYGqLt9

# MmeOreGPRdtBx3yGOP+rx3rKWDEJlIqLXvJWnY0v5ydPpOjL6s36czwzsucuoKs7

# Yk/ehb//Wx+5kMqIMRvUBDx6z1ev+7psNOdgJMoiwOrUG2ZdSoQbU2rMkpLiQ6bG

# RinZbI4OLu9BMIFm1UUl9VnePs6BaaeEWvjJSjNm2qA+sdFUeEY0qVjPKOWug/G6

# X5uAiynM7Bu2ayBjUwIDAQABo4IBXTCCAVkwEgYDVR0TAQH/BAgwBgEB/wIBADAd

# BgNVHQ4EFgQU729TSunkBnx6yuKQVvYv1Ensy04wHwYDVR0jBBgwFoAU7NfjgtJx

# XWRM3y5nP+e6mK4cD08wDgYDVR0PAQH/BAQDAgGGMBMGA1UdJQQMMAoGCCsGAQUF

# BwMIMHcGCCsGAQUFBwEBBGswaTAkBggrBgEFBQcwAYYYaHR0cDovL29jc3AuZGln

# aWNlcnQuY29tMEEGCCsGAQUFBzAChjVodHRwOi8vY2FjZXJ0cy5kaWdpY2VydC5j

# b20vRGlnaUNlcnRUcnVzdGVkUm9vdEc0LmNydDBDBgNVHR8EPDA6MDigNqA0hjJo

# dHRwOi8vY3JsMy5kaWdpY2VydC5jb20vRGlnaUNlcnRUcnVzdGVkUm9vdEc0LmNy

# bDAgBgNVHSAEGTAXMAgGBmeBDAEEAjALBglghkgBhv1sBwEwDQYJKoZIhvcNAQEL

# BQADggIBABfO+xaAHP4HPRF2cTC9vgvItTSmf83Qh8WIGjB/T8ObXAZz8OjuhUxj

# aaFdleMM0lBryPTQM2qEJPe36zwbSI/mS83afsl3YTj+IQhQE7jU/kXjjytJgnn0

# hvrV6hqWGd3rLAUt6vJy9lMDPjTLxLgXf9r5nWMQwr8Myb9rEVKChHyfpzee5kH0

# F8HABBgr0UdqirZ7bowe9Vj2AIMD8liyrukZ2iA/wdG2th9y1IsA0QF8dTXqvcnT

# mpfeQh35k5zOCPmSNq1UH410ANVko43+Cdmu4y81hjajV/gxdEkMx1NKU4uHQcKf

# ZxAvBAKqMVuqte69M9J6A47OvgRaPs+2ykgcGV00TYr2Lr3ty9qIijanrUR3anzE

# wlvzZiiyfTPjLbnFRsjsYg39OlV8cipDoq7+qNNjqFzeGxcytL5TTLL4ZaoBdqbh

# OhZ3ZRDUphPvSRmMThi0vw9vODRzW6AxnJll38F0cuJG7uEBYTptMSbhdhGQDpOX

# gpIUsWTjd6xpR6oaQf/DJbg3s6KCLPAlZ66RzIg9sC+NJpud/v4+7RWsWCiKi9EO

# LLHfMR2ZyJ/+xhCx9yHbxtl5TPau1j/1MIDpMPx0LckTetiSuEtQvLsNz3Qbp7wG

# WqbIiOWCnb5WqxL3/BAPvIXKUjPSxyZsq8WhbaM2tszWkPZPubdcMIIG7TCCBNWg

# AwIBAgIQCoDvGEuN8QWC0cR2p5V0aDANBgkqhkiG9w0BAQsFADBpMQswCQYDVQQG

# EwJVUzEXMBUGA1UEChMORGlnaUNlcnQsIEluYy4xQTA/BgNVBAMTOERpZ2lDZXJ0

# IFRydXN0ZWQgRzQgVGltZVN0YW1waW5nIFJTQTQwOTYgU0hBMjU2IDIwMjUgQ0Ex

# MB4XDTI1MDYwNDAwMDAwMFoXDTM2MDkwMzIzNTk1OVowYzELMAkGA1UEBhMCVVMx

# FzAVBgNVBAoTDkRpZ2lDZXJ0LCBJbmMuMTswOQYDVQQDEzJEaWdpQ2VydCBTSEEy

# NTYgUlNBNDA5NiBUaW1lc3RhbXAgUmVzcG9uZGVyIDIwMjUgMTCCAiIwDQYJKoZI

# hvcNAQEBBQADggIPADCCAgoCggIBANBGrC0Sxp7Q6q5gVrMrV7pvUf+GcAoB38o3

# zBlCMGMyqJnfFNZx+wvA69HFTBdwbHwBSOeLpvPnZ8ZN+vo8dE2/pPvOx/Vj8Tch

# TySA2R4QKpVD7dvNZh6wW2R6kSu9RJt/4QhguSssp3qome7MrxVyfQO9sMx6ZAWj

# FDYOzDi8SOhPUWlLnh00Cll8pjrUcCV3K3E0zz09ldQ//nBZZREr4h/GI6Dxb2Uo

# yrN0ijtUDVHRXdmncOOMA3CoB/iUSROUINDT98oksouTMYFOnHoRh6+86Ltc5zjP

# KHW5KqCvpSduSwhwUmotuQhcg9tw2YD3w6ySSSu+3qU8DD+nigNJFmt6LAHvH3KS

# uNLoZLc1Hf2JNMVL4Q1OpbybpMe46YceNA0LfNsnqcnpJeItK/DhKbPxTTuGoX7w

# JNdoRORVbPR1VVnDuSeHVZlc4seAO+6d2sC26/PQPdP51ho1zBp+xUIZkpSFA8vW

# doUoHLWnqWU3dCCyFG1roSrgHjSHlq8xymLnjCbSLZ49kPmk8iyyizNDIXj//cOg

# rY7rlRyTlaCCfw7aSUROwnu7zER6EaJ+AliL7ojTdS5PWPsWeupWs7NpChUk555K

# 096V1hE0yZIXe+giAwW00aHzrDchIc2bQhpp0IoKRR7YufAkprxMiXAJQ1XCmnCf

# gPf8+3mnAgMBAAGjggGVMIIBkTAMBgNVHRMBAf8EAjAAMB0GA1UdDgQWBBTkO/zy

# Me39/dfzkXFjGVBDz2GM6DAfBgNVHSMEGDAWgBTvb1NK6eQGfHrK4pBW9i/USezL

# TjAOBgNVHQ8BAf8EBAMCB4AwFgYDVR0lAQH/BAwwCgYIKwYBBQUHAwgwgZUGCCsG

# AQUFBwEBBIGIMIGFMCQGCCsGAQUFBzABhhhodHRwOi8vb2NzcC5kaWdpY2VydC5j

# b20wXQYIKwYBBQUHMAKGUWh0dHA6Ly9jYWNlcnRzLmRpZ2ljZXJ0LmNvbS9EaWdp

# Q2VydFRydXN0ZWRHNFRpbWVTdGFtcGluZ1JTQTQwOTZTSEEyNTYyMDI1Q0ExLmNy

# dDBfBgNVHR8EWDBWMFSgUqBQhk5odHRwOi8vY3JsMy5kaWdpY2VydC5jb20vRGln

# aUNlcnRUcnVzdGVkRzRUaW1lU3RhbXBpbmdSU0E0MDk2U0hBMjU2MjAyNUNBMS5j

# cmwwIAYDVR0gBBkwFzAIBgZngQwBBAIwCwYJYIZIAYb9bAcBMA0GCSqGSIb3DQEB

# CwUAA4ICAQBlKq3xHCcEua5gQezRCESeY0ByIfjk9iJP2zWLpQq1b4URGnwWBdEZ

# D9gBq9fNaNmFj6Eh8/YmRDfxT7C0k8FUFqNh+tshgb4O6Lgjg8K8elC4+oWCqnU/

# ML9lFfim8/9yJmZSe2F8AQ/UdKFOtj7YMTmqPO9mzskgiC3QYIUP2S3HQvHG1FDu

# +WUqW4daIqToXFE/JQ/EABgfZXLWU0ziTN6R3ygQBHMUBaB5bdrPbF6MRYs03h4o

# bEMnxYOX8VBRKe1uNnzQVTeLni2nHkX/QqvXnNb+YkDFkxUGtMTaiLR9wjxUxu2h

# ECZpqyU1d0IbX6Wq8/gVutDojBIFeRlqAcuEVT0cKsb+zJNEsuEB7O7/cuvTQasn

# M9AWcIQfVjnzrvwiCZ85EE8LUkqRhoS3Y50OHgaY7T/lwd6UArb+BOVAkg2oOvol

# /DJgddJ35XTxfUlQ+8Hggt8l2Yv7roancJIFcbojBcxlRcGG0LIhp6GvReQGgMgY

# xQbV1S3CrWqZzBt1R9xJgKf47CdxVRd/ndUlQ05oxYy2zRWVFjF7mcr4C34Mj3oc

# CVccAvlKV9jEnstrniLvUxxVZE/rptb7IRE2lskKPIJgbaP5t2nGj/ULLi49xTcB

# ZU8atufk+EMF/cWuiC7POGT75qaL6vdCvHlshtjdNXOCIUjsarfNZzCCB3QwggVc

# oAMCAQICEATxuaBOthmGPBQf/T19vOkwDQYJKoZIhvcNAQELBQAwaTELMAkGA1UE

# BhMCVVMxFzAVBgNVBAoTDkRpZ2lDZXJ0LCBJbmMuMUEwPwYDVQQDEzhEaWdpQ2Vy

# dCBUcnVzdGVkIEc0IENvZGUgU2lnbmluZyBSU0E0MDk2IFNIQTM4NCAyMDIxIENB

# MTAeFw0yMzEwMDkwMDAwMDBaFw0yNjExMjAyMzU5NTlaMHwxCzAJBgNVBAYTAkNI

# MRIwEAYDVQQIEwlTb2xvdGh1cm4xDjAMBgNVBAcTBU9sdGVuMRYwFAYDVQQKEw1i

# YXNlVklTSU9OIEFHMRkwFwYDVQQLExBJbnRlcm5hbCBTY3JpcHRzMRYwFAYDVQQD

# Ew1iYXNlVklTSU9OIEFHMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEA

# ufaKcpNEghlaO8FJ9JxMxyWtjYDMzK6NEc/2Ey9j3eDKs5MtSDaH6jCZwVIoy0gh

# VM7qQp4mDq7VxTy+LF+EvKOUZ7cBFAM9BF+e0r7Wypq0zloEBB//7YJcnqgwzdco

# Fb2tv1NeVwgE5hzbjpp9ZGtp+WOr0PiDQT7uI7WHMz7CjyeZyBf06wkntnwneuKy

# N3XLzWnbJbwGR0ku+uWZyxni/IqO6Aif+r5fdOed2giizFVrDPJRZ8tu9od+DmAJ

# 7B8Am5Ki3EnxlEyHL3oOolignkrZlt+TyFDAOGyA2f1wV+3MhYCngGDIl+sjcQIB

# A8ObAULMU27iFgdtWmPc5NanibHRkUdXgXnWczMFmpTBnbwJV5CJGMDwBtSU8Tnb

# edOmpF6iIh+nKbxLEOVF90WPrG86rp6ou4BjHz+djua9GO/W3R3HmGCspMl53+r8

# 74zx+B01QRA78JDKdENaa6W9VOICHtZ8s1CISrjw7dvI45cmwopIBivVweCo5OXm

# r1eBcKFbsH2wtGdoO5h12aW7yXEm0sqYMWHRsN/DXgCbW5Aq7o1v7CSNpcSZW+wB

# Ncf9surdMLzwT6vbo3GwqbSxrjeLbHOinn9cV9e2ROA4E7PMQLlyPvffcXn9QWAv

# kTYm/gMbpXepQATcupfEzTnSmHMJwEbAqP0XqbcftckCAwEAAaOCAgMwggH/MB8G

# A1UdIwQYMBaAFGg34Ou2O/hfEYb7/mF7CIhl9E5CMB0GA1UdDgQWBBRm81EbqiBD

# YIXuCPS2E6CaB1RXyjA+BgNVHSAENzA1MDMGBmeBDAEEATApMCcGCCsGAQUFBwIB

# FhtodHRwOi8vd3d3LmRpZ2ljZXJ0LmNvbS9DUFMwDgYDVR0PAQH/BAQDAgeAMBMG

# A1UdJQQMMAoGCCsGAQUFBwMDMIG1BgNVHR8Ega0wgaowU6BRoE+GTWh0dHA6Ly9j

# cmwzLmRpZ2ljZXJ0LmNvbS9EaWdpQ2VydFRydXN0ZWRHNENvZGVTaWduaW5nUlNB

# NDA5NlNIQTM4NDIwMjFDQTEuY3JsMFOgUaBPhk1odHRwOi8vY3JsNC5kaWdpY2Vy

# dC5jb20vRGlnaUNlcnRUcnVzdGVkRzRDb2RlU2lnbmluZ1JTQTQwOTZTSEEzODQy

# MDIxQ0ExLmNybDCBlAYIKwYBBQUHAQEEgYcwgYQwJAYIKwYBBQUHMAGGGGh0dHA6

# Ly9vY3NwLmRpZ2ljZXJ0LmNvbTBcBggrBgEFBQcwAoZQaHR0cDovL2NhY2VydHMu

# ZGlnaWNlcnQuY29tL0RpZ2lDZXJ0VHJ1c3RlZEc0Q29kZVNpZ25pbmdSU0E0MDk2

# U0hBMzg0MjAyMUNBMS5jcnQwCQYDVR0TBAIwADANBgkqhkiG9w0BAQsFAAOCAgEA

# eDbtA8CjFmSEjjq3jgM7utHOhN56IwIVyL4RuVCxPyRwZ1qg9RRzK6LetRwQ969P

# TSXfJFNP1JWGHRkkmKUH/yk5AdTz8vTFLWeYQSrdY5tf246HMFzjassGQnRMdOUr

# IOf+yeGDRy7ktBZGWCIxRZWtT/naIl1lgplLx3O+a5iRV6eTGq20ns1mXnJHyjQ4

# YoPW77YigKFqeJ0Sc/7MzxO9soqr37pRHrgCjuZYso6ExRorvy8cXFINLF+2cyoi

# XXiimWbKA6gxWte+ZyRgGbgmYgTCDqGSH7bCyIJy7oHhcSU5mOauX4b1IgAVwJDf

# frZpQhcDgAy3w4USlO8wmZ616Kdvj1/FG6/7Wh1/3fyxdNfDGx8h2HA6C5wjbmMP

# NaxwS4Cua7MItgVQgHx3FrKLUkGZZoNogSKX3vXAkF1ezDOec8kOeJgHo148esAV

# py9mMWWBbwAbOnxyiC9uMs135xSxEkai2AFjfNYbIKmmEC6l21dNdxz3RRLJzbsB

# McWZ/IHHvD2L702sNDow4N13vDrZfT2G+TbRgzKfq2iCA3OXSMwwofz24RTxkDof

# BKb7ySKnnE6FZwe4u3NHoUOkfrsMyxpmugnOpFiRf2lK0Qzuu9W4sW0+4PEPnokM

# mvymlpDldO5AIqud0quQfdu70cmTzpHVPPMz9wCDR3AxggZZMIIGVQIBATB9MGkx

# CzAJBgNVBAYTAlVTMRcwFQYDVQQKEw5EaWdpQ2VydCwgSW5jLjFBMD8GA1UEAxM4

# RGlnaUNlcnQgVHJ1c3RlZCBHNCBDb2RlIFNpZ25pbmcgUlNBNDA5NiBTSEEzODQg

# MjAyMSBDQTECEATxuaBOthmGPBQf/T19vOkwDQYJYIZIAWUDBAIBBQCggYQwGAYK

# KwYBBAGCNwIBDDEKMAigAoAAoQKAADAZBgkqhkiG9w0BCQMxDAYKKwYBBAGCNwIB

# BDAcBgorBgEEAYI3AgELMQ4wDAYKKwYBBAGCNwIBFTAvBgkqhkiG9w0BCQQxIgQg

# lJlp+9KskSQyBLUPX2WIxvIDPw26e2dqeajYM3Ib2F0wDQYJKoZIhvcNAQEBBQAE

# ggIAhh6HsztwsMxKy6XVTuK/jXbi9Oo4gII6w2KF68eHKVXEtIp6T2iVT4zPiw3i

# G21XvpULp7Ndp1T2wwCzwuJbEscEKyjlY8gPHOoFYlCzYCYHzqs4cnotdq6xeN5V

# CJVdlVt7QPwgB37LY6eI/RSFg1/AaqqUV7QCxxsA2727EzFouDbgKwJSPCEDxuTI

# +UTXIDXPzYkJyJMNFZ08JDsZ8an1pHPDw3sE4rU9Qc6zSUT8zJZ0MTia73w7hUU5

# RTV2/YstzjCLbchZZys7KfOcc7MwsZppqK0PnXEg7mLCsmnTojiRIsMPmh6YqA/A

# rDAihYZKgTn7qGqZOVXZaRqq7CE+RnCp/HQqUsD7ziePnpTfIzIAdxn4do9dkBD3

# /zoa1I7YMDcHGvrjQF+1Sf9+SpjqXAM3ZFFzIYa8J5+G32t+UaVa5FOPnpWtQrIR

# 7libIbBFy6DuyQ8HIFk9qwtfMFbYhu+utnNL1N0d0UHju72CMqUT+EtiUu7TbkWo

# u012fD878mHMtceaLh7ZmHAKmNgxzjFeo7E0UxzAl2o2U1LAjdxU87Mz8VTvtacV

# DclI2QsJgkY/GsTgCQOuOPu61aXF1lQK17t95iWO6K09Ik8Bxt4QzwqZneu5+NEz

# RfYt82RgZoc0cmVK0oKLwxfdLUg0gOmwSCv61Co5ySIcCbehggMmMIIDIgYJKoZI

# hvcNAQkGMYIDEzCCAw8CAQEwfTBpMQswCQYDVQQGEwJVUzEXMBUGA1UEChMORGln

# aUNlcnQsIEluYy4xQTA/BgNVBAMTOERpZ2lDZXJ0IFRydXN0ZWQgRzQgVGltZVN0

# YW1waW5nIFJTQTQwOTYgU0hBMjU2IDIwMjUgQ0ExAhAKgO8YS43xBYLRxHanlXRo

# MA0GCWCGSAFlAwQCAQUAoGkwGAYJKoZIhvcNAQkDMQsGCSqGSIb3DQEHATAcBgkq

# hkiG9w0BCQUxDxcNMjUxMDEwMDkzMjE0WjAvBgkqhkiG9w0BCQQxIgQgCuOKjtPK

# +JrYJr+/63nYQe1VKB56eLTCaPQ3kkmkrJAwDQYJKoZIhvcNAQEBBQAEggIANdOJ

# rvD9Wom/TIvp3CVE90dDduuxSjeHbP7jEKSfDjmFiFYPQztHh5xk2uwc0G/b0QEG

# yi6GXUsNxE1qVoemDMhHspWYNpjpCMTAnHQ7+YO1wvkkqazfxe+NXYt39L61hja6

# 0Z2u4Ib3DBFfuLwAjC1ilpJ1+xTfYmrZZrYFV1UdvC2msVZN6ZelJAOV8Bv52nAX

# eCHZnBngSDJsAVkPVWzoU0IBA8lG3ZOOL0HJtg/0Vuzjc2iQXFi0Oe/KsQgC45dB

# p7RAHhFYTLc9//JMnu1lkJ34CVgz7M+XINs1RLlcWu9TMHRffIQExekPmmuksFvo

# GtN8IIHxlYZVSloVFijVQQ8vFPRcKmDsPr3YMmctAKxv65Bhaq14YJMpEzYI/6ho

# uVO6Uvn+WB+Ow60ICh4OoXPjvFpOcB9bPXhQLimzQqhy7/naGbhTd3lQemnCA1RK

# zVgTVwzmOzSDeJPDISgUALBLaYwCDImSUIst0fhu3tHK+GA0ku5yLHghbtTb6orl

# 0ceqOTwZBwx1sKVEl4izGqz3FapWFXyA8XCrCTVikMytF5Wq7+rzcJOHCvJgjXMr

# SxbqH7u6uLxfLeV0Yz7OktvoUEXisH1P3nBcqPYWVPmD4xUyka+lwM8ULoCND9Si

# MYcXhsrI8J3brmTpp3XXKWP2eb2WDahs2CvV7xc=

# SIG # End signature block