OAuth 가이드

Brightcove는 OAuth 2 시스템 승인을 위해 모든 새 API에서 사용할 수 있습니다. 이 항목에서는 OAuth를 사용하여 Player Management API.

소개

시스템을 사용하기 위해 OAuth에 대해 알 필요가 없으며, 아래에서 시작하기 위해해야 할 모든 것을 설명 할 것입니다. OAuth에 대한 자세한 내용은 Brightcove OAuth API 문서.

OAuth 인증을 사용하려면 다음 단계를 따르세요.

고객 인증 정보 얻기
액세스 토큰 가져 오기
요구 Player Management API
2 및 3 단계를 단순화하려면 서버 측 프록시를 사용하십시오

함께 작업 할 때 Player Management API기본 인증을 사용할 수도 있습니다. 자세한 내용은 단계별 : Player 관리 문서를 참조하시기 바랍니다.

클라이언트 자격 증명 얻기

OAuth를 사용하려면 먼저 클라이언트 자격증 명을 얻어야합니다 ( client_id 및 client secret). 이러한 자격 증명은 귀하가 작업하고있는 계정 및 API 작업에 유효합니다. 이는 나중에 사용할 수 있도록 안전한 장소에 이러한 자격 증명을 저장하면 일회성 작업입니다.

자격 증명을 얻는 2 방법이 있습니다.

다음은 권한이 필요한 작업입니다.

기본 방법은 Studio 관리자 UI를 사용하는 것입니다. API 인증 자격 증명 관리 문서를 참조하시기 바랍니다.
다음과 같이 cURL을 사용할 수도 있습니다. cURL을 사용하여 클라이언트 자격증 명 얻기 문서를 참조하시기 바랍니다.
1. 스튜디오에서 :
  
  Player Management API 권한
2. 를 통해 자격 증명을 얻으려면 OAuth API:
  - video-cloud/player/read
  - video-cloud/player/all

그런 다음 OAuth 액세스 토큰을 받아야합니다.

액세스 토큰 가져 오기

이전 단계에서 얻은 클라이언트 자격 증명을 사용하여 액세스 토큰을 요청합니다 ( access_token), API 호출을 수행 할 권한을 제공합니다. 이 토큰은 5 분에만 유효하기 때문에 대부분의 경우 API 호출마다 하나씩 가져와야합니다.

cURL을 사용하여 액세스 토큰을 얻으려면 다음 단계를 따르십시오.

명령 줄에서 export 명령을 사용하여 클라이언트 ID 및 클라이언트 비밀 값을 설정하십시오.
```
    export CLIENT_ID=your client id value
              export CLIENT_SECRET=your client secret value
```

다음 cURL 문을 복사하여 명령 행에 붙여넣고 Enter 키를 누릅니다.

    curl
              -s
              --user $CLIENT_ID:$CLIENT_SECRET
              --header "Content-Type: application/x-www-form-urlencoded"
              --data "grant_type=client_credentials"
              https://oauth.brightcove.com/v4/access_token

응답 내용은 다음과 유사해야합니다.

    {"access_token":"AGUq5IQzLzrRvs8CNbhYlBFeB1_B6jTJrcE8grFHEJaPRsPeEg3-S_Apgv8VKiZ-nzxjDGtKwAco9q3z8tdzrxq76k6B9tUXk9HYQOIYgqziWbuvA50VaW8AK2MQFc0G3-woH_kgQxNQUaVNEpE1sePE9GUb2u9FfeQyLw8XQE_QfriYwkkcQoaGOusoIpujx8H6dLFovPuH5F5N3OSxNYhNZrdOhJwkdN7oe076j3xwNRarHn5IRPYKzjOMbqDk552aAhJxo2pYWoDh3q63pBrzre4Bj1rCHKJPifPEMrgPWzG1Uz1BPhQb5_ubr4P8mtnhCjJn4zzT_1-C8ActMUof45kVFhG4VTWRA8rh05THqEBj_TzPIR7L1t5oHhLo5ziILNSp7mZRM3folvYJC6YIhY7M4qLNGR5iq3nerlv5Ufr_bI-1AnP7a68JasawDpZxjfoGf3h6cwIZJr2uG_iU4FO9Ig-Gotaqv5mLWmUgR-DJ3sfRADc",
              "token_type":"Bearer",
              "expires_in":300}

액세스 토큰을 사용하면 Player Management API.

요구 Player Management API

OAuth를 사용하여 Player Management API, 이전 섹션에서 생성 한 액세스 토큰이 필요합니다. 이 토큰은 5 분 후에 만료되므로 액세스 토큰이 만료 된 경우 이전 섹션 단계를 반복해야 할 수도 있음을 기억하십시오.

다음 단계를 수행하십시오. player cURL을 사용한 구성 정보 :

명령 줄에서 export 액세스 토큰, 계정 ID 및 player 신분증.

    export ACCESS_TOKEN=your access token value
              export ACCOUNT_ID=your account id
              export PLAYER_ID=your player id

다음 cURL 문을 복사하여 명령 행에 붙여넣고 Enter 키를 누릅니다.

    curl
              --header "Content-Type: application/json"
              --header "Authorization: Bearer $ACCESS_TOKEN"
              --request GET
              https://players.api.brightcove.com/v2/accounts/$ACCOUNT_ID/players/$PLAYER_ID/configuration

응답 내용은 다음과 유사해야합니다.

    {"video_cloud":{"video":null,"policy_key":"BCpkADawqM3VpA66ktTO5bdLTmz6kLGMvGZrSyp-YTvbc4MHllmDmuwzEseO1uTeYYRqygGHhB_MgMaM6ndh5ch-cKYtMFx3LerHyziID8M19b162eeIXKYaxDf8uh4OsLTxVijM-qT1N5QR"},
              "stylesheets":["http://solutions.brightcove.com/bcls/brightcove-player/disabled-scrubber/disabled-scrubber.css"],
              "scripts":[],"plugins":[],
              "player":{"template":{"version":"1.14.22","name":"single-video-template"}},
              "autoadvance":0}

모든 요청에 대해 알아 보려면 Player Management API,를 참조하십시오 Brightcove Player Management API 참조 문서.