管理即時 API 的認證

簡介

有幾種認證可與您的即時 API 工作搭配使用：

即時系統需要將剪輯片段推送到您選擇的目的地所需的 FTP、S3、視訊雲端或 Zencoder 憑證
RTMP 憑證可防止某人取得您的即時蒸汽 RTMP 地址的人播放
OAuth2 或即時系統需要將通知傳送通知給您的通知處理常式的基本授權憑證

即時 API 的認證端點允許建立和管理這些認證，然後您可以在建立即時或 VOD 剪輯工作時依其標籤參考這些認證。

有關憑據的 API 操作的完整詳細信息，請參閱API參考 .

認證類型

下表顯示目前支援的認證類型及其用途。

認證類型
`credential_type`價值	說明/使用案例
`ftp`	應傳送剪輯片段的 FTP 站台認證
`http`	要傳送通知給 http 位址的基本授權憑證
`oauth`	要傳送通知的位址所需的 OAuth2 驗證憑證
`rtmp`	將驗證新增至您的編碼器所連線的端點，以便擁有 RTMP URL 的任何人都不能只連線
`s3`	S3 儲存貯體可將剪輯片段傳送至
`videocloud`	您的視訊雲端帳戶的 OAuth 認證可傳送剪輯片段 (必須包含動態擷取所需的權限)
`zencoder`	您的 ZenCoder 帳戶驗證將短片傳送至

認證作業

下表顯示管理認證的端點。

身份證明端點
端點	方法	描述
`/v1/credentials`	`GET`	列出帳戶的所有認證
`/v1/credentials`	`POST`	建立帳戶的新認證
`/v1/credentials/{credential_id}`	`PUT`	更新帳戶的認證
`/v1/credentials/{credential_id}`	`DELETE`	刪除帳戶的認證

證明資料欄位

下表顯示認證的欄位。

認證欄位
欄位	類型	必需的	允許值	預設	描述
`credential_default_for_type`	布林	否	`true` `false`	`false`	想要將此憑據作為此類憑據用戶的默認憑據嗎？
`credential_label`	串	是			憑據的用戶可識別名稱
`credential_type`	枚舉	是	`ftp` `http` `oauth` `rtmp` `s3` `videocloud` `zencoder`		憑證類型
`credential_public`	串	是			用戶名、公鑰或客戶端 ID，具體取決於憑證類型
`credential_private`	串	是			密碼、私鑰或客戶端機密，具體取決於憑據類型
`user_id`	串	否		（憑證適用於所有帳戶用戶）	正在為其創建憑據的 user_id (GUID)

創建視頻雲憑證

為 Live 設置 Video Cloud 憑據的步驟如下。

在 Video Cloud 中設置憑據。憑據所需的最低權限是：

視頻雲權限
保存client_id和client_secret下一步。

使用 Live API，創建一個新的憑證：

請求網址：

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

請求類型：開機自檢

要求主體：

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