[{"_1":2,"_155":-5,"_156":-5},"loaderData",{"_3":4,"_13":14,"_21":22,"_134":135},"root",{"_5":-5,"_6":-7,"_7":8,"_9":-7,"_10":11,"_12":-7},"currentUser","primaryEmail","siteVerification","6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI","toast","enableDev",false,"incidentStatus","routes/_layout",{"_15":-5,"_16":17,"_18":17,"_19":11,"_20":11},"username","isAskGordonEnabled",true,"isUsingNewTemplate","showMinimalLanding","showHoneypotTrap","routes/_layout.r.$namespace.$reponame",{"_23":24,"_25":-5,"_26":11,"_27":11,"_28":29,"_30":31,"_32":-5,"_33":11,"_34":35,"_84":-5,"_85":86,"_125":-5,"_126":11,"_127":17,"_128":11,"_129":-5,"_130":11,"_131":-5,"_132":133},"canonicalUrl","https://hub.docker.com/r/tmunzer/mwtt/tags","mcpServer","canSeeDockerfile","canSeeAutobuilds","namespace","tmunzer","reponame","mwtt","cloudBuildSource","isAutobuildsAvailable","repo",{"_36":37,"_38":39,"_41":42,"_43":44,"_45":11,"_46":47,"_48":49,"_50":51,"_53":31,"_28":29,"_54":55,"_56":40,"_57":58,"_59":60,"_61":62,"_63":-5,"_64":58,"_65":66,"_67":11,"_68":29,"_69":70,"_75":11,"_76":77,"_81":29,"_82":83},"categories",[],"content_types",[40],"image","date_registered","2020-02-20T08:15:14.469466Z","description","Mist Want To Talk","is_private","last_updated","2025-01-22T13:47:12.555777Z","last_modified","2025-01-22T13:47:41.451332Z","media_types",[52],"application/vnd.docker.container.image.v1+json","name","pull_count",1666,"repository_type","star_count",0,"status",1,"status_description","active","source","collaborator_count","full_description","# Mist Want To Talk\nMWTT is a small python app to publish Mist Webhook messages to Slack or MsTeams channels.\n\nIt is composed of lightweight python web server ([Flask](https://github.com/pallets/flask)) and python code to process the webhook information and send it the Slack/MsTeams channels.\n\nThis script is available as is and can be run on any server with Python3. \n\nThe script is also available as a Docker image. It is designed to simplify the deployment, and a script is available to automate the required images deployment.\n\n* [Features](#features)\n* [Mist Configuration](#mist-configuration)\n* [Docker Deployment](#docker-image-deployment)\n* [Source Code Deployment](#source-code-deployment)\n\n## MIT LICENSE\n \nCopyright (c) 2021 Thomas Munzer\n\nPermission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the \"Software\"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.\n\n# Features\n* Send the messages to different slack channels depending on the severity level (can be configured):\n

\n\n* Send the messages to different MS Teams channels depending on the severity level (can be configured):\n

\n\n* Send the messages to different Google Chat channels depending on the severity level (can be configured):\n

\n\n# Mist Configuration\n## Webhook Configuration\nTo get this script working, you will have to manually configure webhooks on your Mist account and enable the \"audits\", \"alarms, \"device-events\" and/or \"device-updowns\" topics. This configuration can be done at the Organization level, or at the site level, depending on your needs.\n\nFor some topics, if they are enable at the Org and Site(s) levels, you may receive the same message multiple times.\n\nThis will tell Mist Cloud to send events (like AP Connected/Disconnected) to the MWTT FQDN. As of today (January, 2020), some topics like the \"device-events\" topics cannot be enabled directly from the Mist UI. This configuration can be done through Mist APIs. You can use the web UI to manage APIs by reaching https://api.mist.com/api/v1/orgs/:your_org_id/webhooks or https://api.eu.mist.com/api/v1/orgs/:your_org_id/webhooks (Be sure to replace \":your_org_id\" first). Then you will be able to create a new webhook by using the following settings:\n\n```json\n {\n \"url\": \"https:///\",\n \"topics\": [\n \"device-events\"\n ],\n \"enabled\": true\n }\n ```\n\n\n## SSL Certificate\nIn case you are using a Self-Signed certificate, be sure to configure the Webhook in the Mist Cloud to not validate the SSL certificate. This can be done by adding `\"verify_cert\": false` in the webhook configuration:\n```json\n {\n \"url\": \"https:///\",\n \"topics\": [\n \"device-events\"\n ],\n \"verify_cert\": false,\n \"enabled\": true\n }\n ```\n\n## Secret\nTo improve the webhook security, Mist allows to configure a secret in the webhook configuration, which will add two HTTP headers: \n- `X-Mist-Signature-v2`: HMAC_SHA256(secret, body)\n- `X-Mist-Signature`: HMAC_SHA1(secret, body)\n\nTo configure the secret in Mist, you just need to add the `\"secret\": \"mysupersecret\"` setting in the webhook configuration (please not this is just an example and we are recommanding to use something stronger than \"mysupersecret\"):\n```json\n {\n \"url\": \"https:///\",\n \"topics\": [\n \"device-events\"\n ],\n \"secret\": \"mysupersecret\",\n \"enabled\": true\n }\n ```\n\nThis App can be configured to validate the `X-Mist-Signature-v2` when receiving a new webhook, allowing to validate the origin and the content of the received webhook.\nThe secret is configured with the `mist_secret` parameter in the `config.py` file.\n\n# How to use it\n\n## Docker Image Deployment\nYou can easily deploy this application as a [Docker](https://www.docker.com/) image. The image is publicly available on Docker Hub at https://hub.docker.com/r/tmunzer/mwtt/.\nThis is the preferred way if you want to use the application.\n\nIn this case, you can choose to \n* manually deploy the image and create the container. In this case the Mwtt container will listen for HTTP messages on port `TCP51361`\n* use docker-compose to deploy the mwtt container and Nginx container acting as a reverse proxy. This is the prefered way and will allow you to easily manage the SSL Certificates with Nginx. In this case Nginx will listen on port `TCP443` (HTTPS) and forward the request to the Mwtt container based on the HTTP Host (see below)\n\n### Docker-Compose Step by Step procedure\n1. create a folder used to store the permanent data (config file, certificates, ...). In this example, we'll use `/home/demo/docker`\n2. in this folder, create a `mwtt` and a `nginx` folders\n3. in `/home/demo/docker/mwtt/`, create the `config.py` file to configure the application. You can find an example [here](https://github.com/tmunzer/mwtt/blob/master/src/config_example.py)\n4. in `/home/demo/docker/nginx/`, create or copy SSL certificate and key Nginx will use for HTTPS communication. The files names MUST be `foo.bar.com.crt` and `foo.bar.com.key`, where `foo.bar.com` is the Mwtt Application FQDN (for example, if Mist is sending the webhooks to `mwtt.mycorp.com`, the certificate filename must be `mwtt.mycorp.com.crt` and the key filename must be `mwtt.mycorp.com.key`)\n5. download the [docker-compose.yaml file](https://github.com/tmunzer/mwtt/blob/master/docker-compose.yaml), and edit the required paramters\n - line 9 : replace `` with the folder created in step 1. In this example, line 9 will be `/home/demo/docker/nginx:/etc/nginx/certs:ro`\n - line 20: replace `` with the application FQDN (same as step 4). Based on the example used in step 4, line 20 will be `- VIRTUAL_HOST=mwtt.mycorp.com`\n - line 22: replace `` with the folder created in step 1. In this example, line 9 will be `/home/demo/docker/mwtt/config.py:/app/config.py:ro`\n6. start the containers with the docker-compose command: from the folder where you downloaded the `docker-compose.yaml` file, use the command `docker-compose up`. This will download the required docker images, start the containers, and display the logs on the console. After a few seconds, your Mwtt is ready to receive Webhooks messages from Mist\n\n**Note:**\nWhen using the command `docker-compose up`, the logs are displayed, and using `Crtl + C` will stop the containers. If you want to start and run the containers in background, please use the command `docker-compose up -d`\n\n## Source Code Deployment\nIt is possible to start the application directly from the source code. This is the prefered way if you want to bring modification to the code.\n\n### Step by step procedure\n1. install [Python](https://www.python.org/) and Pip\n2. Clone the repository on your computer\n3. from the `src` folder, use the `python3 -m pip install -r requirements.txt` command to install the required dependencies (exact command may vary depending on your OS)\n4. create a `config.py` file in the `src` folder to configure the application. You can find an example [here](https://github.com/tmunzer/mwtt/blob/master/src/config_example.py)\n5. run the app from the `src` folder with the command `python3 ./mwtt.py` (exact command may vary depending on your OS)\n\n\n","has_starred","hub_user","immutable_tags_settings",{"_71":11,"_72":73},"enabled","rules",[74],".*","is_automated","permissions",{"_78":17,"_79":11,"_80":11},"read","write","admin","user","storage_size",2025919647,"orgData","recentTags",[87],{"_88":40,"_89":90,"_91":92,"_93":94,"_95":96,"_97":98,"_46":114,"_115":90,"_116":29,"_117":52,"_53":118,"_119":120,"_121":105,"_122":114,"_123":62,"_124":17},"content_type","creator",806974,"digest","sha256:f3acb339ba1e638c3f6cb85d134596999d39e2c3e03a8c1d9650ca7f80952106","full_size",52043125,"id",87521939,"images",[99],{"_100":101,"_91":92,"_102":103,"_104":105,"_106":107,"_108":109,"_110":103,"_111":-5,"_112":94,"_59":62,"_113":-5},"architecture","amd64","features","","last_pulled","2026-09-25T01:29:29.004465249Z","last_pushed","2025-01-22T13:47:11.754093276Z","os","linux","os_features","os_version","size","variant","2025-01-22T13:47:12.120236Z","last_updater","last_updater_username","media_type","latest","repository",8518525,"tag_last_pulled","tag_last_pushed","tag_status","v2","sbxKitMetadata","isPotentialSpam","isHubSbxKitsEnabled","showSbxLogoOverride","sbxTrademarkText","displaySecurityMetadata","tagAttestations","tagsHaveAttestations",[],"routes/_layout.r.$namespace.$reponame.tags",{"_34":136,"_143":144,"_132":153,"_154":11},{"_36":137,"_38":138,"_41":42,"_43":44,"_45":11,"_46":47,"_48":49,"_50":139,"_53":31,"_28":29,"_54":55,"_56":40,"_57":58,"_59":60,"_61":62,"_63":-5,"_64":58,"_65":66,"_67":11,"_68":29,"_69":140,"_75":11,"_76":142,"_81":29,"_82":83},[],[40],[52],{"_71":11,"_72":141},[74],{"_78":17,"_79":11,"_80":11},"tags",{"_145":60,"_146":-5,"_147":-5,"_148":149},"count","next","previous","results",[150],{"_88":40,"_89":90,"_91":92,"_93":94,"_95":96,"_97":151,"_46":114,"_115":90,"_116":29,"_117":52,"_53":118,"_119":120,"_121":105,"_122":114,"_123":62,"_124":17},[152],{"_100":101,"_91":92,"_102":103,"_104":105,"_106":107,"_108":109,"_110":103,"_111":-5,"_112":94,"_59":62,"_113":-5},[],"canDeleteTags","actionData","errors"]

tmunzer/mwtt

Tags for tmunzer/mwtt