Gestion des informations d'identification pour l'API Live

Cette rubrique fournit une vue d'ensemble de la gestion des informations d'identification de différents types pour l'API Live.

Introduction

Il existe plusieurs types d'informations d'identification qui peuvent être utilisées avec vos tâches Live API :

  • Informations d'identification FTP, S3, Video Cloud ou Zencoder dont le système Live a besoin pour envoyer les clips vers la destination choisie
  • Identifiants RTMP qui empêchent quelqu'un qui obtient l'adresse RTMP de votre live steam de le lire
  • OAuth2 ou les informations d'identification d'autorisation de base dont le système en direct a besoin pour envoyer des notifications à votre gestionnaire de notifications

Les points de terminaison des informations d'identification pour l'API Live permettent de créer et de gérer ces informations d'identification, que vous pouvez ensuite référencer par leurs étiquettes lorsque vous créez des tâches de clip Live ou VOD.

Pour plus de détails sur les opérations de l'API pour les informations d'identification, consultez le Référence API.

Types d'identifiants

Le tableau ci-dessous présente les types d'informations d'identification actuellement pris en charge et leurs utilisations.

Types d'identifiants
credential_type valeur Description/cas d'utilisation
ftp Informations d'identification pour le site FTP où les clips doivent être envoyés
http Identifiants d'autorisation de base pour une adresse http à laquelle envoyer des notifications
oauth Informations d'identification pour l'authentification OAuth2 requises pour l'adresse à laquelle les notifications doivent être envoyées
rtmp Ajoutez une authentification au point de terminaison auquel votre encodeur se connecte, afin que toute personne disposant de l'URL RTMP ne puisse pas simplement se connecter
s3 Informations d'identification pour un compartiment S3 auquel envoyer des clips
videocloud Informations d'identification OAuth pour votre compte Video Cloud auquel envoyer les clips (doit inclure les autorisations nécessaires pour l'ingestion dynamique)
zencoder Authentification pour votre compte Zencoder auquel envoyer des clips

Opérations d'identification

Le tableau ci-dessous présente les points de terminaison pour la gestion des informations d'identification.

Points de terminaison des informations d'identification
Point de terminaison Méthode Description
/v1/credentials GET Répertorier toutes les informations d'identification du compte
/v1/credentials POST Créer un nouvel identifiant pour le compte
/v1/credentials/{credential_id} PUT Mettre à jour les informations d'identification du compte
/v1/credentials/{credential_id} DELETE Supprimer un identifiant pour le compte

Champs d'informations d'identification

Le tableau ci-dessous montre les champs pour les informations d'identification.

Champs d'identification
Champ Type obligatoire Valeurs autorisées Défaut Description
credential_default_for_type booléen non true
false 		false Voulez-vous que ces informations d'identification soient par défaut pour l'utilisateur pour ce type d'informations d'identification ?
credential_label chaîne oui     Nom identifiable par l'utilisateur pour les informations d'identification
credential_type énumération oui ftp
http
oauth
rtmp
s3
videocloud
zencoder 		  Le type d'informations d'identification
credential_public chaîne oui     Nom d'utilisateur, clé publique ou identifiant client, selon le type d'identification
credential_private chaîne oui     Le mot de passe, la clé privée ou le secret du client, selon le type d'identification
user_id chaîne non   (les informations d'identification sont disponibles pour tous les utilisateurs de compte) user_id (GUID) pour lequel les informations d'identification sont en cours de création

Créer des informations d'identification pour le nuage vidéo

Vous trouverez ci-dessous la marche à suivre pour configurer les informations d'identification de Video Cloud pour Live.

  1. Configurer les informations d'identification dans le nuage vidéo. Les autorisations minimales dont vous aurez besoin pour les informations d'identification sont les suivantes :
    Autorisations pour le nuage vidéo
    Autorisations pour le nuage vidéo
  2. Enregistrez le client_id et client_secret pour l'étape suivante.
  3. À l'aide de l'API Live, créez une nouvelle identification :

    URL de la demande :

    https://api.bcovlive.io/v1/credentials/

    Type de demande : POST

    Corps de la demande :

    {
  "credential_label": "{your_own_label_here}",
  "credential_public": "{client_ID}",
  "credential_private": "{client_secret}",
  "credential_type": "videocloud"
}