Come utilizzare un token offline con l'EloViewHome SDK
Pubblico: Sviluppatori di applicazioni Android e integratori di sistema
Tipo di articolo: Guida all'integrazione pubblica
Un token offline è necessario quando si utilizzano le API dell'EloViewHome SDK che richiedono autenticazione. Il token offline è generato specificamente per il nome del pacchetto della tua applicazione Android.
Richiedere un Token Offline
Se non hai già un token offline, contatta il supporto tecnico Elo a elo.support@zebra.com e fornisci il nome del pacchetto Android della tua applicazione.
Il supporto Elo fornirà un file di proprietà .prop contenente le credenziali associate alla tua applicazione. Il file di proprietà contiene il nome del pacchetto dell'applicazione e il token offline JWT.
package_name=com.example.application
jwt=<offline_token>
⚠️ AVVISO CRITICO SULL'ATTRIBUZIONE
Il token offline è strettamente legato al nome del pacchetto Android specificato. Assicurati che il nome del pacchetto fornito al supporto Elo corrisponda esattamente al nome del pacchetto della tua applicazione in produzione. La verifica del token fallirà immediatamente se c'è una discrepanza.
Esempio incluso con l'EloViewHome SDK
L'EloViewHome SDK include sia un'app di test EloViewHome che il codice sorgente completo dell'app di test. Il progetto sorgente fornisce un esempio di caricamento di un token offline da un file di proprietà e verifica tramite l'EloViewHome SDK.
Nell'app di test, il file di proprietà è memorizzato nella directory assets dell'applicazione. L'applicazione carica il file di proprietà, recupera il valore jwt e passa il token all'API verifyEloToken().
val credentials = Properties()
credentials.load(
applicationContext.assets.open("your_application_jwt.prop")
)
val accessToken = credentials.getProperty("jwt")
AccountManager.instance.verifyEloToken(
applicationContext,
accessToken,
accessTokenHandler
)
Verifica del Token
Il token offline viene verificato utilizzando l'API AccountManager.verifyEloToken() dell'EloViewHome SDK.
Lo SDK restituisce un risultato della verifica del token tramite il gestore fornito. Una verifica riuscita restituisce TOKEN_VERIFY_SUCCESS. Se il token non può essere verificato, lo SDK restituisce TOKEN_VERIFY_FAIL.
💡 Errori comuni nella verifica del token (TOKEN_VERIFY_FAIL):
- Il payload del token è corrotto o mal formattato.
- L'epoca di scadenza del token è trascorsa (se impostata su non permanente).
- Il nome del pacchetto dell'applicazione compilata non corrisponde esattamente ai metadati del certificato.
Utilizzare l'app di test inclusa come riferimento
L'app di test EloViewHome inclusa con lo SDK dimostra il processo di verifica del token. Nell'app di test, naviga a:
API del gestore account > Carica un file contenente le credenziali e verifica > Carica e verifica token
L'app di test inclusa carica il proprio file di proprietà di esempio direttamente dagli asset dell'applicazione invece di selezionare un file di proprietà dalla memoria del dispositivo. Gli sviluppatori dovrebbero rivedere il codice sorgente dell'app di test inclusa e utilizzare l'implementazione del gestore account come riferimento durante l'integrazione dell'autenticazione del token offline nella propria applicazione.
Informazioni aggiuntive
Il pacchetto EloViewHome SDK include:
- La libreria EloViewHome SDK
- Un'app di test EloViewHome installabile
- Il progetto sorgente completo dell'app di test
- Documentazione API EloViewHome SDK
Fare riferimento al sorgente dell'app di test e alla documentazione API com.eloview.sdk.accountManager.AccountManager inclusa con lo SDK per ulteriori dettagli sull'implementazione.
Articoli correlati
Please report any broken links by emailing elo.support@zebra.com and include a link to the knowledge article