EloViewHome SDK와 함께 오프라인 토큰 사용하기
대상: 안드로이드 애플리케이션 개발자 및 시스템 통합자
문서 유형: 공개 통합 가이드
인증이 필요한 EloViewHome SDK API를 사용하려면 오프라인 토큰이 필요합니다. 오프라인 토큰은 특정 안드로이드 애플리케이션 패키지 이름을 위해 생성됩니다.
오프라인 토큰 요청하기
오프라인 토큰이 없는 경우, elo.support@zebra.com에 연락하여 애플리케이션의 안드로이드 패키지 이름을 제공하십시오.
Elo 지원팀은 애플리케이션과 관련된 자격 증명을 포함하는 .prop 속성 파일을 제공합니다. 속성 파일에는 애플리케이션 패키지 이름과 JWT 오프라인 토큰이 포함되어 있습니다.
package_name=com.example.application
jwt=<offline_token>
⚠️ 중요 속성 경고
오프라인 토큰은 지정된 안드로이드 애플리케이션 패키지 이름에 엄격하게 바인딩됩니다. Elo 지원에 제공된 정확한 패키지 이름이 생산 애플리케이션 패키지 이름과 일치하는지 확인하십시오. 불일치가 있을 경우 토큰 검증이 즉시 실패합니다.
EloViewHome SDK와 함께 제공되는 예제
EloViewHome SDK에는 EloViewHome 테스트 앱과 완전한 테스트 앱 소스 코드가 포함되어 있습니다. 소스 프로젝트는 속성 파일에서 오프라인 토큰을 로드하고 EloViewHome SDK를 통해 검증하는 예제를 제공합니다.
테스트 앱 소스에서 속성 파일은 애플리케이션의 assets 디렉토리에 저장됩니다. 애플리케이션은 속성 파일을 로드하고 jwt 값을 검색하여 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
)
토큰 검증하기
오프라인 토큰은 EloViewHome SDK AccountManager.verifyEloToken() API를 사용하여 검증됩니다.
SDK는 제공된 핸들러를 통해 토큰 검증 결과를 반환합니다. 성공적인 검증은 TOKEN_VERIFY_SUCCESS를 반환합니다. 토큰을 검증할 수 없는 경우 SDK는 TOKEN_VERIFY_FAIL를 반환합니다.
💡 일반적인 토큰 검증 함정 (TOKEN_VERIFY_FAIL):
- 토큰 페이로드가 손상되었거나 잘못 형식화되었습니다.
- 토큰 만료 시점이 지났습니다(비영구적으로 설정된 경우).
- 컴파일된 애플리케이션의 패키지 이름이 인증서의 메타데이터와 정확히 일치하지 않습니다.
포함된 테스트 앱을 참조로 사용하기
SDK와 함께 제공되는 EloViewHome 테스트 앱은 토큰 검증 프로세스를 보여줍니다. 테스트 앱에서 다음으로 이동하십시오:
계정 관리자 API > 자격 증명이 포함된 파일 로드 및 검증 > 토큰 로드 및 검증
포함된 테스트 앱은 애플리케이션의 자산에서 직접 예제 속성 파일을 로드하며, 장치 저장소에서 속성 파일을 선택하지 않습니다. 개발자는 포함된 테스트 앱 소스 코드를 검토하고 자신의 애플리케이션에 오프라인 토큰 인증을 통합할 때 계정 관리자 구현을 참조로 사용해야 합니다.
추가 정보
EloViewHome SDK 패키지에는 다음이 포함됩니다:
- EloViewHome SDK 라이브러리
- 설치 가능한 EloViewHome 테스트 앱
- 완전한 테스트 앱 소스 프로젝트
- EloViewHome SDK API 문서
추가 구현 세부정보를 보려면 테스트 앱 소스 및 SDK와 함께 제공되는 com.eloview.sdk.accountManager.AccountManager API 문서를 참조하십시오.
관련 문서
Please report any broken links by emailing elo.support@zebra.com and include a link to the knowledge article