Metadados do usuário user-metadata
Os metadados do usuário se referem aos atributos específicos do usuário (por exemplo, códigos postais, classificações dos pais, IDs de usuário etc.) que são mantidos pelos MVPDs e fornecidos aos Programadores por meio da REST API V2 de Autenticação da Adobe Pass.
Os metadados do usuário ficam disponíveis após a conclusão do fluxo de autenticação, mas determinados atributos de metadados podem ser atualizados durante o fluxo de autorização, dependendo do MVPD e do atributo de metadados específico em questão.
Os metadados do usuário podem ser usados para aprimorar a personalização para os usuários, mas também podem ser usados para análises. Por exemplo, um programador pode usar o CEP de um usuário para fornecer notícias localizadas ou atualizações meteorológicas, ou para aplicar os controles dos pais.
A Autenticação Adobe Pass normaliza os valores de metadados do usuário quando os MVPDs fornecem dados em diferentes formatos. Além disso, para determinados atributos (por exemplo, código postal), os valores podem ser criptografados usando um certificado de Programador.
A Autenticação da Adobe Pass permite aos Programadores revisar os metadados do usuário disponibilizados em suas integrações do MVPD e gerenciá-los por meio do Painel do Adobe Pass TVE.
Atributos de metadados do usuário attributes
A tabela a seguir lista alguns dos atributos de metadados do usuário que são disponibilizados aos programadores:
userIDuserID será diferente de householdID se o MVPD oferecer suporte a subcontas e o usuário atual não for o titular primário da conta.upstreamUserIDupstreamUserID é igual ao valor userID para a maioria dos MVPDs.householdIDuserID.primaryOIDprimaryOID é igual ao valor userID quando o valor typeID é definido como "Primário".typeIDprimaryOID é igual ao valor userID quando o valor typeID é definido como "Primário".is_hohhba_statusallowMirroringzipzip representa dados confidenciais que precisam de contratos legais com a MVPD. Quando criptografada, a representação da chave zip será String em vez de Array.encryptedZipchannelIDmaxRatinglanguageOs atributos de metadados do usuário disponibilizados para um Programador dependem do que um MVPD oferece. A tabela a seguir lista os atributos disponibilizados por vários MVPDs:
userIDupstreamUserIDhouseholdIDprimaryOIDtypeIDis_hohhba_statusallowMirroringzipchannelIDmaxRatinglanguageonNetinHomeupstreamUserID.householdID com o mesmo valor que userID.userID está disponível sem trabalho extra.Criptografia de metadados de usuário encryption
Para criptografar e descriptografar atributos de metadados do usuário, o Programador precisa gerar um certificado (par de chaves públicas/privadas) e autoconfigurar o certificado por meio do Painel do Adobe Pass TVE ou compartilhar a chave pública com representantes da Autenticação da Adobe Pass.
Siga as etapas abaixo para garantir que o certificado seja gerado e configurado corretamente:
-
Baixe e instale o kit de ferramentas OpenSSL (http://www.openssl.org).
-
Gerar uma solicitação de assinatura de certificado (CSR):
-
Gere um par de chaves. No terminal de comando, execute o seguinte:
code language-bash openssl genrsa -des3 -out mycompany-license.key 2048 -
Gere a CSR. No terminal de comando, execute o seguinte:
code language-bash openssl req -new -key mycompany-license.key -out mycompany-license.csr -batchVocê será solicitado a digitar a senha da chave privada.
-
Crie uma cópia de backup da sua chave privada e senha. CSR de exemplo:
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-----
-
-
Envie a CSR a uma autoridade de certificação (CA) (por exemplo, Verisign).
-
A CA enviará o certificado no formato .p7b (PKCS#7, Padrão de Sintaxe de Mensagem Criptográfica).
-
Implante o certificado .p7b. Converta o arquivo PKCS#7 (.p7b) em PKCS#12 (arquivo PFX, Padrão de Sintaxe de Troca de Informações Pessoais) usando sua chave privada e gere o arquivo PEM (arquivo de contêiner de certificado concatenado):
-
Converta o arquivo PKCS#7 em um arquivo PEM temporário. Na linha de comando, execute o seguinte:
code language-none openssl pkcs7 -in mycompany-license.p7b -inform DER -out mycompany-license-temp.pem -outform PEM -print_certs -
Converta o arquivo PEM temporário em um arquivo PFX. Na linha de comando, execute o seguinte:
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 -
Converta o arquivo PEM temporário em um arquivo PEM final. Na linha de comando, execute o seguinte:
code language-none openssl x509 -in mycompany-license-temp.pem -inform PEM -out mycompany-license.pem -outform PEM
-
-
Use o arquivo PEM para configurar o certificado por meio do Painel do Adobe Pass TVE ou enviar o arquivo PEM para os representantes de Autenticação da Adobe Pass.
-
Consulte a próxima seção para obter mais detalhes sobre como gerenciar certificados no Painel do Adobe Pass TVE.
-
A Autenticação do Adobe Pass oferece suporte a um certificado primário e de backup. Se o certificado principal ficar comprometido de alguma forma, você poderá revogá-lo e alternar para o certificado secundário. Isso garantirá uma transição sem problemas entre certificados, com impacto mínimo no cliente.
-
Gerenciamento de metadados do usuário management
O Adobe Pass TVE Dashboard é uma ferramenta para clientes de autenticação da Adobe Pass (programadores) gerenciarem suas configurações e dados. Este painel de autoatendimento habilita uma série de funcionalidades descritas na documentação do Guia do Usuário do Painel do Adobe Pass TVE.
Para revisar e gerenciar os atributos de metadados do usuário disponibilizados por uma MVPD, siga as etapas da documentação do Guia do Usuário do Painel do TVE para Integrações.
Para revisar e gerenciar os certificados usados para criptografar atributos de metadados do usuário, siga as etapas do Guia do Usuário do Painel TVE para Programadores ou o Guia do Usuário do Painel TVE para Documentos de Canais.
REST API V2 rest-api-v2
Os atributos de metadados do usuário podem ser recuperados usando as seguintes APIs:
Consulte as seções Resposta e Amostras das APIs acima para entender a estrutura dos atributos de metadados do usuário.
Para obter mais detalhes sobre como e quando integrar as APIs acima, consulte os seguintes documentos:
Determinados atributos de metadados podem ser atualizados durante o fluxo de autorização, dependendo do MVPD e do atributo de metadados específico. Como resultado, o aplicativo cliente pode precisar consultar as APIs acima novamente para recuperar os metadados do usuário mais recentes.