使用者中繼資料 user-metadata
使用者中繼資料是指由MVPD維護並透過Adobe Pass驗證REST API V2提供給程式設計師的使用者專屬屬性 (例如郵遞區號、家長分級、使用者ID等)。
驗證流程完成後,使用者中繼資料即可使用,但在授權流程期間,某些中繼資料屬性可能會更新,具體取決於MVPD和有問題的特定中繼資料屬性。
使用者中繼資料可用來增強使用者的個人化,但也可用來進行分析。 例如,程式設計師可能會使用使用者的郵遞區號來傳送當地語系化的新聞或天氣更新,或強制家長監護。
當MVPD提供不同格式的資料時,Adobe Pass驗證會標準化使用者中繼資料值。 此外,對於某些屬性(例如郵遞區號),可以使用程式設計師的憑證將值加密為加密。
Adobe Pass驗證可讓程式設計師檢閱可在其MVPD整合中使用的使用者中繼資料,並透過Adobe Pass TVE Dashboard進行管理。
使用者中繼資料屬性 attributes
下表列出程式設計師可以使用的部分使用者中繼資料屬性:
userID
userID
值將與householdID
不同。upstreamUserID
upstreamUserID
值與大部分MVPD的userID
值相同。householdID
userID
相同。primaryOID
typeID
值設為「主要」時,primaryOID
值與userID
值相同。typeID
typeID
值設為「主要」時,primaryOID
值與userID
值相同。is_hoh
hba_status
allowMirroring
zip
zip
值代表需要與MVPD簽訂法律協定的敏感資料。 加密後,zip
金鑰的表示形式將為String
,而不是Array
。encryptedZip
channelID
maxRating
language
程式設計師可使用的使用者中繼資料屬性取決於MVPD提供的內容。 下表列出各種MVPD所提供的屬性:
userID
upstreamUserID
householdID
primaryOID
typeID
is_hoh
hba_status
allowMirroring
zip
channelID
maxRating
language
onNet
inHome
upstreamUserID
。userID
具有相同值的householdID
。userID
不需額外工作即可使用。使用者中繼資料加密 encryption
若要加密和解密使用者中繼資料屬性,程式設計師必須產生憑證(公開/私密金鑰組),並透過Adobe Pass TVE Dashboard自行設定🔗憑證,或與Adobe Pass驗證代表共用公開金鑰。
請依照下列步驟操作,確認憑證已產生並正確設定:
-
下載並安裝OpenSSL工具組(http://www.openssl.org)。
-
產生憑證申請檔(CSR):
-
產生金鑰組。 在命令終端機上執行下列動作:
code language-bash openssl genrsa -des3 -out mycompany-license.key 2048
-
產生CSR。 在命令終端機上執行下列動作:
code language-bash openssl req -new -key mycompany-license.key -out mycompany-license.csr -batch
系統會提示您輸入私密金鑰的密碼。
-
建立您的私密金鑰和密碼的備份復本。 範例CSR:
code language-none -----BEGIN CERTIFICATE REQUEST----- MIIBnTCCAQYCAQAwXTELMAkGA1UEBhMCU0cxETAPBgNVBAoTCE0yQ3J5cHRvMRIw EAYDVQQDEwlsb2NhbGhvc3QxJzAlBgkqhkiG9w0BCQEWGGFkbWluQHNlcnZlci5l eGFtcGxlLmRvbTCBnzANBgkqhkiG9w0BAQEFAAOBjQAwgYkCgYEAr1nYY1Qrll1r uB/FqlCRrr5nvupdIN+3wF7q915tvEQoc74bnu6b8IbbGRMhzdzmvQ4SzFfVEAuM MuTHeybPq5th7YDrTNizKKxOBnqE2KYuX9X22A1Kh49soJJFg6kPb9MUgiZBiMlv tb7K3CHfgw5WagWnLl8Lb+ccvKZZl+8CAwEAAaAAMA0GCSqGSIb3DQEBBAUAA4GB AHpoRp5YS55CZpy+wdigQEwjL/wSluvo+WjtpvP0YoBMJu4VMKeZi405R7o8oEwi PdlrrliKNknFmHKIaCKTLRcU59ScA6ADEIWUzqmUzP5Cs6jrSRo3NKfg1bd09D1K 9rsQkRc9Urv9mRBIsredGnYECNeRaK5R1yzpOowninXC -----END CERTIFICATE REQUEST-----
-
-
將CSR傳送給憑證授權單位(CA) (例如Verisign)。
-
CA會以.p7b格式(PKCS#7、密碼編譯訊息語法標準)將憑證傳送給您。
-
部署.p7b憑證。 使用私密金鑰將PKCS#7 (.p7b)檔案轉換為PKCS#12 (PFX檔案、個人資訊交換語法標準),並產生PEM檔案(串連的憑證容器檔案):
-
將PKCS#7檔案轉換為暫存PEM檔案。 在命令列上執行下列動作:
code language-none openssl pkcs7 -in mycompany-license.p7b -inform DER -out mycompany-license-temp.pem -outform PEM -print_certs
-
將暫存PEM檔案轉換為PFX檔案。 在命令列上執行下列動作:
code language-none openssl pkcs12 -export -inkey mycompany-license.key -in mycompany-license-temp.pem -out mycompany-license.pfx -passin pass:private_key_password -passout pass:pfx_password
-
將暫存PEM檔案轉換為最終PEM檔案。 在命令列上執行下列動作:
code language-none openssl x509 -in mycompany-license-temp.pem -inform PEM -out mycompany-license.pem -outform PEM
-
-
使用PEM檔案來🔗透過Adobe Pass TVE Dashboard設定憑證,或傳送PEM檔案給Adobe Pass驗證代表。
-
請參閱下一節以取得有關如何透過Adobe Pass TVE控制面板管理憑證的詳細資料。
-
Adobe Pass驗證同時支援主要和備份憑證。 如果您的主要憑證遭到任何危害,您可以撤銷該憑證,然後切換至次要憑證。 這將確保憑證之間的順利轉換,並對客戶的影響降至最低。
-
使用者中繼資料管理 management
Adobe Pass TVE Dashboard是供Adobe Pass驗證客戶(程式設計師)管理其設定和資料的工具。 此自助儀表板可啟用Adobe Pass TVE儀表板使用手冊檔案中說明的一系列功能。
若要檢閱和管理MVPD所提供的使用者中繼資料屬性,請依照TVE整合儀表板使用手冊檔案中的步驟操作。
若要檢閱和管理用於加密使用者中繼資料屬性的憑證,請依照程式設計師的TVE儀表板使用手冊或頻道的TVE儀表板使用手冊檔案中的步驟操作。
REST API V2 rest-api-v2
您可以使用以下API擷取使用者中繼資料屬性:
請參閱上述API的 回應 和 範例 區段,瞭解使用者中繼資料屬性的結構。
如需如何及何時整合上述API的詳細資訊,請參閱下列檔案:
在授權流程期間,某些中繼資料屬性可能會根據MVPD和特定的中繼資料屬性而更新。 因此,使用者端應用程式可能需要再次查詢上述API,以擷取最新的使用者中繼資料。