Intestazione - AP-Device-Identifier
- Argomenti:
- Autenticazione
Panoramica
L'intestazione della richiesta AP-Device-Identifier contiene l'identificatore del dispositivo di streaming creato dall'applicazione client.
Sintassi
AP-Device-Identifier: <tipo> <identificatore> | |
Tipo di intestazione | Intestazione richiesta |
Standard | No |
Direttive
<tipo>
Tipo di identificatore del dispositivo.
È disponibile un solo tipo supportato, come illustrato di seguito.
Tipo | |
---|---|
impronta digitale | L’identificatore del dispositivo è costituito da un identificatore stabile e univoco creato e gestito dall’applicazione client per ciascun dispositivo. L'applicazione client deve memorizzare nella cache l'identificatore del dispositivo nell'archiviazione persistente, poiché la perdita o la modifica di tale identificatore invaliderà l'autenticazione. L'applicazione client deve impedire le modifiche del valore causate da azioni dell'utente quali la disinstallazione, la reinstallazione o gli aggiornamenti dell'applicazione. |
<identificatore>
Il valore Base64-encoded
dell'identificatore del dispositivo.
Esempio
// device identifier
// ba23d141-d715-561c-94f4-e9e4c966b1eb
// Base64-encoded
// YmEyM2QxNDEtZDcxNS01NjFjLTk0ZjQtZTllNGM5NjZiMWVi
AP-Device-Identifier: fingerprint YmEyM2QxNDEtZDcxNS01NjFjLTk0ZjQtZTllNGM5NjZiMWVi
Cookbook
AP-Device-Identifier
deve contenere un valore formattato come descritto nella sezione Direttive.Browser
Per generare l'intestazione AP-Device-Identifier
per i dispositivi in esecuzione in un browser, l'applicazione client richiede di calcolare un identificatore stabile e univoco in base ai dati disponibili, ad esempio dati specifici del browser, del dispositivo o dell'utente.
(*) Si consiglia di integrare una libreria o un servizio che fornisca un meccanismo di rilevamento delle impronte digitali del browser o del dispositivo.
Dispositivi mobili
iOS e iPadOS
Per generare l'intestazione AP-Device-Identifier
per i dispositivi che eseguono iOS o iPadOS, è possibile fare riferimento ai seguenti documenti:
- Documentazione per gli sviluppatori di Apple per identifierForVendor.
(*) Si consiglia di applicare una funzione hash SHA-256 al valore del sistema operativo specificato.
Android
Per generare l'intestazione AP-Device-Identifier
per i dispositivi che eseguono Android, è possibile fare riferimento ai seguenti documenti:
- Documentazione per gli sviluppatori di Android per ANDROID_ID.
(*) Si consiglia di applicare una funzione hash SHA-256 al valore del sistema operativo specificato.
Dispositivi collegati al televisore
tvOS
Per generare l'intestazione AP-Device-Identifier
per i dispositivi che eseguono tvOS, è possibile fare riferimento ai seguenti documenti:
- Documentazione per gli sviluppatori di Apple per identifierForVendor.
(*) Si consiglia di applicare una funzione hash SHA-256 al valore del sistema operativo specificato.
Fire OS
Per generare l'intestazione AP-Device-Identifier
per i dispositivi che eseguono Fire OS, è possibile fare riferimento ai seguenti documenti:
- Documentazione per gli sviluppatori di Android per ANDROID_ID.
(*) Si consiglia di applicare una funzione hash SHA-256 al valore del sistema operativo specificato.
Sistema operativo Roku
Per generare l'intestazione AP-Device-Identifier
per i dispositivi che eseguono Roku OS, è possibile fare riferimento ai seguenti documenti:
- Documentazione per gli sviluppatori Roku per GetChannelClientId.
(*) Si consiglia di applicare una funzione hash SHA-256 al valore del sistema operativo specificato.
Altri
Per le piattaforme di dispositivi non incluse nella documentazione, l’identificatore del dispositivo deve essere collegato a qualsiasi identificazione hardware disponibile, generalmente specificata nel manuale dell’hardware del dispositivo.
Se non sono disponibili identificatori hardware, è necessario utilizzare un identificatore generato in modo univoco in base agli attributi dell'applicazione client e memorizzarlo nella cache dello storage persistente.