Débogage des problèmes de connexion réseau et API avec les intégrations CMS et DAM

Cette rubrique traite des problèmes de débogage réseau qui empêchent les intégrations CMS et DAM d'accéder aux API Brightcove.

Les connecteurs CMS AEM, Drupal, SharePoint, Sitecore et WordPress pour Brightcove ainsi que les connecteurs CMS et DAM développés par des tiers nécessitent l'accès aux API REST de Brightcove.  Pour utiliser les API Brightcove, elles doivent d'abord être activées dans Brightcove Studio sous Authentification de > l'API Admin-.  Voici une configuration typique avec les autorisations nécessaires pour l'utilisation du connecteur CMS :

Autorisations API
Autorisations API

Vous trouverez plus de détails sur la gestion de l'authentification API ici.

Après avoir récupéré l'ID client et le secret client de Brightcove et les avoir saisis dans la configuration du connecteur CMS, si le connecteur ne parvient pas à se connecter à Brightcove pour synchroniser les vidéos, il se peut qu'un pare-feu ou d'autres configurations réseau bloquent l'accès aux API Brightcove.

Le moyen le plus simple de tester l'accès aux API Brightcove est d'utiliser le script shell simple ci-dessous.  Exécutez ce script à partir du serveur CMS lui-même ou d'une machine Linux ou OS X sur le même réseau que le serveur CMS.  Veillez à mettre à jour le script d'abord avec votre ID de compte Brightcove (PuBid), votre ID client et votre secret client.


#!/bin/sh

# Set up proxy if necessary
# export http_proxy="http://:"
# export https_proxy=" http://:"

# Enter pub_id, client_id, and client_secret below
PUB_ID='xxxxxx'
CLIENT_ID='xxxxxxxxxxxxxxxxxxxx'
CLIENT_SECRET='xxxxxxxxxxxxxxxxxxxxxxxxxxxxx'
API_CALL='https://cms.api.brightcove.com/v1/accounts/'$PUB_ID'/videos'
VERB='GET'

TOKEN=$(curl -s --data "grant_type=client_credentials" https://oauth.brightcove.com/v4/access_token --header "Content-Type: application/x-www-form-urlencoded" --user "$CLIENT_ID:$CLIENT_SECRET" | sed -E 's/.*access_token\"\:\"([^\"]+)\".*/\1/');
RESPONSE=$(curl -s -v -X $VERB "$API_CALL" -d "$DATA" -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json")
echo $RESPONSE

Ce script renvoie simplement une liste de vidéos du compte. Il n'effectue aucune opération d'écriture sur le compte Brightcove. Si vous ne voyez pas la liste des vidéos ou si un message d'erreur s'affiche, votre réseau bloque l'accès HTTPS à l'un des points de terminaison API suivants ou aux deux :

  • oath.brightcove.com
  • cms.api.brightcove.com

Si ces points de terminaison sont bloqués, il est probable que les autres points de terminaison API Brightcove utilisés par les connecteurs CMS et DAM sont également bloqués.  Celles-ci comprennent :

  • ingest.api.brightcove.com
  • oauth.brightcove.com
  • ingestion.api.brightcove.com
  • policy.api.brightcove.com
  • players.api.brightcove.com
  • edge.api.brightcove.com
  • experiences.api.brightcove.com
  • ingestion-upload-prod.s3.amazonaws.com

Pour utiliser les connecteurs CMS, les neuf de ces terminaux devront être accessibles depuis le serveur CMS et les réponses de ces points de terminaison doivent également être autorisées à transmettre au serveur CMS.  Si le pare-feu ne peut pas être ouvert pour les terminaux listés ci-dessus et que la prise en charge du proxy doit être ajoutée au connecteur CMS ou DAM, contactez votre représentant Brightcove au sujet d'un projet de développement personnalisé pour les connecteurs CMS listés ci-dessus ou contactez le développeur du connecteur tiers vous utilisez.