Användarmetadata user-metadata
Användarmetadata refererar till användarspecifika attribut (t.ex. postnummer, klassificeringar av föräldrar, användar-ID:n) som underhålls av programmeringsprogram och tillhandahålls programmerare via Adobe Pass Authentication REST API V2.
Användarmetadata blir tillgängliga när autentiseringsflödet har slutförts, men vissa metadataattribut kan uppdateras under auktoriseringsflödet, beroende på MVPD och det specifika metadataattributet i fråga.
Användarmetadata kan användas för att förbättra personaliseringen för användare, men kan också användas för analys. En programmerare kan till exempel använda användarens postnummer för att leverera lokaliserade nyheter eller väderuppdateringar, eller för att framtvinga föräldrakontroll.
Adobe Pass Authentication normaliserar användarens metadatavärden när MVPD tillhandahåller data i olika format. För vissa attribut (t.ex. zip-kod) kan värdena dessutom vara krypterade med ett programmerarcertifikat.
Med Adobe Pass Authentication kan programmerare granska de användarmetadata som är tillgängliga i deras MVPD-integreringar och hantera dem via Adobe Pass TVE Dashboard.
Attribut för användarmetadata attributes
I följande tabell visas några av de attribut för användarmetadata som är tillgängliga för programmerare:
userIDuserID skiljer sig från värdet householdID om MVPD stöder underkonton och den aktuella användaren inte är den primära kontoinnehavaren.upstreamUserIDupstreamUserID är samma som värdet userID för de flesta PDF-filer.householdIDuserID.primaryOIDprimaryOID är samma som värdet userID när värdet typeID är Primär.typeIDprimaryOID är samma som värdet userID när värdet typeID är Primär.is_hohhba_statusallowMirroringzipzip representerar känsliga data som behöver juridiska avtal med MVPD. När nyckeln zip är krypterad blir den String i stället för Array.encryptedZipchannelIDmaxRatinglanguageVilka metadataattribut som är tillgängliga för en programmerare beror på vad en MVPD tillhandahåller. I följande tabell visas de attribut som finns tillgängliga för olika dokumentskyddskomponenter:
userIDupstreamUserIDhouseholdIDprimaryOIDtypeIDis_hohhba_statusallowMirroringzipchannelIDmaxRatinglanguageonNetinHomeupstreamUserID.householdID med samma värde som userID.userID tillgänglig utan extra arbete.Kryptering av användarmetadata encryption
Om du vill kryptera och dekryptera användarmetadataattribut måste programmeraren generera ett certifikat (offentlig/privat nyckelpar) och konfigurera certifikatet automatiskt via Adobe Pass TVE Dashboard eller dela den offentliga nyckeln med Adobe Pass autentiseringsrepresentanter.
Följ stegen nedan för att se till att certifikatet skapas och konfigureras korrekt:
-
Hämta och installera OpenSSL-verktygen (http://www.openssl.org).
-
Generera en CSR-begäran (Certificate Signing Request):
-
Skapa ett nyckelpar. Kör följande på kommandoterminalen:
code language-bash openssl genrsa -des3 -out mycompany-license.key 2048 -
Generera CSR. Kör följande på kommandoterminalen:
code language-bash openssl req -new -key mycompany-license.key -out mycompany-license.csr -batchDu uppmanas att ange lösenordet för den privata nyckeln.
-
Skapa en säkerhetskopia av din privata nyckel och lösenord. Exempel på 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-----
-
-
Skicka CSR till en certifikatutfärdare (CA) (till exempel Verisign).
-
Certifikatutfärdaren skickar certifikatet i .p7b-format (PKCS#7, Cryptographic Message Syntax Standard).
-
Distribuera P7b-certifikatet. Konvertera PKCS#7-filen (.p7b) till en PKCS#12-fil (PFX-fil, Personal Information Exchange Syntax Standard) med hjälp av din privata nyckel och generera PEM-filen (sammanfogad certifikatbehållarfil):
-
Konvertera PKCS#7-filen till en tillfällig PEM-fil. Kör följande på kommandoraden:
code language-none openssl pkcs7 -in mycompany-license.p7b -inform DER -out mycompany-license-temp.pem -outform PEM -print_certs -
Konvertera den tillfälliga PEM-filen till en PFX-fil. Kör följande på kommandoraden:
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 -
Konvertera den tillfälliga PEM-filen till en slutgiltig PEM-fil. Kör följande på kommandoraden:
code language-none openssl x509 -in mycompany-license-temp.pem -inform PEM -out mycompany-license.pem -outform PEM
-
-
Använd PEM-filen för att konfigurera certifikatet via Adobe Pass TVE Dashboard eller skicka PEM-filen till Adobe Pass autentiseringsrepresentanter.
-
Mer information om hur du hanterar certifikat via Adobe Pass TVE Dashboard finns i nästa avsnitt.
-
Adobe Pass Authentication stöder både ett primärt certifikat och ett säkerhetskopieringscertifikat. Om ditt primära certifikat äventyras på något sätt kan du återkalla det och växla till det sekundära certifikatet. Detta säkerställer en smidig övergång mellan certifikat med minimal inverkan på kunderna.
-
Hantering av användarmetadata management
Adobe Pass TVE Dashboard är ett verktyg som används av Adobe Pass Authentication-kunder (programmerare) för att hantera konfiguration och data. Den här självbetjäningsinstrumentpanelen möjliggör en rad funktioner som beskrivs i Adobe Pass TVE Dashboard User Guide -dokumentationen.
Om du vill granska och hantera attribut för användarmetadata som gjorts tillgängliga av en MVPD följer du stegen i användarhandboken för TVE Dashboard för integreringar .
Om du vill granska och hantera certifikat som används för att kryptera attribut för användarmetadata följer du stegen i TVE Dashboard User Guide for Programmers eller TVE Dashboard User Guide for Channels -dokument.
REST API V2 rest-api-v2
Attribut för användarmetadata kan hämtas med följande API
Se avsnitten Svar och Exempel i API:erna ovan för att förstå strukturen för attributen för användarmetadata.
Mer information om hur och när ovanstående API:er ska integreras finns i följande dokument:
Vissa metadataattribut kan uppdateras under auktoriseringsflödet beroende på MVPD och det specifika metadataattributet. Därför kan klientprogrammet behöva fråga API:erna ovan igen för att hämta de senaste användarmetadata.