Cómo usar un token fuera de línea con el SDK de EloViewHome
Público: Desarrolladores de aplicaciones Android e integradores de sistemas
Tipo de artículo: Guía pública de integración
Se requiere un token fuera de línea al utilizar las API del SDK de EloViewHome que requieren autenticación. El token fuera de línea se genera específicamente para el nombre del paquete de su aplicación Android.
Solicitando un Token Fuera de Línea
Si aún no tiene un token fuera de línea, comuníquese con el soporte técnico de Elo en elo.support@zebra.com y proporcione el nombre del paquete de su aplicación Android.
El soporte de Elo proporcionará un archivo de propiedades .prop que contiene las credenciales asociadas con su aplicación. El archivo de propiedades contiene el nombre del paquete de la aplicación y el token fuera de línea JWT.
package_name=com.example.application
jwt=<offline_token>
⚠️ ADVERTENCIA CRÍTICA DE ATRIBUCIÓN
El token fuera de línea está estrictamente vinculado al nombre de paquete de la aplicación Android especificada. Asegúrese de que el nombre de paquete exacto proporcionado al soporte de Elo coincida con el nombre de paquete de su aplicación en producción. La verificación del token fallará de inmediato si hay una discrepancia.
Ejemplo incluido con el SDK de EloViewHome
El SDK de EloViewHome incluye tanto una aplicación de prueba de EloViewHome como el código fuente completo de la aplicación de prueba. El proyecto fuente proporciona un ejemplo de cómo cargar un token fuera de línea desde un archivo de propiedades y verificarlo a través del SDK de EloViewHome.
En el código fuente de la aplicación de prueba, el archivo de propiedades se almacena en el directorio assets de la aplicación. La aplicación carga el archivo de propiedades, recupera el valor de jwt y pasa el token a la 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
)
Verificando el Token
El token fuera de línea se verifica utilizando la API AccountManager.verifyEloToken() del SDK de EloViewHome.
El SDK devuelve un resultado de verificación del token a través del controlador proporcionado. Una verificación exitosa devuelve TOKEN_VERIFY_SUCCESS. Si no se puede verificar el token, el SDK devuelve TOKEN_VERIFY_FAIL.
💡 Errores Comunes en la Verificación del Token (TOKEN_VERIFY_FAIL):
- La carga útil del token está corrupta o mal formada.
- La fecha de expiración del token ha pasado (si está configurado como no permanente).
- El nombre del paquete de la aplicación compilada no coincide exactamente con los metadatos del certificado.
Usando la Aplicación de Prueba Incluida como Referencia
La aplicación de prueba de EloViewHome incluida con el SDK demuestra el proceso de verificación del token. En la aplicación de prueba, navegue a:
API del Administrador de Cuentas > Cargar un archivo que contenga las credenciales y verificar > Cargar y Verificar Token
La aplicación de prueba incluida carga su archivo de propiedades de ejemplo directamente desde los activos de la aplicación en lugar de seleccionar un archivo de propiedades del almacenamiento del dispositivo. Los desarrolladores deben revisar el código fuente de la aplicación de prueba incluida y usar la implementación del Administrador de Cuentas como referencia al integrar la autenticación de token fuera de línea en su propia aplicación.
Información Adicional
El paquete del SDK de EloViewHome incluye:
- La biblioteca del SDK de EloViewHome
- Una aplicación de prueba de EloViewHome instalable
- El proyecto de código fuente completo de la aplicación de prueba
- Documentación de la API del SDK de EloViewHome
Consulte el código fuente de la aplicación de prueba y la documentación de la API com.eloview.sdk.accountManager.AccountManager incluida con el SDK para obtener detalles adicionales de implementación.
Artículos Relacionados
Please report any broken links by emailing elo.support@zebra.com and include a link to the knowledge article