Azure based Membership Management

Auto manage Team and Space memberships on Webex with Azure AD Groups.

This is a proof-of-concept application that automatically links Azure Active Directory group memberships to corresponding team memberships on Webex by creating those teams and then adding Webex users to them. For example:

Your organization has an Azure AD group named chicago-employees for all employees based in Chicago. This PoC will automatically create a corresponding chicago-employees team on Webex and add those employees to it. As a result, Chicago-based employees can collaborate seamlessly on Webex by creating Spaces without an admin or group owner manually adding or removing members using their email IDs.

The target audience for this PoC are IT Administrators or group owners who want an effortless way to manage team memberships on Webex across their organization. The PoC supports Dynamic and Assigned/Static Azure AD memberships as well as Security and O365 Azure AD groups.

Table of Contents (click to expand)

• Overview
• Setup
• Demo
• Disclaimer
• License
• Support

Overview

At it's core, the application is a collection of background processes that run on a predefined schedule.

These processes, collectively, retrieve and compare membership details across the two platforms; treating AD groups as the source.

Finally, the application utilizes a Webex Bot account to create, update or delete teams on Webex, as required. Of course, this is an over-simplification of the steps involved. For example, syncing large orgs with thousands of users can be particularly time-consuming. However, this POC can be modified to account for many such scenarios.

Setup

These instructions assume that you have:

• Administrator access to an Azure AD Tenant and Webex Control Hub.
• Configured the SCIM based connector to automatically provision and de-provision users to Webex. Future versions of the project may not need this, but for now, please complete either of these tutorials first:
  • Tutorial: Configure Cisco Webex for automatic user provisioning
  • Synchronize Azure Active Directory Users into Control Hub
• Docker installed and running on a Windows (via WSL2), macOS, or Linux machine.

Open a new terminal window and follow the instructions below to setup the project locally for development/demo.

1. Clone this repository and change directory:

   git clone https://github.com/WXSD-Sales/azure-based-membership-management && cd azure-based-membership-management
   

2. Copy .env.example file as .env (you may also change the database credentials within this new file):

   cp .env.example .env
   

3. Review and follow the Quickstart: Register an application with the Microsoft identity platform guide.

   • Select the following Microsoft Graph API permissions:

     API / Permissions name	Type	Description
     Directory.Read.All	Delegated	Read directory data
     email	Delegated	View users' email address
     Group.Read.All	Delegated	Read all groups
     GroupMember.Read.All	Delegated	Read group memberships
     offline_access	Delegated	Maintain access to data you have given it access to
     openid	Delegated	Sign users in
     profile	Delegated	View users' basic profile
     User.Read	Delegated	Sign in and read user profile
     User.Read.All	Delegated	Read all users' full profiles

   • Use these Redirect URIs:
     • https://localhost/auth/azure/callback
     • http://localhost/auth/azure/callback
   • Take note of your Azure Tenant ID, Application ID and, Client Secret. Assign these values to the AZURE_TENANT_ID, AZURE_CLIENT_ID, and AZURE_CLIENT_SECRET environment variables within the .env file respectively.

4. Review and follow the Registering your Integration on Webex guide.

   • Your registration must have the following Webex REST API scopes:

     Scope	Description
     spark-admin:people_read	Access to read your user's company directory
     spark:kms	Permission to interact with encrypted content

   • Use these Redirect URIs:
     • https://localhost/auth/webex/callback
     • http://localhost/auth/webex/callback
   • Take note of your Client ID and Client Secret. Assign these values to the WEBEX_CLIENT_ID and WEBEX_CLIENT_SECRET environment variables within the .env file respectively.

5. Review and follow the Creating a Webex Bot guide. Take note of your Bot ID and Bot access token. Assign these values to the WEBEX_BOT_ID and WEBEX_BOT_TOKEN environment variables within the .env file respectively.

6. Install Composer dependencies for the application:

   docker run --rm \
    -u "$(id -u):$(id -g)" \
    -v $(pwd):/var/www/html \
    -w /var/www/html \
    laravelsail/php81-composer:latest \
    composer install --ignore-platform-reqs
   

7. Start the Docker development environment via Laravel Sail:

   ./vendor/bin/sail up -d
   

8. Generate the application key:

   ./vendor/bin/sail php artisan key:generate
   

9. Initialize the database for the application:

   ./vendor/bin/sail php artisan migrate:fresh
   

10. Install NPM dependencies for the application:

    ./vendor/bin/sail npm install
    

11. Run Laravel Mix:

    ./vendor/bin/sail npm run dev
    

Lastly, navigate to http://localhost in your browser to complete the setup. To stop, execute ./vendor/bin/sail down on the terminal.

Demo

A video where I demo this PoC is available on Vidcast — https://app.vidcast.io/share/0b200a83-b489-4757-9b9a-d6dd340c7f43 and Youtube — https://youtu.be/lKNUpkCK6uI&t=87s.

Disclaimer

Everything included in this repository is for demo and Proof of Concept (PoC) purposes only. Use of the PoC is solely at your own risk. This project may contain links to external content, which we do not warrant, endorse, or assume liability for. This project is for Cisco Webex use-case, but is not official Cisco Webex branded project.

License

MIT

Support

Please reach out to the WXSD team at [email protected] or contact me on Webex ([email protected]).