サポート サポートへのお問い合わせ | システムステータス システムステータス
ページコンテンツ

    クイックスタート: 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のクライアント資格情報を取得します。

    ステップ

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

      注:BC_TOKEN値は、Studioを開いたときに設定されるクッキーです。Studioで扱うAPI管理トークンとは関係ありません。

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

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

      アカウント ID:

      BC_TOKEN:

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

    1. クライアントの資格情報を取得するには、次のcURLコマンドをコピーしてコマンドラインに貼り付け、Returnキーを押します。
    2. レスポンスは次のようになります(書式が追加されています)。
              {"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}

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

    3. の値を入力します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エンコードする必要があります。

    ステップ

    1. access_tokenを取得するには、次のcURLコマンドをコピーしてコマンドラインに貼り付け、Enterキーを押します。
    2. 出力は次のようになります。
              {"access_token":"ACkkpftcuhyzqdf4ftxm304za3anhziG0Ni5-S_dplxMNYNrSrBZRgJL3sf_U38ZZVDdgkmWtrb0_GRZj-VzWOAFWgpEYwgwIWLjcGsTI-9QMUMNv2eFj33clsWFHnGLzgtdcILXpR-wPM0LzKKzRahodwofPfuExYCej18Wpt1x7DxOJDySEjCGOWiTuZVKp1QjG0_nqD9T3TpK3Cchv0suVRTGkYrs15qYSKdxh2-e5XbUiKKptNl8ryvMriavPN66fOh17c09Q0525OPqejkU6uERPTw-sTLU_QjJbRV6psxoSVYKRAetsBikH9XRJbZCSt2JP88O","token_type":"Bearer","expires_in":300}
    3. このトークンを使用して、Player Management APIへの呼び出しを5分間認証できます(その後、新しいトークンを取得する必要があります)。トークンは、HTTPリクエストとともにAuthorizationヘッダーで渡されます。
              Authorization: Bearer access_token value