用户元数据 user-metadata
用户元数据是指由MVPD维护并通过Adobe Pass身份验证REST API V2提供给程序员的用户特定的属性（例如邮政编码、家长评级、用户ID等）。
在身份验证流程完成后，用户元数据将变为可用，但在授权流程期间，某些元数据属性可能会更新，具体取决于MVPD和有问题的特定元数据属性。
用户元数据可用于增强用户的个性化，但也可用于分析。 例如，程序员可能使用用户的邮政编码来传送本地化的新闻或天气更新，或实施家长监控。
当MVPD以不同格式提供数据时，Adobe Pass身份验证会标准化用户元数据值。 此外，对于某些属性（例如，邮政编码），可以使用程序员的证书加密。
Adobe Pass身份验证使程序员能够查看在其MVPD集成中提供的用户元数据，并🔗通过Adobe Pass TVE仪表板管理这些元数据。
用户元数据属性 attributes
下表列出了一些可供程序员使用的用户元数据属性：
userIDuserID值将与householdID值不同。upstreamUserIDupstreamUserID值与userID值相同。householdIDuserID相同。primaryOIDtypeID值设置为“Primary”时，primaryOID值与userID值相同。typeIDtypeID值设置为“Primary”时，primaryOID值与userID值相同。is_hohhba_statusallowMirroringzipzip值表示需要与MVPD签订法律协议的敏感数据。 加密后，zip密钥的表示形式将为String，而不是Array。encryptedZipchannelIDmaxRatinglanguage对于程序员可用的用户元数据属性取决于MVPD提供的内容。 下表列出了各种MVPD提供的属性：
userIDupstreamUserIDhouseholdIDprimaryOIDtypeIDis_hohhba_statusallowMirroringzipchannelIDmaxRatinglanguageonNetinHomeupstreamUserID。userID具有相同值的householdID。userID均可用，无需额外工作。用户元数据加密 encryption
若要加密和解密用户元数据属性，程序员需要生成证书（公钥/私钥对）并🔗通过Adobe Pass TVE仪表板自行配置证书或与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仪表板配置🔗证书或将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以检索最新的用户元数据。