Skip to content

Connect a Video Platform

MediaShield overviewFree + ProGet MediaShield →

PRO - requires MediaShield Pro. Without Pro you can still add a single video by pasting its URL.

Connect your Bunny Stream, YouTube, Vimeo or Wistia account so you can browse that library inside WordPress and import videos in bulk. MediaShield then wraps each imported video in the protected player (watermark, login gate, tracking).

You pick videos from your library inside WordPress instead of copying and pasting an address for each one, and every imported video is wrapped in the protected player straight away. For a catalogue of dozens or hundreds of lessons that saves hours and avoids typing mistakes.

  • Free MediaShield and MediaShield Pro are both active.
  • You have API details from the platform (see each platform below).
  • For Bunny Stream you also know your Pull Zone Hostname (the address your videos stream from).
Platform Browse and import Filter in the browser Upload from WordPress
Bunny Stream Yes Collection Yes, see Upload Queue and Default Upload Target
YouTube Yes Playlist Yes
Vimeo Yes Folder Yes
Wistia Yes Project Yes

No platform is hosted by MediaShield. Your videos stay on the platform and stream from its servers. MediaShield only wraps the player. Encryption, if any, is done by the platform. See Encryption and DRM.

  1. Go to MediaShield > Platforms.
  2. In Connect a Platform, choose the platform.
  3. Type a Connection Name so you can tell connections apart (for example “Course Videos”). This is optional.
  4. Fill in the fields for that platform (tables below).
  5. Click Connect Platform. A “Platform connected.” message appears and the connection is listed with a Connected badge.
Field Required What it is Where to find it
API Key Yes The Stream API key for this library. It lets MediaShield read and upload to it. Do not use the account key from Account > API Keys, which grants full account access Bunny dashboard > Stream > your library > API
Library ID Yes Identifies your Stream library Stream > Library settings
Pull Zone Hostname Yes Where videos stream from, for example vz-12345-e25.b-cdn.net. You can type only the prefix and .b-cdn.net is added. A pasted https:// and a trailing slash are removed Stream > Library > Hostname
CDN Token Key No Needed only if your library uses token authentication, so thumbnails and URLs can be signed Stream > Security > Token Authentication Key

MediaShield checks the API key and Library ID with Bunny before it saves anything. If Bunny refuses them you see “Bunny Stream validation failed” with Bunny’s reason, and nothing is stored. The connection is also refused without a Pull Zone Hostname, so you never end up with a connection that imports videos that cannot play.

After connecting, copy the Webhook URL shown on the Platforms page into Bunny. See Bunny Webhook.

Field Required What it is Where to find it
API Key Yes A YouTube Data API v3 key Google Cloud Console > APIs > YouTube Data API v3 > Credentials
Channel ID Needed to list videos The channel whose videos you browse. Starts with UC. The form lets you connect without it, but the library then has nothing to list YouTube Studio > Settings > Channel > Advanced settings
Field Required What it is Where to find it
API Key / Access Token Yes A personal access token with the scopes public, private and video_files developer.vimeo.com > My Apps > Generate Access Token
Client Secret No Not needed for browsing and importing Your Vimeo app
Field Required What it is Where to find it
API Key / Access Token Yes A Wistia API token with all permissions Wistia > Account > API Access
Project ID No Optional Wistia project

MediaShield checks credentials against the platform only for Bunny Stream. For YouTube, Vimeo and Wistia a wrong key is saved without complaint and you find out when you open the library browser.

Your API key and secret are encrypted (AES-256-CBC) before they are saved, using a key derived from your site’s SECURE_AUTH_SALT. The Platforms screen never shows them again.

  • If you regenerate your WordPress salts, saved credentials become unreadable. Disconnect and connect again.
  • The Bunny “Token authentication key” on the Bunny Playback page is stored separately and is encrypted. See Play Bunny Videos in the MediaShield Player.
  1. On MediaShield > Platforms, click Browse & Import on a connected platform. The library opens as a grid or a list (switch with the Grid view and List view buttons).
  2. Use Search videos, and the filter at the top (Collection, Playlist, Folder or Project, depending on the platform), to narrow the list.
  3. Tick the videos you want. Clear Selection unticks all.
  4. Click Import Selected (n).
  5. A message reports how many imported, how many were already imported and how many failed. Click Go to Videos to see them.

What import does for each video:

  • Creates a published MediaShield video with the platform title.
  • Saves the platform, the platform video ID, the stream or embed address and the duration.
  • For Bunny, Vimeo and Wistia, downloads the platform thumbnail and sets it as the featured image. YouTube imports do not set a featured image.
  • For Bunny, also saves the library ID.
  • Skips any video you already imported, so running it twice is safe.

Page sizes: Bunny, Vimeo and Wistia lists load up to 100 videos per page, YouTube up to 50. Use Next page and Previous page to move through large libraries. Refresh reloads from the platform.

Imported videos get the site-wide default protection level. Open a video under Videos to change its protection level, role restriction or player options.

  1. Go to MediaShield > Platforms.
  2. Click Disconnect on the connection.

Disconnecting deletes the saved credentials. Videos you already imported stay in your library, but you can no longer browse that library, and Bunny videos can no longer be signed through that connection until you connect again.

You can connect several libraries on the same platform, for example two Bunny libraries for different courses. Each connection is stored separately. The Default Upload Target “Auto” setting uses the first active connection in alphabetical order of platform name.

Nothing changes for viewers except that the video is wrapped in the protected player. Connecting an account is an admin task.

Where Name Default What it does
Connection form Connection Name empty Label shown on the card
Connection form Pull Zone Hostname, CDN Token Key (Bunny) empty See the Bunny table
Connection form Channel ID (YouTube) empty Channel to browse
Settings > Upload & Storage Default Upload Target Auto Where new uploads go. See Upload Queue and Default Upload Target

If something does not work, see Troubleshooting.