OAuth 가이드

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

서문

시스템을 사용하기 위해 OAuth에 대해 알 필요는 없으며 아래에서 시작하는 데 필요한 모든 사항을 설명합니다. OAuth에 대한 자세한 개요는브라이트코브 OAuth API문서를 참조하십시오.

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

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

를Player Management API사용하여 작업할 때 기본 인증을 사용할 수도 있습니다. 자세한 내용은단계별 지침을 참조하십시오. 플레이어 관리문서.

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

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

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

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

선호하는 방법은 API 인증 자격 증명관리문서에 설명된 대로 Studio Admin UI를 사용하는 것입니다.
cURL을 사용하여 클라이언트 자격 증명가져오기문서에 표시된 대로 cURL을 사용할 수도 있습니다.
1. 스튜디오에서:
  
  플레이어 관리 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을 사용하여 플레이어 구성 정보를 가져오려면 다음 단계를 따르세요.

명령줄에서 명령을 사용하여 액세스 토큰, 계정 ID 및 플레이어 ID의 값을 설정합니다. export

    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":["https://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 , 참조브라이트코브Player Management API참조 문서.