Benutzermetadaten user-metadata
Benutzermetadaten beziehen sich auf benutzerspezifische Attribute (z. B. Postleitzahlen, elterliche Bewertungen, Benutzer-IDs usw.), die von MVPDs verwaltet und Programmierern über die Adobe Pass-Authentifizierung (REST V2) bereitgestellt.
Benutzermetadaten werden nach Abschluss des Authentifizierungsflusses verfügbar, aber bestimmte Metadatenattribute können während des Autorisierungsflusses aktualisiert werden, je nach MVPD und dem betreffenden spezifischen Metadatenattribut.
Benutzermetadaten können verwendet werden, um die Personalisierung für Benutzende zu verbessern, können jedoch auch für Analysen verwendet werden. Beispielsweise kann ein Programmierer die Postleitzahl eines Benutzers verwenden, um lokalisierte Nachrichten oder Wetteraktualisierungen bereitzustellen oder elterliche Kontrollen durchzusetzen.
Die Adobe Pass-Authentifizierung normalisiert Benutzermetadatenwerte, wenn MVPDs Daten in verschiedenen Formaten bereitstellen. Für bestimmte Attribute (z. B. Postleitzahl) können die Werte verschlüsselt)das Zertifikat eines Programmierers verwendet werden.
Die Adobe Pass-Authentifizierung ermöglicht es Programmierern, die in ihren MVPD-Integrationen bereitgestellten Benutzermetadaten zu überprüfen und verwalten über das Adobe Pass TVE-Dashboard.
Benutzer-Metadatenattribute attributes
In der folgenden Tabelle sind einige der Benutzermetadatenattribute aufgeführt, die für Programmierer verfügbar gemacht werden:
userIDuserID unterscheidet sich von der householdID, wenn MVPD Unterkonten unterstützt und der aktuelle Benutzer nicht der Hauptkontoinhaber ist.upstreamUserIDupstreamUserID entspricht dem userID für die meisten MVPDs.householdIDuserID identisch.primaryOIDprimaryOID ist derselbe wie der userID, wenn der typeID auf "Primär" gesetzt ist.typeIDprimaryOID ist derselbe wie der userID, wenn der typeID auf "Primär" gesetzt ist.is_hohhba_statusallowMirroringzipzip Wert stellt sensible Daten dar, für die rechtliche Vereinbarungen mit der MVPD getroffen werden müssen. Bei der Verschlüsselung wird die Darstellung des zip Schlüssels als String statt als Array dargestellt.encryptedZipchannelIDmaxRatinglanguageWelche Benutzermetadatenattribute einem Programmierer zur Verfügung gestellt werden, hängt davon ab, was ein MVPD bereitstellt. In der folgenden Tabelle sind die Attribute aufgeführt, die von verschiedenen MVPDs zur Verfügung gestellt werden:
userIDupstreamUserIDhouseholdIDprimaryOIDtypeIDis_hohhba_statusallowMirroringzipchannelIDmaxRatinglanguageonNetinHomeupstreamUserID.householdID mit dem gleichen Wert wie userID verfügbar gemacht.userID ohne zusätzliche Arbeit verfügbar.Verschlüsselung von Benutzermetadaten encryption
Zum Ver- und Entschlüsseln von Benutzermetadatenattributen muss der Programmierer ein Zertifikat (Paar aus öffentlichem/privatem Schlüssel) generieren und 🔗 Zertifikat über das Adobe Pass TVE Dashboard selbst konfigurieren oder den öffentlichen Schlüssel mit Adobe Pass-Authentifizierungsbeauftragten teilen.
Gehen Sie wie folgt vor, um sicherzustellen, dass das Zertifikat korrekt generiert und konfiguriert ist:
-
Laden Sie das OpenSSL-Toolkit herunter und installieren Sie es (http://www.openssl.org).
-
Certificate Signing Request (CSR) generieren:
-
Erzeugen Sie ein Schlüsselpaar. Führen Sie auf dem Befehlsterminal Folgendes aus:
code language-bash openssl genrsa -des3 -out mycompany-license.key 2048 -
CSR generieren. Führen Sie auf dem Befehlsterminal Folgendes aus:
code language-bash openssl req -new -key mycompany-license.key -out mycompany-license.csr -batchSie werden aufgefordert, das Kennwort für den privaten Schlüssel einzugeben.
-
Erstellen Sie eine Sicherungskopie Ihres privaten Schlüssels und Kennworts. Beispiel-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-----
-
-
Senden Sie die CSR an eine Zertifizierungsstelle (CA) (z. B. Verisign).
-
Die Zertifizierungsstelle sendet Ihnen das Zertifikat im Format .p7b (PKCS#7, Cryptographic Message Syntax Standard).
-
Stellen Sie das .p7b-Zertifikat bereit. Konvertieren Sie die PKCS#7-Datei (.p7b) mithilfe Ihres privaten Schlüssels in eine PKCS#12-Datei (PFX-Datei, Personal Information Exchange Syntax Standard) und generieren Sie die PEM-Datei (verkettete Zertifikatcontainerdatei):
-
Konvertieren Sie die PKCS#7-Datei in eine temporäre PEM-Datei. Führen Sie in der Befehlszeile Folgendes aus:
code language-none openssl pkcs7 -in mycompany-license.p7b -inform DER -out mycompany-license-temp.pem -outform PEM -print_certs -
Konvertieren Sie die temporäre PEM-Datei in eine PFX-Datei. Führen Sie in der Befehlszeile Folgendes aus:
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 -
Konvertieren Sie die temporäre PEM-Datei in eine endgültige PEM-Datei. Führen Sie in der Befehlszeile Folgendes aus:
code language-none openssl x509 -in mycompany-license-temp.pem -inform PEM -out mycompany-license.pem -outform PEM
-
-
Verwenden Sie die PEM-Datei um dasüber das Adobe Pass TVE Dashboard zu konfigurieren oder senden Sie die PEM-Datei an die Adobe Pass-Authentifizierungsstellen.
-
Im nächsten Abschnitt finden Sie weitere Informationen zum Verwalten von Zertifikaten über das Adobe Pass TVE-Dashboard.
-
Die Adobe Pass-Authentifizierung unterstützt sowohl ein Primär- als auch ein Sicherungszertifikat. Wenn Ihr primäres Zertifikat in irgendeiner Weise kompromittiert wird, können Sie es widerrufen und zum sekundären Zertifikat wechseln. Dadurch wird ein reibungsloser Übergang zwischen Zertifikaten mit minimalen Auswirkungen auf die Kunden gewährleistet.
-
Verwalten von Benutzermetadaten management
Das Adobe Pass TVE-Dashboard ist ein Tool für Adobe Pass-Authentifizierungskunden (Programmierer) zum Verwalten ihrer Konfiguration und Daten. Dieses Self-Service-Dashboard ermöglicht eine Reihe von Funktionen, die in der Dokumentation Benutzerhandbuch für das Adobe Pass TVE-Dashboard beschrieben werden.
Um die von einer MVPD zur Verfügung gestellten Benutzermetadatenattribute zu überprüfen und zu verwalten, führen Sie die Schritte in der Dokumentation TVE Dashboard User Guide for Integrations aus.
Um die Zertifikate zu überprüfen und zu verwalten, die zum Verschlüsseln von Benutzermetadatenattributen verwendet werden, führen Sie die Schritte im TVE Dashboard-Benutzerhandbuch füroder im TVE Dashboard-Benutzerhandbuch für Kanäle aus.
REST-API V2 rest-api-v2
Die Benutzermetadatenattribute können mit den folgenden APIs abgerufen werden:
Weitere Informationen zur Struktur der Benutzermetadatenattribute finden Sie in Abschnitten Antwort und Beispiele der oben genannten APIs.
Weitere Informationen zur Integration der oben genannten APIs finden Sie in den folgenden Dokumenten:
Bestimmte Metadatenattribute können je nach MVPD und spezifischem Metadatenattribut während des Autorisierungsflusses aktualisiert werden. Daher muss die Client-Anwendung möglicherweise die oben genannten APIs erneut abfragen, um die neuesten Benutzermetadaten abzurufen.