クイックスタート: OAuth API

このチュートリアルでは、OAuth API を使用してクライアント認証情報とアクセストークンを取得する手順を説明します。

要件

このチュートリアルのAPI呼び出しでは、MacOSおよびすべてのlinux / unixシステムに組み込まれているcURLを使用します。Windowsを実行している場合は、を参照してください。 cURLを設定する
システムにはターミナルまたはその他のコマンドラインコンソールが必要です

概要

Brightcove OAuthAPIを使用して他のBrightcoveAPIにアクセスするには、2つの部分があります。

クライアントの資格情報を取得します（client_idそしてclient_secret）必要なアカウントとAPI操作に有効です-これは1回限りの操作です。ただし、client_idとclient_secretを将来使用するために安全な場所に保存しておく必要があります。
取得するaccess_tokenこれは、API呼び出しを行うための承認を提供します-access_tokenは5分間有効であるため、ほとんどの場合、API呼び出しごとに1つ取得します

Studioには、次の目的で使用できるUIもあります。クライアント資格情報を取得して管理する。可能な限りUIを使用することをお勧めします。新しいAPIの場合、しばらくの間UI経由で認証情報を利用できない場合があります。その場合、次の手順で行う方法を学習するため、OAuthAPIから直接認証情報を取得できます。

クライアント認証情報を取得する

これらの手順では、cURLコマンドを使用して、Player ManagementAPIのクライアント資格情報を取得します。

ステップ

で説明されているように、cURLが利用可能であることを確認してください要件 ;コマンドラインに移動して入力することでテストできますcurlそしてreturnキーを押します-cURLがインストールされている場合、次のようなメッセージが表示されます。
```
        curl: try 'curl --help' or 'curl --manual' for more information
```
ここで、Studioから取得できる2つの情報が必要です。に移動してStudioにログインしますスタジオ。
- アカウント ID
- BC_TOKEN
注：BC_TOKEN値は、Studioを開いたときに設定されるクッキーです。Studioで扱うAPI管理トークンとは関係ありません。

アカウントIDとBC_TOKENを取得します

まず、アカウント情報からアカウントIDが必要になります。
設定アイコンをクリックします Studioヘッダーにあります。
ドロップダウンから[アカウント情報]を選択します。
アカウント情報ページからアカウントIDをコピーして保存します。これは、後の手順で必要になります。
次に、ブラウザ開発者コンソールを開きます。ほとんどのブラウザでは、OPTION-CMD-i（Mac）またはALT-CTRL-i（Windows）を押すことでこれを行うことができます。または、メニュー項目も見つけることができるはずです。
コンソールで、次のJavaScriptを貼り付け、Returnキーを押して、モーダルダイアログにBC_TOKENを表示します。
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);
BC_TOKENをクリップボードにコピーします。
ここにアカウントIDとBC_TOKENを入力します。
アカウント ID:

BC_TOKEN：

資格情報のリクエストを行う

クライアントの資格情報を取得するには、次のcURLコマンドをコピーしてコマンドラインに貼り付け、Returnキーを押します。アカウントIDとBC_TOKENを入力すると、cURLコマンドがここに表示されます

レスポンスは次のようになります（書式が追加されています）。

        {"redirect_url":null,"maximum_scope":[{"identity":
        {"type":"video-cloud-account","account-id":57838016001},
        "operations":["video-cloud/player/all"]}],"name_html":"Sample-Client",
        "issued_to":"rcrooks@brightcove.com","trusted":null,"expires_at":null,
        "issued_at":"2015-06-18T20:17:12Z","name":"Sample-Client",
        "description_html":null,"revoked":null,"type":"credential",
        "client_secret":"PiQ5s3-tk46DvNBPauknctP3aTIS07zNIa7Kxz3b7hnRMA5JvQdkwa7JpyuX7dnD4RXziA4KEK0n1pEO94Q7,
        "description":null,"client_id":"b63e5ac2-5264-4a5a-971a-a133bc7bd605",
        "issued_user":53255203001}

これはない有効なクライアントシークレット- 決してクライアントシークレットを公開します。

の値を入力しますclient_idそしてclient_secret以下では、これらを取得する必要があるときはいつでも必要になるため、access_token。
クライアント認証
クライアントID：

client_secret：

アクセストークンを取得する

ザ・client_idそしてclient_secret前の手順で取得したものは、ユーザー名パスワードリクエスト時の認証の組み合わせaccess_token。ここで使用するcURLでは、これらを次のように渡すことができます。--userパラメータ。他の言語では、HTTPリクエストとともに基本認証ヘッダーでこれらを渡します。

        Authorization: Basic {client_id:client_secret}

注：client_id：client_secret全体しなければならない OAuthAPIによって受け入れられるようにBase64でエンコードされていること。 cURLは--user資格情報を自動的にBase64エンコードしますが、他の言語では自分でBase64エンコードする必要があります。

ステップ

access_tokenを取得するには、次のcURLコマンドをコピーしてコマンドラインに貼り付け、Enterキーを押します。client_idとclient_secretを入力すると、cURLコマンドがここに表示されます

出力は次のようになります。

        {"access_token":"ACkkpftcuhyzqdf4ftxm304za3anhziG0Ni5-S_dplxMNYNrSrBZRgJL3sf_U38ZZVDdgkmWtrb0_GRZj-VzWOAFWgpEYwgwIWLjcGsTI-9QMUMNv2eFj33clsWFHnGLzgtdcILXpR-wPM0LzKKzRahodwofPfuExYCej18Wpt1x7DxOJDySEjCGOWiTuZVKp1QjG0_nqD9T3TpK3Cchv0suVRTGkYrs15qYSKdxh2-e5XbUiKKptNl8ryvMriavPN66fOh17c09Q0525OPqejkU6uERPTw-sTLU_QjJbRV6psxoSVYKRAetsBikH9XRJbZCSt2JP88O","token_type":"Bearer","expires_in":300}

このトークンを使用して、Player Management APIへの呼び出しを5分間認証できます（その後、新しいトークンを取得する必要があります）。トークンは、HTTPリクエストとともにAuthorizationヘッダーで渡されます。
```
        Authorization: Bearer access_token value
```

ページコンテンツ

クイックスタート: OAuth API

要件

概要

クライアント認証情報を取得する

ステップ

アカウントIDとBC_TOKENを取得します

資格情報のリクエストを行う

アクセストークンを取得する

ステップ