Package File Formats

Humio packages are Zip files containing assets files (e.g., dashboards and alerts) a README file, and a manifest.yaml file.

The file structures of a typical package would look something like this:

humio
mypackage.zip
├── manifest.yaml
├── README.md
├── dashboards/
│   ├── dashboard-template-1.md
│   └── dashboard-template-2.md
├── alerts/
│   ├── alert-template-1.md
│   └── alert-template-2.md
├── queries/
│   ├── query-1.csv
│   └── query-2.json
...

Below is a description of each file (or file type) as well as a link to the JSON schema defining the file format.

Getting Started

We recommend you use Humio's export package feature to get started with creating your own packages. See Creating a Package. Fill out the form and examine the content of the zip file. It can be a good idea to check your package into source control and maintain it from there, rather than maintain everything in Humio and export every time

Understanding Package Scopes

As part of the export process you will be asked to input "scope". In Humio's package system, a scope is essentially a namespace that allows multiple parties to create a package with the same name while avoiding naming collisions. If for instance you create a packages called accesslog-parsers it would be namespaced under your registry scope (essentially username), allowing for packages to be named:

humio
tomcat/accesslog-parsers
nginx/accesslog-parsers
dilbert/accesslog-parsers

File Formats

The rest of this page describes the respective files that are part of a package. Most files are written in YAML and are best described by example. We also provide a JSON schema for each file (Json Scheme works YAML as well), you can find the Schemas further down this page.

manifest.yaml

The manifest.yaml contains meta information about the package itself, such as author, license, description, and other meta tags. If you are familiar with NodeJS, this file can be compared to the package.json in the NPM package system, some of this data is exposed to users when browsing the Marketplace.

  • Author - author

    It is suggested that you enter the Author as your company name, although you can use your individual name. It is preferred to NOT include email addresses here. The schema supports email and contributors but these should not be used as do not get shown in the product UI. Example: Acme

  • Minimum Humio Version - minHumioVersion

    This is the minimum Humio version required for the package to work. Example: 1.30.1

  • Licence

    For inclusion in the marketplace Humio requires the package to be usable under Apache 2.0 license. This is the default choice when creating a package using the Humio UI so does not need to be added to the manifest file.

    Note

    Any package submitted to the Marketplace without a license, or with a license that is not Apache 2.0 will require amending to include Apache 2.0 license prior to review

Example:

humio
$schema: https://schemas.humio.com/manifest/v2.0.0

name: nginx/nginx # <scope>/<name>

description: |
    This is a brief description of the package. One or two lines.

author:
  name: Thomas Anagrius
  email: thomas@humio.com

logoUrl: data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAQAAAAEACAYAAABccqhmAAAABGdBTUEAALGPC/xhBQAAACBjSFJNAAB6JgAAgIQAAPoAAACA6AAAdTAAAOpgAAA6mAAAF3CculE8AAAABmJLR0QAAAAAAAD5Q7t/AAAAB3RJTUUH4QYRDi8JF3cKHgAAcRhJREFUeNrtvXecJFd1/v29VR0mbpjNykgIJCSREWBMjiKYZHIWyZhosA02YDAiGmMbY5vwGoGxweCfDQhEEghJSIAQKCAUUdhd7UqbJoee6e6qe94/qqq7cugwM7s757OzXXVT3QrPc8K9dQvWZE06EBHZKCLrV7ofa9KdqJXuwJocPiIiJvBU4FXAsxE5MHHhty6c/eUVTbSN2BrRtmDbtmgbsW2wte2mefmWaBt3X6NtW2wbtEZs2xbbllZbtm3htaNtLbbW0t63xNZOu055p6zWIKIRNIAgINiAeKeBYHm74pTTbg4gtlfNTbHdNnDL2e2y2CAi0mrXBljSWmp2bVYJNzxrhsWVvm9pskYAa5IpInIGDuhfDuwIZTLz88uYvuTHSLOJD5B44PUBnDb4XbAG0nQo3wY3zSETp45LAB7B4CMF93jusbWA6Db0PVyLv/++BAkUDRYUf3I0HUCLsGg3dd1uKBCFQxi3ANcAvwJ+hskNz5pwCWcVyBoBrEmsiMgY8FIc4D80q3xj/z1MfPdbNA8dbAPRA7gf5B6AcwI8QB6t9A7IRWsnTQttpBcgBOeihMq1CWHRtmTRqoPoLExNABcDPwK+96xpDqzkfV4jgDVpiYiUgKcBrwaeCVQL1beazPzsEuZ/e02KJeCmtfLjAZ5kCUQA3gW5oDUi4gA7DyEQ5ABEqNu2LDTriLYKYcmlIQ3qFwLfEPjGc6fl0HLf8zUCWBNE5P44mv5lwLZu21vadSczl/4Ee2E+AtZk6yCkxUNEEQfwRHLJsB4SycWzEtIIwblgNLWW+fqS2HbTyH2dfb+CCu3TENSFAp8XpX/8wqnIUfsiawRwlIqIbMYx8V8JPKTX7evFRWauuJT6XbviffxclkCcj68ziCSBXAKWQAFyCRACWFrLQn2JRrMOOfHjAhxc0Lf3g2TgS7tJUJ8S+K+XTNuNfj4HawRwFImIlIFzcEz8ZwCVUAEad99F/Y5baey6g+Y9e7D234M1eQg9N4PUFhCriVIGRrWKMTJKadMWStuPo3LSKVTveyYDZz4IY2S01eTibbcwf81v0I16go/v09g+SyAuLZlIQi5CXnKJsw4Sjq1tS+bn51msL6qgH5BwrVu/KgbwTnpwP1peYLfA34oYX3nFTNPuxzOxRgBHgYjIA2ib+Fu99Oah/Sz8+hfUrr6S2vVXs3TTb9Hzs4BqPRitB0QRSVMqtI9CmSYDZzyQ4cc9lZGnP4/qfc/Enptl7qpf0pycSDDDw6MBwbQ8lkA+ckkmnGRLwGZualLmpyYQ287ESxGAQ6I7ELQYhBsE3vGqGeviXj8bawRwhIqIbKUdxX8ggF6sMffzS5i9/GLmfvZj6nf8nvajGgZ25yTgTx8480FsePVbGH3WC1i84zaW7rgNsaz04bzcQ4nxAO8VuSxMTsj03ruw64upOOlE2ye7BL42JNiGwNcE9Y7XzjR6FixcI4AjSESkAjwdx8R/OlC2Z6aY+uEFTP/wAmavuBhZWgLSAOxPV4EHxE0qTAIKKJ94Mpvf/REGHv5YFm68Hl1bKDaclzga0OVcgZhjL05NycRtt9CYnswEfrK2T/f3U8tLahsHBfW61880vtuLZ2aNAI4AEZEH42j6lwBb9GKNqYu+y+R3/h8zl/wQadQBlQH2/pMAwPDjn8bWj/wrjZlZmgf25RrO84M1yUzvdq6A2DaNuTk59LtrWdh7VyIu8mj7TIDHtSGFCEUE/glDvftPpurNbp6dNQI4TEVEtuGY+K8BzgJYuP4aDn7ti4x/+xvouZkYoPaZBCLp8SRQ2rKNHf/635j3ug/1XXeiAzMIE3z8vMN5qaMB8eRiLdbk0LW/Yeqm3yl0fKytl9o+0IZ00kar/iUCL3jzTH2i0+dojQAOIxGRKs4EnVfhRPNLenGRQ9/6Gvu/9G/UbroeSAOk839+Le5PVznazk8CRrXK9k//J0OPexpLe3Zjz811ELBLjvYn57fJRZpNDl79Kzl01S/QS1E/PyEy38rLAGfH2r5gAPEWgXPeNrO0q5Nnao0AVrm4b5o8BEfTvxjYBFDfu5t9X/4sB752Ptb0VAFAOv+vChIoldn+2a8z/MRnYE1O0Bw/iFgZAM/w5/POFZj47bVyz4+/TzPGz+9G2ycSguRvI6sP4TaAPQJPfMfM0m1Fn681AlilIiI7cIbtXgWc6aUv3Pw79v7bpxi/4BuI5bh/yg/MPpKAU7bHJDA4xHFf/wnVsx6MNOo0xw+h6/VccwX8LkDcCEHcXIGZ226Ru779Pyzu3hl49nsFTkjX9h21kVLfu9ACewUe887pxZ1FnrM1AlhF4pr4z8aZnfdUoOTlzVz1C/Z85hNMXvx9EEkGWCSdjHS14iRQPvYETrjwVxjrN4II9tws9sJCxtBdxnBeaDSgdvde2fX1rzB9zVWxwM+j7XODswttnxVA9PJQ7bKA8+4h3CbwqHdNLeYeJlwjgBUW18Q/G2fo7kXAmD9/5je/ZPffn8fUZRe10jIBFkknIz0fCQTb6C0JrHv2i9n2j19uX5dmE7u2gFhWymhAdrS/PjXJ7q9+Wfb/6MJWgK9f2t6bILgM2r6VjmqfC4AortDwxL+crOWaQrxGACskInIMzvv1rwZOD+fPXX8Nd370fUxeelEQgHGa+QghgWP/8/sMPeoJ/ouEbjQcEkiZ0hs3V8BarHHX178ie772ZWXXFpzm6AM4C2j7ovMBvLwEbd/us+/mCCBK/dtfTiy8mRyyRgDLKCIygGPivxp4MmCGyyzuuoM7Pv43HLzgf9qmPqwKEohvo3ckUD39/pzw3SvBCL1gJ+K+y69TfHyPBCz2fuv/yR3/+ikaB/erfpnibW3f+Vz/tD4ka/v2zWgTgVs2SAR//O6Jhf8jQ9YIoM/imviPxAnmvRDYGFeuOTXBnZ/8W/Z+5QvQ9IJ7gFJHPgn40nd87n8YecofZV3UFin4LYGDl14st370/czdfIOC/mr7ns719+X5tX2bCKLavm0RqEiaODdrAtQZ7xmfS11wZI0A+igi8mrgPcB9E8tYTfZ86XPc8cm/xZqZSgBNzEQclp8E0o/ZGxIYOvvRHPf1Hxe6zjM3/o6b/uYvZPynP1L9MMV7oe3TCCKi7UOgD6a5ZUNmv9868LXzjb8+NP/itGu3RgB9EhH5a+AjaWXGL/4ht/zNu6jddguQBZqjhAQMxUk/uZ7KvU7NvMZL+/dx80feJ3u/+mUlIj0zxeOG76JtdD7X38srpu3jLQDxmWbhoKBb5snvPTT3k6RrmHs1kzXJJyKiROTvSAH/0t17uPbcF/KblzyDhdtuCT4EEnpIWunRB9xNjinrT5ccbcelS2x66jH9xyp0TF89Lcx973+zr7Ntc8N57529/av/qRqisFCt5X2dP+X+xaWllHWvnb+sZLab/3iiHNCKC35n303D/fPScAlFhdLCbZDShuLvz9u6PhHnJmvSM3GXzf4c8Na4fN1ssvOz/8C1r3shczf8Ntnfdv9LsgQiaZBjjn9vLIHMY/bAEpDFGutffG7qtVaGwTHPeHZZhkb37rzsZ0N1VTbrqkxDmViY2MpAK8MHCkJ/PrBIXHpCWe9e+9JJLN8uiwvYlmZ2Ntv1vf3WRXHLKx9RKuVe9HYbTj23H6E2nDS1XRS3XrJQvyH2OrImPRH3Vdz/xAn0RWT6mqv43Z+9gbnIfP1oNLz1m2iCH+EkYJqceu0+jNF1ua79PZf+dN/Fr3jxOqtWG04rpxCU+Ax1EdqL+ucfIYgvH+/bx/vxKlCmtU00oBdxE/CRROA4vrbDbgLqJtHWmR88tOA35IA1F6AnIiJDwLeJAb9dW+Cm972Tn5/zKGZvvD7GfHYfwESzOpjuHi9aNqmNQHr37kBuF6Qbd8C2Wfrtr3Nf/2Me94Qdz7niqvrICSdOpt4nFFoZaGViqxK2UUabFbRZQcwyGCUwSogyoWU95Df9o+Z5yMyPmuc+E1/5zP4kE99n5qu4dhPaUNwPs/SMuGuyRgBdiohswFnj/Zxw3vjlP+WyPzyLOz/3T84klVYd99fbL0AC7TZWhgRyH7NFAtIRCSzd9NtC92H0xJPGnnvFVQM7HvPYfR3cRhwzxHDWOzRMDKNEyShRNsvOn2FSMkxKysBQhkMQvviAKNBxoHfTdIpv3yYPFYkP6JT4gI6NDzhpOhofeEvcWa8RQBfiLrv1U+AP/el2rcbv/vIt/PJ5T2bhrl3BOq26of2cJBBsIwZg9JcEstuOa6M4CTTu/H3h+1EaHh562jcv3HLGn751D/Tu6zsKMJSipBRlw6BqGAwZBiOmyYhpMmyaDCiDqlKUlcJo+endaPvYgF62tg+30SalJ7//mPUnhs9tLQjYoYjICcAl+N7UA5j45eX86kXncOiSiwLlw8GWZB86PSYQSWuVVQnpvY8JQPcLi2Qd09wwxvrnvbz4jVHKOPYJT1q//t6n3rPnB9+riNal4o0UOByOFjU9glCKqlIMuH8VFCUUJgrD55tLK8gXDehFgnx4vr0Kpnn1/UOB/qBgax9QSglq4mdzSz/z93/NAuhAROS+wOXAfbw03Wxy84f/ml8++/Es7LwjWidhv6glEElrlV0eS6Cl0YtYAkl9TDmmdXB/V/fo5Oe/4NhnXXz5/MCmzTNdNdSFKJzXOavAEDAqsEFgk8BmLWzUwjoRRgQGBMriEGSaxeC4G/HaXqfEBxxXghfF9XFNCoiIPAj4Ib7ltedv/z3XvPFlTP/2aiD9oq56SyDlmNFRgP5ZAuVtOzj1V7s6v1GuLE1MzF70x8+uT1x/3ZauG+uzeIDWgKUUtgLL3Xb2nbTwaEBw35emQsSqFIic+tG7p273Sq5ZAAVERB6FY/a3wL/7P77AZU94SAv8ENX2gTYS9otYAq7r3x9LIKl87ChA/ywBu1br7ma5MrBp07pn/vjS0VNe8OJ7etJgn8R/bRVQEqGqhSEtjNqajZbNpqbFlobFWNNmnaUZtoQBW1MWcYEc0PahYKMXWFSB0YA1AsgpIvJU4CJgPYA1N8tvXv8SrnvXn+C9bhoon9ZWwn5eEmhtrwAJRNvoEwnYVmc3KkaMUmngMZ/79x1nf/jjd6NUV6vo9kPCxJq2LYApQkULg7ZmxNKsb9hsrFtsWmqysW6xrmEx3LQdctAaQ/yzEXiy/9h9DZAcKSIiLwD+C/dTWtO/vYbfvP5Fjq+vnAc6zuwXkt2BcJ63L+Jaat4+gnJnqykV1BICKHHYXkXa8GqmtR1Od4+VUp7YNgQRldF2jj76z8XoQDe1TCNBtIA4rxAjGtFanf6KVxy74aQTD1zyxteNNBcWhosfoPdSFPzOvootB2CIULHdERt/GQW2Eyd4mP/ZW4sBZIiIvA5neq8JcOe//ws3fuAvnG/dBQomX8x+xASCecRH1PsUE0huo3cxgdLYZk675u7oBdO2M/zpfbRTt7/s63zu27ftT9fOykFozfzePdMXv+lNzN199wZWUHoJ/tRtFUk/5d0T83fCmgWQKiLy58DfAcquLXDtO9/I3v/7Wjygl9ES8MAe0KrLaAmQ2EbvLAFjJDoNWBp19MJcG9wSB/T4bcRuLSoyOFTd8NTPfmbxig9+aP/+a67bviLPFnkB31vwu3mPBNYIIEncWXbnAe8DmL/jNq56zfOZvdl5nyIR0MtEAsSBneUjAVLb6A0JmBvGItfJnp5AL8y2NLkH6NZnvL1tSUhvbWuUtgcf/RdvL1//X1+/+9bv/WgHyxgPKw5+lR/w/m2V2O7DgK/CGgFEREQU8GncN/r2/fA7XPPmV9GcDQ4nryQJgIoHO8tDAmS20T0JlLZsC14grbH239VaHzBg1ksKGaQTQ+mMpz/x2PVbN+7/zVf+3wZt2wN9f75YcfAj7sdiYY0AAiIiJeCLwCsR4dZ//Cg3f+IDiNbFAN1nEmhBc9lIgHa9OBfEPdfgMbsjgdIxxweujT15EHvioAv2bD9fXLM/Nj20vePkY7c/5g0vnvzlV75Zry8sru/b88XygT+j3Blen9YIwBV3Tf6vA8+xazWufutruPs7/6+dT0FAr1YSQBBVlATcel6wLvcxOyeBygn3ClyXxl23Y0+PJ/v5kkEG3rbEpw9XjbHHvPTpC1dd8NOJmYNTm3r+fJHXz+87+BHY/JGxkU3vnZyfWCMAQESGgW8BT67tvYsrX/EcZm64LlqO1UMCTvMdkACgpDsSILXt3pBA1b8kmGgat/4WvbiQEemPJ4a85UxtDz/iSQ8u3/CLG/bfvetAz4KDqwz8zrbiZGCNAERkI/A94JFT1/6aX77iOSwd2JcbnFnpWSRAzvaS/fDlJ4HW/30kgYH73K917s27d2Ed2BOj1UN+vtg5YgEhAhHdWgdMRINQud/9T9g+MlLdd+sNd23CnfvR8fPFKgS/83sC8OujmgBEZDvOu/z3v/vCb/KbP30F9uKid4GWhQSKtOcHDWGALSMJeBGBfpGAMbqOyvEntc67fsNV2FPjMaZ8CtC9wGAA4C4EhNZ6Ct50RWl9p9uZ2XjscWM7hofK49dfs2vQsuyOJg31G/yt/eLgR2AHHMUxAPd13h8D97n1nz/BTR95r/PA+MuwekmAOIAtEwk4h+8fCQye+aD2gYDaVZdE/X/R7dl+HrhdELcWL4kBdzjfSQ6C3ys3OjKw+aFnnzz72+t2Ty/WGhsKPV8UAiPLDH5AbYajlADc13l/LLZ9/HV/9Tbu/NJnnUsSV5bVSQKQALAjgASGHvzw1rk2d99GY/dtUUA7GwHAZgE6oPX9ROCVi2m3bBjrHvSAE5ZuvmXfwamphdZLYKnPF4XBuIzg90LIzjcojzoC8F7ntZcWt171xpdxz/e/3c7j8CGBVtoKkUDbBek9CQw/9A9a51j7zc/QDYs0kPZE68eQi6/ewOn33lq5a+/kvr37ZraRMmnoMAE/4n6h6qgiAPd13gsbUxMbfvHyZzNx1S+iZVgjgTwkEHRBuiABQummycjZj2qd3/yVl6CbzTwgDYLb/U20ELx2EiyEQD2HJIxjt47uGKyYB++4a2qddr7zGLkXvQZ/bF734AcYgKOIANzXef9v8Z69w5e/8GnM3npT7wCdUYe4vMOcBIi00SEJhPo49MCHYY6uB6C5fw9Ld/4+WetnBPIC9bxy+bV+bL31Q5Wtp580NvP7PVONpqXX+e/x4QJ+N68KRwkBiMgfA1+dv/O2ys9e8FRq7kKdPdXqneQdbiRAu3z8MbsngfWPf2rrnOZ/eQm60fTuoXczC2n9NL8/h9aPJZeqwfrTj1tfu2Pf3MR83drkXYvDCPyIO7x5xBOA+4HOf5++4bfmFS96GkuHDgTU2BFJAhCdwdcLEvCVJ7GNTkkAlCjWPf5prfOZu+In6KbVEUjDJBHOT7MQYuuFjq+EoVO2DJb3TC0dmFhobjvMwN/6OaIJQETeAfzDxK9/qS5/6TNozky3QXMkkwBhs733JIBKa6MTEoDSth0Mn/UgAKzJcRauvxqx3VXzM0zznmj9IjEC57d87LC5bUDJwb3z1gaBymoCf0Y5C45QAnBv1AeBDxz6xWVc8bJnYS3Mty7A0UsCjpbtBQkQaLs3JLDx6c8F5QTYZ6/4CXa9UVzr5/T7O9H6QeuiXXZjRW2trCtN7ZyzLFsYKgL+TDD3B/wYWo7MYUD3dd5/At524LIf8/NXPhd7MbjA5NFLAi4we0ACxLbdHQmMPfP5rf7PXPJDdKPZGUiTwJ3XQsDXVuiaBtPaO0MmG09dV5q7c96eWbJlvZe7GsHv3tMmHGEE4H+dd99Pvs8vzv1j9NJSfFl6SwLQI4I4TEiAxLY7I4Hy9h2MPswZ/rPn55i98mfoptWpaZ6u9ZPAHb9BYkoooaQYPXXEXNpds8dnmrJ5tYLf/ZuDI4gA3Nd5vwE8e9/FP+Dnr35+a92+XGDqkgTS8o5EEkhvuzgJbHruS8FdCHTm8ouxFmrJWt8P7rBrQLus/xoENyI7MXAPJmbSQZtTBk4cMioH6nJg/5JsFjD7Cf72fsHlwhSH4AghABEZxfk67xP2X/IjfuEDv3fiRxMJEMpbURKA6OpCMW1veeErW/2d+vGF6IbVE9M8uhefmAVwiW0kobRgbK2obVWD8d01GdXumPuqAT+gUfvgCCAAEdkEfB84+8BlP+aKVz0PXY+a/UcTCcTl9YME/JcrkQQC6fEkMPzAhzLovv6rG3WmLrkIbdutfidsxOzFJ3YL7kgNiWkjps66EptPHVazd9Sk0RBGVwv4BTBFDn8XQESOwflYxxkHf3EZl7/yOdhLzuu8XQHwaCUBskz5IAl4H7bslgS2vuTcVh9nf3EZ1txsoM+xJ5aYn2iaJ0on4A5nJvWjarDuvsMs3rnI5LzN2GoAP4Ch5fB2AUTkFBzwnzx57a+54uV/1HqX3zvZNRIoSAKoHP68fyhQUF2SQGl0PZuf99JW/yYuurAds0s8I99eMdMcsikjkpFpQWQ0ZMDgKYOU99Y5dKjJFq9oXvDH53UOfgBD5PB1AUTkLJyFPHbM3HIDl7346TTn56Ll6C0J0G173dRZhSTg3ouuSGDrC1+JOeSstyFaM/mT7xP+JFqadKy9i5BMakMJBBE1RErHVtgyYDC+p67WiTsVdyXADzBcb07CYUgAIvIInCW8xuZ33sGlL3gq9amJ/gHQP+7Vi/a6qbPKSKB1eTolAaXY/qo/afVp7upf0Rg/FOhjcKd3pnlKs9nHkAL9CBUfM9lcHZCZO+rKsnAmDXltLBf4DRGGGtbh5wKIyJNwFu8cWTp0gEtf9FQWD+xrnejRRAL0oL1uSSDYhrhl868psOkpz2DwlPu0+uOY/xLoX+KJkBPcqQ3FZBUEd3yMIaUNgSHF+tOqsnB705hd1KxbTvADlLSgYBwOIwIQkecC/w1Urfk5LnvJM5jfdWfkQh8tJOA9eCtJAv7L0m4j/7cHjnvTuwJ9G7/ouyn+f0JKF6Z5P8Cdtx8lxfB9ynZjV9OYmNJqUzaYewN+gJKtmxbMwmFCAO4bff8fUNLNBpe/5vlMXn/N8gNwjQQCJECieZ9NAqMPeQTrHv6HrT4s3HwDi7t3Bvq0nKZ5Uo0sKyKxRmqMwREFlZNKemzAVofusY0xiZk05Gz3DvwAJa0n3uwWWfUE4P9AJyJc+bZz2X/ZT1onetSTAMlxgX6TAKk+fjoJHP/Wvwz0Z/xH3w0AslvTPD6AWEx7Z4E7Vz8yDiSgtpmyZUDJ1J2WOSRQ7Sf4AUq2TLS2WaXivtTzcaD1pFz/iQ+w+/++Fr6APQUgedpbTSTg9mclSADaxy3yKbLRsx7Ipqc8K9CXQz/6bsv/X0nTPOYnrRtxTJV+DInfXadk4+kla/73ttmsixpx8noPfoCqZY9726uSANyXer4AvMZL2/mNr3DjP34kvjw9BFPe9tZIIHAZinyP8MQ/ex/+Zb+X9uxm7sbr230oAqo+gbtVJl17px40/hjBh8ZfpgIjp5tW/Xa7NDUnxsa8gJfU4wVFCVQse/VaACIyiPONvj/y0g78/FJ+9a43OA9hCHj+y3qkkQBF21tmEgiUJR8JDJ/xADaf8+zA8f3a33/u0Z2kpL6Y5pkHTrVCJGcfQjsGUj3VaJb26NLEQTHHxA23eEW6AT9A2bZbIwCwyghARDYDFwCtdaHndt7O5ef+MbrZaJ3o0UICHbW3ykng5Pd8KKD9AQ7+IC3670vt2DTPchjoObgDNSSmjbTzEMzjlbVpEJncJaVRoNwL8ANULQ2w+iwAETkJ+ClwLy+tOTfLz175HBrTk5ELt+pIwEtcqT74ZRlJgDDYSSaBjY94FJue/IzAMRsTh5j+9S/y+/8UdBFiEoqa5qmlE8CdeJxUKyWYMqassSp69jYpN5uoIa9Ep+AHqFo2rDYLwA34fREf+EVrfv6nL2f69zclP8iriQQgYA0cLSRAHNiJJ4FT3vuxyPEOXfT91pt/3vG68bvjk7o3zYu6CHnoIM97DEPodfejvvh7KnM1jNFuwA8tAlh1FsDLgSf4E377sfdx90UXtk60lyQAvQPn0U4CkG+x0c3nPJv1Z/9B5FgHf/Cd9Nl/q8s0z9cP8oE7q4KXUoLB06k376QyOYE5ltrHFDFEKNsaVpMF4C7m8Ql/2l0X/h83fuYTwXL0jgQy2+u2zlFEAi1bIIUEVLXCqX/zicgx7IV5xn/20/yz/3pgmvcE3KkNxdSQhDZSKsfkl0+mvnGQ8sQeVd4AmBSUgWbL0lpVFsB7cT9VDDB7+61c+Y7XJjJiKgl4OznqZLbXbZ2cJEDe9rrpdx9JwGk+nQSOf+1bGTr51Ej7h356EXZ9sdX44WSap1XIAneefiScntpOc9MgeuYOVRmwUVUKyIDVIoDVYQGIyMnAO7x9a2Gey859Po252c4f/hhrYDWTQN/74OtLP0ignRZPAtXNWzj5ne+NbXv/Dy6In/3XofbODO7RW9M8qYEOwZ1xjHbD68Rafzp64TZzwKqjhskpA03L21w1FsAncNdLA7jyna9n5tabWhdgjQSWlwTI2Z6fBIKjAFESOPW9H6W0bn2kTd1scPDHP8iO/q9+05yiAE8Dd45TAKAievh0q9a4wxyYnlPmhqzyphYqzhCgVYdpL33FCMD9Um9rIfjff+Xz7Pz2N2IftKSLuEYCvSWBIu219iNmf5sENpz9SI596atjjzNxxWU0Z2YC7UWPGNpbvaZ5xjGKATzvS0oKKve2F827jerkQaM8ltamz/+ffJuvwRUhAHfY7+9xn6Gpm37Hr9/3zlgt1OnDD/HBwTUSYFlIALPE/T7xr3hf+gnL/u9fgPhuzpFgmmf2gSQiSyGqhOC2T8xj7KWxQdtiT3kQnXDcwbb5P+5PXykL4AXAIwCs2gKXvf5FWEuLzgPkPmHdkkArb4VJIHAuRygJQHTc/6TXvZnRMx8Q37jW7Eub/dcT0zwlpY+mebeTlFJ7nhLr2IBFpbnArtIgzRjSHYzx/2EFCEBEKsBHvf0r/+qtTN92Sys/vNiE/xIcjiQQyTsCSaCV5t67oeNO5NT3fIgkmbr6Kpb23xOomyiHkWneFbij3SksQ6K5T7PGrtIgC0Z7lLBq2Zi61fKKWwB/CpwCsOvCb3Lb174cCCQBrQ9KeOn+S7VGAqufBM785L9RGhklSe75/gUBwB6hpjlxHegG4HmkhHCKVWOvOcCkWQZgqGH5i6ycBSAiG4D3AdT238PP3/XGgOYIkADBKLP/Oq6RQI9cEl9fekUCx77gZWx50jmkyb7vfTt+9t8RaJqvhCjgeHuJQbG5pzTAcJAAVtQC+GtgEyL87K3nsjTZJqM1ElihPvj60i0JVLds434f/kfSZPaWm5i7/bZA/WiLFAL4ajfNeyUahQZsQCuFjcKG2F8N2KIYaTYo2YHQ4MpYACJyIvBWgJvO/yx7LrkIFWf6FyABLz9yLNZIoKO8LkngrE99lsqmzaTJPUnaP+WYR4Jp7okGxA9kFLby9tvpQVCrFvjF95dHNjatcNKKWQDnAQNzu3fyqw+9ByAykQSKkQB0AYw1EugpCRz7olew/enPIUvuvvDbgcve11d7+wRuIQhk58+3rVQrzQ7kBUHc7psK7cf9OvMrPIl5fCNiApVmZGBw+S0AEXkg8DIR4dK3v5bGwjyKKLADvuBhRgLQJTgPYxIYPOY4zvzop8mS2t67mLru6hbqV9I0l8BfG5gahXbPX6t4kEsMYP3bwTQVSVOxvWnneNc3/Bu3lXb+JRFKVoQAVsQC+Bhg3PjFf+Puyy+NrikXAnwSMfjTwxdypUmgqz54O4chCSjD4IGf+RLl9RvIkru/dwHSHo7qGtx+wHngbW+3gZqUF9eHlsuhon1sP4dpVzN8jVovTScCu/3rLZwWvc7BMsFeJF2nwSj4UcttAYjIE4Gnzd+9hyvP+2s3ja5JILw6bei+xV7ExJt0hJEA9IggcpDAKX/6TjY/9onkkbu/+y0HDiHTPAzMtpkc9ntVqxy0QRw9+2xRLVhGtXNs3CFyEdKudNLVSi4fJoG4+xEkA///0e4aQLU9/bclejktAHfK7ycALn/3W2nMzwVM/zUSSMjrkgR60gdfX5JIYP39H8xp7/0weUS0zZ5rrp6ax9woqNZHMRNx5jumipRpU0cW/FS7uYQzjgNQjK+daMN77oxK7UsSwOOBnlwmK82Tcrz5b5d8LwKBQxT9lBcBD7nju9/kzu9/p9XZ1u3zPeT+tEgARJLLhu9N3H5WeitPdVCnYF7uOqqDOr3ug68v4XRzaJiHfOGrGOUKeUQZJjse9ZjZstZo5UXAg6erxPdH+M/R/4YL+rQ/w/eXlpZcX1rHiy0T28d2ZCBMXPHnQmpZEtoLlpeYNEcGY7Q/MPm64GXvHwG4U34/3Jib5WfvebsD3AwQp5JAjvqB4yf1K63P4avoP3an7XVTZxWTwP0/+a+M3Pu+FJHjnvp0TIRhbVEV3QZjBuiTgGgQD/y8BJHWVq4+pBCBP43Y3/QySfWiaVGSMAi8/eeXiXBCPy2ANwKnXPXJ85jfd3erq2EQpwF7NZFAV+11U2cVksAJL3sNx7/olRSV4558TutsKqIZ0hYlkQRwZGv6dABLwl8e0KeTQbCvxLor/nLJQA+WCbfr1/JJ5cLtAFS1xrRj7+DyEIC7zt/7J2+9mes+989BsBIFbBYJSEbZuDYhfj8rvZW3RgKxeevudxZnffxf6ERGTjzpmPLIyD7/aVXFpip2ttlNOiiTgB7V9snl8xNCTD9D1gBEgZlGApAEbudOxFkAEE8cQ/HaH0IBQOifBfAuYMul73k7drPZGtLplAQiaTnq++VIJIGV6ENpZJSHffEbmIODdCilYx7/5MjUNBNhQGxKucEvPsKIB25SDCDZcuiEgJKtgaIkUNTUT8o3gWojaVWAZSAAEdkKvOv2736Luy5tf8V3jQR6SwLL3geleNBnvsTIqafRjRz3lHNUUl5JNJWWNRA85UTNSxqoi+XFafhwH+L7VIwE4tpK0vJ5Nb+3PWjZqOTVVZbFBXi/bjZGLv/geyKAXSOBw5cETn3rX3LMM59Ht3Lsk56m0vIVDhGY/iBhAc2cNwjYsakfug1+Ez0PCUDn4I6zAvz5CmGwkWj+Q78tAHeV3zdc98XPMXXHba0uHy4kkAqMo5gEtj72SZz+1/nG+9NFGD72uB2V9Rv2ZZU0EEzxXoNpn3bRWIARcBfSg4LJQE8PxMWBMx7ckjuf2PzkbUgc+/dL3y2A8+rT05Vf/t15ycE6N2E1kkBa3tFKAsMnncxDv/DfKDPlOxS2DbYFtoVYTcRqIM0G0qwjjTrSWELqi0h9CakvGsc87glp3QqIIYIhOhF4aUE8I2E73vePa7u7aLxnBRDTNgW285YdStf+EGMB9GwmoPvCz4uv+vTfsTg5gaIN9uDnpNxOC4Glv7yyxKT5Zwz6L6yklE1K8zWRhOfEPIFl+R5h6xpl1Qn1pdd9KI+O8vD/vIDK2KaEyoJeqoG2fWzb/m1P+/X/Csc8+rHsuuCbFBElGlAo92MEiUG4lGuXcOsCV8L/7ASeV8A/Q4/Y/Pi04Hb8FffnJx0j7Y45wb9MAohYAL2cCvyxhYMHjKs//5lo5wuQQBIx9IpEDhcSyN1en0hAGQYP/dzXWHfaGfGVtMaenURsKwT+eNA72U7+joc/3MjoUmJPRQSlVAT0Sb/JLUVBqxJIIFje2UoCeuS0QgosuV5+iWtjoKlR2Y31xwIQkccBT7vyUx+jsbCQXzvTHxLIUz/hdgXPi6OXBM54/8fZ/pRnxJe1mljj+8Cy8APc0fpE0tq/DilU141sq27YcKA+Pb2dDkRE0IDhswa837igW1D8Hnec5g5q4KQWsgDdS3BntacUDDasrKahHxaA+8LPx+fu3sO1X/p8+8ImgRCiC36skcCqIoGTXv46Tn3Ln8eXaSzRvGcXYjXdhHTtL/H5asfDH86uH/2ITkUAWwQDhakyfPHA+flfqI3evl4DOkl62XbVSpz55xetYCqc2AsL4LnAw6/8p09i1estFk4EoS99jQS6z4uQgJfYYR+2Pv4pPPCT/xqbp2vzNHbf6gT8oAVqSTD548hB3PxtD35QVwTQ6pN7fFOpnkS0JWG719LLtgfrmb4/wNQbnHewAtIVAYhICfjIwsEDXPeVLzo3OPRkrZFA/vSu+hC46HREAuvvdxZnf/F/UKVypLw9O0njjhtjfH4Ia/8WIaSQwrYzz+gwDhAVDWjXGigpMMJM2NpTgdQiYJcc251KN+2VtVBOH/rzZCIusVsL4NXAaVf9yz/SXHS+7JMX2K2zPYpJAHpHEN2SwOCOY/mDr11IeXRdpJw1vo/6768DrQkH9JICfsnlnPTKQHnrwIYNB5emp7fShfgvuQ3YAiXlPdgqsayfBIKEoDLAnsxXvSaJPO0NZkf+PRmPS+yYAERkEPjA0sw0v/n3zwY6llu7Q+rCoH7JHfEvWH8lSSCzvW7r5CSByvqNPOp/fsDgscdH8pt338nSLdfQXpQhHvTOZlI8oJ0uvvxtZ92P3Zf/gl6IfwpNU8ACyip+oksSEfjBHyWGuPJx2+EHL7mf8W2o3IRhSq6hP096bgG8FTju2i//O/W5uXxLfHdAAh1p9wL1wyTivyFHAwmYA4M88r++zbrTzoy0Vb/jBuo3X+0z7ZMA7v36tX5MuVCdLaedqrohAD9owmmioI4zPl5OrBcP/OTffC5E3vzwdvo5Ri2QoXyRf096ZwGIyEbgPdqy+PXn/8VNo3MQd1vfe656RCL+C94xCYTvXjftdVsngQSUaXL2F77G5kc8OtLG4u9+Sf3W67L9/Ix4QJp1sPnk4w0cF75w/C4VRKqd5q2tX0IwA+VVYjtxv0nxg6ClECIiFW4/XvtnnVNcWUUh7Q89tgDeDWy89TvfZG7vnt6AeKXr95oE/I33qr1u6oRJQCke/A+f55hznh2qKCz86sc0bv9disaPgj5p1l9cfY88yiabBjesG1+cnk3/mkiKZIPKyW+isHAe+PD9DW+nuQXh3zD4W+2paPms46XFH8L5gw07z8Qfv/TGAhCRY4G3AVz375/FNBRoJwq74iDutv5RRAIP+PA/cNJLzw1W0DZzl3yLxp03EwfgTob7kvK9jmw++QT2XHMDRSRR47rnmOQaCNDAMTfMhDbb2yoRrFEiCFkHKr5MGiFkxQb8aYrcQ39+6ZkL8AFgcPLWm9n3q19gKjfSkkECpADTO6kjkQSAFf0KURwJnPHuD3HvN7w9WK7ZYPb7/0Xjrt+7CdnaX2Lzo+XSyGPzCdtVEQJINZ1D4E8CnOcWmEjL98jSwnmsg7DZnwb+LJCnEZKj/Yupf3rhAojIfYHXANz4lS9iKsC1ALJIIBWY7oVr34LOSCSr/kqQQCtvlZDAfd/8F5z+rvcF8vVSjZn/+zzNe3Z6N5pCmrxl2qfnxwUJx7ZtzB0HCIJCZeSn1XfAZOHM6c+2BnJofafZQuBvWxP5Rx8UqhPtDz2KAXwEKNn1JW77369hKvfe+W6h0s4UzUIk4KZ3/J2AOGAnlM1NIkcgCZz6hrdz1gc+EUjX8zNMfvUfsQ7uzQH0zob7Eq0DhBJsHFo3NFmbrY2RU5JM/9T80LVonT9t9jFi8qNgTAB0CPySVjajTLR8m2yGGlYn2h/p1gUQkYcBzwO468c/wJqZcfx/MZwJIi4JeJywWkmgG+vAf3MONxK492vfwgPP+4dAmj15gIkvfRx78kAIvEmmPMSD3CvrHd3XEXdfYtK8/bFjtlCb3U2a+AEYSVMZ+Vn1AdszZIWE+tF6aVo/Ui70m0YQcW6G4MxwHKwXGvrzn3XXFsBHvat35/99vRX8A8AIkoDfHYAjgARol/U/BIcLCZzy6jfxoI9+mvb4JDT37WbiC3+LPTvZrhAApgTaiuQHdiVcJbYdfz3xtTW2fZPae0syAaSa9iojnyD40/IFheXeZyXBqxs5RofAb/+mm/1h8AMM1a2ikX9PtILJuIxcBCAiTwKeBFCfnGD/ZT8JBP8AlwQEDI3ykcARYQmEyvofhNVOAvd+zZt48Mf/JQD+xq5bOfT5DyK1eZLBK1E0eco/ouUjBUIpyW2BsH7LBhMnNpey7FAe0z6/6R/Id4dr/ODTSrWW+W6VV8G6cRZCNvjb5fIQhJdmCgx0qP2BmTc4kyMjkkkA7uu+H/P29/7oQpRltS0A75WOFugNlKEDlsCRTgK+ZyN47VhZErjPG9/BAz/0qQD4l265lvEvnIduLEU0eCyuEzS4v3BwN9oWvrbieMY01Lqh0aGp2lxtY+yhQle4l6a/xFw48eXpmGsbBnMwLe03/4xDP/gBhutW4nORQ8aTMvJYAH8MPNTbuedHFwbB37IA8AUCDQiRQNgd8CQxWOdejSQSyKrvme79JJFQV1cVCZz2tndz//d9LFBm4ZrLGT//E+C+yx+16hPAmwDcJJdAMtqKa2bD1o2qNleLay6wnQT+jkx/la9+G+gS2E/rX17rIA9BlHXhWX9hmUjKSCUA93Xf87z95twsE1de7kT/DQn6/RCKAYTKCGjdJoFcwHSvQFzZrPr+O9MViRxmJABw5l98gDP+4gOBvLnLf8D4f/4TiI7x9/2b6Ro8UiWlrSKxgQ2bN3DPHXfHNlNkyC8KwPyz67Lzs94U7NQtCLYd+FWKkaUGXUrHFsBrgNYXIA9e9hOUZWG0LAAjAHC/xlctMnDL4OQtJwn0hERSXBTvucwTF1gWElCKB33oU9znje8IJE//4BtM/s8XWgeQ4H/BRkM7EfCmuASS1laGe7Fuw2gJWrN1fWXjTf/U/IRu5DX929sqNT+ZAHoAfPd3wNJ53/dPk+IWgPe6rz9t/LKLW+Z/EsD98wHwl5G2S5BJAhB913+FSCBvnGKlSUCZJg/7hy9wr5e8Jnjnv/F5pr73395NjTZACLoZLkEceEMZxBdJtyyUYmRoZHCmNr+4fvn8/vQx+MTuek2LwrcKYqA9f93kY6SD31CKkaUmPZCOLIC3AMe2eyxM/fKyVvQ/DeCxvwRdglQScK/AGgnkq2NWqjzy81/juGc8t52hNQfO/xSzP/1Oq1zrgsc14gducJewBvc/E5LRlv/gktHWurF1amF+MVytLSonON3CvcyPcy2cfwotpBJJUeB7MtiwMe2utT8UtQBEZAPwHn/a/G23YE+ORwOACQAPWgnEzhlYI4GEvAIkUF63nj/88jfZ9oePb5e1muz7zIeYu/LiduXoPY4eIFw4DNy4tlLJI92yCHdh3YZR9t11wC2xPEN+8fUz8lUw3xtk8ROBv14cqWT9miiGljoe9gtLYQvgL4DA1MzZ3/wS0zAKAVyFiUIIuA3KAFtLMjBD6auGBEivv1wkMLj9GB77399jwxkPaKXppUXu/uR7WLjuV606aVo33H5Eg8eo+E4n/MSaC760kZHBMmCBKkWq9HnIL7Z7cflKxeYr3NdipA2FTt0CgJG6hdHBlN8EyW8BiMgO4O3h9Llrf+2a//kBTixBRMvkIQF/wC2uLEn1+0ECOer3kwQA1p96Go/9+vcZPv6kVp49P8td5/0Zi7deHyzs28kf1OsgNpDSVsCOSHAvFAwODg/O1RaWRgNtLOOQX3Z+GlEoDPdZsbtwC6oiHU/5TZBCFsD7gOFwYu3G6xwCgMCsv3SAS2RSULiMctvJIoHcC4OmgBiS6/vvRqf1l4sEtjz8D3n0V75FdWP7k13W1Di73v9m6rtuL6R12/jMdglyzRZ0C0pGW9FNp63R0WFqC0uBIkngKw7U3pr+acf3vlVgFXQLDAWjtZ4E/vySzwIQkVOA14cLWVOTNA8dxDRdrZ0y6w8gdVKQEDNcaCwLCbiB287rZ7go/rvcLxI48Xkv4eGfPh+zWm2Vaezby873vonGvj3tSr6NNK0bPFhSUC/UgIRaL+RexLfl7YyODKgD/uQcQ36Sld+DIb8k0z+tvsJZmNSS9oL8WX0dbvZk2C8suS2A84iuoUjt9lswymU0YFpNnKl95AI4PoDHTxgKlukrCXRbPwcJJKWFH4yw5CGBM/7sfdz/3X8beBiXdt7GnX/1RqyJQx1r3egBJVguE7hOQtS9iCmY4V4MDVTLQBMor54hP5WeT3q+99GSZoZbUAGGF3uu/UUSXgQCHwG4X/d9UVyhpd07UZVKa+2PMAlkAbyt5SVjzoBTxhbdepV8jQTAqFQ4++8/z8kvelUgfeGm33LnX70Je26mfatD7eXRurE8kBjU8zXQqXsR0y9fkergQGW+Vm+U85v7/RnyIyGtWH77QSsrJzbQjLnehoLRxZ4G/jyZ+ROHUGPFbwGcScKqLPV79mCUKy5eFVqB2WyTQH6AEztnIDqaYGDjIwHIXLXnSCWBgc1befSX/o8tZz8qUG721z9n5/veir1YizZQUOu2EiSumfi2CscGJHT8hLYQGB4aULV6w5e0MkN+nvZPtxiyXINgEUNBxXMLpJ09aAsDxZb5zisTaZl+ArgAqAFD4UKNQwdQ5UrEcvdIoBOARwKIaSQAuVbtaT2vGSMGhwMJAIyd+UAe8x/fYvi4EwP5Uz/9ITv/9l3uBzp7onXb6QkugWS01Yl7Ed11doarFQ6273L0kIHt5R/ya28HTf+sfH+PS8pxDSwRSihGF7ue758k42mZLQJQSs2JyMXAs8KFrKlJVNkJDTj4VC13n2YThe4I4P4y8UOKBjbtteZ69T3BwM1YpSRwwjOfzyM/82VKQ8EBmUMXfIPdn3g/YtuhVoieXAGt2/6RFHRIwm5R9yKmsz4rZbBkVoAmqHI6UFd2yC9XvkpqS7lE4Ez46dGMvzjJbQFAzOeDwRlfNioVtDcKiN/dV9BsQCwJSMacgXaZ+ElFzrYNPSeBrPp5LAnvriaNLpBxfF8TgTn9D/irD3PGW/4yooH2feUL7PnnjxEH+G61bhxKc034CZNHQlu5rJT2bnmwXK7VmlY5mhVXvJhpnyu/wJBfYr5KKtsmD4UwVO954M8v+SwAV0bCBXR9CRHxuQAO+sI4jZCAEJn1lz4fIH3ikPcFWFg+Eljuj5IObNzEoz73VXY87inBmyDCXf/8ce758mf7pnXT2opvJt2yyO9exFspQ+UStaYV6VJvTP/eD/lF8lVaflvKSrsPRNzF6YkUsgCiBFCrYZQriGPoB7GpVMAqoNkE7I4AHjt7UKLlj1QSGLv/g3nM+f/LiG9mH4Bozc7z3sOB//2qL9H/U0DrpgLX12Ie8LptSUZbuayUGPdisGSqcJNxpns8+Lsx7bPyuxsS9OeXlMZA0AaYffMAurUAGnVUpRLQ+oZLBuDDpjvW6aw8ZicAXDImBYXKBOq7bgQ9JAFWB4nc51Vv5KHn/SNmdSBw7aXZ5PfvfgvjP/zOsmjdwEZu9yJYWDLa8vcrzUqpotrzAYgHf2z3yX6Lr3+mf7bf76UphJJyFmfRpsK0VocFMBouINpuDQHiznUO4leFrAKvph0DcFLnDATnA+iE+k61npBAt/W7JIHy8CiP+PvPcq/nvTRyY+xajZvf8hqmr7jEdzOc//Jq3QAsc2jdLA3u7HfyCnBCH1JEQWnANBcXbbsc02y0az0a8ks/VrEhvzi/35Oy0Vb52gjm9Vi6swCUMgJDgODiUamQVeDGB/BNJrDtQgCPzAxEkzyK0CYBD4FJICQmzV82q34/SGDsjPvz2C98nfWnnha5KdbMNDe89iXMXntVPq2bB7h5YwOx1YuBN6Y3KQWSSwyaBou23SO/PyM/NNsvCfydm/7tbc/090SnroXctXQXA1CmiaoEhwDb244YSsVY9QpoREggCPCQSxCZMxAto2JIwBuSSwJxJjAz6geuR7ckgOK01/4pD/vgJyMmP0Dj4AGuf8XzWbjlxnbiMmnd2EOkFujObM2qPWiaSlqT2Ho72y+uD0XALXH5RUx/X6HVbQFUB9ougIqP37W2Q8OEBqBCJJA1KSh5uFAn1F8eEuho2DBUdmDTZh7z6S9y/FMjUy0AWNy9k9++9Lks7t7JSmndnrTfAxGgaqiKgoZApV+mv5Pd/yE/T/ymf6tMfwkgnwXgrgA8GC5gDg61XIDWSIAKzgNICgh66SZNsK1cAE8eKUgvsxpIIC3OcOwTnsJjPv1Fhna0V1nzy8ItN3HdS59D/cD+9Nu5ysErPeijJwqMAdPQi3a7veKm/+oY8osz/f3nIYZyXo3vkXi8qCS/CzAS21C5jDkyij0/BwRHAkQ5Wr+Nw2hA0HMZTGiRQBbAVWoZiQ4pun7HqiEB33NhDg3xiA/+Hfd7zZsiD5sns9f8mute/nys6anEG7VcWreP49EdncOgYaqaHZ0jf7gN+RnKZ/rHSK+GAl3gu/MMmXs9kjrHOJ0A3Lmu5U2bkUY9HuS4IwEqmtbadm+WRwKdAjw4XKhj/ZFVQQJu/W0PewSP/9cvs/6U+yTegMmf/ZTrX/tS7IWFjm96v4HbOkbXjSS3kpQzYBqtd9miAbqVNP2L+P1QUekf9ujFUKBqA9/TNeNZNy6RAMSykPoSxvAIlS3baY4fivHzgwFBAxAVM2HIcxMUmE1QltUxwBMnDvnKrDQJmAODPOzdH+QBb34nykwO8R648Fvc+ObXoRv1rm58mvSMFhLA22/LxIsDaOd1eUdU9NhxpvnKDfkFpax0cNQpplA3gUDlno/ynZZLBBNZdyieAESQ2hz21ATG0ClUtm2ndvstgN/Pzw4IxsYH8CYM2RmLhKSTgAqXCZFIGgkkDvuFbmonJLD97D/gCZ85nw33Ttb6AHd/9cvc8u63h17qCcpKad1eSaH2k/upqoYhi+5r5n7TP+44q2PIr51vKsFUOvNa2GZxAvAD3zstV/+3LYAMiSUAaSxhz81iT09irNtAZfux7nTgmDF/5bcKooA3VASbbn7DmTWYOinINzMwYiXgIwo3M1S/Xx8lbd1dX1pldJRHvPfDnPW6NzsWTIrs+rd/4rYPvz/bbF8hrVvoGB26HkVqDZpKLeqVH/LDn5/b9M/n2GsjV7H2EULmfgj4HjlMZLXlJwBnFqBto+dm0XMz6LkZmrtup3r/h2EMDgW0epKJnxUQTCSBRIB7V0fHEER6GfpIAv60U57xHB77iX9m5Jjj0q+2CLd95G/Y+S//kP9uF5Qead3eHaPb9kUYCD7VK+b3tyyGnEN+FSMf+MGJAeSRGD8fFQW+15PiFoBeXMCen0XPz2LPzdLcu4vqWQ9h4PgTWdx1B4BvOrCK0e7ZAUHHKvCIpOG87xv3slCRmYEGIEG3QfncAeg9Caw7/kQe94lPc/I5f5R540Rrbn7329n7n+cnl8n7tBwmwO2VVAxVRrXfC4g73mob8isnDPmlXT1tKIyEoUDlkl/Ez3e7FGcVkDEHAEIEII16QPvr+RnsqXEat93EwL3uTf3uPUHtHgoIxk4XJsFawE8kTcCKkIDKCfDgAdpug+qTJVAaHOAhb/lzzn7neygNRhZQiohuNvjdm1/L/u9886gDb4/6rwYMJUE3IL7t1TDkZyqhpFLOWOJ3tekYw4ETh3aAz02IM/eVUr7yLSLIbwGIbY3ohTkX/LOBv8VfX876l/4Jc0PDUIvR7orQS0IhNyEjIKgVGA1wSEAy5gPEAzwaCIwuWd4LEjjlac/icR/7Bzbc65SsawuAXVvg2nNfwvglP8lVvqj0G7iRY/SkwWCLedofUIaqoVPqrKYhPx1oKe/1c0YCfHSSz8/vjQWg5+dG9Nysa/7PYM87VoA9N0Nzz52se96rGLr3fVm45YbC04FbuFTExwe8/CZgWZ3PDAwfOKZM2B3w38I0Eth61gN43Hmf5MTHPynn7YTm9BRXv+x5TP/mV7H5q1zrxjQYbXG5LJMBg9bi+stv+geLpBFJEb8/LN5LQUX8/DSrAFR+C0DPz462TH9P+3uxgOlJaj//MUOPPYfFnbf7wJxi4icEBFskETuM6A0RtkmgqJYPdMgg9rsFmZ8n95HAyI5jefT7PsSZL31VZnTfL/UD+/n1i57F3E03dPQw9BRYKwDcjo6RQoJlZ1XtpvbFAWIDdOG0Ltf0L5Jf3O8PijYUhooCP83PT7MKKGYBzI54wb82EbT/5n74TUae+jyG7nM6tVtu9E38yRjzV/EgD1oF0QlFHgmo0BeHwwWVfzny2ElFELdkeRYJDGzcyCP+7N085I1voZzDz/dLbfdOrnrhM6ntvLPjh6ElK6h1u+ljT9t3ZUApap4F10otNuQnOfO9tiGf6Z/p9+cQbarCfn6gfNQqKGABzM2OeGD3jwLouVn0wjyL1/0K6+A+hk49nfo9e2F2Jqrd00z8lIBg0HVQARLImvATmThEXF58mTgSqIyOcvafvp2Hv/VdVNetL3wT526+kate+Ezq+/dF8lYdcL2T7/cxum3f7WNVoWqBAt36/Vlr/pNi+rczDPKP98cHAJ3/tfP6bMTcTwjw+SyAYBlvxECULmABLMyOBEYA3FEAPT+DbjYRrZm7+EI2vuT1jD7wYcxc+bNEE16UH3ch4Kv2+gH+9NaQogqmYTUzAa4ySCDtuwUeCVRG13P2m97K2X/6dgbHNtGJTF99FVe95Nk0p6YK112tWrerY/Q4rjGgks+lX0N+WRYDQMVIms2ZPwDYqmEqDN1d9N/dnnvJopU5xzxoAcy72n/Op/0Xa4g4a/PPXXQBG1/yesqbNjN82pm+gGCcdg+/KRjjJrg9TXq5qHXxMkggCvCg2xC/BoFTZnjrVh7yprfysDe8uSON78mhSy/m6le/ECvPSz2rDLxpWrevxygoZUVJOR/VKfV6tl+n+VWlQ1TSnWhDURK/Zi807Oe3CjK1P0SCgLNBzb8wi2jtEgAs3nojjZ23UbnXqQyech/sxQWWdu+M8fO97fb6AdEJQznfK/BO2vLmCUQBHj9SYKSWGTv1vjzoTW/jfi98GaXByDII+cW2FprTk9M/eP5ztpm6URoynGiV94D0W/qtdft2DhFfPp9UFSzK6hjyKyuN0aXfHxZtgrK7i/675JDp/0MoCBiZA9BoIFpaFgAizFx0AVve+OcAjJzxQNDC0p5doeh+ekCw7conrx8QIRIFZtPyWQB5JwXplpWgSgbHP/aJnHnun3DCE5/aYtHcImJJs6710iKyuCB6cUFLsz588OdXDptNmEIzZUNZKYYMGDIUlYRDHC5aN62PK2GZOAQQX2Y5h/xMJZRVcRM/S2xDoZTk9vP9ROAfMaADC2CkNQdgbgZdWwDtfh3GRwIzP/w2W97wLrdnipGzHoRRrVK7/dbYWX6JAUEVVso+4IcCgq10wLQssKMkkDxcaDC0ZSsnPf+l3PcV5zJy3An574a2bV1fQhpLIks19NJiCdty3uDz/e679GeUMKhSoo5FU4RZG2ZtoaRgUKWTQVhWm9bt6FBd9jFJqqAkxuheziE/hVDNG/RLuShxd8M22lo/Dvix0f9IecgzBwB8BGDP+SyA+VnEtlqgF8GxBLRQ37ub2u+uYej+D2kdbei+Z1Bav5H566+BWki7ByYGxWj3hAVF0+YSmN60Yd/bgOH5AObAINuedA4nPPeFbH/041FmiXQREctCGnWksYTUF0WaDTMMdrFt0P59i/1XXAnAMGUaoS8xWwJzAnNaMIFBQ8mgoagq8psfK6x1i/axb8cAymAajgowiw3pZeXnM/0Bqrkm+3RmHdhGW+t3Gv13f4pbAE7wbwapLzmgFwmSgDgkMP2Db7UJwJXK9mPYsHGMhZt/x9LuO6PavWBAMOI6hIjEtNqfJ/cmBZnDA2x81OPZ9tRnsvVxT6E0ErvKmXt/NGI1kWZDHNDXldiWH+yqBXLtJwEbp5yNaIvZ23eyePAQACaKAUosYcWiWwMLWtSCFgycce0BA6kqijoj8afUccV8NVfUcvD1sYpQC1/hHJ/x7sWQX9VoB/36cT1s5YA6feJPHqugAAEc+vNXlxvzswN6fgapzbe0fTwJwPRF32XHn/9tZLUbozrA6AMfxuDJ96F2600s3XVnzHTglHcC3BOInTBElEhMq8nAccez7hGPZsMfPoGxRz4aYyAhoKdtZ5UjB/SI1fDArAKgti2nrH8/IV1sm/0/D07zHaJCAyvx4fA/PIsiLNoO+AeUkqrhjHXnJoNl0rpdt9+D2Ia/hYqPAPox5JdUtqykq5l+ecU2oKxz+fltIoim5XcB6vPzI7LgBv6azTbgY0lAaI4fYu7Kn7HuUY+Pb3TdetY97JGM3P9BLN21k6W7dtK4524gNB2YuOi/6yaoqLVglkpUT7kPg/c+jZEz7s/IAx5KNfYdfGeUQGwbsZpgNV3AxoDa1eTF0tvbB359beDIBooqZerk/+KrSwZq0Xaew4pyxryrwXvdF+k3cDOP0YFUY7znXvr9EpNf6sFMv7xiG1CRLD8/bPpHyCE/AcjCzIien0Uv1aKATyCBqe99M5EAPDGqAwydejpDp56OWBbN8YM0xg/SnDiENTWJNTuDvTCHrtXQzQZi2475UypjDA5ijoxS3riJypZtVI45joHjTkSVyzFHEidQ6ZnqltXy09vgTfLhi6d7bS5NTjFz512R3gy6sYDw45IHyQKqLlB3n/GKQjwyMEJN5DGXu5G+P+7SmZ9ccuMANpjLMeRnuBH/np56Ym89NyBpiM9NcxNSrIL8LoCenx3R83OBMf8ICehg2tRPvs/xf/N3ySZ3SFSpRGX7MVS2H9OjKyiOH+/55TpomgdArGNAXTA9zio4dPX1sWAzUAxQZqmAFdC6TqHdpjhfxgAog1SVUFVgZvBJX8HbIXALHyYlr4JmUZmJ5Xs15KeASmHwJ33JKZ9YhjcXoGj032cVFLEA7LnZEWk2A2P+nr/vnwMg2jkREUHPzzF9yUWMnfPsghenC/GDPsFPjwd1Md8+7AYkWQUHr7spsauOG2C1HoW8dnzcc+LVtUA1RTHvTIWTihIGcpBB+Bqu2pEEXx+z2q8oYZHemv7hfEUw6LdcYvkCgWnA984iwSrIbwFIsznqgR43AEgL+MnWwMR3/7f/BNAin2xt3b1vH0MoCVaBvVRn8ve7ErutwJ0XEGcFJMNcZZT28m1QNVHUBEyHDKSKqFKXMYOuwJvD9egV+VRFVLLpHk3rxPSvRMC/PMOxTXemQw4/v00UBIlACg0Diowg0eG+yBBggAhg+rKfYM1MU1q/oceXIOTT5/DHszV8fp8/j7UwcfNO7KaV0Hv3BSNKbixAcqAyySsMThhIIoNFUWrRGTmRCiIVJZTdlyrzXfJsrbuapIQYBqK188J4qJ/dmP4u+JUUuHi9FdtFfJafHwd8t8zCM6cXFvNdR0AHCCBEAjqZBHS9weQPLmDri1/VmzPX2gV9Dm3dI98+TAZ5rYXxm7Pf9U+3ApLrBMVvsrdvepgIvH0NagmlFsVHBghlZKWe575JVYSabwgwzrRPIoc0i6GsBLOPEf+s+ZgCWIZQFRf6xaL/KJVvFiD4LICkMf+gNRAlgYMX/G93BBAGfYEx+OJR/Rzmfp62LIvx2/am3Fzfw0SJpi8WkP8BaUsb9O3QVJgI4vY9MlhyyusyolxC8D9Th61U0dRcPV3I74/R/l5+qQdz/LsJAHpiKRggDPbcVkEu8x+8GIDIiOPXx5j6sSTQLjfzq5+zuHsngyfeK//Z+UGfMtaeJxLflc/fobUwt3+SxsJSxu1v3/Wy6wrklSyTv00F8UQQty1gNFDUHR2iy65lUD2MyaAqEul55pBgit9vKukg4h85Qk/OralAeacXZ+6nWwUFCUAzmjTcl+USWLbm1695lTz6op8qVUqZby8asXXxMXgXjIWi96lR/U7iB765BFozcee+vNfXvcglLMlvBfj91DQyCFsEWSTga8clA4M50I5VoKkiGEXiBissJcQwEe18bjbfbL+kfAOopoJ/+d7HADcQmO7nx5JD3uXA29cQ1wIIBfgSSSBkDUw0bMrXXqt2ffHfudcb/yR0zTSidcf+eFYkvlhbIWsir7WgbffFI90aGZnYfSjhEZHQb1vKqkRD8lkBqt2gO9U1mB41+4W8JBDcFgRlNFA0MJkDKSN2Fa2qCOZhQAYVESzldwOCksc1UKjACz4rGfD0jt0k2c9PtAra5bskAI8EdDDNGxLEJYGGrZlrajZhctvff4ITXv4KzKFBF/TdaeuOZuxlkETutkKgbw+JCvX5JRYm5wveTsHExMgZC4iY/W6CpBBB5yQQ2FZNlNl0yaCEWAOIqqIpuV93X20ygFCDFNM/fchPoRhYxrH+rACgJw0lbY2eP/rvkUPRGAAjIgQB7gFe09oPxwDG63bLC22Mj7Pzs//KyW9+c8f+uEcGeQJ2edsqZEVoDVp8oG8TgPc3eVc8uYa1ftxvSZk0JX7o0C+JZn+MRdA9CQjEPP4KlIUqzaOYw6CEWFWEAbQqryIyqIpONe3DFzQMvV5P9OlFABBwVIVSLRMsK/ofsgo6sABSIv1x1sCiLSzYQsl3+e74t3/h+Be/EHNgoGNt3c2MvfSZfAltRUAvEdA7S5A5hDC5dzLnIxD9NXJaAf5ZA7Fmv48IuiEBCuRbqJKFYh4DE6wBNAMIFSRroYW+ijsfQOzQK4F5TH/3/YoeSm+dhyaaEkaSn5+ybFjxUYDRrOG+1qIg7v543VkJ1ZuFIUBjaoq7vvIfnPTKlxfy06Pg7dy3zx7Pd6YRe6BOBb20Z0Uigt20mDk4m/sxiPs1VAk7Ixbgf73FI4NYs99V3kVJgEiaswRVGjH402xUaQGTecBA7AFEDzpBxLg3tfouA6JZUGbsW3xJpn9FQc4P8gZqLmd8oKFgKAD23B8H7WAYMCbAl0QCc03NkructvfOvic7/+M/OP45z0KZRi5t3dVbermtiM5B7/+b3jeNtqOrwYSDf2mPiYGBuOG37MetFajz7XdOAnFtxEl2nXbbGmXWUOaCc2bWAMIgWleRUs8VbIJUEeKiMkngLysoJYB/NQQAvb0mkgB80q0CKegC4MYAosN9cXMDYKLRBkHYX106eIi9F3yHY895cnagLzWq39nQX5A4NHh+vM4AvY8cYvNEmLxnqsNbGtJNqgQ+KyB54o+339bTXn4WCbRbiCePaFp8LCBOktrRqFINxYLzlQfLtQxkEDFUH+MGA744QNaQXykA/uWFe94AoCd11zIrEP139ozC8wD8owDxw32tiT9Nm6Zv3rgRM/Vy139/gx2P+wMHgN2M5+cMAHYF+gTgS8Qq0Eztj5r/SUN/ab+Oud2GUdbEn9CwXSuvW7++07Q8IqjSIoqa+3mXKtIcQjOIVkbws/RdSwlRJYRmGyaxfTZVe8n2ZZEu+aWBjvfzs6wC1fUwYIgEXGvA1sJkM2gC+10A73d+z14OXvFztjz4/l3O5Ms7nu8DfYoJXxT0/jJzUws0G9kR/GwK8G6YCViRHBVTOmbsPpLuKfBeWQG9JA2PDBYdj8CuouvDaGMQjen72Gc3UhVNU7kGbYz2N5UT9Oufzu/9a9bxFkDQ3Pfulo8IFh+zf7qW9xjeMOBoOMofNv3RwlRTY4fOMu6BBbjr299j0+n3znynvrPxfCt+nD7DhI8DfqyFEBMniNf+nfy6r123bqnEWgBpU3zjzPVeau98kt9lCPXFXMIwl5z1jaQiemkYrYbQRqkLMhjw4gAx4Ddc8Hd+nuGt5RELQSvBROWM/itUgSFAgNK1999eEWdauKM5fWazMzfAXQdQC9PNaAAsPHvS25286VZmbv09o8dt7zKqHzMrrx+gz3AZpg7OpTwc6do+SaQ1LOi7nqHahcz7RCtgedLSzjSBLFRdGQN1x2mVCnppRLQMoc0yVHI3TzsOEO6TM8U3fy9XSiRhr4Ew7M50zPnJ8Nz+PzgWQMj/J3ZloMmmjr1A3kc9/d32fu/64cWc/vLndvfiThzoOzDhOwG9V69ea1BbaHRwQ6MRAkf7t1/mcYw8jX/wLwlcWVbASkuXFodqYAxMKpMJoIyuD4vWI2gqSOa6cyWcRTubvhiAAVSNJCt1dQcAPakjjOSN/gMq5wdBWtdN6/BaANEx/7qtmbXSP4YQJQHh4LU3cq8nP4rKyECxqH43oO9yqC/Oupg6NB9zvkkQL/ZYaAxMnLXWVAIJdK+pi8QBeiudttvEqE4pgymgLFqG0WrYnXyUJAOiabrzARRB8C+79Ohi1lvrZOf+OGhBCyB2LQAfCWhhohkP/rYXGz5nFwy2zd1XXMVJj31o/qm4PfTbOwJ9zPGmxnPHVGKuRrJb0LYCvIXPk0mAgmm9kNXSblMZagqHDEqiGUYzgmYw1MqAaGaViQIGlhX8/VtnsS4SAnvmx0GLWQCtV4ETSKBmCzU7/vTib2RwOsy+q2/kuIfcF0NJjG8fHLbrhwnf7aiA3bSZna3HnmHhIKDE19YoSvQWbP0NAK6cNJXBNAbTgIkw4hLCEJoB0T3W/CsXAPRkyT2nHNH/QsuBe1IScWMArbUAgkSQpP2hPQegfYGic+EatSUO/PYWtp12fOCd+q5An9N370WAcHpq0UlLfUCytX2aCAodOxl3TdLEwmDadRNMhK22xZjYLFaKzzlajQFAgCV04Os/kBj9LzwHAKAkokNrAbStgXlLU9fJl8YbAch6/O/57W1sPWlLMuh7GLDr9ajA1FT8yj/5tH5S8C9KlDYGJexePE+x9+BIl2FbM9R0gFERzWw17SNeK3F1OjumJYKFUFYq75yAohZATAxACzpm0k9YgpOAokEwb3thco6Zu8dZt219z333fo4KiBZmZuLN/261friu0P4eYtojkzetF3K4tLve1my2aL0rX7WFjUua6arR+gTdskJeUncLS100FVXK+3HQYhYAgjsKQAAYM5bQzOh5e3glKcDV/r3nlrtYt/l+vQV9PwOEwNx8E8suevuilOh5EFnUYSe4Ab0G/ZFEIhttzZglEY1YEdhU10xWDWeZ7b5J/wKAniwhrFOZ0X8Pj8UsAC0y6oHDswQsLUxnDPs5x4+OTCf9Tu4Zpz63SGWgvDwmfB7Qh9vCF6gTmJoNvrZbdN4/odpZpR0rIPqGJbHtqox8f9ryxMOX27DeZGk22N5HNJzz9EfHy6LY0hAmKopGF5dgpeMDi2KjVCXD9G+RQ1ELwF0MxPfiz7QVnfIbJ/556VkgEBH23XY3J97vBALz9vtowncC+ta+CNOzWZN/uncHwvaCTRCuWS0F8lPM3eVIS5b86Mt7rC2WsN6WsPkbiI4rwBTY0oCJMiwZ+Y+5XLCXlD1PlnSb5DLnBBQfBfDFALQz5XfGynfy4RlWaTdPgAM7D3L8qTucDkdA392oQO44AdByecKg9/YFlho29YZ/och8Wj/4mxT8SzYbBYcEzND1DG7n0/6rSXrldihgqyWMaN+quYnAcLYMYKsFkyWYN1biSnV3zEV3vaPsj4Oy9MDdh/IuWAk48wBG/Ob/VMKU3zhRojJB7/9t1Jsc2jPO1mPGcpjwenlB7+2LA87p2aRVe7rX+llteW5AuJSzrWLT47R/nPmfDkSVs1y7bMfA7sAkV8A2SxjWzl7OoFgLLJttZ+77dD9JQFJ3O5JF0a2hvzSiUzBR9LKW/K8C17UwVyDoFWeqZv3u23mQrdvWd2jC6/xxAg/MeUDv0/ziJs7MZy/hnaj18R8je9wg+ivYoREBJz0eoIXchIJpyyF5+mIAO5rCgJA5JTbNKhjTihKKcSM7xpWn58txzZyhQE0FI+t8C/n/4BDAaHvST2eeXRGdODdTY3ZqjtHRwc799jAhdAN6b9/V/AhYtlBbbI/J5zfg06SY5aCR9s0lA/xdaP+8ve5nWlvi9ZdJG/zJ5m8bGFlf0l2voYzBAUOTRQMr6Vr5j70oQtXI/GR4If8fvJmA2pnyu6jzn24W+ONOpGUF7J5g9PQdvRvf7xT0MZpfgNmFZs4bnw3qIlrf/wueK5AM4jzgzwJh/81/1RU5lASOsYQyPlM33vz1TZKJBz6+8iOiKGnFPYaNlasnvRdJ2QvLorbZWCqlRf87tgBGRLIn/YQl/iWg6OnE/Y4fmuWkkzZRLhnJwM6zTFc3oPf2fZrfSRNmFyzfeYS1f/b5+Y+VXipZxD2mkQC2ouDPTwTpacspVYEdlrTWD4tq+aygWLpVMIjiBCmxV9k0Vvxs06XmxQF85xtDdJ1YADIyZwuNgueviJprecGhtbD/nimOP3ZDYW3fE9C7Kl98oPfyRIT5WtqU3OJgzmorzbWwfSTQqqXCLXS23Zb82j/vCERqmsouNyiw3RJMivv5RayCKnASJfZgsdgtCUjcbm+IpabtSBCwJxaA1jIylWPST1iy3gPIsg72H5jj2G0jzkno/oC+bdq74PLvB+YAtPfnF220Lqjt3f9bvxLaL3Btwun+WIBf64fL+U35YkSQ30TPys9r/sdL+8RGNWy1JRT5ztbo/hdjgIDLkNZGGcVJqsxesZjLjAq0z3Y5bYaabo8EBPsfILriFsCMLaM5h/0DEucCFHEJlhoWk5MLbFo30BPQx4I8aT9G83v78zUrpdfdaP3O29IIhkrW0nnM/k6tg060f6qo9ONs1DBmx/vtRf38YHki5OD3p03gRFXmHppMit3ZufVQwsf2WwCJ7k8nFsCMJes66WDRSUDRX2HfwXnGhsu5QV8I5En7CZrf259fLPJGXtaSX0WsCIlpvZ0XB752mXw+f7Ruf4YV/X3KW0cBm21YL7RB2wM/P9EqSCh/HGUqSrFf51kBuleSfbdsERqiGTDMNKIrbgFoqANDRSv6LYC4U0nXc87e1HydxcUmAxWjmPne6X6K5geoNzRNK94v78wGKK71k3K0xFkB+QCcZPpnHb9b7Z/XtTBQbLNhSLL9/OWwCrZTpmIY3KX7FxrspN2a1gwaZtrioMUtAKBGBwQQdzL5XIEgoO6ZrHGvrSO9A3nSfobmF5EM7d+5CZ+l9dO0f3s7bAWkjA4k9CxPnCCrna60fwznlIAdthPxhwSN3uPofx6rYLMqUVGKO+wGuebGStxub+ljQVtsVuU0oituAQCzwOaiFVXoAUyDRfSBb6cfnFni+E1DGEr1jwQyNL+3v7CkE/uZ/Zs87z+vZJV0rAAjtmz+/XxBwqD0flhRgAGB7bazHFo3Gj33N/PcGunl3VIK1iuT01SV2+x64GtY8ZTdf6nZOnQNQkQn0pEFMN1JZ1rfqqebOIAz6+7QbJ0t66orpvm9ftQjcyE61/rFr0R6LWdbCK/wG9dCMhCLjhBkm/7R3ufT/qMatmqFkRP4XhO98PP9boZXPm44EaUYUSb3Mwa5tbnEkvRi+nC2SELqgrbSrKB6o7JxDvYVOlaJDsyGrM4masiEsvunl9g8Ull2zd+uI9Sczx2ruP5ln1Pxob88FlPs9Zb2KrFFrABJIY084O+lmzCmFRvFp9H74Of30ioYRHFmxSGBOd27ZduSr1a8LNh22vlOnHHjjYWPXgIOdtLtMFKygJJWdr5uMbdkMVwx+6b5/TP+JGa/Vg+b/91o+6yrUqx2sAVvTCBrWLB9p/JaCEW3o5JgYbhdNYBtWjEsvZnIEyzfX6ugDJxRGeT3zSUm7ewXxdKk0ydqQduR6+O7bh0p8hKwv2ilpCHA+Mc8nz+9f2aJe20e6gr0LU2cAPKkfRFYypwKnXwGPoMi52+yTZTn4fCsgCxNmxXsSwe5ylEmWj6Sr5ztCrDDVpRTQAh90Og9tAoM4PTKIHc0Ffus5MViisZ+8ootwqLYDKtSHNEV9v/BIYA9nVTM5//nAz/A5EKT4zYIprseVhbogfh5AzlB799fbIqIoDqd91+kVNq1zJPf7mHQYymi9ePb9G8XBX/yeQgwIopt2n29ucdDdu3ynfv56eWj1saplUEGDIOdjaV8N7CHsmBrRsyYa9aFBXBX0Uoq5gHxJKrliP0N1xERDs3X2TZSzQZ50n5Bze/tLzaStH/noI62JLG/yeUz2ou1AooBP7zfOfiTTf9NWjEmfrB3/hov0HM/P90VUb7ybhvu9onlKgPK4JZ6bRnw3z7Cgm2hqMYRXccWwB1FK/lHAPzdKwKXSBkFhxaabBmuBM15cpJAB5rf2683Ow3aZS/5VVy75y3rMp77GGS7A+nHyjMrsAj4TWC7Vgy2QNULP391WQXbyxWqhsHvFhewpRMaKO4Cztt2wL3p9JuAnpQQ7kBFVqEqfAoRYOQui/t2m2LJ1swsWayrmMui+RGhaSO29jzVtF727urkrZVVQ0RAGan18+33FvyDwHYx2q/xdhOcW+VWwaZSmYcOjXJdbZ56jmHCbq2FOdtKOJfOYgDGuVOLC8DuIpXSg4DFPGMP/N4rrodqTbS7QpCzLKCk72tBi7i/xfeXcqyCFK/d+zPvP70P4W1J2cu731vwj4niWBf8DsDaJr+z3Qaqcr9242z7y7TBr/CV8bdJuAyJZQzvOIltEt9mzr6vK5mcPTLKsGn2LQDoybxtJVyz4msBAC2SvgG4V5GKaYGwYoBQgf3Zhk3d1pS9se4+af6W+W+JiEs/nc/hy3O2yTU6z1cgGpSZWS+v1g/vJ4E/LCVgmxjunPJ++PnpprxXppd+fnzMot03v+syaJo8fGQd1yzMMWV1N0yYJILjArT65rtmqM5iAJ79eG2RSiomraOPZfjuhLj7GphYsvqi+QPfPtSCpUUsneb65D+bvFo/37z/7B7FpQrxYM6r9dP6Etb8/jxnZR2DIVdrGn4NHtCa8ZrVKGoVRMqohDLJxzU6sUYyjlsxDM4eXcf2SpXeSfAOaRFq/glBSqEMhTK6swB+3U3Xikb8gZbJLz5qdUgAJuo2WypO14ITevJr/mjd6H7Dyk9ckd9Q8C/5jNOvXZ78zLI5rADP2krPzzp+0OxXwCYUG0Ql+/mJmvTwtwqC/XfKmErx4JFRbqoZ7FpazHmH891nT+Zsi9Fy2TluOyLY8SgAwJW0Q8qZ4v8eQCHQe78hv19ClkATmGnajJruiy9+4BYEedp+IzCrs5dBwCKh0WitPPnROfrxawaEgR93HMmVFwR/BSfQV13G4Fy7vFsqA7Rp5JC7jUD5OOKKJ4ezhkcYMgxuqi3kvr95Zc61AEImTkcWgAFw7uTiOHBz0crdRPzD4G+vc+c8aBNN22f2uya8f9uXpzvY11rwJv/l0/rdz/snZr/bOEC7oI7Uk/bj70sjdT96bEUY/BtQHC8m1dQgWRvI+YOAxU35tDYNfGVSg4DFA4vZbcK9h4Z5yOi6wDoOvZA52wJDgeFdC9VUxtJsJ22VfNuXAPfLW7EXEf9ouTbVzmuhbgtl5RSIBgM71/wATY2WVgykf1o/b1vFSCHJlJcI6OPay7+vAvtlnEDfoIqfausPiq1aqyBQPlujd/sOwvEDAwyaJr+amabR0VyB6D2as6ywBTBxzNX3dNS4PwD2ozwVwo9eMe0Xch18fr8Hfv/+pK2dIF5sMLAzze/tN3UQJOmXPaz9O4gZdODzFbYUREfuUJrGh3Tw+8uvR3ECpgN+4jW4kamdV4FVsALH3VKp8JiNYwwaJsUk/q7PWp4FYHjH7Mj/B58FYMBPNSzizOPI6FbxiH/Yzw+Cnwj4UTClhU0oVNIwIJ1bAs0WkDsYvehC23dv8qv0sqKR0OSgNBctuh/W+optuDP6vBLLpdFXqVXgtVnEKthQLvOEsTGumJ5ixuruUyQLloXgjGS4B+34lf7Wk/LqycUF4Md5K/Yq4p9mCdgKZjInBBW3BKyA+Z91RsUj+3nm/XcaB8jujQ6UjQN6vFXQ9vW9aPBGFCfiDu/RmUY3CmpWw18GX5sZ/na8D5/PzzfiyqRYBUWHOb0ywyWTJ4xtYmulkvuZir3DIs58AMM5aDcWQHgM/H+yKsStBBR+wAK/Yb8/1RJQoTYU00D2rMBiJGCJkti+pv5mz/vPkiIs3xUpiC4AfPfi+/arKI7HYAuGE0jzPcRGB2Z3p+PqnboQRi7CyThugHAgnnCKBxYrhsHjxsY4YSDT0E6VWTcOoJwb0rEFUArsiboAJQvAcJFG8kf8g7+RmECgjLNRU7AkQiU2EBjejzf38UjLHUK0DBU+asJvT65Crlp5jpq0NHi4vnK+JJDD9A8C3wA2YbAhYNL3NiiWZMoHy8eZ5lnj+emmPC2Q4ut/2JRvn29c37w2u3V/DAweNTbG0OwMt8zP04nMWc3WyfbMAjh3qjYPfCO9SlhLJ/yGwe/WjYv4Zw0NThkq8/2A8BChf98/I9D5UZFoTLGhv06CgNFjJUlPhgljhwX99zAY5BtBcSImG/3mfk4NZySVOdKsgl4GNJXiIRs28JANGzLvbNw9nm023RmARg8tAEc+D5yb56FL13H5I/4EyCAIflGKOVMx1rAxWprchWLifvIMQduNxBY34PNcgd4M88TnqwJlPStA+erF16+g2IJiuKWl4jXcatPomcG5PlgFaVZQbqvAy3cPctq6dQyVS/x8fKLQK8WzDc8CUNDB9wA8icyDP3dy8SqcmYGpkqbZOon4t8kg6gbYCuZMw6fJBdGk7JP4boCtlOQ7o+gZFh3y68+8//xtqdawYFvb+839LRiciMFwSzP1TsMZOcr42zR6dNygxRL24YOBRSPVwolaQUaKFRRoJ6HvTsDOcPx230SeE4dHeOL2bVSM/G/kzzYaTn2nje5HAULyiaIPZrcR/9Z+q72gqzFTMjNAn4MEBC2GofIO/bV+c4UMi12vpPxekoIH+XCddShOcs19owUoUkG6Ei/sFHUhjFzH7QXRZZwvQXLADda1gO+1r9pEsH1okKcddwzDpRJ5ZKHZdMZ7nIP3zgIAMBXfAa7PesJ6HfH3txEmhnpJsWTQHQkoI7TwSe9M+JioQY7S+fLzBv/iRPliAUM4w3rbMSiT4Of3ESwrbhX0jOh8VkHKcQPAVz7gtyyA1kQeUIoN1SpPP+E4NlazhwkFmHPjAHT4JiAkEMCrJhY18P48D10vI/5R6yFoJcxUSjlAn0wC2jBUPq3f+bz/pOuUVqaT/LxlFRpDwbBhsM4wsAyHSBuGwlbOtY5qLx9YSDKRfWDB1wYEynQ8nn84WwWqbd63ChhGgAg8MgjN6WeoXOacE49nx/BQ5n2ebTRAKQxldD8TMCwjk4vfmR8bvAR4fNLDFQF/IL2ziH9wP2gJLFRNNsyDEi/glxYIjO63lhyOPYsi0l0QsJdDf0ntAihlYJRKKGVgAVMJpRWCiaMNSihMwEQw3e0SipIS33ZywM5JygrwuaV8ZZYzONcu3+6bVyaujXYfs9toAdvHhE6b7TTVaszND5opVDB58gnHc8U9+7hjJvkdH5cArHKtOZP7IQlJIgG8EDgf3gZcg/MeSOxD1n6EyOXn+69uFvj9lgAotIL5qslIrZkb9K0Vhk3TUkqV0nR174b+0oN/8UfvYVmlMM2yM0SUQwTwJqc2kloPJbfIQnmkACVRmCjK7nZJOX9lEUqGyg189xRygzBKDuHyQWDHAd9rM7l8OtEFgO0dPwRs1WooBvj46zuuxWOOP5bhSoXrD8Ur+NlGA2WoifW/vLFj3zU14nDu5OIN548N/j3wV3EPDYTNdULgD/+GySAG/OH23ca9OnNDZYYWGumavgXetqiSKVnBv3QprvW7N/lVgbLOtTfMEqrwSyfFReOSRWC8NV1a5KAUJRRljyAUlJWirAz3F8oYLdJYFVYB8eSQR6OrdkNBCyFQ3pdPu+5Dj9nGcLXMlXv3RS7xzFIduhgBgAwCwLm3f4vimcBZXg+S/P4o+DuI+EfKBttslk3qJZNKw0qcERh/pqbPlu4+or9SQ3+xZZcR+N2IjWALtOZlZIgClyDafxXD/VUGZUNRaaUbVFCUjOWxCoLmPQS0fMACCJn+cRYAobqhtu+3ZTPDlQqX7tqDpb2grjBbr6OMzkcAIAcBnDu1WD9/bPClwK+AoeWI+MdbD+0254fLsmHJUpmg98QwLDEc8z93EDA2+Jcfnsti8iuFMkvQmtzUT+lv60lHbIqQY+HmlhgeIbikUFaKquEQRsVwicIwqBrOfhUDwyhgFXj5YT/fZwEkWwXxWt5v+ie1fdLGDZxTKXPR7buou28TLjSaNLTuswVAyxX4ExRfQVIi/q0a3Uf80yyB2nCF0clFMbTPjEg9S5NutH5UOmurmHZPOTWlwCz5fPzlB+dqFS1CXYQ6gJ3vS74lz4IwFFXlEoTpkMaAYVAxHcKo+n7d75rn1/Ixfn7LHYBQeT8Z0CKKbetG+KP7ncoPb72DuXodAfbPLfTXAvDk3MnF/zx/bPAsDPkLxAg98lFT300mzkrIE/GPBT+tfVUbqeiR2XpOAjB0u6+9H/pLo4GeWgKG4Wj7AjPG1iRbLBEs26ZW4MvfLSvCdInBNKO/JbP1WykZATLwWwAB4LvpSQHFDUODPPvM0/jhLbdxaKHGrqnp/lsAnoih3qO0HIeSl7RBn+Hn5wR/OOIPKcONChbWVWVktp7daaUsTKMUbKkT6c5y6HToTwAMEzHN9gOyJj2Xok9GXWvqWreHTzJEKRVLDAMld79UYqDs+y2XKBsGcUOKQ9UKzzrrdH586+3snJjMAYJkKUQArx2v6fM3Db1KiQwKPAdl9DXiHygbIgqrbJr1gVKzumSVSZOSIRRY/GO5P/WdWFYpxDAR01vacvXKmgOSLSLCkmWzZNmQE7KmoVxyMBkol1xyKDFQKbFuoMpDTziu8bt9BzSHDnXcr46erPPHBsvAf9nKeKGonJYADojz+vn+/YiV4MrgQqM5dnAhnQAGK01KZjli5if9Sp5yaSV8Nz1mOzPfMNBGyTH316RLWd3UVDYNyoahDUPNinBIKSZMZcwZSs0IHDQUk+WSOVMyjfGSYUwMV8szm0aGZ4/bOHqoUipNjH33V0vd9qFj1XL++gEDU33KVsY7tGHEgt35jWrwLJchjgwkxvxVgt6+Z1obtiRZMsLIoIWinA19dy8HAaStCdQR6JVCG6aj8VeNmb+6wbNapOSMKohpqHmBcQWThlIzhlIzSnFIoaZKhjFtGmrCNNT4QKk0vXGwOrdj/cj4aKU8sdneOKcuvXTF+t/103b+2ODrbMP4F1sZ1SLTfDuxBOJk3dTi0uj00kDC3akzWK12p/1z1XR/25LHEtCG4QJ/TduvpJju/AJTGYvABDBhKKZNpeZAHVKKSVOpqYppTJaUMT5QMqbWV6tz24YGJkYr5YmyacyMXXFT9qeBV6H0RN2cPzb4YNsw/tsyzPvkjfj7hwETI/4Jpr9fTFs3t981Y+B8kj4oA+U65VI1UduHf3OZ/2kE0ZYk7S+Gge0Cf016J4Y79m8q1VAwqRSTCjVpKOYUatxQTJmoSVOpqZJShyqGmhopl2a3VqtTGyuVccOU6R3X7urPVz1XsfTM3jx/rDqkjdJHm4bxVm04Ki2TDCDk56eMDqTIpgPzSwO1ZtQKGBlooFTFD9l84O+EBpJBr5WBNg20MlaRiR8vK2n4K5wpwSXDsBVMK5hwTepZBZMKJk2lJk2lpitKHaoYxtSwaU6PlcrTGyrmhKI0ea9bdnftFx9N0vOn8fxNQw9rmOY/24bxCFFhsOfz84uAH2Bgqbmwad98cCFTw2gwXK1kan3vt5D2zzb/HS1vYB8GoO+lKPBeAhIDNatgAsWUAdMGakopJg2YMpWaMpUaLys1OWAYU+tL5uymUnlcKWNqYf09cw+9eqXP5OiQvjyZX9mGWtIjz7VM4yO2YZzWi4h/lmzfO7NgNnWbBCqlJarlgdya3EcAnWh/rRS2csx7+zD36RWOX1xCYShqOMGtKYWaNmBaKSYM1JQBUyUfiEcMY2Z9qTRhiprSZnPmwTunDku/+GiSvqqm/2/9gGFXS8+xTeMvbcN8uOQM+nWiMUdnl2rrJhaHWglD1UUxjcHuh/7icxwt3wa9XoVa3sTRxgbUHRNaTQGThmJGoSYNZ8HlKQM1XkJNlJWaGjKMmQ2GOWmgJlVZTz9i99RR5xcfTbJsT+3ntw4/1DLNN9qG8XzbMDZ2EvFPE1Pr5rY9s1ppqaJUnZGBsiBOLCIrCJhz6M8yFLZSLvBbr4lARz3OJ050U2GA5WrhKZBJAzXjBrumDBfMZdR4SampQdTUsGFOlVBTiJp83KGpNb94TWJl2dXW+WODVcs0n94sGc/RhvF02zA224bq2PT3y9j4wvzgXGOEslmXgUq1U+0vgK0EWyksA2zlLEbSqRiAIWCgtIIZ5SzOM6XcPwPl/jJpwHgJNVVBTQ2hpstKTQJTmyfn5x663DdrTY54WVG79cubh0yt5cG2YTzBNo0/1EqdrQ21VRsKrZQzQUYFXYW2shWUOBOHlYASodqwltYfqJUZrDSkZAw6pdKDgDYO2C3lLD9uKdAqqtMVHohBCfM4UekpzzdWvn0DxsvCZEnU1ABquiROntWUmecvLa35xWuyamRVOa7/cxxqvjZ4IvAA4AzgVPfvBOBYkpcxb0l5wZoxK9VBQSrgQN1WYKOxAe168BqWbMWUIFOufzytYApxNLESmTBRE6YwVdG0QazU9Mtq9TW/eE2OCFlVBJAmXxobLgl6G7AN2ARsBEbdvxFgCBhQlmxSNtMiMm2jpy1kwhCmTFumSpopDKYUavKVDWvNL16TNVmTNVmTo1f+fxtTZy/G8a7EAAAALnpUWHRkYXRlOmNyZWF0ZQAAeNozMjA01zUw0zU0DzE0sTIxtzKw0DYwsDIwAABCRAUYaDWjtQAAAC56VFh0ZGF0ZTptb2RpZnkAAHjaMzIwNNc1MNM1NA8xNLEyMbcysNA2MLAyMAAAQkQFGEEKCz0AAAAASUVORK5CYII=

contributors:
  - Peter Johnson <john@example.com>
  - John Doe <john@example.com>

The logoUrl should be a base64 encoded version of the logo for the package (usually technology logo).

README.md

Each package must provide a README.md file in the root directory. You can write it in markdown format and as a minimum it should contain information about what the package does and how you are expected to use it.

README.md - Title

(this should be the name of the package but may include a couple of extra words if it help provide a meaningful title, must be less than 40 characters)

Underneath the title there should be a description of what it does and why. Focus on what log sources does it apply to, what data does it use and what does it show from that data. Make it really clear as to what the purpose of the package is.You can include links to external websites as long as they are directly relevant and help explain the package or add context. You can include links to Humio's documentation library to explain concepts and provide technical details or helpful tips.

README.md - Package Contents

List which of below are included. (you can include a description of each component if you wish but limited to 100 characters each. All packages need to include the required parsers. This may change in the future but for now a working parser must be included (it can be subject to dependencies as listed in the dependencies section below).

  • Parser

  • Queries

  • Alerts

  • Dashboards

README.md - Use Case

Use Case: (list all that apply from the selection of DevOps, SecOps, ITOps, IoT/OT)

  • DevOps - used by devops teams to provide observability of applications and the platforms the code runs on, including containerised and micro-services type environments.

  • SecOps - useful for security operations teams, typically to provide security monitoring and SIEM like functionality.

  • ITOps - used by IT operations teams to monitor IT systems and to provide investigations and root cause analysis

  • IoT/OT - used to provide security and/or operational management of Internet of Things devices or Operational Technology such as Scada and industrial process control and monitoring.

Technology Vendor: (list of vendors supported by package) e.g. AWS (Amazon Web Services) or Cisco.

  • Support: describe the level of support offered for this package. The default would be:

  • If you have any issues implementing or running this package, please go to support.humio.com for assistance.

  • If the package creator is not CrowdStrike/Humio then describe what support is offered by the package creator.

Dependencies:

  • List/describe dependencies for your package to work. These will typically include versions or configurations of the log sources and often the log collection method and formatting of logs. You can include a sample line of log data to illustrate the required format.

Installation:

Instructions on how to ingest the data and how to install and use the package. Must include any required configuration in external systems such as log sources as well as explaining any optional configurations or choices that need to be made. These should be summary instructions with a link to the Humio documentation library and the specific integration step by step instructions.

If your package is a collection of template files for a specific technology, a short description is usually enough.

README Files for Apps

If your package is an application, it should also explain:

  • Any additional pre- or post-installation steps users need to take.

  • A general introduction about how to get started, e.g. including configuration files.

README File Restrictions

The README cannot currently contain images or HTML tags. We plan on easing this restriction to allow images that have been vetted by Humio and hosted on servers hosted by Humio.

README.md Examples
ini files
## Corelight Threat Hunting Guide
This package contains alerts and saved searches that use Zeek (fka Bro) data from Corelight network sensors. The package contains around 60 different alerts/searches that are useful when threat hunting within Corelight data to detect potentially suspicious activity. This package is intended to accompany the [Corelight Threat Hunting Guide](https://www3.corelight.com/corelights-introductory-guide-to-threat-hunting-with-zeek-bro-logs).
 
The guide provides an excellent introduction to threat hunting with Corelight data and is aligned to the Mitre ATT&CK framework (v6). Corelight provides a rich source of logs for threat hunters and is capable of detecting a large range of attacker tactics and techniques. The name of each alert/search includes the relevant Mitre ATT&CK tactic and techniques (as names and references codes). When threat hunters are reading the Corelight guide they can search the Humio package based on tactic and technique names or numbers to find the relevant Humio searches/alerts and simply click to run those searches.
 
The Corelight Threat Hunting Guide explains what to look for, this package shows you how.
For more information on how Corelight can provide valuable data for your security operations please visit www.corelight.com
 
## Package Contents
- Parser for Corelight JSON data
- Saved Searches
- Alerts (with no action defined)
 
## Use Case
- SecOps
 
## Technology Vendor
Corelight
 
## Support
Supported by Humio and Corelight. https://support.humio.com/ and support@corelight.com
 
## Dependencies
> ℹ️ The parser included assumes data is sent from Corelight in JSON format.
 
The package uses logs from the following log files from Corelight (all suffixed with .log): `conn`, `dce_rpc`, `dnp3`, `dns`, `files`, `http`, `kerberos`, `modes`, `notice`, `rdp`, `smb_files`, `smb_mapping`, `smtp`, `ssh`, `ssl`, `weird`. Please make sure all these log types are sent to Humio as otherwise some of the searches/alerts may not work.
 
## Installation
The preferred option for sending logs from Corelight to Humio is to choose 'Export to Splunk HEC' (available under the Sensor-> Export menu in the Corelight management interface). For 'HEC URI', enter your Humio service URL appended with `/api/v1/ingest/hec` (e.g. `https://cloud.humio.com/api/v1/ingest/hec`) For further information on using the Humio HEC see [the documentation](https://docs.humio.com/docs/ingesting-data/data-shippers/hec/).
Installing the package will automatically deploy the `corelight-json` parser, saved searches, and alerts directly into the repository you install the package into.
You will need to link the parser to an ingest token within Humio.
 
If you have already installed the `corelight-json` parser as part of the `corelight/sensor` package then you can use this existing parser as it is identical to the `corelight-json` parser in this package.

Note

Note that the README provides details ensuring that a user knows at least how their ingested data should arrive to ensure it is compatible with the parsers in the package. It is highly desirable that the README provides details on the exact procedures for data collection (i.e. a howto on getting the specific data source(s) into Humio).

Asset Files (Alerts, Dashboards, etc)

The best way to get started with asset files is to export assert you have authored in Humio and tweak them in a text editor.

Each file contains a $schema field which references the JSON schema that it is validated against.

Schemas

All schemas are hosted at: https://schemas.humio.com/

Tip

Many editors have support for Json Schemas and will give you suggestions and and validate the files on the fly. One such editor is Visual Studio Code.

Lookup Files

Packages can also contain lookup files. These are either CSV or JSON files, which Humio can use to look up data in while searching. These files do not have any schemas, and are stored in the data folder. Additionally some file has been added in the data folder of a package, it can be referred to from queries by typing packageScope/packageName/nameOfFile.csv, as opposed to just nameOfFile.csv that you would normally look up such a file with.