IntegrityErrorCode

public annotation IntegrityErrorCode


Integrity API의 오류 코드입니다.

요약

상수

static final int

Integrity API를 사용할 수 없습니다.

static final int

호출 앱이 설치되어 있지 않습니다.

static final int

호출 앱 UID(사용자 ID)가 패키지 관리자의 UID와 일치하지 않습니다.

static final int

Play 스토어의 서비스에 바인딩할 수 없습니다.

static final int

클라이언트 기기에 일시적인 오류가 발생했습니다.

static final int

입력한 클라우드 프로젝트 번호가 잘못되었습니다.

static final int

알 수 없는 내부 Google 서버 오류입니다.

static final int

알 수 없는 내부 오류입니다.

static final int

사용 가능한 네트워크를 찾을 수 없습니다.

static final int

nonce가 base64, 웹 안전, 줄바꿈 없음 문자열로 인코딩되지 않습니다.

static final int

nonce 길이가 너무 깁니다.

static final int

nonce 길이가 너무 짧습니다.

static final int
static final int

Play 서비스를 사용할 수 없거나 버전이 너무 오래되었습니다.

static final int

Play 서비스를 업데이트해야 합니다.

static final int

기기에서 Play 스토어 계정을 찾을 수 없습니다.

static final int

기기에서 Play 스토어 앱을 찾을 수 없거나 공식 버전이 설치되어 있지 않습니다.

static final int

Play 스토어를 업데이트해야 합니다.

static final int

호출 앱이 API에 너무 많은 요청을 해 제한되었거나 앱이 일일 요청 할당량을 초과했습니다.

상수

API_NOT_AVAILABLE

public static final int API_NOT_AVAILABLE = -1

Integrity API를 사용할 수 없습니다.

Integrity API가 사용 설정되지 않았거나 Play 스토어 버전이 오래되었을 수 있습니다.

추천 해결법:

  • Google Play Console에서 Integrity API가 사용 설정되어 있는지 확인합니다.
  • 사용자에게 Play 스토어를 업데이트하라고 요청합니다.

APP_NOT_INSTALLED

public static final int APP_NOT_INSTALLED = -5

호출 앱이 설치되어 있지 않습니다.

문제가 발생했습니다. 공격일 수 있습니다. 작업이 불가능합니다.

APP_UID_MISMATCH

public static final int APP_UID_MISMATCH = -7

호출 앱 UID(사용자 ID)가 패키지 관리자의 UID와 일치하지 않습니다.

문제가 발생했습니다. 공격일 수 있습니다. 작업이 불가능합니다.

CANNOT_BIND_TO_SERVICE

public static final int CANNOT_BIND_TO_SERVICE = -9

Play 스토어의 서비스에 바인딩할 수 없습니다. 기기에 이전 Play 스토어 버전이 설치되어 있기 때문일 수 있습니다.

사용자에게 Play 스토어를 업데이트하라고 요청합니다.

CLIENT_TRANSIENT_ERROR

public static final int CLIENT_TRANSIENT_ERROR = -17

클라이언트 기기에 일시적인 오류가 발생했습니다.

지수 백오프로 다시 시도합니다.

Integrity Play Core 버전 1.1.0에서 도입되었습니다 (이전 버전은 빈 기기 무결성 확인 결과와 함께 토큰을 반환함). 몇 번 다시 시도한 후에도 오류가 지속되면 기기가 무결성 검사에 실패했다고 가정하고 적절하게 조치를 취해야 합니다.

CLOUD_PROJECT_NUMBER_IS_INVALID

public static final int CLOUD_PROJECT_NUMBER_IS_INVALID = -16

입력한 클라우드 프로젝트 번호가 잘못되었습니다.

Play Integrity API가 사용 설정된 클라우드 프로젝트의 경우 Google Cloud Console의 프로젝트 정보에서 확인할 수 있는 클라우드 프로젝트 번호를 사용합니다.

GOOGLE_SERVER_UNAVAILABLE

public static final int GOOGLE_SERVER_UNAVAILABLE = -12

알 수 없는 내부 Google 서버 오류입니다.

지수 백오프로 다시 시도합니다. 계속 실패하는 경우 버그 신고를 고려해 보세요.

INTERNAL_ERROR

public static final int INTERNAL_ERROR = -100

알 수 없는 내부 오류입니다.

지수 백오프로 다시 시도합니다. 계속 실패하는 경우 버그 신고를 고려해 보세요.

NETWORK_ERROR

public static final int NETWORK_ERROR = -3

사용 가능한 네트워크를 찾을 수 없습니다.

추천 해결법:

  • 사용자에게 네트워크 연결을 확인하고 사용 설정해 달라고 요청합니다.
  • 사용자가 네트워크 연결을 설정하는 데 도움이 되는 안내 사용자 환경의 경우 GET_INTEGRITY 또는 GET_STRONG_INTEGRITY 대화상자를 표시할 수 있습니다.

NONCE_IS_NOT_BASE64

public static final int NONCE_IS_NOT_BASE64 = -13

nonce가 base64, 웹 안전, 줄바꿈 없음 문자열로 인코딩되지 않습니다.

정확한 nonce 형식으로 다시 시도합니다.

NONCE_TOO_LONG

public static final int NONCE_TOO_LONG = -11

nonce 길이가 너무 깁니다. nonce는 base64 인코딩 전에 500바이트 미만이어야 합니다.

더 짧은 nonce로 다시 시도합니다.

NONCE_TOO_SHORT

public static final int NONCE_TOO_SHORT = -10

nonce 길이가 너무 짧습니다. nonce는 보안 강화를 위해 최소 16바이트 (base64 인코딩 전)여야 합니다.

더 긴 nonce로 다시 시도합니다.

NO_ERROR

public static final int NO_ERROR = 0

PLAY_SERVICES_NOT_FOUND

public static final int PLAY_SERVICES_NOT_FOUND = -6

Play 서비스를 사용할 수 없거나 버전이 너무 오래되었습니다.

추천 해결법:

  • 사용자에게 Play 서비스를 설치하거나 업데이트하라고 요청합니다.
  • 사용자가 Play 서비스를 사용 설정하거나 설치하거나 업데이트할 수 있도록 안내하는 사용자 환경을 위해 GET_INTEGRITY 또는 GET_STRONG_INTEGRITY 대화상자를 표시할 수 있습니다.

PLAY_SERVICES_VERSION_OUTDATED

public static final int PLAY_SERVICES_VERSION_OUTDATED = -15

Play 서비스를 업데이트해야 합니다.

추천 해결법:

  • 사용자에게 Google Play 서비스를 업데이트하라고 요청합니다.
  • 사용자가 Play 서비스를 업데이트할 수 있도록 안내하는 사용자 환경을 위해 GET_INTEGRITY 또는 GET_STRONG_INTEGRITY 대화상자를 표시할 수 있습니다.

PLAY_STORE_ACCOUNT_NOT_FOUND

public static final int PLAY_STORE_ACCOUNT_NOT_FOUND = -4

기기에서 Play 스토어 계정을 찾을 수 없습니다. Play Integrity API가 이제 인증되지 않은 요청을 지원합니다. 이 오류 코드는 지원되지 않는 이전 Play 스토어 버전에만 사용됩니다.

사용자에게 Play 스토어에서 인증하라고 요청합니다.

PLAY_STORE_NOT_FOUND

public static final int PLAY_STORE_NOT_FOUND = -2

기기에서 Play 스토어 앱을 찾을 수 없거나 공식 버전이 설치되어 있지 않습니다.

사용자에게 Play 스토어의 공식 최신 버전을 설치하라고 요청합니다.

PLAY_STORE_VERSION_OUTDATED

public static final int PLAY_STORE_VERSION_OUTDATED = -14

Play 스토어를 업데이트해야 합니다.

사용자에게 Google Play 스토어를 업데이트해 달라고 요청합니다.

TOO_MANY_REQUESTS

public static final int TOO_MANY_REQUESTS = -8

호출 앱이 API에 너무 많은 요청을 해 제한되었거나 앱이 일일 요청 할당량을 초과했습니다.

지수 백오프로 다시 시도합니다. 일일 요청 한도에 도달한 경우 일일 요청 할당량 증가를 요청하세요.