建立用戶端認證:郵遞員

本教程將指導您完成獲得client_idclient_secret使用 Postman,一種用於測試 REST API 請求的流行工具。

概覽

您的客戶端 ID 和客戶端的秘密用於獲取訪問令牌,它提供了對特定的布萊特灣 API 進行調用的授權。您可以在快速開始:OAuth

如果你還沒有看過OAuth 概述 , 在繼續之前先看看它是個好主意。

注意:還有一個 UI 用於獲取client_idclient_secret :

需求

  • 有效的視訊雲端帳戶
  • 有效的「執行」帳戶
  • 郵差作為 Chrome 擴展程序或打包應用程序運行

概覽

獲取client_idclient_secret只是對 OAuth 服務的 POST 調用,但您需要有您的帳戶 ID 以及您的BC_TOKEN,您可以在登錄 Studio 時在臨時 cookie 中找到它。

步驟

拿你的BC_TOKEN和帳號

您需要登錄 Studio 才能獲得您的BC_TOKEN .

  1. 像平常一樣登錄到工作室。
  2. 您需要您的帳號,可以通過進入Studio中的帳號資料來獲得:
    帳戶資訊
    帳戶資訊
  3. 隨著 Studio 中的任何頁面打開,打開瀏覽器的開發人員工具,轉到控制台,並粘貼以下代碼:
    var cookiesArray = document.cookie.split(";"), cookiesObj = {}, i, tmpArray = [];
    for (i = 0; i < cookiesArray.length; i++) {
        tmpArray = cookiesArray[i].split("=");
        if (tmpArray[0].indexOf('BC_TOKEN') > -1) {
            cookiesObj.BC_TOKEN = tmpArray[1];
        }
    }
    window.prompt("BC_TOKEN:", cookiesObj.BC_TOKEN);

    ,然後按回車鍵。

  4. 您應該會看到一個提示出現,其中包含您的BC_TOKEN :
    BC_TOKEN
    BC_TOKEN
  5. 如果您有 BC_TOKEN,請繼續獲取客戶端憑據部分;如果由於某種原因您沒有使用前面的步驟獲得 BC_TOKEN,只需轉到控制台,鍵入document.cookie , 然後按回車。
  6. 該頁面的所有 cookie 將以分號分隔的列表返回。找到列表中的 BC_TOKEN cookie,並複製值:
    開發人員工具中的 BC_TOKEN
    開發人員工具中的 BC_TOKEN

得到client_credentials

現在,您可以調用OAuth服務以檢索客戶端憑據。您將指定要為其請求憑據的客戶端應用程序名稱,該名稱是任意的,旨在幫助您跟踪將使用憑據的應用程序。您還必須指定要訪問的操作範圍,在這裡您將使用視頻雲/播放器/全部執行/播放器/所有(對於播放器管理 API)。看客戶端憑證請求的 API 操作獲取當前支持的所有操作的列表。

  1. 啟動 Postman,並將請求類型設置為郵政 .
  2. 輸入以下內容作為請求網址 :
    https://oauth.brightcove.com/v4/client_credentials
  3. 通過執行以下指示信息創建標題:
    1. 點擊請求標頭選項。
    2. 為了鑰匙 , 開始打字授權您可以隨時從自動提供的選項中進行選擇。
    3. 為了價值輸入,字符串BC_TOKEN,後跟一個空格,然後是您的實際令牌值。
    建立標頭
    建立標頭
  4. 通過單擊選擇要使用的請求正文類型身體選項,然後是單選按鈕x-www-form-urlencoded .
    選擇要求主體的類型
    選擇要求主體的類型
  5. 對於實際身體內容,您現在將輸入四個鍵/值對條目,如屏幕截圖所示。它們是:
    1. 鑰匙:類型 / 價值:憑據
    2. 鑰匙:最大範圍 / 價值: [{“身份”:{“類型”:“視頻雲帳戶”,“帳戶ID”:YOUR_ACCOUNT_VALUE},“操作”:[“視頻雲/播放器/全部”]}]
    3. 鑰匙:姓名 / 價值:您選擇的名字
    4. 鑰匙:描述 / 價值:您的選擇說明
    定義本體鍵/值對
    定義本體鍵/值對
  6. 點擊發送,您應該會看到如下所示的響應:
    {
    "redirect_url": null,
    "maximum_scope": [
        {
            "identity": {
                "type": "video-cloud-account",
                "account-id": 57838016001
            },
            "operations": [
                "video-cloud/player/all"
            ]
        }
    ],
    "name_html": "test credentials",
    "issued_to": "rcrooks@brightcove.com",
    "trusted": null,
    "expires_at": null,
    "issued_at": "2017-08-06T20:30:17Z",
    "name": "test credentials",
    "description_html": "test for OAuth guide",
    "revoked": null,
    "type": "credential",
    "client_secret": "VD0GwgzE35uZzRzksT3dT0H_u_xZh-7oOqsiuqw4-r9qjefl;qkejfLY-PssYa1XQWF-zRn_JtNDPQUHNv-eQEwvETIw",
    "description": "test for OAuth guide",
    "client_id": "0e8939de-a2b1-44ae-9d96-f6f09ba73e8b",
    "issued_user": 53255203001
    }
  7. 複製並保存client_idclient_secret,因為您隨時都需要它們access_token調用 API。