빠른 시작: OAuth API

이 자습서에서는 OAuth API를 사용하여 클라이언트 자격 증명 및 액세스 토큰을 가져오는 단계를 안내합니다.

요구 사항

이 자습서의 API 호출은 MacOS 및 모든 Linux / unix 시스템에 내장 된 cURL을 사용합니다. Windows를 실행하는 경우 cURL 설정을 참조하십시오.
시스템에 터미널 또는 기타 명령 줄 콘솔이 필요합니다.

개요

브라이트코브 OAuth API를 사용하여 다른 브라이트코브 API에 액세스하는 데에는 두 부분이 있습니다.

필요한 계정client_id및client_secret API 작업에 유효한 클라이언트 자격 증명 (a 및) 을 가져오세요. 나중에 사용할 수 있도록 client_id 및 client_secret를 안전한 장소에 저장하면 이 작업은 한 번만 수행할 수 있습니다.
API 호출을 위한 권한 부여를 받으세요. access_token은 5분 동안 유효하므로 대부분의 경우 API를 호출할 때마다 하나씩 받게 됩니다. access_token

Studio에는 클라이언트 자격 증명을가져오고 관리하는 데 사용할 수 있는 UI도있습니다. 가능하면 UI를 사용하는 것이 좋습니다. 새로운 API의 경우 한동안 UI를 통해 자격 증명을 사용하지 못할 수 있습니다.이 경우 다음 단계에서 수행하는 방법을 배우게되므로 OAuth API에서 직접 자격 증명을 얻을 수 있습니다.

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

이 단계에서는 cURL 명령을 사용하여 Player Management API에 대한 클라이언트 자격 증명을 가져옵니다.

단계

요구 사항에 설명된 대로 cURL이 사용 가능한지 확인하십시오 . 명령줄로 이동하여 Return을curl입력하고 키를 눌러 테스트할 수 있습니다. cURL이 설치된 경우 다음과 같은 메시지가 표시됩니다.
```
        curl: try 'curl --help' or 'curl --manual' for more information
```
이제 Studio에서 얻을 수있는 두 가지 정보가 필요합니다. Studio로 이동하여 Studio에로그인합니다.
- 계정 ID
- BC_토큰
참고: BC_TOKEN값은 Studio를 열 때 설정된 쿠키입니다. Studio에서 처리하는 API 관리 토큰과 관련이 없습니다.

계정 ID와 BC_TOKEN 받기

먼저 계정 정보의 계정 ID가 필요합니다.
Studio 헤더에서 설정 아이콘을 클릭합니다.
드롭 다운에서 계정 정보를 선택합니다.
계정 정보 페이지에서 계정 ID를 복사하여 저장하십시오. 이후 단계에서 필요합니다.
이제 브라우저 개발자 콘솔을 엽니 다. 대부분의 브라우저에서 OPTION-CMD-i (Mac) 또는 ALT-CTRL-i (Windows)를 눌러이 작업을 수행하거나 메뉴 항목도 찾을 수 있습니다.
콘솔에서 다음 자바스크립트를 붙여넣고 return 키를 누르면 모달 대화 상자에 BC_TOKEN이 표시됩니다.
var cookiesArray = document.cookie.split(";"), cookiesObj = {}, i, tmpArray = []; for (i = 0; i < cookiesArray.length; i++) { tmpArray = cookiesArray[i].split("="); if (tmpArray[0].indexOf('BC_TOKEN') > -1) { cookiesObj.BC_TOKEN = tmpArray[1]; } } window.prompt("BC_TOKEN:", cookiesObj.BC_TOKEN);
BC_TOKEN을 클립 보드에 복사합니다.
여기에 계정 ID와 BC_TOKEN을 입력하세요.
계정 ID:

BC_토큰:

자격 증명 요청하기

클라이언트 자격 증명을 얻으려면 명령 줄에 다음 cURL 명령을 복사하여 붙여넣고 Return 키를 누릅니다.계정 ID와 BC_TOKEN을 입력하면 cURL 명령이 여기에 표시됩니다.

응답은 다음과 같아야합니다 (형식이 추가됨).

        {"redirect_url":null,"maximum_scope":[{"identity":
        {"type":"video-cloud-account","account-id":57838016001},
        "operations":["video-cloud/player/all"]}],"name_html":"Sample-Client",
        "issued_to":"rcrooks@brightcove.com","trusted":null,"expires_at":null,
        "issued_at":"2015-06-18T20:17:12Z","name":"Sample-Client",
        "description_html":null,"revoked":null,"type":"credential",
        "client_secret":"PiQ5s3-tk46DvNBPauknctP3aTIS07zNIa7Kxz3b7hnRMA5JvQdkwa7JpyuX7dnD4RXziA4KEK0n1pEO94Q7,
        "description":null,"client_id":"b63e5ac2-5264-4a5a-971a-a133bc7bd605",
        "issued_user":53255203001}

이것은 ~ 아니다유효한 클라이언트 암호 - 다음을 수행해야 합니다. 절대클라이언트 비밀을 공개적으로 노출합니다.

에 대한 값을 입력하십시오. client_id그리고client_secret아래에 있습니다. 필요할 때마다 필요하므로access_token .
클라이언트 자격 증명
클라이언트_ID:

클라이언트_시크릿:

액세스 토큰 받기

이전 단계에서 얻은client_id및client_secret는 를 요청할 때 인증을 위한사용자 이름:암호조합으로 사용됩니다access_token . 여기서 사용할 cURL에서는 이를--user파라미터로 전달할 수 있습니다. 다른 언어에서는 HTTP 요청과 함께 Basic Authorization 헤더에 다음을 전달합니다.

        Authorization: Basic {client_id:client_secret}

참고: OAuth API에서 승인하려면 전체 client_id:client_secret가 Base64로인코딩되어야 합니다. cURL은 --user 자격 증명을 Base64로 자동으로 인코딩하지만 다른 언어에서는 Base64로 직접 인코딩해야 합니다.

단계

access_token을 가져오려면 다음 cURL 명령을 복사하여 명령줄에 붙여넣고 Enter 키를 누릅니다.클라이언트_ID와 클라이언트_비밀을 입력하면 cURL 명령어가 여기에 나타납니다.

출력은 다음과 같아야합니다.

        {"access_token":"ACkkpftcuhyzqdf4ftxm304za3anhziG0Ni5-S_dplxMNYNrSrBZRgJL3sf_U38ZZVDdgkmWtrb0_GRZj-VzWOAFWgpEYwgwIWLjcGsTI-9QMUMNv2eFj33clsWFHnGLzgtdcILXpR-wPM0LzKKzRahodwofPfuExYCej18Wpt1x7DxOJDySEjCGOWiTuZVKp1QjG0_nqD9T3TpK3Cchv0suVRTGkYrs15qYSKdxh2-e5XbUiKKptNl8ryvMriavPN66fOh17c09Q0525OPqejkU6uERPTw-sTLU_QjJbRV6psxoSVYKRAetsBikH9XRJbZCSt2JP88O","token_type":"Bearer","expires_in":300}

이 토큰은 5 분 동안 Player Management API 호출을 인증하는 데 사용할 수 있습니다 (그런 다음 새 토큰을 받아야 함). 토큰은 HTTP 요청과 함께 Authorization 헤더에 전달됩니다.
```
        Authorization: Bearer access_token value
```