Como Usar um Token Offline com o EloViewHome SDK
Público-alvo: Desenvolvedores de Aplicativos Android e Integradores de Sistemas
Tipo de artigo: Guia de Integração Pública
Um token offline é necessário ao usar as APIs do EloViewHome SDK que exigem autenticação. O token offline é gerado especificamente para o nome do pacote do seu aplicativo Android.
Solicitando um Token Offline
Se você ainda não tiver um token offline, entre em contato com o Suporte Técnico da Elo pelo e-mail elo.support@zebra.com e forneça o nome do pacote do seu aplicativo Android.
O Suporte Elo fornecerá um arquivo de propriedades .prop contendo as credenciais associadas ao seu aplicativo. O arquivo de propriedades contém o nome do pacote do aplicativo e o token offline JWT.
package_name=com.example.application
jwt=<offline_token>
⚠️ AVISO CRÍTICO DE ATRIBUIÇÃO
O token offline está estritamente vinculado ao nome do pacote do aplicativo Android especificado. Certifique-se de que o nome do pacote exato fornecido ao Suporte Elo corresponda ao nome do pacote do seu aplicativo de produção. A verificação do token falhará imediatamente se houver uma discrepância.
Exemplo Incluído com o EloViewHome SDK
O EloViewHome SDK inclui tanto um Aplicativo de Teste do EloViewHome quanto o código-fonte completo do Aplicativo de Teste. O projeto de código-fonte fornece um exemplo de como carregar um token offline de um arquivo de propriedades e verificá-lo através do EloViewHome SDK.
No código-fonte do Aplicativo de Teste, o arquivo de propriedades é armazenado no diretório assets do aplicativo. O aplicativo carrega o arquivo de propriedades, recupera o valor jwt e passa o token para a 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 o Token
O token offline é verificado usando a API AccountManager.verifyEloToken() do EloViewHome SDK.
O SDK retorna um resultado de verificação do token através do manipulador fornecido. Uma verificação bem-sucedida retorna TOKEN_VERIFY_SUCCESS. Se o token não puder ser verificado, o SDK retorna TOKEN_VERIFY_FAIL.
💡 Armadilhas Comuns na Verificação de Tokens (TOKEN_VERIFY_FAIL):
- O payload do token está corrompido ou mal formatado.
- O tempo de expiração do token já passou (se configurado para não permanente).
- O nome do pacote da aplicação compilada não corresponde exatamente aos metadados do certificado.
Usando o Aplicativo de Teste Incluído como Referência
O Aplicativo de Teste do EloViewHome incluído com o SDK demonstra o processo de verificação do token. No Aplicativo de Teste, navegue até:
API do Gerenciador de Contas > Carregar um arquivo contendo as credenciais e verificar > Carregar e Verificar Token
O Aplicativo de Teste incluído carrega seu arquivo de propriedades exemplo diretamente dos assets do aplicativo, em vez de selecionar um arquivo de propriedades do armazenamento do dispositivo. Os desenvolvedores devem revisar o código-fonte do Aplicativo de Teste incluído e usar a implementação do Gerenciador de Contas como referência ao integrar a autenticação de token offline em seu próprio aplicativo.
Informações Adicionais
O pacote do EloViewHome SDK inclui:
- A biblioteca do EloViewHome SDK
- Um Aplicativo de Teste EloViewHome instalável
- O projeto completo do código-fonte do Aplicativo de Teste
- Documentação da API do EloViewHome SDK
Consulte o código-fonte do Aplicativo de Teste e a documentação da API com.eloview.sdk.accountManager.AccountManager incluída com o SDK para detalhes adicionais de implementação.
Artigos Relacionados
Please report any broken links by emailing elo.support@zebra.com and include a link to the knowledge article