Webex Spaces Monitor

Use Case

In K-12 environments students with Webex access may be able to create spaces outside of admin view and misuse the technology. This container and script can be used to match newly student created Webex spaces then transfer ownership to an administrator and remove other users or delete the space entirely.

The intent is to provide ongoing monitoring of newly created spaces and move those under the control of school teachers or administrators.

Description

Runs a Docker container to pull all recent Webex Room/Space membership changes capturing new room creation by students and moves them to admin control.

Related Learning Labs

• Getting Started with Webex APIs - https://developer.cisco.com/learning/tracks/collab-cloud
• Getting Started with Containers (Specifically Intro to containers part 1 and part 2) - https://developer.cisco.com/learning/tracks/containers

Usage

All variables MUST be defined in "webexinfo.json" for script to function.

Variable descriptions:

• ClientID and ClientSecret - from Webex Integration (used for token renewal and access to API)
• BotID and AuthToken - for Webex Bot (Bot to post messages to Teams Space)
• SpaceID - Webex space ID where the Bot is a member and will post logs
• studentMail and facultyMail - Pattern to match for student and faculty accounts.
• action - options are "update" or "delete" - Update will add the admin to the room and remove all other members. Delete will delete the room.
• harmless - options are "yes" or no" - Yes will disable the action changes from occuring and only log what action would be taken. No will process the actions.
• loglevel - options are INFO or DEBUG - Adjust logging verbosity.

Docker container setup:

• Script runs within a Docker container. Info on Docker and setup can be found at https://www.docker.com/get-started
• Once Docker is running, navigate in your terminal program to the path where the included dockerfile resides and build with the following command: "docker build -t webexmon ."
• Navigate to the "persist" folder included and run the container with: "docker run -d -v $PWD:/persist webexmon python ./app/monitor.py"

Version

• v.2.0.1 - all earlier revs built by James Martin. This version is repackaged based on webexteamssdk. Tokens managed via requests library. Wrapped in Docker for standardized deployment.
• v.2.1.0 - Added action, harmless and loglevel functionality.
• v.2.1.1 - Standardize function naming format.

Acknowledgements

Thanks to Jim Martin for sharing the logging and token handling components and the awesome script this is based on.