mattermost-plugin-skype4business

README

Mattermost Skype for Business Plugin (Beta)

Maintainer: @kosgrz Co-Maintainer: @mickmister

Start and join voice calls, video calls and use screen sharing with your team members with a Skype for Business plugin for Mattermost.

Clicking a video icon in a Mattermost channel posts a message that invites team members to join a Skype for Business meetings call.

Originally developed by kosgrz.

Installation

Skype for Business Online

1. Install the plugin
   1. Download the latest version of the plugin from the GitHub releases page
   2. In Mattermost, go to System Console -> Plugins -> Management
   3. Upload the plugin
2. Register an Azure Active Directory app
   1. Sign in to https://portal.azure.com/#home
   2. On the left-hand sidebar, select Azure Active Directory, then navigate to App registrations -> New application registration
   3. Set the following values:
      • Name: Mattermost Skype for Business Plugin - [your company name]
      • Supoorted account types: Accounts in any organizational directory and personal Microsoft accounts (e.g. Skype, Xbox, Outlook.com)
      • Redirect URI (optional): Web, then enter "https://your-mattermost-url.com/plugins/skype4business/api/v1/auth_redirect" replacing https://your-mattermost-url.com with your Mattermost URL
   4. Click Register to submit
3. Grant permissions for your application in Azure Active Directory
   1. Select API permissions in the application sidebar menu, then Add a permision -> Skype for Business -> Delegated permissions
   2. Click the Meetings dropdown, then check Meetings.ReadWrite.
   3. Click Add permissions to submit
   4. Click Grant admin consent for ..., then Yes to confirm
4. Allow implicit flow in Azure Active Directory
   1. Select Manifest in the application sidebar menu
   2. Set the oauth2AllowImplicitFlow and oauth2AllowIdTokenImplicitFlow values to true
   3. Click Save
5. Configure the plugin in Mattermost
   1. Select Overview in the application sidebar menu
   2. Copy the Application (client) ID value
   3. In Mattermost, go to System Console -> Plugins -> Skype for Business, and enter the Application ID you copied on the previous step
   4. Choose Online as the Skype for Business Product Type.
   5. Click Save
6. Enable the plugin
   1. Go to System Console -> Plugins -> Management and click Enable underneath the Skype for Business plugin
7. Try it out
   1. Go to a Mattermost channel and click the Skype for Business icon in the channel header
   2. A dialog will open asking you to sign in to microsoftonline.com
   3. Once signed in, the dialog will close and a new message posted to the channel, with a link to the newly created meeting
   4. By clicking the "Join meeting" button, you will be redirected to a meet. page, which in turn opens a Skype for Business client installed on your computer or smartphone to join the meeting

Skype for Business Server

1. Install the plugin
   1. Download the latest version of the plugin from the GitHub releases page
   2. In Mattermost, go to System Console -> Plugins -> Management
   3. Upload the plugin
2. Configure the plugin
   1. Go to System Console -> Plugins -> Skype for Business
   2. Choose Server as the Skype for Business Product Type
   3. Enter the Server Domain of your Skype for Business server instance. For example, contoso.com.
   4. Enter the Skype for Business Bot Username of your bot user created in the Skype for Business domain. For example, bot@contoso.com. We strongly recommend using a dedicated bot account for this plugin, rather than an existing Skype for Business user account.
   5. Enter the Skype for Business Bot Password of your bot user created in the Skype for Business domain.
   6. Click Save
3. Enable the plugin
   1. Go to System Console -> Plugins -> Management and click Enable underneath the Skype for Business plugin
4. Try it out
   1. Go to a Mattermost channel and click the Skype for Business icon in the channel header
   2. Observe a new message posted to the channel, with a link to the newly created meeting
   3. By clicking the "Join meeting" button, you will be redirected to a meet. page, which in turn opens a Skype for Business client installed on your computer or smartphone to join the meeting

Developing

This plugin contains both a server and web app portion.

Use make dist to build distributions of the plugin that you can upload to a Mattermost server for testing.

Use make check-style to check the style for the whole plugin.

Server

Inside the /server directory, you will find the Go files that make up the server-side of the plugin. Within there, build the plugin like you would any other Go application.

Web App

Inside the /webapp directory, you will find the JS and React files that make up the client-side of the plugin. Within there, modify files and components as necessary. Test your syntax by running npm run build.