Page Contents

    Adobe-AEM-Brightcove Connector: Configuration

    This topic covers the configuration of the Brightcove connector for Adobe Experience Manager (AEM).


    The Adobe-AEM-Brightcove Connector allows you to manage Brightcove Video Cloud videos and players within AEM, and easily embed videos in AEM pages.

    Configuration steps

    The following sections will walk you through the steps to configure the Adobe-AEM-Brightcove Connector using the classic interface. Note that before completing these steps, the connector must be installed - see Adobe-AEM-Brightcove Connector: Installation

    Disable DAM transcoding

    By default, when you upload video assets to the AEM DAM it will run ffmpeg in the background to transcode the video into a variety of formats.  If you do not have a need for the transcoded assets in the DAM, you should turn off the transcoding to save processing time and storage:

    1. Open the AEM tools:
      AEM Tools
    2. Select Workflow:
      Workflow Tools
      Workflow Tools
    3. Select Models:
      Models Tools
      Models Tools
    4. Select List View:
      List View
      List View
    5. Select DAM Update Asset:
      DAM Update Asset Configuration
      DAM Update Asset Configuration
    6. Select Edit:
      Select Edit
      Select Edit
    7. Double-Click FFmpeg Transcoding from the workflow to edit it:
      Select FFmpeg Transcoding
      Select FFmpeg Transcoding
    8. Select the Process tab in the Step Properties dialog:
      Select Process Tab
      Select Process Tab
    9. Change the Process to No Operation:
      Change the Process
      Change the Process
    10. Change Ok to close the dialog and then save the changes
      Save Changes
      Save Changes

    If you do need the locally transcoded video assets, you will need to make sure ffmpeg is installed on your AEM server:

    1. Verify that you have FFmpeg installed by opening a command line and typing:
    2. If the ffmpeg command is not found, you need to install it:

    Enter account information

    Now you are ready to configure the AEM-Brightcove connector with Video Cloud account information.

    1. Open the AEM Web Console configuration manager (http://localhost:4502/system/console/configMgr)
    2. Search on Brightcove Service to locate the service:
      Find Brightcove Service
      Find Brightcove Service
    3. Click on the + sign to add a new configuration:
      Add Configuration
      Add Configuration
    4. In the dialog, enter values as shown below. See Managing API Authentication Credentials for instructions on getting a client id and client secret. The permissions you need here are:
      Require API Permissions
      Required API Permissions
      • Below are suggested values for the configuration form:
        • Account Alias: enter a name for the account to be displayed in the Connector (required)
        • Account ID: enter your Brightcove publisher ID (required)
        • Client ID: enter your Brightcove client ID from the Brightcove API Authentication page (required)
        • Client Secret: enter your Brightcove client Secret API (required)
        • Allowed Groups: specify the group that will access the Connector (required) be sure that it is a group you are included in.
        • Players Store Path: keep default value or use folder of your choice for players for this Brightcove account (required)
        • Default Video Player ID: keep default value or choose another player ID (required)
        • Default Video Player Key: deprecated, leave blank or use value from previous connector
        • Default Playlist Player ID: enter a player ID enabled for playlists if you plan to use playlists (required)
        • Default Playlist Player Key: deprecated, leave blank or use value from previous connector
        • Proxy server: leave blank or enter proxy if you were previously using a proxy
        • Dam Integration Path: keep default value or use folder of your choice for video assets for this Brightcove account (required)
        • Ingest Profile: specify Brightcove ingest profile to be used for uploaded videos, blank value will use default profile, if blank/default is not working, ask Brightcove support to make sure a default profile is defined in the Video Cloud backend
    5. Test your configuration.  Browse to http://localhost:4502/brightcove/admin and select the Brightcove account just added in the pull-down in the upper right corner.  If no videos are displayed, it is likely due to one of the following reasons:
      1. Your API credentials Account ID, Client ID, and Client Secret may have been incorrectly entered in the connector configuration
      2. Your API credentials were not configured properly in Brightcove
      3. The currently logged in user is not a member of one of the Allowed Groups in the connector configuration
      4. Your network configuration is blocking API access to Brightcove's cloud servers. See "Debugging Network and API Connection Issues" for more information.
    6. If you will be using multiple Video Cloud accounts, repeat the previous steps for each account.

    Set up Brightcove Players

    The last configuration task is to set up Brightcove Players.

    1. Navigate to the Site Admin tools (http://localhost:4502/siteadmin#/content in the Classic UI or http://localhost:4502/sites.html/content in the Touch UI)
    2. In the top-level Websites folder, create new folder that matches the Players Store Path in the configuration.  The default is a folder name in the configuration is called brightcovetools with a folder inside called players.  If you are connecting to multiple Brightcove accounts, you might want to create a unique players folder for each account.
    3. Inside the players folder create a new Brightcove Player Page:
      Player Page Creation
      Player Page Creation
    4. After you create the page, right-click on it and select Properties from the menu in the Classic UI; in the Touch UI, select the page and then click on Properties.
    5. Go the Brightcove Basic tab of the dialog, and the Brightcove account and then select a player from the list:
      Select Player
      Select Player
    6. If you also want to make multiple players available for publishing, repeat the steps above to create a page for each player.
    7. If you also want to use playlists, repeat the steps above to create a page for a Playlist Player.
    8. If you are using multiple Brightcove accounts, you will need to create player pages for each one.

    Activate Metadata Schema for Brightcove Asset Location

    If you are using Touch UI with the v5.4 connector or later, you will need to activate the metadata schema for the Brightcove asset location.   This is not necessary if you are only using classic UI.  Activate the metadata schema with the following steps:

    1. Open the AEM tools:
      AEM Tools
    2. Select Assets:
    3. Select Metadata Schemas:
      Metadata Schemas
    4. Select brightcove and click Apply to Folders:
      Select Brightcove
    5. If the brightcove_assets folder does not exist, create a folder named brightcove_assets:
    6. Enter the name "brightcove_assets":
      Create brightcove_assets Folder
    7. Select brightcove_assets and click Apply:
      Select brightcove_assets

    You have now completed the configuration of the AEM-Brightcove Connector. Proceed to Using the Connector.

    Page last updated on 12 May 2021