Hoe een Offline Token te Gebruiken met de EloViewHome SDK
Doelgroep: Android Applicatieontwikkelaars en Systeemintegratoren
Artikeltype: Publieke Integratiehandleiding
Een offline token is vereist wanneer je gebruik maakt van EloViewHome SDK API's die authenticatie vereisen. Het offline token wordt specifiek gegenereerd voor de pakketnaam van je Android-applicatie.
Een Offline Token Aanvragen
Als je nog geen offline token hebt, neem dan contact op met de Elo Technical Support via elo.support@zebra.com en geef de pakketnaam van je applicatie op.
Elo Support zal een .prop eigenschappenbestand verstrekken met de inloggegevens die aan je applicatie zijn gekoppeld. Het eigenschappenbestand bevat de pakketnaam van de applicatie en het JWT offline token.
package_name=com.example.application
jwt=<offline_token>
⚠️ CRITIEKE ATTRIBUTIEWAARSCHUWING
Het offline token is strikt gebonden aan de opgegeven pakketnaam van de Android-applicatie. Zorg ervoor dat de exacte pakketnaam die aan Elo Support is opgegeven overeenkomt met de pakketnaam van je productie-applicatie. De tokenverificatie zal onmiddellijk falen bij een ongelijkheid.
Voorbeeld Bijgevoegd bij de EloViewHome SDK
De EloViewHome SDK bevat zowel een EloViewHome Test App als de volledige sourcecode van de Test App. Het sourceproject biedt een voorbeeld van het laden van een offline token uit een eigenschappenbestand en het verifiëren daarvan via de EloViewHome SDK.
In de source van de Test App is het eigenschappenbestand opgeslagen in de assets directory van de applicatie. De applicatie laadt het eigenschappenbestand, haalt de jwt waarde op en geeft het token door aan de verifyEloToken() API.
val credentials = Properties()
credentials.load(
applicationContext.assets.open("your_application_jwt.prop")
)
val accessToken = credentials.getProperty("jwt")
AccountManager.instance.verifyEloToken(
applicationContext,
accessToken,
accessTokenHandler
)
Verifiëren van het Token
Het offline token wordt geverifieerd met de EloViewHome SDK AccountManager.verifyEloToken() API.
De SDK retourneert een resultaat van de tokenverificatie via de geleverde handler. Een succesvolle verificatie retourneert TOKEN_VERIFY_SUCCESS. Als het token niet kan worden geverifieerd, retourneert de SDK TOKEN_VERIFY_FAIL.
💡 Veelvoorkomende Verificatiefouten (TOKEN_VERIFY_FAIL):
- De payload van het token is corrupt of slecht opgemaakt.
- De vervaldatum van het token is verstreken (indien ingesteld op niet-permanent).
- De pakketnaam van de gecompileerde applicatie komt niet exact overeen met de metadata van het certificaat.
Gebruik van de Bijgevoegde Test App als Referentie
De EloViewHome Test App die bij de SDK is inbegrepen, demonstreert het verificatieproces van het token. Navigeer in de Test App naar:
Account Manager API > Laad een bestand met de inloggegevens en verifieer > Laad en Verifieer Token
De bijgevoegde Test App laadt zijn voorbeeld eigenschappenbestand rechtstreeks vanuit de assets van de applicatie in plaats van een eigenschappenbestand uit de opslag van het apparaat te selecteren. Ontwikkelaars moeten de bijgevoegde sourcecode van de Test App bekijken en de implementatie van de Account Manager als referentie gebruiken bij het integreren van offline-token authenticatie in hun eigen applicatie.
Aanvullende Informatie
Het EloViewHome SDK-pakket omvat:
- De EloViewHome SDK-bibliotheek
- Een installeerbare EloViewHome Test App
- Het volledige sourceproject van de Test App
- EloViewHome SDK API-documentatie
Verwijs naar de sourcecode van de Test App en de com.eloview.sdk.accountManager.AccountManager API-documentatie die bij de SDK is inbegrepen voor aanvullende implementatiedetails.
Gerelateerde Artikelen
Please report any broken links by emailing elo.support@zebra.com and include a link to the knowledge article