A Strapi plugin for managing uploads to Mux.
This plugin provides the ability to upload content via a url or a direct file upload to Mux.
npm i strapi-plugin-mux-video-uploader
- or -
yarn add strapi-plugin-mux-video-uploader
- A Mux account
- You will need both the Access Token and Secret Key scoped with "Full Access" permissions which can be created in the Mux Dashboard
- The Webhook Signing Secret which can be created in the Mux Dashboard (See the Webhooks section for more info)
- Tested with Strapi v3.6.2 Community Edition
Please note: We've currently disabled webhook signature verification as there is not a way to access the raw request body from the Koa.js middleware (which Strapi is using for parsing requests). This is needed to ensure that we are verifying the signature and that the request JSON payload has properties in the same order that was used for generating the signature.
When setting up your Webhook configuration in the Mux Dashboard, the "URL to notify" field should be in the format of—
{STRAPI_BASE_URL}/mux-video-uploader/webhook-handler
Where {STRAPI_BASE_URL} is the publicly accessible hostname of your Strapi instance.
In order for this plugin to communicate with Mux, some configuration values need to be set for the plugin before it can be used.
With your Access Token, Secret Key and Webhook Signing Secret, navigate to the Settings view within Strapi and click the "General" section under MUX VIDEO UPLOADER.
On this view, set the appropriate values to their fields and click the Save button.
Currently, anyone with "Super Admin" access to your Strapi instance will be able to utilize the plugin for uploading and managing content.
Aside from admin permissions, a public user role needs to be configured to allow access to the muxwebhookhandler method. This is needed so that Mux can send Webhook events to your Strapi instance for updating MuxAsset content types.
To enable this permission, do the following steps—
- Log into the Strapi admin UI and navigate to "Roles & Permissions"
- Click on the edit button aside the "Public" role
- Drop down the "MUX-VIDEO-UPLOADER" section and check the box nexzt to
muxwebhookhandler - Save changes
- Upload videos using a url or a file to Mux from inside of Strapi
- Mux updates Strapi when the asset is ready
- A
MuxAssetcontent-type is provided to track asset readiness and that can be referenced by other Strapi content-types
Contributions, issues and feature requests are welcome!
Feel free to check issues page.
Yes! However, in order to make it work, you'll need a "Webhook Relay" that runs from within your network. You can use a Webhook Relay service like Smee (https://smee.io/) or ngrok (https://ngrok.com/) to forward Webhook events to an instance of Strapi behind a firewall.