지원 지원 문의 | 시스템 상태 시스템 상태
페이지 내용

    OAuth 가이드

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

    소개

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

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

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

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

    클라이언트 자격 증명 얻기

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

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

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

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


    페이지 최종 업데이트 28 Sep 2020