요구 사항
- 이 자습서의 API 호출은 MacOS 및 모든 Linux / unix 시스템에 내장 된 cURL을 사용합니다. Windows를 실행중인 경우 cURL 설정
- 시스템에 터미널 또는 기타 명령 줄 콘솔이 필요합니다.
개요
Brightcove OAuth API를 사용하여 다른 Brightcove API에 액세스하는 데는 두 부분이 있습니다.
- 클라이언트 자격 증명 가져 오기 (a
client_id
과client_secret
) 필요한 계정 및 API 작업에 유효한-향후 사용을 위해 client_id 및 client_secret을 안전한 장소에 저장 한 경우 일회성 작업입니다. - 받기
access_token
API 호출을 할 수있는 권한을 제공합니다. access_token은 5 분 동안 유효하므로 대부분의 경우 API 호출마다 하나씩받습니다.
Studio에는 다음 작업에 사용할 수있는 UI도 있습니다. 클라이언트 자격 증명 획득 및 관리 . 가능하면 UI를 사용하는 것이 좋습니다. 새로운 API의 경우 한동안 UI를 통해 자격 증명을 사용하지 못할 수 있습니다.이 경우 다음 단계에서 수행하는 방법을 배우게되므로 OAuth API에서 직접 자격 증명을 얻을 수 있습니다.
클라이언트 자격 증명 가져오기
이 단계에서는 cURL 명령을 사용하여 Player Management API에 대한 클라이언트 자격 증명을 가져옵니다.
단계
- 에 설명 된대로 cURL을 사용할 수 있는지 확인하십시오. 요구 사항 ; 명령 줄로 이동하여 다음을 입력하여 테스트 할 수 있습니다.
curl
그리고 Enter 키를 누르면 cURL이 설치되어 있으면 다음과 같은 메시지가 표시됩니다.curl: try 'curl --help' or 'curl --manual' for more information
- 이제 Studio에서 얻을 수있는 두 가지 정보가 필요합니다. 로 이동하여 Studio에 로그인하십시오. 사진관 .
- 계정 ID
- BC_토큰
참고:
BC_TOKEN
값은 Studio를 열 때 설정된 쿠키입니다. Studio에서 처리하는 API 관리 토큰과 관련이 없습니다.
계정 ID와 BC_TOKEN 받기
- 먼저 계정 정보의 계정 ID가 필요합니다.
- 설정 아이콘을 클릭하십시오
Studio 헤더에서.
- 드롭 다운에서 계정 정보를 선택합니다.
- 계정 정보 페이지에서 계정 ID를 복사하여 저장하십시오. 이후 단계에서 필요합니다.
- 이제 브라우저 개발자 콘솔을 엽니 다. 대부분의 브라우저에서 OPTION-CMD-i (Mac) 또는 ALT-CTRL-i (Windows)를 눌러이 작업을 수행하거나 메뉴 항목도 찾을 수 있습니다.
- 콘솔에서 다음 JavaScript를 붙여넣고 Return을 눌러 모달 대화 상자에 BC_TOKEN을 표시하십시오.
- BC_TOKEN을 클립 보드에 복사합니다.
- 여기에 계정 ID와 BC_TOKEN을 입력하세요.
계정 ID:
BC_TOKEN :
자격 증명 요청하기
- 클라이언트 자격 증명을 얻으려면 명령 줄에 다음 cURL 명령을 복사하여 붙여넣고 Return 키를 누릅니다.
- 응답은 다음과 같아야합니다 (형식이 추가됨).
{"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
.
액세스 토큰 받기
그만큼client_id
과client_secret
이전 단계에서 얻은 정보는사용자 이름 : 암호요청시 인증 조합access_token
. 여기서 사용할 cURL에서이를--user
매개 변수. 다른 언어에서는 HTTP 요청과 함께 Basic Authorization 헤더에 다음을 전달합니다.
Authorization: Basic {client_id:client_secret}
참고 : 전체 client_id : client_secret 절대로 필요한 것 OAuth API에서 허용하도록 Base64로 인코딩되어야합니다. cURL은 --user 자격 증명을 자동으로 Base64로 인코딩하지만 다른 언어에서는 Base64로 직접 인코딩해야합니다.
단계
- access_token을 얻으려면 다음 cURL 명령을 복사하여 명령 줄에 붙여넣고 Enter 키를 누릅니다.
- 출력은 다음과 같아야합니다.
{"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