程式設計師使用案例 programmer-use-cases
Last update: Thu Sep 28 2023 00:00:00 GMT+0000 (Coordinated Universal Time)
此頁面上的內容僅供參考。 使用此API需要Adobe的目前授權。 不允許未經授權的使用。
概觀 overview
本檔案概述Adobe Pass Authentication支援的程式設計師整合使用案例。 您可以先檢查此頁面，再開始整合專案，以檢視目前支援哪些功能。
使用案例 use-cases
基本整合：單一通道網路的聯合驗證和授權 basic-integration
優先順序 — 高
劃分 — 單一程式設計人員品牌的TVE應用程式，體驗內託管單一通道網路
如此一來，程式設計師就能在自己的品牌TVE應用程式*中提供付費內容，並向MVPD提供同盟權益檢查。 請求者ID應該對齊以符合向檢視器提供內容的應用程式品牌。 在此案例中，Adobe Pass驗證請求者ID與獲得權益驗證的資源ID之間存在1對1的關係。
本檔案使用TVE應用程式來統稱為不同型別的應用程式（網頁應用程式、行動應用程式等） 受Adobe Pass驗證支援。 下方的平台欄可能包含特定使用案例所支援平台的詳細資訊。
特定使用案例（適用於大多數的整合專案） sp-use-cases-basic-int
高
從程式設計員TVE應用程式進行MVPD探索
使用者從程式設計師品牌的TVE應用程式開始，並提示您選取其MVPD提供者。
Web (SWF/JS) Mobile (iOS/Android)無使用者端API （適用於第2熒幕）
高
來自程式設計人員TVE應用程式的同盟驗證
使用者從程式設計師品牌的TVE應用程式開始，在選取他們的MVPD提供者後，使用者會移轉至MVPD自己的登入頁面以輸入其認證。
網頁(SWF/JS)行動(iOS/Android)
高
來自程式設計師TVE應用程式的授權
在使用者通過驗證後，程式設計師的TVE應用程式能夠向MVPD發出後端通道授權請求以檢查使用者的權益。 這通常只是檢查頻道網路是否在使用者MVPD訂閱套件中。 在這種情況下，請求者ID和資源ID將符合1:1。
所有平台
Medium
從程式設計人員TVE應用程式登出
讓使用者登出並清除Adobe Pass驗證AuthN/AuthZ權杖。 在許多情況下，這也會將使用者從MVPD登出。 但是MVPDs因是否支援此專案而異。 它會一律清除Adobe Pass驗證工作階段和權杖。
除XBox Native以外的所有平台
有幾個MVPD不支援此功能。
高
跨網站和應用程式的單一登入
可讓使用者在網站和應用程式間共用登入工作階段，而不需再次登入。
所有平台，無使用者端API除外
部分MVPD至少需要SDK 1.7。
單一TVE應用程式主控多個管道網路 single-app-multi-channel
優先順序 — 高
可讓程式設計師為檢視者彙總相同品牌目的地上的數個內容管道網路。
特定使用案例 sp-use-cases-singl-tve-app
高
不同管道授權
使用者可以從同一個TVE應用程式內的數個管道網路觀看內容。 程式設計師能夠發出特定於每個頻道網路的授權呼叫，以確認使用者的權益。
所有平台
現在所有MVPD都以某種形式支援此功能。
低
預檢授權查詢
如此一來，程式設計師就能在單一API呼叫中，檢查使用者的封裝中有哪些管道。 這會在實際AuthZ呼叫之前完成，以便從使用者無權存取的使用者介面中篩選內容。
大部分的MVPD尚未將這些資料公開為使用者屬性，因此Adobe實際上會進行AuthZ呼叫以取得資料。 此外，大部分的MVPD一次最多只能有5個，因為它們不支援單一呼叫中的多個管道。 確認程式設計師需要預檢檢查的管道數量非常重要。 無論數字為何，我們都需要檢查MVPD是否正常。 大部分MVPD目前（2013年第3季）不支援超過5個管道。
資產層級授權 asset-level-authz
優先順序 — 低
劃分 — 在授權請求上傳遞資產識別碼
平台 — 所有平台
特定使用案例 sp-use-cases-asset-lvl-authz
讓MVPD可取得每個AuthZ呼叫的資產層級分析。 這有否定Adobe Pass驗證AuthZ快取的缺點。
低
在授權請求上傳遞資產識別碼
讓MVPD可取得每個AuthZ呼叫的資產層級分析。 有否定Adobe Pass Authentication AuthZ快取的缺點。
所有平台
目前只有一個MVPD支援此功能。
家長監護 parental-controls
優先順序 — 低
啟用在程式設計師的TVE應用程式上套用的MVPD使用者帳戶限制。
低
根據使用者屬性篩選內容
讓程式設計師在將可用內容清單呈現給使用者之前，先檢查使用者允許的最大評分。
網頁(Flash/JS)行動(iOS/Android)
目前只能與一個MVPD搭配使用。
低
在AuthZ請求中傳遞內容分級
可讓程式設計師將使用者想要觀看之內容的特定評等（屬於AuthZ請求的一部分）傳送至#3相關的MVPD，因為評等通常在資產層級。
所有平台
目前只能與一個MVPD搭配使用。
根據程式設計師品牌的MVPD整合自訂 mvpd-int-cust-prog-brand
優先順序 — 中
在AuthN期間或AuthZ錯誤訊息啟用自訂體驗。
Medium
在AuthN要求中傳遞服務提供者識別碼。
在服務提供者專屬的MVPD登入頁面上啟用特定品牌。 同時啟用自動選取預設以符合對象，例如Univision西班牙文。
所有平台
因MVPD而異。 有些版本不支援此功能。
Medium
AuthZ回應上的自訂錯誤訊息
啟用來自MVPD的程式設計師或品牌特定錯誤訊息，這些訊息可以包含用於追加銷售的特定訊息，以及升級套件的連結。
網路、Android、iOS
因MVPD而異。 有些版本不支援此功能。
連線裝置使用案例 connected-devices
Medium
跨應用程式和控制檯的XBox LiveID SSO
可讓使用者在應用程式之間及不同遊戲主控台之間共用驗證工作階段，並繫結至其LiveID帳戶。
XBox原生SDK
大部分的MVPD都不喜歡這樣，因為典型的模式是將權杖繫結到裝置，而不是繫結到使用者。 如果可能的話，我們不建議再使用此方法。
高
連結的裝置，其權杖已繫結至裝置上的appID
讓程式設計師將權杖中的MVPD軟體權利檔案繫結至其獲核發裝置上的appID。
無使用者端API
如此一來，連線裝置就會更符合權杖的標準Pass實作。 仍需改善才能成為裝置範圍的ID。
裝置特定驗證TTL長度 authn-ttl-length
針對特殊事件啟用TVE軟體權利檔案，這些特殊事件可能不是MVPD軟體權利檔案資料庫中的資源，例如一般通道。
高
為每個平台設定不同的TTL值
讓程式設計師為網頁、行動裝置和連線裝置建立不同的TTL長度。 目前，Adobe Pass驗證支援具有3個獨立TTL值的功能：網頁(Flash)行動/HTML5無使用者端 — 連線裝置
有些MVPD會動態設定TTL。 如有需要，Adobe可使用組態設定覆寫這些動態設定。
特殊事件型應用程式 special-event
優先順序 — 低
針對特殊事件啟用TVE軟體權利檔案，這些特殊事件可能不是MVPD軟體權利檔案資料庫中的資源，例如一般通道。
低
多個管道作為事件的Proxy
這是為奧運會所做，因為訂閱者需要在他們的套件中有兩個不同的管道才能存取。 在這種情況下，Adobe Pass驗證會建立新的resourceID，並讓所有MVPD對應到其一端的特定通道。 只要事先通知夠多，就能順利運作。 這很重要，因為大部分的MVPD不支援多個資源呼叫。
所有平台
所有MVPD均支援，請另行通知。
低
特殊的新事件應用程式，使用現有的管道資源
這是為了「瘋狂三月」而做的。 內容提供者已使用新請求者ID建立新應用程式。 所有MVPD都需要在其系統中新增對新requestorID的支援。 resourceIDs是正常管道。 有些MVPD也需要將通道對應為新要求者的有效，因此這些情況需要更多時間。
所有平台
所有MVPD均支援，請另行通知。
低
現有的requestorID、resourceID
這是為大師高爾夫週末錦標賽完成的。 幾天來，這只是個小活動，Masters有自己的行動應用程式，可以正確顯示內容。 程式設計師計畫支付Adobe Pass驗證流量的費用，只需使用其標準requestorID和resourceID。 唯一的訣竅是讓程式設計師與大師共用行動憑證，讓對方與大師簽署requestorID，並將之新增至其設定，作為週末的備份憑證。
所有平台
對MVPD沒有影響
內容伺服器整合 content-server-integration
優先順序 — 中
在將視訊資料流釋放給使用者端播放器之前啟用媒體權杖驗證。
|優先順序 |使用案例 |說明 |平台 | MVPD附註 | |---------|-----------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------|----------| |高 |程式設計師同盟播放器 — 具有頁面層級授權 | Adobe Pass驗證API會在頁面的JavaScript中完成，且Token會傳遞至播放器。 Token可以數種方式傳遞至驗證服務：取得驗證服務URL引數上的引數URL引數傳遞至串流URL外部介面API FlashVars的查詢字串 | | | |中 |程式設計師同盟播放器 — 具內部播放器授權 | Adobe Pass驗證API會在播放器SWF中以ActionScript完成，因此播放器可在回撥中使用權杖。 | | | |高 |聯合播放器 — 託管於MVPD入口網站，提供頁面層級授權，使用iFrame包住播放器 |類似於具有頁面層級授權的播放器，但播放器頁麵包裝函式會將影格裝入MVPD入口網站。 驗證必須在MVPD入口網站中單獨進行。 | | |