TempPass功能 temp-pass-feature
TempPass是多功能的功能，可讓程式設計師為沒有有效MVPD帳戶憑證的使用者提供對其受保護內容的暫時存取權。 不論是透過基本存取情境或目標式促銷活動，它都是吸引觀眾的有效工具。
TempPass是程式設計師的強大解決方案，可以：
- 與檢視者互動： 提供優質內容的味道，以吸引新的訂閱者。
- 推動促銷活動： 執行目標式行銷活動，以增加內容曝光率，並建立品牌忠誠度。
- 保留控制權： 管理存取期間、強制限制，以及視需要重設存取權，以符合業務目標。
TempPass功能的提供方式是在Adobe Pass驗證伺服器設定中匯入偽MVPD （進一步命名為「Temp Pass」），作為與參與程式設計人員的整合。 TempPass功能提供兩種設定：
- 基本TempPass以時間為基礎的存取。
- 促銷活動暫時傳遞，用於彈性促銷活動導向的存取。
下表提供基本與促銷暫時傳遞功能的簡短比較：
- 基於時間
- 基於時間
- 資源數量上限
- 裝置ID
- 裝置ID
- 提供的使用者識別碼資訊的雜湊（例如電子郵件）
無論您是要提供內容庫的窺視或促銷圈選事件，TempPass都能提供工具，讓您擴充您的對象，同時保持對存取權的控制。
基本暫時傳遞 basic-temp-pass
基本的TempPass功能可讓程式設計師針對各種情境提供有時間限制的內容存取：
- 簡短預覽： 提供簡短預覽，例如10分鐘的每日存取期，以吸引潛在訂閱者。
- 事件型存取： 啟用主要事件的較長存取權，例如4小時工作階段。
- 組合存取： 混合和比對持續時間，例如初始的延長檢視期間，之後是幾天內的每日較短預覽。
某些事件可能需要分階段免費存取內容，例如初始的延長免費存取時段（例如，4小時），接著較短的每日免費存取間隔（例如，每天10分鐘）。 為了實作此情境，程式設計師必須和他們的Adobe代表協調以設定兩個根據其需求量身打造的TempPass MVPD。
例如，若要提供起始的4小時免費工作階段以及隨後的10分鐘每日免費工作階段，Adobe可以為程式設計師設定：
- TempPass1：已設定4小時的存留時間(TTL)，以涵蓋初始的免費存取期間。
- TempPass2：設定為後續每日自由存取間隔的10分鐘存留時間(TTL)。
為確保日常存取的正常運作，所有裝置的TempPass2必須在每天00:00重設。
功能詳細資料 basic-temp-pass-feature-details
組態引數：
- TTL （存留時間）： 程式設計師可以指定存取期間。 無論實際檢視時間為何，這個以時鐘為基礎的TTL都會過期。
使用者識別：
基本的TempPass功能使用裝置識別碼作為使用者識別引數。
下表可協助您瞭解使用者識別引數如何影響使用者試用體驗：
檢視時間計算：
TTL代表從初始授權請求時間到到期時間的持續時間，與檢視內容所花費的實際時間無關。 每個未來的請求都會根據儲存的到期時間檢查目前的伺服器時間，以授權存取。
驗證：
Basic TempPass不需要驗證，允許您直接進入授權步驟。
授權：
由於無法與實際MVPD互動，因此，鑑於TempPass有效，基本「Temp Pass」MVPD將授權任何資源。 如果授權成功，媒體權杖驗證器程式庫仍適用於驗證媒體權杖，以及在起始內容播放之前確保資源驗證。
授權決定是根據使用者識別引數和設定的TTL。 若要成功取得資源的授權，有效的請求必須符合下列條件：
- 未使用的持續時間： 到期時間是透過將初始授權要求時間（儲存在我們的資料庫中）新增至設定的TTL來計算的。 系統會比較目前的伺服器時間與此到期時間，以判斷TempPass是否仍然有效。
如果使用者超過設定的TTL，除非重設其TempPass，否則他們將無法再在相同的裝置上檢視內容。
預先授權：
當對基本「暫時通過」MVPD發出預先授權請求時，回應將傳回請求中的完整資源清單，因為已成功預先授權。 鑑於授權條件是根據時間限制，而不是特定資源，此行為會反映授權邏輯。 只要時間限制有效，請求的資源就會獲得授權。
登出：
Basic TempPass不需要登出，允許您使用實際使用者MVPD直接切換到驗證步驟。
追蹤資料和分析：
在基本TempPass流程中，追蹤資料會使用雜湊版本的裝置識別碼，並將MVPD識別碼設為「Temp Pass」。 程式設計師應在其Analytics實作中將TempPass量度與標準MVPD量度區分開來。
促銷暫時傳遞 promotional-temp-pass
促銷TempPass功能擴充了基本TempPass的功能，專為執行促銷活動而設計。 此功能可讓程式設計師在收集有效的使用者身分識別（例如電子郵件地址）後，在指定期間記憶體取預先定義數量的VOD標題，與使用者互動。
促銷TempPass包含基本TempPass的所有功能，並增加下列專案的彈性：
- 定義促銷期間可存取的VOD標題數量上限。
- 設定促銷存取的有效期間。
一旦使用者超過預先定義的存取限制(VOD標題數量或持續時間)，除非重設其TempPass，否則他們將無法再使用相同的使用者識別碼或相同的裝置上檢視內容。
功能詳細資料 promotional-temp-pass-feature-details
組態引數：
- 使用者資訊金鑰： 用來傳達使用者提供的識別碼的金鑰，例如電子郵件地址（亦即，金鑰是電子郵件）。
- 資源數目： 定義使用者可以存取的VOD標題數目。
- TTL （存留時間）： 使用者可以使用允許資源的期間。
使用者識別：
促銷暫時傳遞功能會使用使用者提供的識別碼雜湊，在裝置識別碼上方，做為使用者識別碼引數。
Adobe建議在傳送至Adobe之前，先對資料使用 SHA-2 系列或其特定的 SHA-256、SHA-512 功能。 例如，超過 "user@domain.com" 的 SHA-256 是 "f7ee5ec7312165148b69fcca1d29075b14b8aef0b5048a332b18b88d09069fb7"。
下表可協助您瞭解使用者識別引數如何影響使用者試用體驗：
檢視時間計算：
TTL代表從初始授權請求時間到到期時間的持續時間，與檢視內容所花費的實際時間無關。 每個未來的請求都會根據儲存的到期時間檢查目前的伺服器時間，以授權存取。
驗證：
Promotional TempPass不需要驗證，您可以直接進入授權步驟。
為了支援程式設計師應用程式的實作，Promotional TempPass會公開下列使用者中繼資料資訊，可透過對應的索引鍵存取：
remaining_resources：指出使用者仍有權使用的資源數目。used_assets：提供使用者已使用的資源清單。expiration_date：顯示使用者促銷臨時傳遞的到期日。
授權：
由於無法與實際MVPD互動，因此促銷「暫時通過」MVPD將授權任何資源，前提是TempPass有效。 如果授權成功，媒體權杖驗證器程式庫仍適用於驗證媒體權杖，以及在起始內容播放之前確保資源驗證。
授權決定是根據使用者識別引數，以及設定的資源數和TTL。 若要成功取得資源的授權，有效的請求必須符合下列條件：
- 未使用的持續時間： 到期時間是透過將初始授權要求時間（儲存在我們的資料庫中）新增至設定的TTL來計算的。 系統會比較目前的伺服器時間與此到期時間，以判斷TempPass是否仍然有效。
- 未使用的資源： 已追蹤使用的資源數目（儲存在我們的資料庫中）。 耗用的資源數會與設定的資源數比較，以判斷TempPass是否仍然有效。
如果使用者超過設定的TTL或資源數，除非重設其TempPass，否則他們將無法再於相同裝置或使用相同使用者提供的識別碼檢視內容。
預先授權：
當對促銷「暫時通過」MVPD提出預先授權請求時，回應會將請求的整個資源清單傳回為已成功預先授權。 此行為會反映授權邏輯，因為授權條件是根據時間限制和存取的資源總數，而不是特定資源。 只要時間限制有效且未超過資源限制，就會授權請求的資源。
登出：
Promotional TempPass不需要登出，因此您可以使用實際的使用者MVPD直接切換到驗證步驟。
追蹤資料和分析：
在促銷TempPass流程期間，追蹤資料會使用雜湊版本的裝置識別碼，並將MVPD識別碼設為「Temp Pass」。 程式設計師應在其Analytics實作中將TempPass量度與標準MVPD量度區分開來。
重設TempPass API存取 reset-tempass-api-access
在存取Reset TempPass API之前，您必須完成動態使用者端註冊(DCR)程式中的必要步驟。 此強製程式可確保您擁有與Reset TempPass API互動所需的存取Token。
如需完整的指示，請參閱Dynamic Client註冊概述檔案。
重設TempPass API -DELETE/reset-tempass/v3/reset reset-tempass-v3-reset
為了重設裝置或所有裝置的特定TempPass，Adobe Pass驗證為程式設計師提供同時適用於基本和促銷TempPass的API。
請求 reset-tempass-v3-reset-request
回應 reset-tempass-v3-reset-response
範例 reset-tempass-v3-reset-samples
重設特定裝置的TempPass reset-tempass-v3-reset-specific-device
$ curl -H "Authorization: Bearer <access_token_here>" -X DELETE -v "https://mgmt.auth.adobe.com/reset-tempass/v3/reset?requestor_id=REF30&mvpd_id=TempPass&device_id=ba23d141-d715-561c-94f4-e9e4c966b1eb"
重設所有裝置的TempPass reset-tempass-v3-reset-all-devices
$ curl -H "Authorization: Bearer <access_token_here>" -X DELETE -v "https://mgmt.auth.adobe.com/reset-tempass/v3/reset?requestor_id=REF30&mvpd_id=TempPass&device_id=all"
重設TempPass API -DELETE/reset-tempass/v3/reset/generic reset-tempass-v3-reset-generic
為了重設一般金鑰（使用者提供的識別碼雜湊）或所有金鑰的特定TempPass，Adobe Pass驗證為程式設計師提供可用於促銷TempPass的API。
請求 reset-tempass-v3-reset-generic-request
回應 reset-tempass-v3-reset-generic-response
範例 reset-tempass-v3-reset-generic-samples
重設特定金鑰的TempPass reset-tempass-v3-reset-specific-key
$ curl -H "Authorization: Bearer <access_token_here>" -X DELETE -v "https://mgmt.auth.adobe.com/reset-tempass/v3/reset/generic?requestor_id=REF30&mvpd_id=TempPass&key=f7ee5ec7312165148b69fcca1d29075b14b8aef0b5048a332b18b88d09069fb7"
重設所有金鑰的TempPass reset-tempass-v3-reset-all-keys
$ curl -H "Authorization: Bearer <access_token_here>" -X DELETE -v "https://mgmt.auth.adobe.com/reset-tempass/v3/reset/generic?requestor_id=REF30&mvpd_id=TempPass&key=all"
REST API V2 rest-api-v2
運用TempPass功能需要實作程式碼更新，以修改您的隨處電視(TVE)應用程式與Adobe Pass驗證REST API V2互動的方式。
如需這些更新和相關工作流程的完整指南，請參閱暫時存取流程檔案。