프로그래머 통합 안내서 programmer-integration-guide
이 통합 안내서는 Adobe® 인증 전달과 통합하려는 콘텐츠 공급자(프로그래머)를 위한 것입니다.
오늘날의 디지털 환경에서 뷰어는 언제 어디서나 인터넷에 액세스할 수 있으며 보호된 콘텐츠에 대한 액세스를 요청할 수 있습니다. 그들은 한번의 행사를 보거나 당신이 방영하는 전체 텔레비전 시리즈를 방영할 수 있는 권리를 찾으려 할지도 모른다.
보호된 콘텐츠에 대한 액세스 권한을 부여하기 전에 뷰어에 권한이 있는지 여부를 결정해야 합니다. 주요 질문은 다음과 같습니다.
- 뷰어에 다중 채널 비디오 프로그래밍 배포자(MVPD)를 사용하는 활성 구독이 있습니까?
- 해당 구독에 프로그램이 포함되어 있습니까?
TV Everywhere용 Adobe Pass 인증 adobe-pass-authentication-for-tv-everywhere
프로그래머들에게 자격을 결정하는 것이 항상 간단한 것은 아니다. MVPD는 고객의 식별 데이터 및 액세스 권한을 관리하는 관리자입니다. 더욱 복잡한 문제는 프로그래머 뷰어가 각각 고유한 시스템으로 작동하는 매우 다양한 MVPD에 가입할 수 있다는 것입니다. 이러한 복잡성으로 인해 자격 검증은 기술적으로 어렵고 리소스 집약적입니다.
프로그래머가 직접 결정한 사용자 권한
Adobe Pass 인증은 프로그래머와 MVPD 간의 권한 거래를 안전하게 지원하므로 적합한 뷰어에게 보호된 콘텐츠를 빠르고 쉽고 안전하게 제공할 수 있습니다.
Adobe Pass 인증에 의해 중재된 사용자 권한
Adobe Pass 인증은 프록시 역할을 하며 양측에 안전하고 일관된 인터페이스를 제공하여 프로그래머와 MVPD 간의 권한 흐름을 촉진합니다.
프로그래머의 경우 Adobe Pass 인증은 Standard 또는 Premium 계층의 일부로 API를 제공합니다.
-
표준 Adobe Pass 인증 API:
-
Premium Adobe Pass 인증 API:
사용 사례 use-cases
이 섹션에서는 Adobe Pass 인증에서 지원하는 프로그래머 통합 사용 사례에 대해 간략히 설명합니다.
-
단일 채널 네트워크를 사용하는 프로그래머(TVE) 애플리케이션
이를 통해 프로그래머는 TVE 애플리케이션 내의 단일 브랜드 채널 네트워크에서 콘텐츠에 대한 액세스를 뷰어에게 제공할 수 있습니다.
-
다중 채널 네트워크를 가진 프로그래머 (TVE) 응용 프로그램
이를 통해 프로그래머는 단일 TVE 애플리케이션 내에서 여러 채널 네트워크에서 콘텐츠에 액세스할 수 있는 권한을 시청자에게 제공할 수 있습니다.
-
특수 이벤트에 대한 프로그래머 (TVE) 응용 프로그램
이를 통해 프로그래머는 일반 채널과 같은 MVPD 권한 데이터베이스에 있는 리소스가 아닐 수 있는 특수 이벤트의 콘텐츠에 대한 액세스 권한을 뷰어에게 제공할 수 있습니다.
권한 흐름 entitlement-flow
권한 흐름은 프로그래머(TVE) 애플리케이션이 보호된 콘텐츠를 스트리밍하기 위해 완료해야 하는 일련의 단계입니다. 플로우는 다음 단계로 구성됩니다.
프로그래머(TVE) 애플리케이션에 대한 사용자의 초기 방문 시 자격 흐름은 요약된 시퀀스를 따릅니다. 그러나, 후속 방문에서, 애플리케이션은 등록 또는 인증의 상태 및 적용 가능한 시청 정책에 기초하여 특정 단계를 우회할 수 있다.
권한 흐름 및 해당 단계에 대한 자세한 내용을 보려면 이 문서를 계속 읽고 관련 Cookbook 안내서에서 추가 인사이트를 참조하십시오.
등록 단계 registration-phase
등록 단계의 목적은 DCR(Dynamic Client Registration) 프로세스를 통해 Adobe Pass 인증에 대해 클라이언트 응용 프로그램을 등록하는 것입니다.
DCR(Dynamic Client Registration) 프로세스를 진행하려면 클라이언트 애플리케이션이 클라이언트 자격 증명 쌍을 가져오고 등록 단계의 최종 목표로 액세스 토큰을 검색해야 합니다.
API
흐름
FAQ
구성 단계 configuration-phase
구성 단계의 목적은 각 MVPD에 대해 Adobe Pass 인증으로 저장된 구성 세부 정보와 함께 현재 통합되는 MVPD 목록을 클라이언트 애플리케이션에 제공하는 것입니다.
구성 단계는 클라이언트 애플리케이션이 사용자에게 TV 공급자를 선택하라고 요청해야 할 때 인증 단계에 대한 필수 단계 역할을 합니다.
API
FAQ
인증 단계 authentication-phase
인증 단계의 목적은 MVPD에서 사용자의 ID를 확인하고 사용자 메타데이터 정보를 얻을 수 있는 기능을 클라이언트 애플리케이션에 제공하는 것입니다.
인증 단계는 클라이언트 응용 프로그램에서 컨텐츠를 재생해야 할 때 사전 인증 단계 또는 인증 단계에 대한 필수 단계 역할을 합니다.
인증에 성공하면 사용자 메타데이터 정보도 포함하는 애플리케이션, 디바이스 및 서비스 공급자에 연결된 프로필이 생성됩니다.
높은 수준의 단계
다음 단계는 SAML 통합의 경우 높은 수준의 단계에 대해 간략히 설명합니다.
-
프로그래머 응용 프로그램(웹 사이트) 로드
사용자가 Adobe Pass 인증 REST API V2을(를) 통합하는 프로그래머 애플리케이션(웹 사이트)으로 이동합니다. -
보호된 콘텐츠 요청
사용자가 보호된 콘텐츠에 액세스하려고 하면 프로그래머 애플리케이션은 사용자가 선택할 수 있는 MVPD 목록을 표시합니다. -
인증 요청 초기화
MVPD 선택 시 사용자는 Adobe Pass 인증 서버로 리디렉션됩니다. 여기서, 선택된 MVPD에 대한 암호화된 SAML 인증 요청은 SAML 통합의 경우에 생성된다. 이 요청은 프로그래머를 대신하여 MVPD으로 전송됩니다. MVPD 시스템에 따라 사용자의 브라우저가 MVPD의 로그인 페이지로 리디렉션되거나 로그인 iFrame이 프로그래머 애플리케이션 내에 포함됩니다. -
MVPD 로그인
MVPD은 요청을 수락하고 리디렉션 또는 iFrame을 통해 로그인 인터페이스를 제공합니다. -
사용자 로그인 및 유효성 검사
사용자가 MVPD 자격 증명으로 로그인합니다. MVPD은 사용자의 구독 상태를 확인하고 자체 HTTP 세션을 설정합니다. -
Adobe Pass 인증에 대한 MVPD 응답
유효성 검사가 완료되면 MVPD은 SAML 응답(암호화됨)을 생성하여 Adobe Pass 인증으로 다시 보냅니다. -
프로필 생성
Adobe Pass 인증은 SAML 응답을 확인하고, 캐시되는 사용자 프로필을 생성하고, 사용자를 프로그래머 애플리케이션(웹 사이트)으로 다시 리디렉션합니다.
API
흐름
FAQ
SSO(단일 인증) single-sign-on
API
흐름
(선택 사항) 사전 인증 단계 preauthorization-phase
사전 인증 단계의 목적은 사용자가 액세스할 수 있는 카탈로그의 리소스 하위 집합을 클라이언트 응용 프로그램에 제공하는 것입니다.
사전 인증 단계는 사용자가 클라이언트 애플리케이션을 처음 열거나 새 섹션으로 이동할 때 사용자 경험을 향상시킬 수 있습니다.
API
흐름
FAQ
인증 단계 authorization-phase
인증 단계의 목적은 MVPD을 사용하여 권한을 확인한 후 사용자가 요청하는 리소스를 재생하는 기능을 클라이언트 애플리케이션에 제공하는 것입니다.
성공적인 인증은 보안 목적으로 프로그래머(TVE) 애플리케이션에 제공되는 미디어 토큰도 포함하는 결정을 생성합니다.
높은 수준의 단계
다음 단계는 상위 레벨 단계에 대한 개요입니다.
-
리소스 식별자 처리
보호된 콘텐츠는 리소스 식별자로 식별됩니다. 이 식별자는 간단한 문자열이거나 더 복잡한 구조일 수 있습니다. 이 식별자는 사전 정의되어 있으며 프로그래머와 MVPD이 동의합니다. 프로그래머 응용 프로그램에서 Adobe Pass 인증 REST API V2에 리소스 식별자를 보냅니다. -
MVPD 인증 확인
Adobe Pass 인증 서버는 표준화된 프로토콜을 사용하여 MVPD의 인증 엔드포인트와 통신합니다. -
Adobe Pass 인증에 대한 MVPD 응답
유효성 검사가 완료되면 MVPD은 사용자에게 콘텐츠에 액세스할 권한이 있는지 여부를 확인하고 응답을 다시 Adobe Pass 인증으로 보냅니다. -
결정 및 미디어 토큰 생성
Adobe Pass 인증은 응답을 확인하고 캐시되는 결정을 생성하며 미디어 토큰이 포함된 결정을 프로그래머 애플리케이션(웹 사이트)으로 다시 반환합니다. -
콘텐츠 액세스 확인
프로그래머 응용 프로그램은 미디어 토큰 검증기를 사용하여 올바른 사용자가 올바른 콘텐츠에 액세스하고 있는지 확인합니다. 유효성을 검사하면 사용자에게 보호된 콘텐츠를 볼 수 있는 액세스 권한이 부여됩니다.
API
흐름
FAQ
로그아웃 단계 logout-phase
로그아웃 단계의 목적은 사용자 요청 시 Adobe Pass 인증 내에서 사용자의 인증된 프로필을 종료할 수 있는 기능을 클라이언트 애플리케이션에 제공하는 것입니다.
API
흐름
FAQ
SLO(단일 로그아웃) single-logout
흐름
권한 이해 understanding-entitlements
Adobe Pass 인증 솔루션은 인증 및 권한 부여 워크플로의 성공적인 완료 시 생성되는 특정 데이터인 권한 생성을 중심으로 다룹니다. 이러한 권한은 보호된 콘텐츠에 대한 액세스 권한을 부여하지만 사용 기간은 제한됩니다. 권한이 만료되면 인증 또는 권한 부여 프로세스를 다시 시작하여 갱신해야 합니다.
권한에 대한 자세한 내용은 다음 문서를 참조하십시오.
-
프로필
인증에 성공하면 Adobe Pass 인증은 요청하는 애플리케이션, 장치 및 서비스 공급자 식별자(요청자 식별자)와 연결된 인증된 프로필("long-lived")을 만듭니다.
-
인증에 성공하면(그리고 경우에 따라 인증 후에도) Adobe Pass 인증은 MVPD에서 사용자 메타데이터를 수신하여 이를 요청하는 애플리케이션에 노출할 수 있습니다.
-
승인이 성공하면 Adobe Pass 인증은 요청하는 애플리케이션, 디바이스, 서비스 공급자 식별자(요청자 식별자) 및 특정 보호된 리소스(리소스 식별자)와 관련된 권한 부여 결정("long-lived")을 만듭니다.
-
인증에 성공하면 Adobe Pass 인증은 성공적인 재생 요청과 연결된 미디어 토큰("단기")을 만들고 사기(예: 스트림 복사)를 줄이기 위한 업계 모범 사례에 대한 지원을 제공합니다.
프로필 및 의사 결정에 대한 TTL(time-to-live) 값은 프로그래머 및 유료 TV 공급자 간의 합의에 따라 설정되며, 프로그래머는 관련 있는 모든 사람에게 가장 적합한 값에 동의합니다.