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

    빠른 시작: OAuth API

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

    요구 사항

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

    개요

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

    • 클라이언트 자격 증명 가져 오기 (a client_idclient_secret ) 필요한 계정 및 API 작업에 유효한-향후 사용을 위해 client_id 및 client_secret을 안전한 장소에 저장 한 경우 일회성 작업입니다.
    • 받기access_token API 호출을 할 수있는 권한을 제공합니다. access_token은 5 분 동안 유효하므로 대부분의 경우 API 호출마다 하나씩받습니다.

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

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

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

    단계

    1. 에 설명 된대로 cURL을 사용할 수 있는지 확인하십시오. 요구 사항 ; 명령 줄로 이동하여 다음을 입력하여 테스트 할 수 있습니다. curl그리고 Enter 키를 누르면 cURL이 설치되어 있으면 다음과 같은 메시지가 표시됩니다.
              curl: try 'curl --help' or 'curl --manual' for more information
    2. 이제 Studio에서 얻을 수있는 두 가지 정보가 필요합니다. 로 이동하여 Studio에 로그인하십시오. 사진관 .
      • 계정 ID
      • BC_토큰

      참고: BC_TOKEN값은 Studio를 열 때 설정된 쿠키입니다. Studio에서 처리하는 API 관리 토큰과 관련이 없습니다.

    계정 ID와 BC_TOKEN 받기

    1. 먼저 계정 정보의 계정 ID가 필요합니다.
    2. 설정 아이콘을 클릭하십시오계정 설정 Studio 헤더에서.
    3. 드롭 다운에서 계정 정보를 선택합니다.
    4. 계정 정보 페이지에서 계정 ID를 복사하여 저장하십시오. 이후 단계에서 필요합니다.
    5. 이제 브라우저 개발자 콘솔을 엽니 다. 대부분의 브라우저에서 OPTION-CMD-i (Mac) 또는 ALT-CTRL-i (Windows)를 눌러이 작업을 수행하거나 메뉴 항목도 찾을 수 있습니다.
    6. 콘솔에서 다음 JavaScript를 붙여넣고 Return을 눌러 모달 대화 상자에 BC_TOKEN을 표시하십시오.
    7. BC_TOKEN을 클립 보드에 복사합니다.
    8. 여기에 계정 ID와 BC_TOKEN을 입력하세요.

      계정 ID:

      BC_TOKEN :

    자격 증명 요청하기

    1. 클라이언트 자격 증명을 얻으려면 명령 줄에 다음 cURL 명령을 복사하여 붙여넣고 Return 키를 누릅니다.
    2. 응답은 다음과 같아야합니다 (형식이 추가됨).
              {"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}

      이것은아니유효한 클라이언트 비밀-당신은클라이언트 비밀을 공개적으로 노출합니다.

    3. 값을 입력하십시오. client_idclient_secret아래에, 당신이 얻을 필요가있을 때마다 이것들이 필요하기 때문에access_token .
      클라이언트 자격 증명

      client_id :

      client_secret :

    액세스 토큰 받기

    그만큼client_idclient_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로 직접 인코딩해야합니다.

    단계

    1. access_token을 얻으려면 다음 cURL 명령을 복사하여 명령 줄에 붙여넣고 Enter 키를 누릅니다.
    2. 출력은 다음과 같아야합니다.
              {"access_token":"ACkkpftcuhyzqdf4ftxm304za3anhziG0Ni5-S_dplxMNYNrSrBZRgJL3sf_U38ZZVDdgkmWtrb0_GRZj-VzWOAFWgpEYwgwIWLjcGsTI-9QMUMNv2eFj33clsWFHnGLzgtdcILXpR-wPM0LzKKzRahodwofPfuExYCej18Wpt1x7DxOJDySEjCGOWiTuZVKp1QjG0_nqD9T3TpK3Cchv0suVRTGkYrs15qYSKdxh2-e5XbUiKKptNl8ryvMriavPN66fOh17c09Q0525OPqejkU6uERPTw-sTLU_QjJbRV6psxoSVYKRAetsBikH9XRJbZCSt2JP88O","token_type":"Bearer","expires_in":300}
    3. 이 토큰은 5 분 동안 Player Management API 호출을 인증하는 데 사용할 수 있습니다 (그런 다음 새 토큰을 받아야 함). 토큰은 HTTP 요청과 함께 Authorization 헤더에 전달됩니다.
              Authorization: Bearer access_token value