From 8792fa4c0df620fb21f6e70c7d9bc91ef1c24d62 Mon Sep 17 00:00:00 2001 From: John Pipkin Date: Wed, 11 Dec 2024 14:24:54 -0600 Subject: [PATCH 1/2] First pass --- .../automation-service-integrations.md | 19 ++++++++++++++++++- 1 file changed, 18 insertions(+), 1 deletion(-) diff --git a/docs/platform-services/automation-service/automation-service-integrations.md b/docs/platform-services/automation-service/automation-service-integrations.md index 4f2f965f1a..389606fdbb 100644 --- a/docs/platform-services/automation-service/automation-service-integrations.md +++ b/docs/platform-services/automation-service/automation-service-integrations.md @@ -65,7 +65,24 @@ Note that in the following example a **(2)** follows the duplicated integration' ## Create a new integration -You can build basic integrations without having to provide custom YAML files. +### With the Automation Service + +To create a new integration, you must supply YAML configuration files. See the following for more information: +* For an example of creating a new integration by supplying YAML files, see [Advanced example: Configure a custom integration](/docs/cse/automation/cloud-siem-automation-examples/#advanced-example-configure-a-custom-integration). +* To learn how to build your own YAML files, see [Integration framework file formats](/docs/platform-services/automation-service/automation-service-integration-framework/#integration-framework-file-formats). +* For example YAML files, see [Example files](/docs/platform-services/automation-service/automation-service-integration-framework/#example-files). + +To create a new new integration: +1. Create a YAML file containing the configuration for the new integration. +1. [**Classic UI**](/docs/cloud-soar/overview#classic-ui). Click the gear icon Settings menu icon in the top right, select **Automation**, and then select **Integrations** in the left nav bar.
[**New UI**](/docs/cloud-soar/overview#new-ui). In the main Sumo Logic menu select **Automation > Integrations**. You can also click the **Go To...** menu at the top of the screen and select **Integrations**. +1. Select the **+** icon at the top of the screen to the left of **Integrations**.
Add Integration button +1. In the **New Integration** dialog, click **Upload File**. + 1. Drag the file into the **Select File** box. + 1. Click **Upload**. An integration is created based on the YAML file. + +### With Cloud SOAR + +If you have Cloud SOAR installed, you can build basic integrations without having to provide custom YAML files. 1. [**Classic UI**](/docs/cloud-soar/overview#classic-ui). Click the gear icon Settings menu icon in the top right, select **Automation**, and then select **Integrations** in the left nav bar.
[**New UI**](/docs/cloud-soar/overview#new-ui). In the main Sumo Logic menu select **Automation > Integrations**. You can also click the **Go To...** menu at the top of the screen and select **Integrations**. 1. Select the **+** icon at the top of the screen to the left of **Integrations**.
Add Integration button From d0cc019a518f45ea040b34a0006fac5d8347967f Mon Sep 17 00:00:00 2001 From: John Pipkin Date: Wed, 11 Dec 2024 17:07:55 -0600 Subject: [PATCH 2/2] Finish adding section --- .../automation-service-integrations.md | 40 +++++++++++------- .../new-integration-dialog.png | Bin 0 -> 42102 bytes 2 files changed, 25 insertions(+), 15 deletions(-) create mode 100644 static/img/platform-services/automation-service/new-integration-dialog.png diff --git a/docs/platform-services/automation-service/automation-service-integrations.md b/docs/platform-services/automation-service/automation-service-integrations.md index 389606fdbb..f1d5a79eaf 100644 --- a/docs/platform-services/automation-service/automation-service-integrations.md +++ b/docs/platform-services/automation-service/automation-service-integrations.md @@ -65,26 +65,36 @@ Note that in the following example a **(2)** follows the duplicated integration' ## Create a new integration -### With the Automation Service +### In the Automation Service -To create a new integration, you must supply YAML configuration files. See the following for more information: -* For an example of creating a new integration by supplying YAML files, see [Advanced example: Configure a custom integration](/docs/cse/automation/cloud-siem-automation-examples/#advanced-example-configure-a-custom-integration). -* To learn how to build your own YAML files, see [Integration framework file formats](/docs/platform-services/automation-service/automation-service-integration-framework/#integration-framework-file-formats). -* For example YAML files, see [Example files](/docs/platform-services/automation-service/automation-service-integration-framework/#example-files). +To create a new integration in the Automation Service, you must supply an integration definition YAML file, as well as an action definition YAML file for each of the actions contained in the integration. For an example of creating a new integration by supplying YAML files, see [Advanced example: Configure a custom integration](/docs/cse/automation/cloud-siem-automation-examples/#advanced-example-configure-a-custom-integration). For sample YAML files, see [Example files](/docs/platform-services/automation-service/automation-service-integration-framework/#example-files). To learn how to build your own YAML files, see [Integration framework file formats](/docs/platform-services/automation-service/automation-service-integration-framework/#integration-framework-file-formats). -To create a new new integration: -1. Create a YAML file containing the configuration for the new integration. -1. [**Classic UI**](/docs/cloud-soar/overview#classic-ui). Click the gear icon Settings menu icon in the top right, select **Automation**, and then select **Integrations** in the left nav bar.
[**New UI**](/docs/cloud-soar/overview#new-ui). In the main Sumo Logic menu select **Automation > Integrations**. You can also click the **Go To...** menu at the top of the screen and select **Integrations**. +To create a new integration: +1. Create an integration definition YAML file, as well as an action definition YAML file for each action in the integration. +1. [**Classic UI**](/docs/cloud-soar/overview#classic-ui). In the main Sumo Logic menu click **Automation**. Then click the gear icon Settings menu icon in the top right, select **Automation**, and then select **Integrations** in the left nav bar.
[**New UI**](/docs/cloud-soar/overview#new-ui). In the main Sumo Logic menu select **Automation > Integrations**. You can also click the **Go To...** menu at the top of the screen and select **Integrations**. 1. Select the **+** icon at the top of the screen to the left of **Integrations**.
Add Integration button -1. In the **New Integration** dialog, click **Upload File**. - 1. Drag the file into the **Select File** box. - 1. Click **Upload**. An integration is created based on the YAML file. +1. A **New Integration** dialog appears. Drag the integration definition YAML file into the **New Integration** dialog.
Add Integration button +1. Click **Upload**. The new integration is listed on the **Integrations** page. +1. Now that you have uploaded the integration file, you need to upload an action file for the integration. + 1. Hover your mouse over the new integration and click the **Upload** button that appears.
Upload button + 1. In the **Upload** dialog, notice how **Integration File** is highlighted. That's because it was uploaded already.
Upload dialog + 1. Click **Action** and **Next**. + 1. Drag the action definition YAML file into the **Upload** dialog. + 1. Click **Upload**. The action is added to the integration. + 1. Repeat these steps for any other actions you need to add to the integration. +1. Add the resource information: + 1. Click the **+** button to the left of **Resources**. + 1. Give the resource a **Label** and enter the connection configuration needed by the resource. What you enter is specific to the integration you're adding the resource for. Each resource's configuration screen may be different, but in most cases, you will need information such as IP addresses, API tokens, usernames, and passwords for the application you're integrating with.
Add Resource dialog + 1. Click **Save**. The new integration is complete.
VirusTotal example integration +1. To test an action, click on the action, then click **Test Action** in the dialog that displays.
Test action dialog + +To make your custom integration available for everyone in App Central, see [Publish an integration to App Central](/docs/platform-services/automation-service/automation-service-app-central/#publish-an-integration-to-app-central). -### With Cloud SOAR +### In Cloud SOAR If you have Cloud SOAR installed, you can build basic integrations without having to provide custom YAML files. -1. [**Classic UI**](/docs/cloud-soar/overview#classic-ui). Click the gear icon Settings menu icon in the top right, select **Automation**, and then select **Integrations** in the left nav bar.
[**New UI**](/docs/cloud-soar/overview#new-ui). In the main Sumo Logic menu select **Automation > Integrations**. You can also click the **Go To...** menu at the top of the screen and select **Integrations**. +1. [**Classic UI**](/docs/cloud-soar/overview#classic-ui). In the main Sumo Logic menu click **Cloud SOAR**. Then click the gear icon Settings menu icon in the top right of the screen, select **Automation**, and then select **Integrations** in the left nav bar.
[**New UI**](/docs/cloud-soar/overview#new-ui). In the main Sumo Logic menu select **Automation > Integrations**. You can also click the **Go To...** menu at the top of the screen and select **Integrations**. 1. Select the **+** icon at the top of the screen to the left of **Integrations**.
Add Integration button 1. Fill out the **New Integration** dialog: 1. Upload a **Logo** for your integration. @@ -107,7 +117,7 @@ If you have Cloud SOAR installed, you can build basic integrations without havin 1. Click the **+** button to the left of **Resources**. 1. Give the resource a **Label** and enter the connection configuration needed by the resource. What you enter is specific to the integration you're adding the resource for. Each resource's configuration screen may be different, but in most cases, you will need information such as IP addresses, API tokens, usernames, and passwords for the application you're integrating with.
Add Resource dialog 1. Click **Save**. The new integration is complete.
VirusTotal example integration -1. To test the new action, click on the action, then click **Test Action** in the dialog that displays.
Test action dialog +1. To test an action, click on the action, then click **Test Action** in the dialog that displays.
Test action dialog To make your custom integration available for everyone in App Central, see [Publish an integration to App Central](/docs/platform-services/automation-service/automation-service-app-central/#publish-an-integration-to-app-central). @@ -115,7 +125,7 @@ To make your custom integration available for everyone in App Central, see [Publ You can set integrations, and their related action execution, to be executed in the cloud or through the Bridge. Only certified integrations can be executed in the cloud, while custom integrations must be executed through the [Bridge](/docs/platform-services/automation-service/automation-service-bridge/). -1. [**Classic UI**](/docs/cloud-soar/overview#classic-ui). Click the gear icon Settings menu icon in the top right, select **Automation**, and then select **Integrations** in the left nav bar.
[**New UI**](/docs/cloud-soar/overview#new-ui). In the main Sumo Logic menu select **Automation > Integrations**. You can also click the **Go To...** menu at the top of the screen and select **Integrations**. +1. [**Classic UI**](/docs/cloud-soar/overview#classic-ui). In the main Sumo Logic menu click **Automation**. Then click the gear icon Settings menu icon in the top right, select **Automation**, and then select **Integrations** in the left nav bar.
[**New UI**](/docs/cloud-soar/overview#new-ui). In the main Sumo Logic menu select **Automation > Integrations**. You can also click the **Go To...** menu at the top of the screen and select **Integrations**. 1. Select an integration. 1. Hover your mouse over the resource name and click the **Edit** button that appears.
Resource edit button 1. In the **Edit resource** dialog, click the **Automation engine** field to select **Cloud execution** (for certified integrations only) or select a Bridge option (for custom integrations).
Automation engine field diff --git a/static/img/platform-services/automation-service/new-integration-dialog.png b/static/img/platform-services/automation-service/new-integration-dialog.png new file mode 100644 index 0000000000000000000000000000000000000000..c8ec119d539d67657fa59798fe9b231fd9a82a69 GIT binary patch literal 42102 zcmeFZXEIxxV+`hO?kDX&=e*bZ;e9`xb3LwW&unY&Rsa3B{%b-Wsw$0v7T1T?;YDA0kBVN3%49wPW1m0f8>?M(0GHblc zAMx3q@LjlRj#ykghu8KHi{3imkbS%=tQa#WgT;Y*E{D+E!;7$f-6v0K#@r}F;4eyM zvE_~TTA!|OG8uKVumeC<10Zxgle7{7&{A8u^gV)Z4!i|4q|EQsH|@=CHw z_5%s{$}IyV4~=rh1+3gkVw|Wk(dNC^c4_2EQE9yk8Ge~j7}1U$GqnI#mn-?t=x)r) zhTMzg{&3`%HRBgoZ8X=-DDtJZXg2L@-UqXZlv!0uT{HSdhs>q-k1n9_{HLjU{Nbd< zMbT*_&msLfImmBG-(t=#63N>$`bC7(kPtLn6?t(-E`fpWwzXFDRT7<%y2G@&NN-=s z#)AvGVKjH00!27y`GH?5|JjFQ+zRPieu<5R)_5EJi@Jl8$vRC(+uHAlkKAh~z zB26GcvmgDpygMzovTMX&y!j>_^MJyG)QR~Vam9v-*vIQkd#o2F1K!NCFq1r?slVcE zroD@U_`W`>cf3k{yZJ`2rMX}bPsrUy*{3&df3OZ_n680|GUG#!zf>X_5iU30@$bFN ze(6@vR!@G9c&bxK`MvkcIO@B^{glk@8V5s|Zv|;t49xymS#ZvqVn;dT>#BNB7>p%p zguJNwZmqVyS$OxcA(3f8_eZAh@h>zL9vyO(u_-Ih%5rWRX z6S^a`-$cAK*vrmKyi9ITe@gqs@-zOIuQPgVgP}~?Q&UW6^CwN@9hW7L8WjC>6;?H$ zKi`ZZT`*X%UkG2W@!tIGJ$)p9%YUiNKUS}R&zyvLI)yQo#| z_B!`7W~IJUmvN;2U7N?p$Eh`rW=;6}-w11{-g!^iif#0z?qycXc1-1w;n#>= z*;o?9N!(k>4IK`dmgVINzdfKNBW<`^K64Z)YFkmjxt$ zr1z$zcyYG-y!wk`Bo&On-oMHb?fPQjBW?9rmJ38zue!brxx$+Dnr7M`#>&`8OLFg8 zgx+;JWjTS1Tc zo;{*ym2c?ra3xI$>69hwVPAYu!dP$*owmEEyhG(hxGJ0a$>&O)(5=gsL1IrC-vrB> zap|4qXqtbd6~E^@#_%9p-2 zNTw08*+nG&?KM(%V5uH2hSj}QSJ>VwoxM&RNy!y@opmlMR5?)ztJI{dtDKxsZcbjrHS&s4RsE_; zi~Ov>mdV!bE$uDAE#lD2-$SS6L(*U0DCWw)QFTKtx-DA0l{imiAZS_cZMLNr?W49_ zaKB(bq+gewo_?M_h5j}@)!SF}bM(YQogm4655>N;kv@--#|e>Tk!8VdFWiFnLe;Yk z`;L~lcDxTBc#$7nI>J9H;Lz$*j)HRa8hzBy)rWd&Z=VUQ|MJw4PK)l<8-X8Je^@Al zUzTq(2+L;gPJn9Xg72eZby7vNAW3e~ZYg`DtMF0Uk}6jv@j>ys;@6Vd#U;S%OOlpP zRmnKQxy<=2*Pf=Bxh+$H?OZXHBbAwzlc=(#z2&9Fie>iYj^6x!iM*k2^?HLm(%f;S zq2LH`)UI#z=8d%*n>llzmKBVdb`|_eYHDlrYVZ5i9+MxT&)NpE1~LW;pCvzwCU=s9 zG+b$j4>Bb0y0Z6XkZD!Q;7+Ca&bOZ0D`^UQ3SSjm-nh}1((lqGUJ1U^_C}O0RbcJ5 zS^R#YdE#eLG0R@NR-s+tm=A@bQuYT7hT$C+3q@@s*&}dE1Lp1aeGn#$=6mR~7>m-L<)i@y5CiHuDszy0&{*U^ z#5?g`qCq00%+*k4jIK<(Y-shh8)Fq?6|bA_$|HyIRO&L=XPno0{|^7tW;bKSHIiDURLmdVS0lbcLEpi*8%U z&1eNN?Bdi8vvGpVm^2YLLPKj4pCo=%wN^I2p2abEy+)Z-)gZC|w#`b0XA~bh1BXf^ zgO(Ck2v?QX0SB?##H|X!0p8L(yYrV4xr(!lK0Lo8?7rM%^Ty_dO>ply8)X|vpEPMY zk@kxkSKovA9h0jXut)nwv-}49%a^gQheA^=_RT+cEVk~n7{!ew&&6rS4zNur-@MLW zELU7^QQH#IIug~FniyRr6P^?o>wZ6vt>b-4ioJl(;Er2-;Ag$T+YO)}L3HpfM~wZM z^bhIQ?L)6*4hkL^&WW}LpQ$+$bH>4nqf=5y1rqD3gR;erv{}h;pXWQYr;t{>lWkEr zf{=G%>73~tyUh}xDqU+4@cjilnK*3_&u5eS#?i%#3)dFXOXdA|)eR6OjUFxa?BTT} zn5;6rVm%XYP%gUHu5H62(!#E-iGQ->&?O{i_Gzw*js8*-O+5{5Efd-fQ+~uPs8d$p zY+4Eyb}DtFWi&|*wPQ}m{&TeM=dsC^Nl z#H+6<^m8af41Nq&l)=uV2Geo5CpO>ksC>{)a6+eY^~kMdZ%pEzTfeTpZp`ZSHJ)LN ztL}86%cN6H{)io{$`ze0)hop`@O2;?B>DXL9{sAZcG%!eP!&3Jt!m2$iGB-y2bS0? z-iu?#BaSBa#a>+vP9$!iEMuHz%)|C9H+2NZ2dgZ9}PnTdKpdBSvxeU7@&wRN1T^ZnJ*Ihtr(XOWiWX8zE3Ix0b7%U6}e#Y}}3GupLwU z%}OJACPl(`V!?a+43tcf&zVoe$hr3MsN&B-w`|9h96fS`^L-iUD>Cp^Ix`(!mmq(;CSGb(SDA1qw(UmGoWk@Gi5T zT=>eG*EfLn2W=kfx$3E@ia&F(<1;gNcxu7tVdr?#4xXfkIB;uc;cCX}VP|XaBJLq| z?eq+s@Em%ePZt>l^CQZu9$|~t>ZYi#LU*SL1f&Zkg zS-ZMAiu3ckySwwb3-UQQTk+o(6BFaVCBQErzze*=>*8teYUaUf@51&^BR|`@Z{hOH z*~Zb;#=)NTq+PS84q#WQYu8RX`t|qEI4wMEe)nYW@}Fq|6XZX6!hf6Z7XPodfvS=x zrQ#25JS=SW@7ve`YXB;XN|EQ_=yQbKkziR&Rp$K8`S3p#CHYTg{>MuEv&^TZz&cBlO7j1rnKUVu`%)%AMn;?a8jpc*fXPn& z@VSAH8~=Qt+^b+`YgudX@MQ6n@85mwfxj|Na;Q3hYucntw|#VOL~by$G^6N#m}Y2n z=02O<_50=;?8-L{U){$p5AA`9Emh`p&Ety9N!Um3?N4@LMEa636Y=Zq-nCW<>+U8C zxaM{QWG!BzOTyQ0U2GvGiq|yYDd%@>(zws_Uf;EdF395H|M~G+p4Bj?&c_3nqBlBo z<x)*o>V+1$VuKnFC(A&Jkzl!|*&)^f3pLv{c|L^(8`qy>1|EmZOpNxRWo-9Ww zhgA|NpMfKO8RmUw$~1kpBmMP`(I5^^2S4 zJub9X-CG;yWbu{c)=Yi8OPZ8oT3EG5TI_Q~DbvymJ&wy$7jS?rhbm}hI9`?8I51pq z`}(XYGCr{D-Jep(7a-~B+~zruuh;g7b}*lP5^BU2Ou^&^N7bT*xCqd4at9B}`Bslw z%Mo62?bxRwIIxh$&1im3vW0e`;Od=aiC*`**VYtWTVR=kuJgIZ+uqw^T?M`&hhK5B zvAA~cx?!RnKifppkw(U9%hj{`rItRn#V35h8cd;&-iQ!P|i9T(c;wYCnLr{>t=`gd%(~@f3-PYRM)OT-k5ti3$_+fZGpCH*DnGzDXdlcP2hY!pAP-RMYOhI09?}gp8Nq4+@{9T3_sT?Vv~UG zVkNbhZN45*)w09kJ$fRA!wa_6o8BK%!bhXM({F*_kLBj_^1d z2%5!egXXH{@{0s0Q^|kLx=xN&DovuNq0ASNL55fuvbo6%taBK`g2^I9 zaf=vejp}!ct(Uz;ewoRD<}*)8#^bNr=F0*j8r_9PGD*0%C<UQWk;h@S?9AfC)ymu;wvy2i(RkMT3ZKa zdmgXM#+eT{JZs-}^lPMtfpha>c?+Yxz@P_9n(P@*0{Sc(ex#bOR4KD8~Yq#!EhkZE!P zlVWjtDj5NWRyl=ECfeH~F7x~XGHyv;%ekFpH#PI;JvECJz+8q|(YB-219y1!cC?2d zovYbRD!qHOBDJ<=JDRe8=!%(7oSUy$4_A_&VW%CUPF^*FYHvQZYUvttYfS(%wC@^x zvCdr?XPB5oo2)hUZ7)QXiIzuiCwCc_sVWzPuzRNFOGA^bhU>nIrVsLsMl>}uHRX$O zQC$lyA=I3Rjt>haz6UdpqJG3Fz1p&vLw=JhdcG^Jzv^AS-AZaT=UmS|-v zH=Lc{rIfLc+-30HStmnhJWLauo!1#so@=GaaBV4OFW-hAd15JCI$6ATD!j4dt&YK1 zbj2jDYF#%h#l6gSq&?iJl+UpyuoIn=P^>wjj`F@s{^*!Iv-G#j{28c zmCzLJJCBREj#`DCyL<@cg5Gf_3P&z!X~tGAqmc~)Gco0IWtkGO?KoK>n2n9IcH$SZ z+J&w--9aAQJ$0wShl8?C*l{j&d1BzFL$=%S-T0e#$0nrjs;Ma*c;4S zOs0@+83EhIDT63iWDSo)r3Lh7^Y7zR5JmJGg>@k-CBH&&tdJU<0!I* z*%e*du9Mr!r4C}_Js_-uqg^kS?%foxeA+DcsRIm0?Twi)ew@fMSPI>pUF`XkOF^>N zcMG??Ly~?MVJy^WGPt9F=GZn0-22cJ^kLmMFWJwbJN|IeXZ;x+X8+CtaWGSE-fm5K z;ttBiJ#RHl1OZ;hi(e{P;O^lgi{*DP@w8q%>OBYoUDqu%sXiNW}7ee3GVmiukTNE;&KGVp~ljtCE16cG%Qu(Bo6k` zXJo{(jcoKK*L`sFiph05?JskWhrVebP&$)C?m5-R^N?@a*L;~&kTsvMgaXI8itUuF zek(GpVR7DUVYP>&?brS6zi&CO4#Z&zWA{uC($10)>$@v6 zLVxM9`|1Q6rIdikfK}zU_}kbe&Y(oJxbNZ1r72^$8{BrZM7z`Nh3%Y6n@V3B|8}tD z5&lQ_+9^wB|Hp5S;CKBRuWS!LtiWWU+Apu#4R-IXZp9Q?bvdL@)>fACZ{Y51^~1Qb zvLzDg3MQ9qx@2q=h!ztMXOo~oa{`$vt!+?v)N{Be(@0O1l_-w#(pXZ;IJ6einG|={ zZ`H@acVKQFo4dN?djz>CnK!-6&Cn*SD>`s9O9)5qGp5 z7%QP<0L6zR)}Re+Y>?|*5-ltOP*qG*SRqD-7HX40A14^5PW zbWixMdiJDsjy4$Xz6eTB>&~~XW4T=d9f8VRx2^*@JyV3{S&n_8+>PsGa=6{apEJZ` zeD_*xT|t@xgg;v>z_$C#qg?5@1Q{8#=*Qq7^mDpf9vQhH6OY5GWBfFfvCmus&Uft* zw`1R{-RCWS6G_kSRlO5gT-|wsdgj=}>;c!QF?qPU+K*()gE<&>8`9aYdPC_r)(fEx zAFv4b;GHGU;1S97F!o;9)c1MM>rx2rw&L)cpz&Wa(nKV0LnXiV*8TYeWEi zcFmq^@(esVO}Ex8MefUP@C%9Ll)bx0kOVoaF5?@k5@59O4CczJ6k@H8fzJ^YuI3`` z*>~vw(cv%^EpvOpXMZC#xAT*B+q{5f|HGcCX#?>?Q_6T@tGjt#mEVqzYt}#Rg_fg+ z$7QM~-2tn(-M08XaIO*ry_L8lkvYjr`qLTl_m{#aA8){!7(dVHyBj%DU)Fje=F2<% zHnL8%Oex}R@v^Ik(1j0QhN>-y^=qD%R)yj`0n3Q$z|4~O8Rp@TLw@_g-1M`T+f$Yh z;a&;t$+dc;6R}=7g=g8xRSgQkUY_IdS8HXaem0R6oQ9A*2OAgo5_zFczEd;y9c{-^ zcweIaAOZ@h5ImHWVh2dJ9yhpU>&0K7?wtMUY)O;0RU)N!Iyu5?9d=fn$?2ouu&A@W z#0GuY8bs#k;>>oqiKq;oH4F}$0%z$Cl~1DedMXx7#s-l2=q1z11DqrZvkcNp+SvJ2 z6E}Z5vaWz;(tCk$X~artc*4yXa{M+f73|dyYW9;!W^;F2XK@n>F3WE?1n*Z~7S_c+ z{H}u>{Fq;EVNEAtU-ZW7>Af7STVq`=3U8}XhaTw-Xs}S=gu*nq3ohY^3OHzZJZ88q z0v|PT_;}TK6M=5GCLT9kj|7>w4ceJ#j|Ba4*dy=>lI^SH*H(S2Y?k6TqvpQTL9Jx- zH|?%15x5tFM!oiomWh;EY9t!Y^A0(>zS8OfQ57o@qKjvkT?Vl=twiN*Ng<=YBc+@j z+z`|7!d~2Qv`M4L>iR7?gK^@e_T_D9l?r!k$k(n`Y7HsWgk1_Kr#EfkfUTZps4OZj zTk2U*{jyY^L)YOAZ6BtaN44x+4FW$j5;!Pj_FVJCdu(5`JA#@EJk1_-nZeM#SHFAl zSH-&In^Fl>D=@$uK$8Z{ey$NV<;G1A^UiAdc~6+kj>$UU$y(+u-r8tNQIcXjXlV+5 zP?hL#3oP!Avb$#w69G>eLZvz5L}1;fyZ|BOKBA1h?CM^cAD?}ZVr{+R3Sx*qtmn>E zpd!*1=I5`Pz2~_dv(WAWe|y)#>YTPMkv-GpTGwyE^St1k!_2ty=-Oj(=H*L=W8-XO z_g?KF>x^s7$OIWDCto*3NmRNy+EZ6dt}G4j*5s_spsnAj{nk=fiM-7WgWrRINC9g8 zqdOUJI^-5ft;)=x>9~kNzlR`C@AmtiTk#88+I=ZcRxb{wqYcnZx2|b3kqhV7CR?rD z_1#{joSl#k)Ed|veF(&57+?JdAA9h!@AARCv2)p))gC<&4UIlg`AbJ-+8_}Tsc7+* zXo?1Su_6vRuS&VE^(i=URTP1ckM*wL(N4A&X{3U&2|H6B)n?7vUFG~9D&mL@T1GWK z0rS;}Pls1IcB)z_Y&g#cUpxwEGV|x?AkIk2- zf`OkFS0$6Q*j|D=czzcxR_#lxiK;=DUWAQP7oX9noQIe~72)zz`L9@7;;k+V6~~zZ z-pfTJM1Vvu2wIFmoulIQLWNAcxOev#2-U0?fI|)Icp>_PktueQQsXlms_$+3OxuP< zONQwK#$M$&R4jOJ#m3h?;56_qVFVrc1 zlsEBBx$DiPWFFP^?E-^OX;#o0>`|W=vkG#sD>qfNAU)MkrZzTF0zv1DDY7PT|Mud{ z{SNR4kBo1V?kQ26?_w_x2?@3-50KJNn`94Swx-(YvYuzCbOM7q%1MW^ks!oJK1>kW zeOkP3u`T1*B*gUm@vC(oJAm&Zq3AV~x&6Z9+|=hql9LdK)H^TpkFG0@Q6qE0McCakE*|salAveo1e=d> zzB)dxc__2YwS|{Aji4NBf(q$UbLY4^w(E|vk#R-!ep5}!Dt0pU@dh9fyuO=g2DSJ9kl_Rd2SKdlA-($C-`zST$kMvJO~2>me?hY)thV6v{Y zZ72R$G;1HM3CcUEj+cm`3FST5gj(0ZJK-flE|xq)Q zflxYNYcJUNwY|-NOdMZ{yTFwsqsjc-yQD$Di{ zV#qp{ythUqmt3(vYg#JX71-c7WNnj|BhQpr?6Y3UM>l^1%}Q}N5GNWj!2aZl=Z)C* zOO+%DX5B}e%zY6Cm5)jKKqHHxgY(i43k>pRN49p;qbC|424LfFceZyH7=DN~^KfLi#hQhk%YR_0hyX>mWjklcfypAYvFDg@B?yGt`jSAh-Y@`2NIU)+Q zjeNxqXr{N7K2)8L-6b>Y~9OM|u}jJl@THuO}=J_(b}5DJ9p&Z+^7iD^m%iQ9_;Z8 z&McKS%>|BbG13yrTN@YSkGBl*gJC#6!3;_NAlhGRfFP=Lv*&l891%+gBq6HxJfJ?9 zya$Y+<5F+M87j`&qCa<>sEdgnYfBwBICwZ4a5t&oraEDr>IKD*L3i}ar^$NgddI*k zYdm(l8sT~BXUmVVXDp?xlW!Yy61RD_aus!sWWg~}99gK&uzm(_uRC!g8b2+NN>GNfw6)5ZW) z!u&^@Lt73fr$^zVRf%tYf{rM$&lvlf_$41y*I1@~;CxMA=wgpl1IEtStJSJ_o|sV) zNr6P3`Kc@~xCiXKw3}=>xQA}EGL7Ks>@5$`IfpPSe9gxz?=ON;i{?PM zYM)nl?F1@SXOovZd$)Qm(2d36S?pG#L#29(@3py!Ri$7blvs>R_Gjdd+V5+W5Ep=SAp%ZkyMLw<8ZOQmI|bc;c^Evk;m52I-9%p zAb1Lz^1bMUm(0M`_tkzIcfT@HBhEs9Zb=51Uj|Sa;dqg``14C66mC1O)^I2Ps^vQ;jr^hhiyysC6@4e0vxW@$6S-qlHz z;Xnre6=R8`siqVP zJwK`aVIAJYwy1DQVRR?Rv0$C(F7(!FimV1_b{~tVhyzCKqZpI)L@|VRX$WiI<1$j> znIFxo)!N_E4Cv{6ADPR$i^571Ug!q@?Q_1jpIV#t%yoFP7t|G$KU!S9ME|BsYMly$ zg3i>)NwKhzL&YQI6kV+`KjQDg+nC@-)Mw6$evb9=nz)KaSN5$KY|RPS4D7jef#{a7 zRg-M7&k#-9j6bnTCAR>h3g-tEMHWdRiGE-1Jz7GLsxyx=_C0tcqW-#$DJ`#1`?Fm5 zIJ*&Y&}+zK{BcU^K8)lMr$$P2_79EsOX{$3Oq;!*pjE1IJ3^zN!Kc*yVcSq!tO~?R z&%>ah8%)4se4w`!fHh2eZ0rJpJ zyhqUW9%{Kp{2iKC z)R>>Q(8iKtXkt*L)B0s8sv1Wu$61^xWS=2aTNIM(2cSKegT%S5WI?w56scNea;x65 z(a!6Z;skfY-l=!5KhU*ey2ndL2iqn7lu0Ii30`Xyhu7DAv}xsXl-gCDwjHdVCo)Xu zRfxto96A*X1{mJnZn$RvK)V@znM);$;dd(4tNDzx%d~ImMy%@=#@H2RE~Jw{qmnN& z+Pfr|Kbe|_9=gz2cMqD)$`S8TC3~8*O~A3Up`fu)b=bUix~Jdd=2ylUiCD$oyBM?7 ztd5FK9jTtZ`le(0wZpoAco}HmHf4JB6O@8~9E1i5t*-Kz7QP{Atyw+DkuxPePiNyr zGCl^#6@Wo4sU&0eP!YRILB|Knid!Gf1sHa@wC7yyJ&t8K z%KnVbNu7Rkt@}xqjQL|Xj@Z8V%5izQ^&Kt^IZwR;72n3Q&Ty(xuj-dwgzfr39h@@t3ssp) z4y)~gF?`2mXm>78Hz%%zH~u$tN?wm-!y9l5I~;zc8*Dv~m~F=CA7!~J>)*l}Q!lC! zcCsjjGw;?i?`>T1blXy?F}4(_w@{J34ehIxkx+cMqW)oRhH}R%LOmm^_RZQ@xoMs* zlySq|wqumM_bbY$$O0vT!=8}|VV7)jR^7mE(f{OpSyoRVkK&OLXjN=LHcchaCgi#! zNNQEBCf`u8$E?|Nd%i~vUp{bB*VK>uS&FZ8-bg(t$y8hV2$?EB0WK0^3T4h){IV;| zJs;LtQ)p2nXjfAxmHeLl5kdLc`>UCDer@Dg*<)xr@Njw1S3dWh_u~-XUAsM*WlA>j zHwNpq=y7r6BnBPDB656PD=Ed=Scm&g3GooPmJf(@Dhhl+J&>xlXg;%g?7QSD^IVtJ zNw*+(td}1P!{$fV%7V9IC68ZKP79|cA8&k;!LzBTXh;_D`xXbFb$&)Z7SDQEK(5L{ z&~&+PrhX`?9z&WP_z=|S$|K}pnX8Had$zN8QlS~OHo~LT7Kt;vvHCAM%h_T#@=!k} zdv|&M07j8*c)cBHHg}E_}KEQ4Y3SV`a=>JfxKUJAPsHmz}@F>S)!8`k`+{g`X_6 z+WemFV(RJ{;k5;%x-&-) zq*HQ%@|Q9Jc)mG_;5=7X($L%DP9g$vZqM*436*R^2U0zXl`fg^43U=^wkfXg{BZr7Jk;K*>KA{B4FI9sJ9hylSNDZ3;0;wbxL_USTU7$b9QY%d z5XV^^h8+TSsa?m{JZOK}@{_u()T9?+f>ZJ{(Sq6jd~un@;kut4-&JTB#+8khLc$OC zXDoXr)&@W#9)%UjVluo|zucq~nh@F75dOI+C(fka1y)Bx*-Yg>XL*vm1SCfh|7O#F z?*1=Njyi|9{LqH#PZFI>n?Q8(-$g_`0O@!?_Fn%Pq5Sm9|GU8dS&9F3_St_I_=I8p ze@yTD?*jiHy1>mkUmQoG*4)T0^E#L?Pt-QSBop zSa?E%L3xddL7A<6ir>MKt>;pvC}9F*>XlO@x9$UE&3X-S2PFqSjmK~B`9!5%_m_>O zM68aM#?E&no_PqO+)fZiU3XtYXy!d8;nK{AFmH?PFkR@9!A19cYHF(lGaQcfVy_Dl zt#N6k#P+F6ba?lhz|Xd>jrVjtUZ+6#9qq=^m9c~vccmO1Ng;qV*~Xl}6I%YXBq4ke znS}0})AAPmIcAYk5H}a5SUzKpQJ1P`P5k&n><$x>&K<(K%>%lk!cx_S<@Qli4J@?e z6Li{l7I1=jlidF_xP(gco^ZTKz>9r~bs&PA8Wm8%u%EHR>6r zd*BUYFz4%c(L0DJamTRNz2b+umSPp3hN zCxC|u=1{rhRdIX}4G9pn8@(2IRw~l$K%6Au*!>6Hnc4D5-?&u23BIxN^@wLp$6Mav zz`g^81JtM@{Svp%;}WznWVYOHjIZ{v$j~*iTAr7({HNtx|n@NG8%aUGq)gp{~pQog^r$ zOmUO0^|zvyt?BYAM_7B2{E!F#tI`_;_S29+JP7(&CQz*n*b|mnx*W$hkCV4|I0eGVjXi%@PYVD@r z-Nc}2>^jTSJlKS|ZX@p;?H5*aNfdPu zZkQQwXlsk(=OjFfSV*<--d!%;TFQ3mxP_)-?~FazMZGR`D3F)QFC;8%^Gycpm@U*^ zvxKZqp!XXNio4WL68x;naGOoOBSmvo+mZz`2q}bk8@9v-ngxDc{CUU$pSnLYJ6Hn# z&L)M2<}bfD;M|!aZ=_DJ!drT!L=n+DXu$=_mLj_`ig+2n_uj`Cqb}?huz+y#OSQJq zQij>7;8dl7SP4W|e6g&F$CQO%atQ&t`Mq2_m4#Pbdpt|4#JV?9MkjUgsCl%?B&}Y| z68n-w%e*BLdIV;M*ycp@c$Rs>ZAaX<+6BABs2h_v)`vJNrQHB!D6W$7mOA-9AIyBG z=*hR$U@s}RmFqn&doepi0J#o21AgNkr?CQ@07xgMQ4Y2k%5@3o&(}2sf_fg$t=Y|z zG1w-j=fTnffmb$I|EtrCLVSv?)Z*8s6slD^O1{bz^zhg4gbpt#Y(j92dkP4}Ey&vq zfc?Z2DdN|Ab;NOPd{ugtV3f58Dgw+@S(s@%qS;A_7udcHC<>*?8acU%g@SM6_C;u?+e5L4ydBfD96Z{SET&xz?E5Xi42%&6dxYByL?kKN_ZcgnKhvx)?i`eIUnB4vM{@W2emv&xxEK_Rh`ngayEUID6GAdNHNUm%X7tK+wl)n1=fsA>Ic|jDlg6 z4v^1Mh$Zk2TqgXt76$HQ6;6yOMNnVMfNR!TmKp=bT`ghfg`dd!gP5D*Xx+*6N!q0- z`*E+9G&wG*fhhv_w%8#h)Zmc(=;z#Q^kY=7v4MT{rolpObo>wShYAYO@Jw@87GpT9j82;?}lT5VM9@nC2yr=84&g9j8wRk7dH-7WhFqeHu-B06@G-LCJj!dUo}>%05Hsk4e)!yY&2|GBjcx7|=kxHhqy*OV z{2o&HFGUi;e4^X(b)nO$tZq;jjUCcHL!ZU&sV_R>wno9>pdPw502(z*S!jOWK$j&2 zV6SZ;lkh8>FZDIst2g%L;z-C+&PW1SD$5yWUyqMA%8+gdnt7Hblo?T7__bic1;~Ut zHePF~-wA$&PskjZ>bJMXKGc=n2KJ2khZ`;Ge`h+M%8E_^4+AWWmj7l$Fr}j~b%A9qx`4sOliR80nRwG44m6ZDpfZ>}Ui=Wt5K z9PW)dxZH!BDYpGUL5Yq5D1&-KFRc0?`i6ZTKcKoLafhxX(i-EFpAMyp z6WqOKh?V07GTTAMfspnOA^6x`LAT|8^%7b=P9MnT_n{<E?T39DDYn44yuT|;EhsJxEks)ueX!%I92ItI&w1#?Ny^j+5IXIXr9S{?_C`cPuSfxO}~ zWHmzY1Hi!UX|OJApWEGcAU?4~2S&DkPc5CMxhP#I)eb`2_A4q7rgjweD+XEUC|{hJyTnY%a0Pp&pdW*WZcu zCoBG1hqaB^{!9yC{y3FPxX9`Iqpr!5W($bBt$d(r<}ec~h93e~*= zpunPN%__7Fw4AR^*kwMrQ))N>9i~VHD=i46X$w=I(D^zowwBeA;ZUi7=1gsO^Qxis zIA;AwoCLA=TmqcjMQlY_Axn+ZjK8k z9$X``m+IOPSJ=|e{ma2T_mWyEv~KlmH>3(+dyeeXlrEA2&W>(p;~*7??dvP`H|t^8|jWNrHd7{1=qY;uE+F7+FZO{iQ4XWf1^! z=ft@{{+HImCyE44-zA^djqiH>r{4^CDegc!h!#(|zuYOj0CNE7;%v~K7yMWF)M)Hq z$K>ujapBY>{Pn>~2S8vgjxm@wf0+Y30w-El$EM^Y(cjt7rxW?_@J~aR|L<16$QIe@ z`8>rO=IgESFH*7wJX54NV~24!p@QL<+$U&$QSDU!)kOjpl=g8!cW#?75|Dw6<3jlQGHN8SmZt*1HZ#_iy7&roosRtet z_DTN5w-Fx!xV4QosLqb=!~9>Y8$d(@K&~~nfX8)0;eRpj^&DX2Td%G<8lKJa{A<#z zcL6DgLcf{qLy6Y6fKf)mvy(z9s#Iu!!|ZaXMO6 zs{A1Ndp+r{$s#*1{OEoQ!1H5Yi2q`e=2ij{YS=c-jmzB)#xQf?8Ffl`o#TVek-tNR z&)g>@v0Iw@FE9Nq9EY8kc@dvoTFG<+;uU+cBDvc&|&}4e5WA~ zr+QMeEla?*{E0j_KRuPC=--l5PdeL`sv!=xWh;H2LR)5{Ggjfb-L-WXt!s|mOV(fg zwCQjlUww{>abE#8JI|8Su@h4;wzslGb)9Bo zN7S8m8T`A;d!$A_+SE2KT452`D6=MAQy=cAl*ISvSz`XNKN0??HD3K$;|;yo!%p%1 zFMhbG2EW!r{@CUqav4myMJABRo6N43AQW-WD&^wF*R`e1kBs83cb+it|HDSFgMo1u z3H+9I57OCAp9Iw_=$yqb&ZhAKyW09C`=H4-9*ka*xf9*(YSTI^hTVN4{i?NKf4l#H zX{^jALu&o4W{_MD%T&4O#53IMY9!W{Ie{%xeq=^3?nQNIwJ zu*QEz5_d8Zp+85Gq*YjQp1GgHPzfKLg zclh+nX>+WFC(}XvIUQLfha<%I_VB3(a6uQ)-xl`2mGlO%@kkAms=Z=+YN}u7%icS) zc8J-2u(u*M8!oe_l18OX-Z*sxnI?_waZo^ZT0a_fb6Yk;?hSoq4sJmbl;^A z)8}_h;Fj?A#M=85jCZa$N`DK0Y{%L;1L2^*_>>8NKO442A6pR!5xC#s-Me~>4o&B75^V)LnCN0%f|lh&JwPNg*Dx0Ff( z6UOa?c6ngz;w9YQXH)+tIR3%~Xz*NAiP~>>AO)yPP`*GL`1aK7I-OYYd5&MY1z#fo zz+t>GTMs&u-a{LBoi%|2+zXz}=ef}4W~V-_Y~;zdp(%iQ{`4a@E&(J$*-npFj^6~b zUN&q65kHtD+*;nmO+=QWe9z@5{7QtBjXV(`Q^$W*2H^LY-mQat$+0l=831;k``Xk* z{FvR5*l~m4#B#B=0B&q7|D8W2_yVjVcx*fD+o@X>06QU*%fHB!cy%r%`X9NGWwitx z>UP)nOiIXi?I8xIlc(dppn}{>#*fOvT=)3L6K3@Re(hlglj$iGAfa~cpB!er3rZTu z&gQ-;=CwEd8N8=#(av#V8@~gi`j5MEBIg}ah!oTFBB#Duqc-4E#V7tvBO?1Q{vFzu7vEr|; zw$~lA3B%=1y;TADiIA~h|AW7Qt?;%Np8xOlEzp2~=%0)S9L^@Y%)?p=O6C`HNtqrg zL@O8vLjnQI&pWV&ygCOMk4WPxKQ(Rs{-EN}OOZd`GVHtKYSt;21|T^n(D{_ydR%WN z3Bp9g_8(0RJuy#z_dx~Yj^+nha&@IhRaqt4*m;}F%i-S zpYF6Af==|o&Yv~~AVy7r9LoQHwD+D-O{QP_sA54tz|paw0%8Ga0@9QaP*D+S3Sy+I zG${!^k%S_mFg8%>U8G43JwQkRkzOK%o{)e@4IxMi5CZ1`#~H`pdEfWLS!b<(nJ=s? zR?1!WzV^Pa``Y`VSQ7$koXGiBk*en&SYLS6p1f0g=%d|ECvCzDFv>R+&;N24X*-yF z&#QN{_sSm4jqv02i+lEDq5R37cA6U&bRKAXtzCaYqRL9kOl$dnWMfo-G5_`+9<;20-kjwK$cJj;4EE63BC{0Xldzqbp9B zmN@Z{fQAlI{Gd&b`*Iq=y|s#3(-%>dNDwa^qW80o>mF|wl93s z@4swxEPAQ)GbRCxo4{-P{?+zr9gqBT8!5uE7d#u$5z*g6KraDH#6X>U! z>Wm8yHb|oJM;1K*f&YK&T7PCX&+Jgo3S0pR_sEcD0yj!!`*fb_)c1rh`NGHT(~qAv zCwTZx|K0GY&4a*2j-Gz&`f(%ajMxL9W~78?$vmUSeD-T&{Og^5Y)`W^9iJ;eB{;Nq z?te0=9Nvk;7JB_#IX-c-@Mzu$XQRf@ls^#=hRtG0s4 zPqlB$pP6@AkG15d9N9FxLT&&XA|AKgq`_g)LDVy^?;z1G)LiyCWx zwDh76aK@28_0@kHBe&rYiLZF-6ic=eK_^eXj@)xBB`D?+LvULfGvdjGOS_)D-oqjC zYW|YW_?f#$$oZ}eTpVF!I^M2D%4FbxJ!0(hvhRxbOwR58H}mlWHtQV^(y~3V(~5he zR3N(x-NTPSb|mEZ@yAABvi(4Qb>WnTZxUkZ_>=p!)4n7zspzz?4 zna{|w!R^}zyj5<7B>GGNH}}OXuAQn?CZv5C{NvKwA6r8$?~~ysc(7#cdbjfn)&;WQX8w zhMWA>g{vE|02)3LAhrowlK=rm2a+|qK-8D-c?0kPF0ugikm_bwypaw7DgijP{j^M$ zm1=IoQQE|acy@eqYI(T|y==gBG$J2zok0N`1})CZ%QQ60R7S*%ZT-F_o&agLC^2Hy|5>>G)|dMuS6~&Tjx&OiBbH7IPtiy}+AAI{TXgwf8(?>r|dc4{io3!{+Q(UokHf? z*s|Q;e_Csa&+o6emn}qOr5M)p8Ta(XADrsV*MOA+b;AYLebe4iM>iV;U3k1_UwTN1NOU>y2a#E*CGfleNj*=fwhX7z{b- zPm-6d-E_oHdq2ojHJCQ_%4j)jdpN)ZCUfZTfPm*_xQv%DeAz^3`J(Hxd8h zCN3@*42FfO%Ww)7IoJ81DaO(O#z%H#^)$>2xPNWMh&CnLyLxvDY*(vATlL)XIX^Hg%l>4Y{|p2Q|9Z3!WmVu|U!1 z>@$N-INZ4cpCD`H;#a(*m7o!;Q;n942u}4ch8ka6dR>NuhS@@{J8RunvI^*XhoFbY7Q2ucD_f-NapnJ_50e(Y`l>*)6{nJZLxYqAy@<*nzqo*!MxJ z6RCdJQ@Q%KF{i|O%u#Pv8C@6$c9q)f9|2$IiFm0>-)a6?rr#>2Z9d`Qs;~Q5`y4aR zR;Xu*uF|c;{$`A5Nf~uWAm4!YnaWvP<3d|=Ev1Ja*L|+)sZBieT1~GE>!C*7czf1d z1WjA3hjcUn;C8bNTk zF?x@dadg8HSEx->n0-gS70MV33#eG=K8Y&r!~4B;2n|!YufFH>ZNMb6?64P{3AZQ`C-XzY3c1^+ik?YGc>q^zER1@0l<(mBur!*0b z!SSGxg68@rAVG4xxTnp>Gf6EXya62@Ny3hb1Xap%c!92oCp%~RfSiVeKef< zc)tP=7;KZgm({(13am2kSH57NVUxjukQ2N4*1@nJu_aYxrV$`_!KBSJ+Z*@$A4f`? zTXgL)6z^21?b>EKoK!fsu-8BS%ynQ(e;1ZH12h9R-(vFE;%(;*pbO>a*eB)}t3mUM~hPkTqsROSHTUOJWBB@^;hwL?LwFnzX3|o#q)W#H{jXUq*%Yv^A|cP4Dk) zW4P(&m|_Za1%q}AJZMqrwJ1L*ZF1Z>#7}t)ZzD1HSz}Q-e$w+zgl)r-o^O;TE=JmI zpM@@rO`qn%K!zbFwyna8M^}bmXh0heI6agR#-b|;ReS_Qi9+u&I`gz1Qa7_BRnocx zWO!mgDJf#bf_5)ZgLv=J0T~NhP}NF^7r$M3qB%yG>2A=VM0Oor$-*@YJH@QfP+GC~ z80387{4}n~V`@G)C*7&0oL8tQeYbKV$#s|#rW>o=oF2%3V4!}1rrgh*Y%v!8+V7NO z(|@z;rl!#Gl`=;wN-{v^MJ~@BZ0cm%T34XY_n_+f94zbx)abfQS(>+JdB4ZtLDh>nROX7$ z8m4kxIj8ru(h7$qmCGLJXvKj|+6aHCdpC{&fD@cP=|amp#Uz8T!lQ)8sNk{d85tQ` zf>@f!!c5@AMt!L0657Tr%cq)Ox<; z_cji8^8J#?w2X?1Xfs6Xm5y|MnIjL>71Y~2vxyWOs$aMdF~HVXuItf{s19I;72xB#%6O-XfU;XhHK%Cf*^KY|j z?%FSzKX~ktu1D7m835BmT-m>|vD9_N;S$9yZ3$pPV6m0DdntG*kFq(%c-4OTfiCb)O!J0n=NwH=Qs@H7KMWX9O19q9Wix{?dN*kKoc z7Qf#rHqNUKGW8nauC{c;r04-m&tv{9qfhkgy)V|w?aAu;s1R%q&60jd3v{jHo996( zGbdDZu5A47Nh3e-#kt``)e|d}-TJO-VozZwDq3f}O^Nc03q2N2Oe5#t+WD|C;mYB7 z)O-nBVH}svuQtDrwai=Dz2gR3ClT2+27PgmdA?`MH?s5E9$&5QWuL{hFf*66=rql- zv+}+y(RP&&vS6|!j>fD~UpwChzrTMqp>cm{Jha53iKj0CMA5;8(d@He)zRL-2h9& z`+ZD4`L(c}!`nwJ1s=?~YpQNDGXt*802X7x03eHUwl04YraA`9UWp{%^@}SFK&ZnN zKTH~ZwDVmsZ5P&AvC{L?q4l<`tjO!F7vP%GMGQc9iNdie6Cu+85!QR5tX^pUY=H1u zi-o<%2-fpV#h_Fl$xL8{Excx1?+jP3TX1Oh8jCxl(y2Gnozu~}J@K4BkZO#7ETo6e zCW04eMUr)gKk2P}adiWdvzTF|9NppRbY$QYM>PJkQ1V({hn0Ki+BH>1ocvVCtYu8k z8jZT{{=&d-fip@^MXy+hN%rEIsz}IQTI{3BLQsoJ5cYw-P;UJg*(}H>atfqb;fZ5I zC9K8V*1IPj_J*A$b|SZO`abH5hDOa)RXCjO@3m-bxld5JD-C>DN3$!2oC$Y`E3DtE3%GaHXD-exx(~Y zv-ABUO&FtO!>+Eu^i{bJ>oQ{`Y1$o4_^A#?^o_hoGLobrfG%|i?Et|l>&%AiMS9E- znmKZPL~fqerQKvTCdn(PCJv+uE$|BG3P8qwG-s}U21C~;xt=)Y;;YE`8GHshF;&`K zzW?!XEcIMpN$2Mw|Hp=51g-qFLfUa;9sfzzgGbiVxvLM)#g-w|RHZFV7N-hs$VOAm#mgOJ8h2(p{j-TwKDQ&m`NT zuID8d;?_+EOSQiZyoFZITa#+|DfgXgme=?b8cJh?>}cK6bUH`%{^!e1qkww4{F%c^9S9efF(TsgJMNIgPdBd05~I2izmO z$zJtnZ#^hm_^KwJ{%*R0ZQ{NTgOs^ub0N|);$qESKU_ITXl`Ej82}5i&=w<0jaJNF zTT;I&_?-PNpbx;B+ejD276&n4XyKOLJCh=7xyaPjI`KtrctP7J+|c~eqd^^ymK)X(%SA$QeO zNi5zw;(lo=0bAD_YJ1QUnG7u(>UP~a4+Z|&{+UY-qld3Nd`m_y@uuK`iGyj|>du9- zDr_9y3^~>4Hf`*m#lg~ISh4Vn_R+O3PGU~)h4k@N^x)zsMuZdVy=S(+sdH@Eas+2V z&TZQAef8LBaMXmv0`F*wHH6q=uI}DPiDm0Zo(6kmFeBB0+dcypL`Tq3M2nw{$L}+E zqA2eie0lGJr`EdeFK!$68 ze#3T~U33qHvEB%iMI5_xL*+)VyOn66n;zWl5w3IPz`(D<#+IQGBQ&9XE<{kam2rse`X4*=g+MtqZy!EBLjnUoMUUt z2-9{suzd#c`HS3B%r=|^w66;i?;K;r+{636jB;e-tc<&I+^h!x;ab=UXwWwKdf(Aq z%l(kb2k66tuNU!Li~qPwKeHwN3;<^v-EzO5ADcc^1v>^+fLtbk*coW|X+);F(&4b}pMpx;wu; zt>o)xM#Y4@ZTbKxVWPO!SE&#<=AB&|KY{2I*(to-ZV2!UiA07zTPWUUTDfOUg?tOx zF@f(p7ANfY+k;&jQMy>?rzi~`QFEc{E;jWb@CX}|Lf3;Q3(OUFpRlj$ewU6D;+GSQ zn_$PN*mLUi3-q|T>$}OiI1&mGWOxp}R0n-&ET+gxncgX;H`qNpFEMXy=iLQAlrq;J zW~4FyRh&5Gmz(ZlKAM)VY;guj@CqBo+f0QorhMEFp}Z|em^Zg?DeaHDy9@DtxMYZf zc`7OND6A~-AiG)se<>#(X)gx4nGR41#|}%q*TZvQ80@yOoO-`?oN{02h3cvtF(2Rg z8W2=?jS7^`P@}!68)swxNKDsv9V=Ehe4IMUY~VNXL*8 zYZpT~&up8M=UrH`JSKf(icumhwUc+qoO+#1nB2^CTKnMp-uUzbR#UA?&))rmz zHo9GyUnM0{>5XGw!BgCQkk#l>;;of!q~*7K>$B`2*gkqH=um0#7?}jasW=9mucnu> zT84MRq&3hlY5b135QzTH@w}VJg)1oDZj?!}d&*#lQ_rWh$2@4l`6s~<^v81xY3_xm zv?FPT@TP-X254V)!szqk#QLMQXjl+~4kz)gby1ql8DFZ$3c-sTzJgG522*tWO&R;x zN%j)CVw!7921P75^=!={dzooi6Z5=ytrEH9qo2My{g(Xir0PY=+_TWMz=P?njxV^N z=f4%%&k7#xXxMS1=aUNk%5Qe$XX!jLLRP4c!AobcCct%J6uoS?>)y12lmqoQetn#1>hx5v9mO1Vw`Lk}wzwGU^^KA`$Vy4?P;QNV9lXPKG7~Yi0*Wxa; zIpzQ=SwWc@W$DtspmGHDeD=IJ{74_XX#n|pV(y4wXi%!`%;$-*^+-wDm9auCRy!WKXODlF#rp6t6{`zXk+FV)QQlt!(o48x~ z;ZxH{$C;z=YPh0N@iim_8WA5l;VsUAk%WK*I#|e_7*s=mZlyWVlwPF?nr&1n(|bNI z}-t2Zc4EPYZrX|#0Ce2cWGi?HX{>i1OjzQD%jV#^V;cs|c#?NwZr4=XCK&%XG93dj^qVdLxb<{*c4uX4lw9W8yFo(YoWJR(ou7VD z$#T4^EV#b#yqWMD^rHYDS!|V>?>4Jd-^b_cv3qDH1ya4Bb^(`el77w~3*5NEbp{9T z6b;QXuwz$AyVojsa&@IU@@t9_=HO>8^aVuPKu>~6qpFL#MX}ZjPo=J~goNc5DFqiS zYP~2F>!{=02Wy!d^qm+sZ(ZdtsJZ;K{u>|qNF4JA1k^eClLl&H&|?q4Ww&6{Z+L?n zb4RW&$Ni4w9neeDqH^}j7gMlV3?mx11{1uMxk?R0O7QkO509FnPCRO}u<^ZTi54?;@&?OM{c7Jdrp(( ztOmPBzeJj^m31Un%lHpAU6kTX==ZYbNKDgCRNSgFoQ>1f2|hA$4Zj%3SMI@Fi=Oe^~-V7M!en#IlKqpNa` zER<1~D?C|!92h)dzMGr=RUg&Y<{?v5va{V(ti+iLL+|0-X0>^!_{=6K*+=0AE99Y3 zz?`b(au*c)YwDq*2-v)WmycuL=dcI9E+X1o58}Q04Ye9Y0;$Z=yQqi@tKwGIr?5P@Cx?!UF z+M)9!UkRkpNMx+e(&c0!QmW_{#}^`Wv<8a~gw@1Wvm^skUNb9LdtXJF!L;9Cev$7P z50XiU%5A2&n6NVlz9EtrIMZkI6rWzS2LS34rj>(+mr!ZwX=K*LG`+F;5#UC_t#4^n zufhGA)YZF~O$fXG1Hypk5QK-%gy$YelP^@W{UdjgPU^EFj=t@`7ZqrB(4~e`5ZHTn zS33D>O%uSgHUWB;sr}jTG-87PHddcd*qBdg)!I1KK_!OUa;O{XaN(%?Ky3%n<9*uj zNtzE)+O$X(=f`}T2{m$~vP1e<5vYa9Gj={86EtQ;L(gy3!I`Qu!38|7puhbNCf9r_ zr0va#z$jtQS6}t!hULA{C3p+;c0sop-^HdEN`2}N~J)XWqjqsB8<*z*=wha||6;U8-z$v6TR38kXS^JZMbo_jF z!V+2W1XD~r&=2`6bi$SGc~DDp4iQ)O>H>&OvDuq*IPdx_Ru+WT6Km=OE1gKl zhS21rAB6fq%h7Cu@i7Dar3rV!>g*MFqsk_HN-rZqhtxIZQAto|>}Hu~N%K;K)`OQV z?ns$RNYc4l-<$~Q7dc#PRZ!o;^=5|Yn?w~ayOcT|$wzoNQA;fr%kub8;FXr{0d`Fl zQ`LNRRP=CDvDgAjc-1v0^vcujd>BMuR&~CrwS*81klG4j-jHiD@~hM%wqFBv*e}N& z&*}onDl99C5wF8)a^Iz(up#p}EVd!@SVD>qav;*;dnAh-b?wftXt)Fl1TaU|@exX+ z@U))Gyn7FKw5bkDmL%ujJ%4yoaUN`iti=tNIHvUP#)Sg$-%-H>h)*J;oV_<#Coacc zaS(Gl9JY|ZXbW5qz26DL2>UR{rNyE}X#tCekByA9l8KAxzz}N1j6t_t-2!LqVnr@E zkG58(<@aGy7F4OA{vMLM^6=qljM@4q&!gI%uz|X7^@33S2jgAd%JyIx1+ks;)=i{g zs;9o@8Vx8B4qoa7a*^@@GoYr!(cO%m?-j+h>+o}O(Y+c`Ln`sB*PKP8huf*iv6Lui zsZZkqL<5sxJ!!4Sy(4{@=RhnfeEmUC4UZZ_XpH9_40qbES$E8xx-u&6R<*|JeY1t^ zs08hI3K}AkuFj{JxJW3tI0`&&5fUWE6weI zNt?!oCn6`g-ZNitih<>_**C}4Y_N9t*D7$*xycV2U$fGR- zZg|GP)g&qiw!ZY@g2sW3e8=aztmfU8t?Z$9R*o2lK7#|%_w0%$CW8e*+@~`ZwTmL% z+0}=RrWY@o^d+`$>8hQ-kPT_fDuKxhmgW?Q2^Um;89sHmQ?e!e4c};He&Ey8Gy$&? zK8l*J(ST~lP^$!TK|v%7H?hMv6u6!`O$(VQ?@NAQsx|9NGfJNxz+QVX+G>OU)|pk1 zn&1u9ppM~mwGZ%`g5cA#(&o3vD$+5X^&?Hh?gJ~vj>Pg}!N=EG&NJt`78Yj(U-)vu z6%rePo(N+{MO()ZFDN~hH`@*SqxZRG-A3m#0tR#T^aWRs*%|7`z^6Ofi^?*@0hthLr(||zN}XTOg~O#oLBRK3@jBh7Mxt@{s9R z-aHvGm--vl--{prRFQ6oH7@}rXnS@Q{tZIkUxi(IBs!9MBW3qbZ`}mS|N8w^=G<4B z{t|)yiK@p=UKr%_mwoXM;TN!1;sBEW`}O~uFV2nbR1`I)sVOHT9R!phgh(pqUI*82 z`_*Lj{2_J&-f*wJb6gufO%`vCK<}}q)IJ@AI}H3u;IfCUxtiNyVjnGk z{jx7Sy(mBzXn)E_LL$YUD0*oyIHW=H?->65)h?bC&ln}A@ngpLq-W+qlH_|5|LiCM zILIGoULPnWVVuQuO(4CHeWl4K3Pit)=l>qlJ^!Mrfl^niiO*Jf=0R10Y4`ux0R!;G zaSnTb?3EXz9ht-}EC&vR$K~$t)t!I4<1s1Vmn4x3uXAh!=|H)S?EZgt%K)6?^1*96 zrhzQ=+PbgLc&ci-pyOX*{?F08HhSkY^BL!8QVcuQ+T2XPzMCha>-mnq$NK%%lj8yRNYfFG9p5ItD_}>e|6@nEf$lB`VfB)mwG2OPL<1lLZ@XT@@#_x$`~L5X^zZt7w~YUN?BPZ? z-klmV*s(aUv$wD5Rn}wuxkG=ISNw4I`@l_%)!lrFU!mmYjt2%pM$Z?1@{rA7`G*Jq zg#NYv(Ovd3P+y@Lejog+`~2764?I*L^$!0p0|JtO?bC)*2)n79QUCp`9}|Awk|T z#>uSmj3PD3%5DO57v1Sy$EkRnR00ieYP#N6bT2;p4!$MZHet7}hFUR3!I|<=4QoB* zZH#wveemi*p>B*)cEM_uWm$gb_8H6LAh@;q;tb8hcl-~Z)QSq# z;sbNU*-+5IMoi)4QdfcU_-oz^L=TQ3Y z^wvs$Y@J0aFXL`<-K#6HaL#l=66TqOITf~6E`I1bKz*CH?x*{*Tf5-yZ>w}k7-(o~ zta8lgS5k^`p__eId9ec5l(w$!s}}j{+h~cg*p-+9>_T>4mJx$2jxAYQi6PS z*R8f9_S}XrbaE`ZKfF6R4%TJJJ9lLk&wuFEC<-PQwJOLb&bFDR^{v-$9gx_B;Fc? za~ig%C(fT;pST6R^zBK{dTekYP8!Op` z8tLa$_c|K3Ka8iK5Eb^vE8ErD z=Jn^TBtt2qDVGTpAH!NH(}EkLg!uRvG(Z0?@{=vp3bNe6D&0?dLVvc5iIMe z6Do$k2jV7*y$|Z>YzDLeqj-9C&DFF7v+@Ucsim2K4O?d~9tFg;%D+X_y_h4E&_n*Cs7U?K+RkQkJ&lCU)>E!S2*;jZ4^sDw6vIh5GO$&bmR zfxm=Od|Or5N|%v&ai#TXx?h7rI{5nGij|4-b3Vp6H?O>g%j%*oV&%x*^FN2b8Ic(+ z&S^Lu)G#=NO6QaA)kczUOmg=j)-_U}3D}vYFE~PC6FSAPSG?Bwl$k!5v$zmiiiWFh zql*kY5(Z9LuM&X^(v8_TgjjEVf1H`VP-z>{16$74F%+p+a+vowpj4zv>jlXYEt+Y~ zmj`oY6l;C|ff$Y3)f%e?KJD&O^!TJUYC-E>eCTmH2XN^(DkYaL*(VoVwe2l9VQ3>| zv6M8S=nZpFqXzhH(POuln9aprxc3N7-StNN8blRvcd&1C~ zK53M(?9E^9!4PLNkH(omKOPzGKyL3z`m{)442B>T&~FeeT#unfriL_xYl^(*ser)wmEo$K;oIouj%*OrO1RZSj_J!(W{Rt@zm=sga}Wt+h;6~ zC})S-8;X`0(JgWO-onJ}iu^JpI@DsQTXJA10~kXvD?XHT&!@>w4MnMjllY_;L5Qp zKt#oM8o9{Tue2@o*pNyxJKcP4G~~Zhs7Y5;uK6$#Mq6{iUi!Eu;v$xPsaNnH-X!xm z(~}eu7~5Z*gJ`*Nd&uPwnTI~^MBT=(4_5SdX{-@@o-OAACH)&=XuSz`A@m+q?hgb@>4D_gPfF*fEdKAwIWx z(P}ghZLEwBnvl)LPMp(8*Qv2RCE^kp%_`N59_;~=CWZ>%z8iKrM7jK)sTjhHvzYr8 zZ$dTF#v-}6p*y5*FgM@*e$ZCpP?bk!2E~~6d_glSbxlDIhsF-o&T9!0OhGE{hH+H` zUGs4ina}P>;AwNY^*V!aMZ!Oh+7E7UREzckLK#-BT~m`yzgb^xtNGD*EIe}SHeG&7 zniwp;JC;&u7iCcuV7Qk9Gp!Gj*IOJMN^VIuXJv|U+7hB1ROGUJ7A%5hJ8WlE%%bCU zF8KL1UG6J#t;zM8bM|v5o0l)-%{ksizwRSawWXU^-?i-4hrb(_wNa5aK4*ELZT(oW z10d8DDs6>3^>B$;`$F4}a$QsVzD!*QyZN=L4BMmQIcbsK2ER(WI8#en6_VO0)iKjG zi%^m-VSteWPsi8`QHa~S2UA+H%Fy1sAV*@>3bemOu^J9R55sUzg?*1{A817sz6U2V z+^dp0O26eM;cW>I^}DlI9#+hBK2PGrvG`sm>__$5d1k`|3rX>xcI|}W2;QW{5Rj2$ z=YyVeBQ~$#@lr0elUf1Bqbb#ayTy3PDq3vqK|P1oJjaSn1XqcWv7LQN_7lfapl57%BIl8qYC5$ zSz?Dp@eAr1xw(8W(cxhi^e8di*W1rq7HB8oI<5r`&b_GKD+MmP{@#v@{47@p&i4cJ zHxhAgp0HTH>LOxZn|XP9%&TBzU9>_<<}&gsxlY9uIu*jJqw~Sy*$~?#YC)83s+fPNXf9Ly%y? z!BRvFU%SV6Q4`R*z-{?$NX*A{Pc?38ScLA~p`dBQ)h%gi%w1tsR$NM+}HYmR4t zYkEv;Q^J@@An)y&^%KZC~xZ?Q*XqaO5y(a-0i4Zh_MfMN`ms73x_6ubWG z@846Jd_Dg^p86vP7@b_+onM+FZ}I;Ca3>!OvV(r*PId#_$!@9JKOc!V?DbeCz@7X% h{Quuq-+!GGs#@4KMBuIi`YmnIx}tYE_tM?R{|_@++D8BY literal 0 HcmV?d00001