서문
Live API 작업과 함께 사용할 수 있는 자격 증명에는 여러 종류가 있습니다.
- 라이브 시스템이 클립을 선택한 목적지로 푸시하는 데 필요한 FTP, S3, 비디오 클라우드 또는 Zencoder 자격 증명
- 라이브 스팀의 RTMP 주소를 받는 사람이 다시 재생할 수 없도록 하는 RTMP 자격 증명
- 라이브 시스템이 알림 처리기에 알림을 보내는 데 필요한 OAuth2 또는 기본 인증 자격 증명
Live API의 자격 증명 끝점을 사용하면 이러한 자격 증명을 만들고 관리할 수 있습니다. 그런 다음 Live 또는 VOD 클립 작업을 만들 때 레이블로 참조할 수 있습니다.
자격 증명을 위한 API 작업에 대한 자세한 내용은 API 참조를 참조하십시오 .
자격 증명 유형
아래 표에는 현재 지원되는 자격 증명 유형 및 해당 용도가 나와 있습니다.
credential_type 값 |
설명/사용 사례 |
---|---|
ftp |
클립을 보내야 하는 FTP 사이트에 대한 자격 증명 |
http |
알림을 보낼 http 주소에 대한 기본 인증 자격 증명 |
oauth |
알림을 보낼 주소에 필요한 OAuth2 인증을 위한 자격 증명 |
rtmp |
인코더가 연결하는 엔드포인트에 인증을 추가하여 RTMP URL을 가진 사람은 누구나 |
s3 |
클립을 전송할 S3 버킷에 대한 자격 증명 |
videocloud |
클립을 보낼 Video Cloud 계정에 대한 OAuth 자격 증명 (동적 인제스트에 필요한 권한을 포함해야 함) |
zencoder |
클립을 보낼 Zencoder 계정에 대한 인증 |
자격 증명 작업
아래 표에는 자격 증명 관리를 위한 엔드포인트가 나와 있습니다.
끝점 | 방법 | 설명 |
---|---|---|
/v1/credentials |
GET |
계정에 대한 모든 자격 증명 나열 |
/v1/credentials |
POST |
계정에 대한 새 자격 증명 만들기 |
/v1/credentials/{credential_id} |
PUT |
계정의 자격 증명 업데이트 |
/v1/credentials/{credential_id} |
DELETE |
계정의 자격 증명 삭제 |
자격 증명 필드
아래 표에서는 자격 증명 필드를 보여 줍니다.
필드 | 유형 | 필수 | 허용되는 값 | 기본값 | 설명 |
---|---|---|---|---|---|
credential_default_for_type |
부울 | 아니요 |
true false
|
false |
이 자격 증명 유형의 사용자에 대해 이 자격 증명을 기본값으로 사용하시겠습니까? |
|
끈 | 예 | |
|
자격 증명에 대한 사용자 식별 가능 이름 |
|
열거형 | 예 |
ftp http oauth rtmp s3 videocloud zencoder
|
|
자격 증명의 유형 |
|
끈 | 예 | |
|
자격 증명 유형에 따라 사용자 이름, 공개 키 또는 클라이언트 ID |
|
끈 | 예 | |
|
자격 증명 유형에 따라 암호, 개인 키 또는 클라이언트 암호 |
|
끈 | 아니요 | |
(모든 계정 사용자가 자격 증명을 사용할 수 있음) | 자격 증명이 생성되는 user_id(GUID) |
생성 Video Cloud 자격 증명
Live에 대한 Video Cloud 자격 증명을 설정하는 단계는 다음과 같습니다.
- 비디오 클라우드에서 자격 증명을 설정합니다 . 자격 증명에 필요한 최소 권한은 다음과 같습니다.
- 을 살리다
client_id
그리고client_secret
다음 단계를 위해. -
Live API를 사용하여 새 자격 증명을 만듭니다.
요청 URL:
https://api.bcovlive.io/v1/credentials/
요청 유형: 우편
요청 본문:
{ "credential_label": "{your_own_label_here}", "credential_public": "{client_ID}", "credential_private": "{client_secret}", "credential_type": "videocloud" }