So verwenden Sie ein Offline-Token mit dem EloViewHome SDK
Zielgruppe: Android-Anwendungsentwickler und Systemintegratoren
Art des Artikels: Öffentlicher Integrationsleitfaden
Ein Offline-Token ist erforderlich, wenn Sie EloViewHome SDK APIs verwenden, die eine Authentifizierung benötigen. Das Offline-Token wird speziell für den Paketnamen Ihrer Android-Anwendung generiert.
Anfordern eines Offline-Tokens
Wenn Sie noch kein Offline-Token haben, wenden Sie sich an den Elo-Technischen Support unter elo.support@zebra.com und geben Sie den Paketnamen Ihrer Anwendung an.
Elo Support wird eine .prop Eigenschaften-Datei bereitstellen, die die Anmeldeinformationen enthält, die mit Ihrer Anwendung verbunden sind. Die Eigenschaften-Datei enthält den Paketnamen der Anwendung und das JWT Offline-Token.
package_name=com.example.application
jwt=<offline_token>
⚠️ KRITISCHER HINWEIS ZUR ZUSCHREIBUNG
Das Offline-Token ist strikt an den angegebenen Paketnamen der Android-Anwendung gebunden. Stellen Sie sicher, dass der genau angegebene Paketname, der an den Elo Support weitergegeben wurde, mit dem Paketnamen Ihrer Produktionsanwendung übereinstimmt. Die Token-Verifizierung schlägt sofort fehl, wenn es eine Abweichung gibt.
Beispiel im EloViewHome SDK enthalten
Das EloViewHome SDK umfasst sowohl eine EloViewHome Test-App als auch den vollständigen Quellcode der Test-App. Das Quellprojekt bietet ein Beispiel, wie ein Offline-Token aus einer Eigenschaften-Datei geladen und über das EloViewHome SDK überprüft wird.
Im Quellcode der Test-App wird die Eigenschaften-Datei im assets-Verzeichnis der Anwendung gespeichert. Die Anwendung lädt die Eigenschaften-Datei, ruft den jwt-Wert ab und übergibt das Token an die 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
)
Überprüfung des Tokens
Das Offline-Token wird mithilfe der EloViewHome SDK AccountManager.verifyEloToken() API überprüft.
Das SDK gibt ein Ergebnis der Token-Überprüfung über den bereitgestellten Handler zurück. Eine erfolgreiche Überprüfung gibt TOKEN_VERIFY_SUCCESS zurück. Wenn das Token nicht überprüft werden kann, gibt das SDK TOKEN_VERIFY_FAIL zurück.
💡 Häufige Stolpersteine bei der Token-Verifizierung (TOKEN_VERIFY_FAIL):
- Die Token-Nutzdaten sind beschädigt oder schlecht formatiert.
- Die Ablauffrist des Tokens ist abgelaufen (wenn auf nicht dauerhaft gesetzt).
- Der Paketname der kompilierten Anwendung stimmt nicht genau mit den Metadaten des Zertifikats überein.
Verwendung der enthaltenen Test-App als Referenz
Die im SDK enthaltene EloViewHome Test-App demonstriert den Prozess der Token-Überprüfung. In der Test-App navigieren Sie zu:
Account Manager API > Eine Datei laden, die die Anmeldeinformationen enthält, und überprüfen > Token laden und überprüfen
Die enthaltene Test-App lädt ihre Beispiel-Eigenschaften-Datei direkt aus den Assets der Anwendung, anstatt eine Eigenschaften-Datei aus dem Gerätespeicher auszuwählen. Entwickler sollten den Quellcode der enthaltenen Test-App überprüfen und die Implementierung des Account Managers als Referenz verwenden, wenn sie die Offline-Token-Authentifizierung in ihre eigene Anwendung integrieren.
Zusätzliche Informationen
Das EloViewHome SDK-Paket umfasst:
- Die EloViewHome SDK-Bibliothek
- Eine installierbare EloViewHome Test-App
- Das vollständige Quellprojekt der Test-App
- EloViewHome SDK API-Dokumentation
Siehe den Quellcode der Test-App und die com.eloview.sdk.accountManager.AccountManager API-Dokumentation, die im SDK enthalten sind, für weitere Implementierungsdetails.
Verwandte Artikel
Please report any broken links by emailing elo.support@zebra.com and include a link to the knowledge article