Verwalten von Anmeldeinformationen für die Live-API

Einleitung

Es gibt verschiedene Arten von Anmeldeinformationen, die in Verbindung mit Ihren Live API-Jobs verwendet werden können:

FTP-, S3-, Video Cloud- oder Zencoder-Anmeldeinformationen, die das Live-System benötigt, um Clips an das von Ihnen gewählte Ziel zu übertragen
RTMP-Anmeldeinformationen, die verhindern, dass jemand, der die RTMP-Adresse Ihres Live-Steams erhält, diese wiedergibt
OAuth2 oder grundlegende Autorisierungsdaten, die das Live-System benötigt, um Benachrichtigungen an Ihren Benachrichtigungshandler zu senden

Die Endpunkte für die Anmeldeinformationen für die Live-API ermöglichen das Erstellen und Verwalten dieser Anmeldeinformationen, auf die Sie dann anhand ihrer Bezeichnungen verweisen können, wenn Sie Live- oder VOD-Clip-Jobs erstellen.

Ausführliche Informationen zu den API-Vorgängen für Anmeldeinformationen finden Sie im API-Referenz.

Arten von Anmeldeinformationen

Die folgende Tabelle zeigt die derzeit unterstützten Anmeldeinformationstypen und ihre Verwendung.

Arten von Anmeldeinformationen
`credential_type` Wert	Beschreibung/Anwendungsfall
`ftp`	Anmeldeinformationen für FTP-Site, an die Clips gesendet werden sollen
`http`	Grundlegende Autorisierungsdaten für eine http-Adresse zum Senden von Benachrichtigungen an
`oauth`	Anmeldedaten für die OAuth2-Authentifizierung für die Adresse erforderlich, an die Benachrichtigungen gesendet werden sollen
`rtmp`	Fügen Sie dem Endpunkt, mit dem sich Ihr Encoder verbindet, eine Authentifizierung hinzu, damit jeder, der über die RTMP-URL verfügt, nicht einfach eine Verbindung herstellen kann
`s3`	Anmeldeinformationen für einen S3-Bucket zum Senden von Clips an
`videocloud`	OAuth-Anmeldedaten für Ihr Video Cloud-Konto zum Senden von Clips (muss die für die dynamische Aufnahme erforderlichen Berechtigungen enthalten)
`zencoder`	Authentifizierung für Ihr Zencoder-Konto zum Senden von Clips an

Anmeldeinformationen-Operationen

Die folgende Tabelle zeigt die Endpunkte für die Verwaltung von Anmeldeinformationen.

Anmeldeinformationen Endpunkte
Endpunkt	Methode	Beschreibung
`/v1/credentials`	`GET`	Alle Zugangsdaten für das Konto auflisten
`/v1/credentials`	`POST`	Neue Zugangsdaten für das Konto erstellen
`/v1/credentials/{credential_id}`	`PUT`	Anmeldedaten für das Konto aktualisieren
`/v1/credentials/{credential_id}`	`DELETE`	Anmeldedaten für das Konto löschen

Felder für Anmeldeinformationen

Die folgende Tabelle zeigt die Felder für Anmeldeinformationen.

Berechtigungsfelder
Feld	Typ	erforderlich	Erlaubte Werte	Standardwert	Beschreibung
`credential_default_for_type`	boolescher Wert	nein	`true` `false`	`false`	Soll dieser Berechtigungsnachweis als Standard für den Benutzer für diese Art von Berechtigungsnachweisen gelten?
`credential_label`	Schnur	Ja			Benutzeridentifizierbarer Name für die Anmeldeinformationen
`credential_type`	Aufzähung	Ja	`ftp` `http` `oauth` `rtmp` `s3` `videocloud` `zencoder`		Die Art der Bescheinigung
`credential_public`	Schnur	Ja			Der Benutzername, der öffentliche Schlüssel oder die Client-ID, je nach Anmeldetyp
`credential_private`	Schnur	Ja			Das Kennwort, der private Schlüssel oder das Client-Geheimnis, je nach Anmeldetyp
`user_id`	Schnur	nein		(Anmeldedaten sind für alle Kontonutzer verfügbar)	user_id (GUID), für die die Anmeldeinformationen erstellt werden

Video-Cloud-Anmeldeinformationen erstellen

Nachfolgend finden Sie die Schritte zum Einrichten der Video Cloud-Anmeldeinformationen für Live.

Richten Sie Anmeldeinformationen in Video Cloud ein. Für die Anmeldedaten benötigen Sie mindestens die folgenden Berechtigungen:

Video-Cloud-Berechtigungen
Speichern Sie das client_id und client_secret für den nächsten Schritt.

Erstellen Sie mithilfe der Live-API eine neue Berechtigung:

URL anfordern:

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

Art der Anfrage: BEITRAG

Anfragetext:

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