OAuth 가이드

소개

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

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

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

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

클라이언트 자격 증명 얻기

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

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

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

• 기본 방법은 Studio 관리자 UI를 사용하는 것입니다. API 인증 자격 증명 관리 문서를 참조하시기 바랍니다.
• 다음과 같이 cURL을 사용할 수도 있습니다. cURL을 사용하여 클라이언트 자격증 명 얻기 문서를 참조하시기 바랍니다.
  1. 스튜디오에서 :

     

  2. 를 통해 자격 증명을 얻으려면 OAuth API:
     • video-cloud/player/read
     • video-cloud/player/all

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

액세스 토큰 가져 오기

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

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

1. 명령 줄에서 export 명령을 사용하여 클라이언트 ID 및 클라이언트 비밀 값을 설정하십시오.

       export CLIENT_ID=your client id value
                 export CLIENT_SECRET=your client secret value

2. 다음 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

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

       {"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을 사용한 구성 정보 :

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

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

2. 다음 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

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

       {"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 참조 문서.