OAuth 가이드

Brightcove는 OAuth 2 시스템권한 부여를 위해 모든 새 API에서 사용할 수 있습니다. 이 항목에서는 OAuth를 사용하여 플레이어 관리 API와 통신하는 방법을 보여 줍니다.

서문

시스템을 사용하기 위해 OAuth에 대해 알 필요는 없으며 아래에서 시작하는 데 필요한 모든 사항을 설명합니다. OAuth에 대한 자세한 개요는 Brightcove OAuth API서류.

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

클라이언트 자격 증명 받기
액세스 토큰 받기
요구Player Management API
2 단계와 3 단계를 단순화하려면 서버 측 프록시를 사용하십시오.

작업 할 때Player Management API , 기본 인증을 사용할 수도 있습니다. 자세한 내용은단계별 : 플레이어 관리문서.

클라이언트 자격 증명 가져오기

OAuth를 사용하려면 먼저 클라이언트 자격 증명 ( client_id과client secret ). 이러한 자격 증명은 작업중인 계정 및 API 작업에 유효합니다. 향후 사용을 위해 이러한 자격 증명을 안전한 장소에 저장하는 경우에 한해 일회성 작업입니다.

자격 증명을 얻는 방법에는 두 가지가 있습니다.

권한이 필요한 작업은 다음과 같습니다.

선호되는 방법은에 설명 된대로 Studio Admin UI를 사용하는 것입니다. API 인증 자격 증명 관리문서.
다음과 같이 cURL을 사용할 수도 있습니다. cURL을 사용하여 클라이언트 자격 증명 얻기문서.
1. Studio에서 :
  
  플레이어 관리 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 분 후에 만료되므로 액세스 토큰이 만료 된 경우 이전 섹션 단계를 반복해야 할 수 있습니다.

cURL을 사용하여 플레이어 구성 정보를 얻으려면 다음 단계를 따르십시오.

명령 줄에서export액세스 토큰, 계정 ID 및 플레이어 ID 값을 설정하는 명령입니다.

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