Header - AP-Device-Identifier
- Themen:
- Authentifizierung
HINWEISÜbersicht
Der AP-Device-Identifier-Anforderungsheader enthält die Streaming-Gerätekennung, wie sie von der Client-Anwendung erstellt wurde.
Syntax
| AP-Device-Identifier: <type> <identifier> | |
| Kopfzeilentyp | Anfrage-Header |
| Standard | Nein |
Anweisungen
<type>
Der Typ der Gerätekennung.
Es gibt nur einen unterstützten Typ, wie unten dargestellt.
| Typ | |
|---|---|
| Fingerabdruck | Die Gerätekennung besteht aus einer stabilen und eindeutigen Kennung, die von der Client-Anwendung für jedes Gerät erstellt und verwaltet wird. Die Client-Anwendung sollte die Geräte-ID im persistenten Speicher zwischenspeichern, da ein Verlust oder eine Änderung die Authentifizierung ungültig macht. Die Client-Anwendung sollte Wertänderungen verhindern, die durch Benutzeraktionen wie Deinstallation, Neuinstallation oder Upgrades der Anwendung verursacht werden. |
<identifier>
Der Base64-encoded der Gerätekennung.
Beispiel
// device identifier
// ba23d141-d715-561c-94f4-e9e4c966b1eb
// Base64-encoded
// YmEyM2QxNDEtZDcxNS01NjFjLTk0ZjQtZTllNGM5NjZiMWVi
AP-Device-Identifier: fingerprint YmEyM2QxNDEtZDcxNS01NjFjLTk0ZjQtZTllNGM5NjZiMWVi
Cookbooks
IMPORTANTAP-Device-Identifier-Kopfzeile einen Wert enthalten, der wie im Abschnitt „Anweisungen beschrieben.Browser
Um den AP-Device-Identifier für Geräte zu erstellen, die in einem Browser ausgeführt werden, muss Ihre Client-Anwendung eine stabile und eindeutige Kennung basierend auf verfügbaren Daten wie Browser-, Geräte- oder benutzerspezifischen Daten berechnen.
(*) Es wird empfohlen, eine Bibliothek oder einen Service zu integrieren, der einen Browser- oder Geräte-Fingerabdruckmechanismus bereitstellt.
Mobilgeräte
iOS und iPadOS
Informationen zum Erstellen des AP-Device-Identifier für Geräte, auf denen iOS oder iPadOS ausgeführt wird, finden Sie in den folgenden Dokumenten:
- Apple-Entwicklerdokumentation für identifierForVendor.
(*) Es wird empfohlen, eine SHA-256-Hash-Funktion auf den vom Betriebssystem angegebenen Wert anzuwenden.
Android
Informationen zum Erstellen des AP-Device-Identifier-Headers für Geräte, auf denen Android ausgeführt wird, finden Sie in den folgenden Dokumenten:
- Entwicklerdokumentation für Android für ANDROID_ID.
(*) Es wird empfohlen, eine SHA-256-Hash-Funktion auf den vom Betriebssystem angegebenen Wert anzuwenden.
TV-Geräte angeschlossen
tvOS
Informationen zum Erstellen des AP-Device-Identifier-Headers für Geräte, auf „tvOS ausgeführt wird, finden Sie in den folgenden Dokumenten:
- Apple-Entwicklerdokumentation für identifierForVendor.
(*) Es wird empfohlen, eine SHA-256-Hash-Funktion auf den vom Betriebssystem angegebenen Wert anzuwenden.
Betriebssystem auslösen
Informationen zum Erstellen des AP-Device-Identifier-Headers für Geräte, auf „Fire OS ausgeführt wird, finden Sie in den folgenden Dokumenten:
- Entwicklerdokumentation für Android für ANDROID_ID.
(*) Es wird empfohlen, eine SHA-256-Hash-Funktion auf den vom Betriebssystem angegebenen Wert anzuwenden.
Roku OS
Informationen zum Erstellen des AP-Device-Identifier-Headers für Geräte, auf (Roku OS ausgeführt wird, finden Sie in den folgenden Dokumenten:
- Roku-Entwicklerdokumentation für GetChannelClientId.
(*) Es wird empfohlen, eine SHA-256-Hash-Funktion auf den vom Betriebssystem angegebenen Wert anzuwenden.
Sonstige
Für Geräteplattformen, die nicht in der Dokumentation behandelt werden, sollte die Gerätekennung mit jeder verfügbaren Hardwarekennung verknüpft werden, die normalerweise im Hardware-Handbuch des Geräts angegeben ist.
Wenn keine Hardware-IDs verfügbar sind, sollte eine eindeutig generierte ID basierend auf Client-Anwendungsattributen verwendet und im persistenten Speicher zwischengespeichert werden.