このチュートリアルでは、を取得するための手順を説明しますclient_id
そしてclient_secret
RESTAPIリクエストをテストするための一般的なツールであるPostmanを使用します。
概要
access_token の取得には client_id と client_secret が使用されます。このトークンは、特定の Brightcove API を呼び出すための認証を提供します。access_tokenがどのように取得されるかの例をクイックスタート:OAuth。
まだ見ていない場合はOAuthの概要、先に進む前にそれを確認することをお勧めします。
注:取得するためのUIもありますclient_id
そしてclient_secret
:
要件
- 有効な Video Cloud アカウント
- 有効なパフォーマンスアカウント
- Postman員 Chrome拡張機能またはパッケージアプリとして実行
概要
client_id
client_secret
およびの取得は OAuth サービスへのPOST呼び出しに過ぎませんが、アカウント ID とBC_TOKEN
。これは、Studioにログインしているときに一時Cookieで見つけることができます。
ステップ
BC_TOKEN
アカウント番号とアカウント番号を入手する
を入手するには、Studio にログインする必要がありますBC_TOKEN
。
- 通常どおりStudioにログインします。
- アカウント番号が必要です。これは、Studioのアカウントプロファイルにアクセスして取得できます。
- 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);
キーを押して return キーを押します
BC_TOKEN
次の内容を含むプロンプトが表示されます。- BC_TOKEN をお持ちの場合は、「クライアント資格情報の取得」セクションに進みます。何らかの理由で前の手順で BC_TOKEN を取得しなかった場合は、コンソールに移動し、「」と入力し
document.cookie
、「return」キーを押します。 - ページのすべてのクッキーは、セミコロンで区切られたリストで返されます。リスト内の BC_TOKEN クッキーを検索し、値をコピーします。
ゲットclient_credentials
これで、OAuthサービスを呼び出してクライアントの資格情報を取得する準備が整いました。資格情報を要求するクライアントアプリケーション名を指定します。名前は任意であり、資格情報が使用されるアプリケーションを追跡するのに役立ちます。また、アクセスする操作の範囲を指定する必要があります。ここでは、ビデオクラウド/プレーヤー/すべて
実行/プレーヤー/すべて
(Player Management APIの場合)。現在サポートされているすべての操作の一覧については、「クライアント認証情報リクエストの API オペレーション」を参照してください。
- Postmanを起動し、リクエストタイプをに設定します役職。
- 次のように入力しますリクエストURL:
https://oauth.brightcove.com/v4/client_credentials
- 次の手順を実行して、ヘッダーを作成します。
- リクエストをクリックしてくださいヘッダーオプション。
- のためにキー、入力を開始します承認自動的に提供されるオプションからいつでも選択できます。
- のために値入力、文字列
BC_TOKEN
、その後にスペース、次に実際のトークン値。
- をクリックして、使用するリクエスト本文のタイプを選択します。体オプション、次にラジオボタンx-www-form-urlencoded。
- 実際の体コンテンツの場合、スクリーンショットに示すように、4つのキーと値のペアのエントリを入力します。非対応形式:
- キー:タイプ /値:資格情報
- 鍵: maximum_scope / 価値: [ { "identity": { "type": "video-cloud-account", "account-id": YOUR_ACCOUNT_VALUE }、 "操作":["video-cloud / player / all"]}]
- キー:名前 /値: お好みの名前
- キー:説明 /値: 選択した説明
- クリック送信、次のような応答が表示されます。
{ "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 }
- をコピーして保存します
client_id
そしてclient_secret
、取得する必要があるときはいつでもそれらが必要になるためaccess_token
APIを呼び出します。